X Ads (Twitter Ads) campaign data can be collected through Airbridge tracking links. Airbridge supports X Ads Conversions API integration for campaign optimization.
Attention
Airbridge supports app install campaign tracking. Re-engagement campaign tracking is currently not supported.
Attention
X ad campaign data can be collected through Airbridge custom tracking links. Make sure the custom channel name is entered as
x.ads
.
Navigate to [Tracking Link]>[Link Generation] and click the [Custom Channels] tab to create a custom tracking link.
For more details on how to create a custom tracking link, refer to this article.
With the conversions API integration, the events collected by Airbridge can be sent to X Ads for campaign optimization.
Make sure to complete the pre-setup before setting up your X Ads campaigns. The following information must be shared with your Airbridge CSM once you complete the pre-setup.
Pixel ID
X event names and the Conversion event IDs of the events
Airbridge event names mapped to X events
1. Log in to your X Ads account. Navigate to [Tools]>[Events Manager] and find the Pixel ID. Share the Pixel ID with your Airbridge CSM.
Attention
If no payment method is registered with X Ads, the [Tools] and other menus may not be visible. For more details, refer to this article from X Ads.
2. Go to the X Ads Integration page and fill in the fields.
Airbridge API Token: Enter the API Token. You can find it on the [Settings]>[Tokens] page.
App Name: Enter the Airbridge App Name. You can find it on the [Settings]>[Tokens] page or the [Settings]>[App Settings] page.
Pixel ID: Enter the Pixel ID you found in step 1.
X(twitter) EPC Status: Configure the Expanded Privacy Control (EPC) toggle. If the EPC toggle is switched on, the events may not be sent through the Conversions API properly. For more details refer to this article.
3. Click Register and log in to your X Ads account. The account must have active campaigns. After logging, click Authorize app.
4. The following information must be shared with your Airbridge CSM.
X event name
and the Conversion event ID
: Find them on the [Tools]>[Events manager]>[Overview]>[Events] page in X Ads.
Airbridge event name
: The Airbridge event you want to map to the X event. Refer to this section of the article first before event mapping.
Let’s say your X Ads dashboard looks like the following image.
The information you need to share with your CSM is as follows.
X event name
and the Conversion event ID
: Download (ID:tw-ofOh4-of0jx)
Airbridge event name
: App Install
5. The Airbridge CSM will notify you when the integration is complete. When the conversion events are received through the Conversions API, the Status will change to Active
.
Make sure the pre-setup is completed before setting up your X Ads campaign.
1. Select Advanced
when creating a campaign in X Ads.
2. Select Sales in [Campaign objective].
3. Configure campaign details in [Campaign details]. In [Ad group details]>[Delivery], you need to select the conversion event, which will be used for campaign optimization. Here, select the Airbridge event you have shared with your Airbridge CSM as part of the pre-setup process.
4. In the [Media] section, click Add media. Enter the Airbridge custom channel tracking link you have created into the Website URL field that shows under [Details].
You can view the X Ads campaign data in Airbridge across all report types by configuring the filter in the report configuration box as follows.
Channel
is x.ads
Follow the steps below to enable cost integration with X Ads.
1. Navigate to [Integrations]>[Ad Channel Integration] in the Airbridge dashboard. Select “X Ads (Twitter Ads)."
2. Select the [Cost Integration] tab. Switch on the X Ads Cost Integration toggle.
3. Click Log in to X Ads and log in to your X Ads account. The account must have a recent history of campaign operation. In the login process, allow Airbridge to access your account.
4. Select the ad accounts you want to connect with Airbridge from the ad account list. Ad account already integrated with Airbridge don't show in the list.
5. When you complete the steps above, you will see the ad accounts in the integrated ad account list. The status will show “Waiting” for up to 4 hours from the time the ad account is added and will change to “Active” when data is pulled for the first time.
To disable the integration, switch off the cost integration toggle. No data will be pulled once the integration is disabled. Data already pulled into Airbridge is not affected.
The account information remains saved to Airbridge unless you remove the ad account from the integrated account list. By switching back the toggle on, the cost integration is enabled again with existing account information.
Select the ad account you wish to delete from the integrated ad account list and click Delete to delete it.
If you want to reconnect the deleted ad account, you need to add the ad account and set up the connection from the beginning.
Upon submitting your ad account information to Airbridge, you can check if the integration is running. The status may show “Waiting” even when the account is successfully added if no data has been pulled yet.
For more details on the integration status and data import schedule, refer to the below information.
The integration status shows your cost integration and data update status at a glance.
Status | Description |
---|---|
Waiting | The ad account is successfully added, but no data has been pulled yet. This status may remain for up to 4 hours. |
Success | The data is being pulled and updated regularly. The last update time is displayed. |
No data | No data has been pulled as the campaign has not run for the past 7 days. |
Failed | The data can’t be pulled due to an error. Some of the most common causes are: |
To ensure accuracy, Airbridge pulls the cost data several times throughout the day.
Frequency: Every 4 hours, 6 times a day starting 3:00 PM (UTC)
Schedule: 3:00 PM, 7:00 PM, 11:00 PM, 3:00 AM, 7:00 AM, 11:00 AM (UTC)
Data pulled: Cost data from the past 7 days, from D-0 to D-6
The last data update time is found under “Last Updated” in the integrated account list.
The cost data pulled from X can be viewed in Airbridge reports using the metrics and GroupBys below.
Metrics | Description |
---|---|
Clicks (Channel) | The number of clicks measured by the ad channel |
Impressions (Channel) | The number of impressions measured by the ad channel |
Cost (Channel) | The ad spend spent on the ad channel |
Difference between Clicks and Clicks (Channel) metrics
The Clicks and Clicks (Channel) metrics both indicate the number of ad clicks, but their data collection methods differ.
Clicks: Data collected through Airbridge tracking links
Clicks (Channel): Data provided by Integrated Channels
All metrics with (Channel) in their names reflect the measurement reported by Integrated Channels. This rule applies to Impression and Impression (Channel) metrics as well.
GroupBy | Description |
---|---|
Channel | The media source of the winning touchpoint |
Campaign | The name of the campaign of the winning touchpoint |
Ad Group | The name of the ad group of the winning touchpoint |
Term | The term, or the search keyword, of the winning touchpoint |
Campaign ID | The unique ID assigned to the campaign of the winning touchpoint |
Ad Group ID | The unique ID assigned to the ad group of the winning touchpoint |
Term ID | The unique ID assigned to the term, or the search keyword, of the winning touchpoint |
Ad Account ID | The unique ID assigned to the ad account of the winning touchpoint |
Sub Publisher | The second-tier media source of the winning touchpoint |
GroupBy | Description |
---|---|
Country | The country code for the mobile device |
OS Name | The operating system installed on the mobile device |
GroupBy | Description |
---|---|
Event Hour | The hour the event occurred in a 24-hour format |
Event Date | The day the event occurred (YYYY-MM-DD) |
Event Year | The year the event occurred (YYYY) |
Event Month | The month the event occurred (MM) |
Event Week | The week the event occurred (WW) |
Event Day of the month | The day of the month the event occurred (DD) |
Event Day of the week | The day of the week the event occurred in three-letter abbreviations |
Manage the access permission of the agencies and have control over which agency has access to your X Ads campaign data.
Here are important points to consider when creating tracking links for X Ads campaigns.
You need to generate Custom Channel tracking links with the Custom Channel name set to "x.ads," all lowercase. If you don't use "x.ads" as the Custom Channel name for all your tracking links, Airbridge won't be able to aggregate X Ads campaign data and the X Ads cost data under the single ad channel name, "x.ads" and the data will be separated into different rows in the Airbridge reports.
Also, ensure that the campaign, ad group, and ad names you enter in the X Ads dashboard match the campaign, ad group, and creative names in the Airbridge dashboard when creating the tracking links. If the parameter names entered in the dashboards differ, the data collected through the X Ads campaign parameters will be separated into different rows in the Airbridge report. When the ad creative name is not entered in the X Ads dashboard, Airbridge uses the tweet URL as the ad creative parameter value.
When connecting Airbridge with an X Ads ad account running campaigns of different apps, the campaign data may not be reported by different apps separately in the Airbridge reports. This is because X Ads may not provide information to distinguish the data of different apps when running campaigns other than app promotion campaigns.
The Airbridge event is sent to X through the CAPI if one of the following conditions are met.
If the app event is attributed to active X campaigns
If the hashed user email has been collected along with the app event
Therefore, the following tips are recommended for campaign optimization.
Was this page helpful?