X Ads (formerly Twitter Ads) integration setup

At a glance: Integrate your X Ads account with AppsFlyer to display attribution data of X Ads campaigns.

Connecting your X Ads account to AppsFlyer

 Watch
 Read

 Before you begin

Make sure you've added a payment method to your X Ads account. Otherwise, you won't be able to activate the partner integration in AppsFlyer.

  1. Log in to your X Ads Account at ads.twitter.com
    If you're not automatically directed to the Ads page, click the Ads button at the top-left corner.

  2. When prompted to select either a Simple (NEW) or Advanced campaign, select Advanced
  3. Under Campaign objective, select App Installs or App re-engagements, then click Next.

    twitter-campaign-objective.png

     

  4. Choose your app, then click the mobile measurement partner link.

  5. On the Conversion tracking page, click Go to AppsFlyer

    twitter-mmp-selection.png

  6. A notification displays informing you that you're about to leave X Ads to go to the AppsFlyer website. Click Go to AppsFlyer and log in to your Dashboard.

    twitter-go-to-appsflyer.png

  7. In AppsFlyer, from the side menu, select Collaboration > Active Integrations.
  8. Search for X Ads and select it.
  9. In the Integration tab, accept the X Ads Terms and Conditions for Mobile App Conversion Recording (MACT), then click Save integration
  10. Turn on Activate partner, and click Log in with X Ads.
  11. Authorize AppsFlyer to use your X Ads account by clicking Authorize app

  12. Turn on Activate Partner again to display the Integration tab settings and enable attribution.
    Note: The toggle must stay on (activated) for as long as you work with the partner. Learn more about partner activation.
  13. Select your X Ads accounts to activate them, then click Save & Close.

    twitter_account_name.png

X Ads attribution setup

For a detailed description of the partner configuration page Header, click here.

Integration tab

The Integration Tab is divided into different sections, as described below. Partner must be activated on the first visit to enable its setup.

Ad account connected

Select the accounts to enable attribution.

Twitter_msc_new_4.png

Click-through attribution

Use the slider to set the maximum time from click to install. Only installs (first launches) that take place within the lookback window may be attributed to X Ads.

You can customize this value to 1-23 hours or 1-30 days. We recommend setting the click-through lookback window to 14 days, to align with X Ads.

Twitter_msc_new_6.png

View-through attribution lookback window

This slider allows you to set the maximum time from impression to the install. Only installs (first launches) that take place within this lookback window, following an ad impression, are attributed to X Ads, providing there was no other relevant ad click.

You can customize this value to 1-23 hours or 1-7 days. We recommend setting the View-through lookback window to 1 day, to align with X Ads.

Twitter_msc_new_7.png

Re-engagement settings

X Ads retargeting attribution includes only re-engagement conversions.

Turn on the Re-engagement attribution toggle to start attributing re-engagements for X Ads.

Re-engagement click-through lookback window

Set the duration of the Re-engagement click-through lookback window (the maximum period of time after an ad is clicked, within which a retargeted user can be attributed to the ad). You can set the value in hours (up to 23) or days (1-30).

twitter-reengagement-activate.png

Re-engagement view-through lookback window

To start attributing impressions of retargeting ads, activate Re-engagement view-through attribution.

Then, set the duration of the Re-engagement view-through lookback window (the maximum period of time after an ad is viewed, within which a retargeted user can be attributed to the ad). You can set the value in hours (up to 23) or days (1-7):

twitter-reengagement-view-through.png

Re-engagement window

Set the duration of the Re-engagement window (the period when the user's in-app events are attributed to the retargeting media source). You can set the value in days (1-90), hours (up to 23), or even lifetime:

Twitter-reengagement-window.png

In-app event postback settings

In this section, you can map your AppsFlyer events with your partners via postbacks.

In-app_event_postbacks_en-us.png

To configure in-app event postbacks: 

  1. Set the Partner ID (if required).
  2. Enable In-app event postback.
  3. Click Add event to add an SDK or server-to-server event to the list.
  4. Complete the parameters required according to the table below.
    Parameter Description
    AppsFlyer event

    The name of the event, as received by AppsFlyer either from the SDK integrated into your app or from server-to-server events.
    Tip: Don't see the event you are looking for?

    • Make sure to activate the event on a device with a non-organic installation and recheck.
    • Type it in AppsFlyer event, then click Create custom. Read more about custom event mapping.
    mapped to partner event

    The unique name or ID of each event, as defined on the partner's side. Possible mapping configurations:

    • Text field: Get the corresponding event ID from the partner.
    • Drop-down box: Select the most suitable pre-defined AppsFlyer event.
    • As is: Send the events as they are, without name mapping.
    for users from

    Select the sending option for the event:

     Note

    For X Ads to receive agency-attributed postbacks, you must select All media sources, including organic. Otherwise, X Ads won't receive such postbacks. 

    • This partner only: send postbacks only when this event is attributed to this partner.
    • All media sources, including organic: send postbacks for events attributed to any partner and organic events.
    including
    • No data (default): send only the event itself without the event value.
    • Values and revenue: send all the event parameters, including the revenue value (if exists in the event).
    • Values without revenue: send all the parameters excluding the revenue value.
  5. [Optional] Click conditional-iae-postbacks-icon.png to set conditions for sending certain in-app events to the partner.
    Learn more about conditional in-app event postbacks

Attribution link tab

X Ads does not use attribution links for attribution.

 Note

For all self-reporting networks (SRNs), such as Meta ads, Apple Search Ads, Google Ads, X Ads, etc., this tab is not functional since they don't use external attribution links.

Cost tab

The cost integration provides the following aggregated data:

  • Cost data for your campaigns, adsets, ads, and channel levels. See the ad network cost integration table for full details on the supported dimensions, metrics, and features.
    Note: Cost data requires an ROI360 subscription. 
  • Data on clicks, impressions, and enriched data (keywords, campaign names, and adset).

To enable the cost API:

View your cost API status and the last time AppsFlyer managed to pull matching cost data in either the cost (and ad revenue) integration status dashboard, or in the individual ad network dashboard.

Ad revenue tab

Ad revenue integration is not available for X Ads. To receive ad revenue data, integrate MoPub.

Permissions tab

In this tab, you can select the permissions to grant X Ads, whether the partner acts as an ad network, agency, or even both. Note that even if attribution is disabled for X Ads, the permissions tab is active and you can grant control to X Ads.

Use these toggles to give the ad network permissions to handle its own configuration for your app:

Ad network permissions

  • Allow to configure integration - permit the partner to set up the integration tab (except in-app event postbacks)
  • Allow to configure in-app event postbacks - permit the partner to setup in-app event postbacks mapping to itself on the integration tab
  • Allow access to your retention report - only to the partner's own retention data
  • Allow access to your aggregate loyal user data - only to the partner's own loyal user data
  • Allow access to your aggregate in-app event data - only to the partner's own in-app event data
  • Allow access to your aggregate revenue data - only to the revenue data attributed to the partner
  • Allow access to your Protect360 dashboard - only to the partner's own Protect360 data, and providing the feature is enabled for the advertiser

Learn more about granting ad network permissions.

Agency permissions

Learn about granting agency permissions

Advanced X Ads setup video 

 Watch

Traits and limitations

Traits and limitations
Trait Remarks

Pre-roll attribution unsupported

X Ads doesn’t support MMP attribution for Pre-roll campaigns. 

Limited name visibility

The dashboard shows IDs instead of names for line item names (ad set names) and post names (ad names). This is because AppsFlyer receives from X Ads only the IDs for these elements and not their names.