---
title: "Data Source - X Ads (Formerly Twitter Ads)"
slug: "data-source-twitter-ads"
updated: 2024-09-19T08:14:44Z
published: 2024-09-19T08:14:44Z
canonical: "documents.trocco.io/data-source-twitter-ads"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://documents.trocco.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Data Source - X Ads (Formerly Twitter Ads)

## summary

Help Page for X Ads (Formerly Twitter Ads) Analytics Data Setting for ETL Configuration.

## Setting items

### STEP1 Basic settings

| item name | indispensable | default value | Contents |
| --- | --- | --- | --- |
| X Ads (Formerly Twitter Ads) Connection Configuration | Yes | - | Select the previously registered Connection Configuration that has the necessary permissions for this ETL Configuration. For more information, see [X Ads (Formerly Twitter Ads) Connection Configuration](/docs/connection-configuration-twitter-ads). |
| Ad Account ID | Yes | - | Specify the ID of the account from which you want to retrieve data. |
| Acquisition Target | Yes | - | Select the type of data you wish to transfer from the following`account report``campaign report``line_item report``media_creative report` (beta version)`promoted_tweet report` (beta version)`card` |
| Report acquisition period | Yes | - | Specify if you have selected a target other than " `card"`. Enter the start and end dates of the data you wish to retrieve, as well as the time zone for the retrieval period. |

### STEP1 Detailed settings

This can be specified when `"card" is` selected as the acquisition target. Click on **Set Details** to display the configuration items.

| item name | indispensable | default value | Contents |
| --- | --- | --- | --- |
| Entity acquisition period | No | - | This can be specified when `"card" is` selected as the acquisition target. You can enter the start and end dates of the data you wish to retrieve, as well as the time zone for the retrieval period. |

              Regarding the acquisition period

              

Due to the specifications of the Twitter Ad API, the following flow is used to acquire data for each.

- If you select an item other than `card` as the acquisition target
  - First, retrieve all entities present on the Twitter ad.
  - Retrieves records from the retrieved entity according to the retrieval period entered.
- If you select `"card"` as the acquisition target
  - First, retrieve all entities present on the Twitter ad.
  - From the retrieved entities, those with `created_at` within the retrieval period entered are retrieved as records.
  - If you do not enter a retrieval period, **records for all entities will be retrieved**.