NoteTo set up X Ads integration, contact your CSM or reach out through Contact us.
Set up Conversion API
Complete the Conversion API (CAPI) setup by following the steps below. Finish registering your credentials and sharing event information before launching a campaign.Create tracking link
Create a tracking link in the Airbridge dashboard under [Tracking Link]>[Link Generation]>[Custom Channels]. For detailed instructions, see this article.- Create a Custom Channel tracking link, not an Integrated Channel tracking link.
- Enter the ad channel name as
x.ads.
Register credentials
Go to X (Twitter) CAPI Integration and register the following credentials:- Airbridge API Token
- App Name
- Pixel ID
- Find the API Token in the Airbridge dashboard under [Settings]>[Tokens] and enter it.
- Find the App Name in the Airbridge dashboard under [Settings]>[Tokens] and enter it.
- Find the pixel ID in the X Ads dashboard under [Tools]>[Events manager] and enter it.
- Choose whether to enable Extended Privacy Control (EPC). Enabling EPC may restrict sending events. For more details, see this article.
NoteIf you haven’t registered a payment method in X Ads, some menus, including [Tools], may not appear. See X Ads guide for more details.
- Click Register.
- Sign in to X Ads with the account you will use to run campaigns. Grant Airbridge access permissions.
Share event information
- In the X Ads dashboard, go to [Tools]>[Events manager] and find the following event details. To find the Event ID, click the code icon
<>on the right side of the event row, then select the Conversion API tab.- Event name
- Event ID
- Refer to this section to decide which Airbridge events to map to your X Ads events.
- Share the following information with your CSM or through Contact us.
- X Ads event name
- X Ads event ID
- Airbridge event name to map
- Airbridge will notify you once the integration is complete.
- After the campaign launches, events collected by Airbridge are sent to X Ads via the Conversion API. Successfully received events appear with an Active status in the X Ads dashboard.
Set up X Ads campaign
- In the X Ads dashboard, click Create campaign.
- Under [Objective], select a campaign objective. Then click Next.
Note
- App installs objective is not supported.
- Only the Sales objective supports using events sent via Conversion API for campaign optimization.
- Under [Details], configure your campaign details.
- Under [Delivery & Placements]>[Conversion event], select the event to use for campaign optimization. Choose the X Ads event you shared with Airbridge in the previous step. Then click Next.
- Go to [Ad details]>[Destination]>[Website URL] and enter your custom channel tracking link.
- Under [Media], click + Add media to upload your files. Then click Next.
- Review your campaign settings and click Publish to launch the campaign.
Viewing X Ads campaign data in Airbridge
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.Channelisx.ads
Cost Integration Setup
Follow the steps below to enable cost integration with X Ads.Settings in the Airbridge dashboard
- Navigate to [Integrations]>[Ad Channel Integration] in the Airbridge dashboard. Select “X Ads (Twitter Ads).”
- Select the [Cost Integration] tab. Switch on the X Ads Cost Integration toggle.
- 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.
- 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.
- 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.
Integration management
Pause cost integration
Pause cost integration
Turn off the toggle to pause the integration. Airbridge stops collecting cost data once the integration is paused.Any data collected before the pause remains available in Airbridge reports.Airbridge retains the credentials of the integrated account, so you can resume the integration at any time by turning the toggle on. However, deleting the integrated account removes these credentials.
Delete integrated account
Delete integrated account
Select the account from the integrated account list and click Delete to remove the account. To re-integrate the account after deletion, set up the integration from the beginning.
Integration status
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.Cost integration status
Cost integration status
Cost data import schedule
Cost data import schedule
- Frequency: Every 4 hours, 6 times a day, starting at 3:00 PM UTC
- Import times: 3:00 PM, 7:00 PM, 11:00 PM, 3:00 AM, 7:00 AM, 11:00 AM UTC
- Data range: Current day (D-0) to 6 days ago (D-6)
Cost data in Airbridge reports
The cost data pulled from X can be viewed in Airbridge reports using the metrics and GroupBys below.Metrics for cost data
Metrics for cost data
Difference between Clicks and Clicks (Channel)Both Clicks and Clicks (Channel) show click count, but the data source differs:
- Clicks: Collected through Airbridge tracking links
- Clicks (Channel): Provided by the ad channel
GroupBys for cost data
GroupBys for cost data
NoteUse the groupBys below to break down cost data in Airbridge reports. Available groupBys vary by ad channel.
Touchpoint
Device
Event Datetime
Agency Settings
Manage the access permission of the agencies and have control over which agency has access to your X Ads campaign data.Attention
Creating tracking links for X Ads campaigns
Creating tracking links for X Ads campaigns
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 with ad accounts running campaigns of different apps
When connecting with ad accounts running campaigns of different apps
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.
Tips for campaign optimization
Tips for campaign optimization
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