Skip to content

How to Import Data from X Ads Source

Before proceeding, please make sure that:

  • You have created a CREDENTIALS: API Key, API Secret, Access Token, Access Token Secret.
  • You have set up OWOX Data Marts and created at least one storage in the Storages section.

X Ads Storage

  • Click New Data Mart.
  • Enter a title and select the Storage.
  • Click Create Data Mart.

X Ads New Data Mart

  1. Select Connector as the input source type.
  2. Click Set up connector and choose X Ads.
  3. Fill in the required fields:
    • Consumer Key (API Key) and Consumer Secret (API Secret) – available in the Consumer Keys section of your X Ads app.
    • Access Token and Access Token Secret – available in the Authentication Tokens section of your X Ads app.
    • Account ID – you can get this ID on https://ads.x.com and look at the URL of your account. For example, in this link: https://ads.x.com/campaign_form/18ce55in6wt/campaign/new the Account ID is: 18ce55in6wt
  4. Leave all other fields as default and proceed to the next step.

X Ads Input Source

X Ads Fill Data

X Ads Account ID

  1. Choose one of the available endpoints.
  2. Select the required fields.
  3. Specify the dataset where the data will be stored (or leave the default).
  4. Click Finish, then Save and Publish Data Mart.

X Ads Publish Data Mart

You now have two options for importing data from X Ads:

Option 1: Import Current Day’s Data

Choose Manual run → Incremental load to load data for the current day.

X Ads Import New Data

X Ads Incremental Load

ℹ️ If you click Incremental load again after a successful initial load,
the connector will import: Current day’s data, plus Additional days, based on the value in the Reimport Lookback Window field.

X Ads Reimport

Option 2: Manual Backfill for Specific Date Range

Choose Backfill (custom period) to load historical data.

  1. Select the Start Date and End Date.
  2. Click the Run button.

X Ads Backfill

The process is complete when the Run history tab shows the message:
“Success”

C Ads Success

Once the run is complete, the data will be written to the dataset you specified earlier.

X Ads Import Success

If you encounter any issues:

  1. Check the Run history for specific error messages
  2. Please visit Q&A first
  3. If you want to report a bug, please open an issue
  4. Join the discussion forum to ask questions or propose improvements