Configure tracking and postbacks
Not supported
Details coming soon
As of September 29th, 2025, X is an Advanced self-attributing network. As an Advanced SAN, Singular's attribution measurement for X app campaigns will utilize existing self-attributing signals with touchpoints reported directly from X, to augment Singular MMP reporting in Singular. Read more about Advanced SAN.
Integration Summary
(See Partner Integrations Glossary)
| Partner | X Ads (found under Twitter Ads) |
| Partner Type | Self-attributing Ad Network |
| Creatives | Supported |
| Publisher | Supported |
| View-Through | Supported for Installs |
| Re-engagement | Supported |
| S2S | N/A |
| Click Tag | No (Self-attributing) |
| Receiving All Installs | Recommended (Self-attributing) |
| Receiving All Events | Recommended (Self-attributing) |
Setting Up X Ads Attribution Tracking
Note: As of June 2020, advertisers may apply to X's Advanced Mobile Measurement Program. Under the AMM Program, advertisers may receive all device-level data (excluding EU and UK users) for measurement purposes. To participate in X’s AMM Program, review and accept the terms.
To set up X Ads attribution tracking:
- Integrate the Singular SDK or S2S (see Getting Started with the Singular SDK/S2S).
- Create and provision your X Ads account. Note that the account must be X Ad enabled. For more information, see X Help Center or contact your X Ads account manager.
-
Proceed to set up your Partner Configuration on X:
Note: This next step will provision Singular as an app Mobile App Conversion Tracking partner, associated with your X ads account. Only one MACT partner can be provisioned for an app at any given time.
- Accept X's Terms and Conditions.
-
Log in and link your X Ads account with Singular. This should be the X Ads account that is permitted to manage campaigns for all your X ad accounts if you have more than one.
-
Select the authorized accounts that are promoting your app and select Next.
-
Configure the X integration like any other partner.
By default, installs are reported to X to enable install attribution tracking. Select the Enable Re-engagement Tracking checkbox to have sessions reported to X, to allow Singular re-engagement tracking.
You can also have Singular report post-install events to X for conversion optimization and reporting. To enable this option, you must map the event to the desired X Conversion event.
FAQ
X’s Advanced SAN leverages touchpoints reported directly from X to Singular, to augment Singular’s SAN attribution to X mobile app campaigns.
- Advanced SAN is automatically enabled for both iOS and Android app campaign measurement and is a privacy-preserving option to attribute opt-in and opt-out users from your X campaigns.
- Advanced SAN prioritizes SAN attribution, and falls back to non-SAN (Advanced) signals to attribute when there is no SAN attribution.
- Both SAN and non-SAN attributions are reported under source "Twitter". Segmentation between SAN and non-SAN attributions can be distinguished through the tracker source name dimension as "Twitter" and "Twitter - Advanced", respectively. See Data Mapping
- Singular Links do not need to be created for Advanced SAN. X and Singular maintain a direct click and impression reporting integration to facilitate Advanced SAN attributions.
Once an attribution is tracked, your X campaigns will appear in your Singular Reporting interface.
Singular supports reporting attributed X app campaign data for click-through and view-through installs and re-engagements. Currently, the available data includes the Campaign ID, Campaign Name, Line Item ID, Publisher App ID, and Tweet ID. This data is mapped to Singular as "Campaign ID", "Campaign Name", "Sub Campaign Name", "Publisher ID", and "Creative ID" respectively.
Note that "Network Installs" in Singular currently reports "conversions" from X's reporting API.
Partner Data Policies
As a X Ads Mobile App Conversion Tracking partner, Singular adheres to the following data handling requirements required by X:
Data Retention
X Ads user-level data is removed after 6 months of original attribution. After 6 months, users attributed to X as treated/marked as "Organic" and reflected as such in both aggregate and user-level reporting in Singular.
Data Access
X Ads's end-users have the ability to opt out of sharing data with third parties. This may increase reporting discrepancies between X Ads and MMPs. By default, Singular respects the opt-out by not reporting these users as attributed to X Ads in user-level data (BI postbacks, exports). However, they are still included in aggregate reporting.
As of June 2020, advertisers may apply to X Ads's Advanced Mobile Measurement Program. Under the AMM Program, advertisers may receive all device-level data (excluding EU and UK users) for measurement purposes. To participate in X Ads’s AMM Program, review and accept the terms. Once you submit the form, device-level data will be available within seven business days.
X Ads Reporting in Singular
| Singular Dimension | Name in X Ads |
Example |
| Tracker Campaign Name | X Campaign Name | “MyCampaign” |
| Tracker Campaign ID | X Campaign ID | 2xzbi |
| Tracker Sub Campaign Name | X Line Item ID | aied2 |
| Tracker Publisher ID & Name | X Publisher App ID | com.publisher.app 123456789 |
| Tracker Creative ID | Tweet ID | 351166379755724804 |
X Ads Organic
Singular also tracks attributions from organic tweets through the X Ads integration. These appear in reports under the source "Twitter Organic."
Troubleshooting
Why are there discrepancies between data reported in X and data reported in Singular reports?
In Singular, the default attribution windows are: 30 days click and 1 day view. Reporting within X could differ depending on what windows are set in their platform. Review X's documentation for their supported attribution windows.
Why do I see differences between X data in my report and user-level exports?
X allows users to opt out of sharing data with third parties. Singular respects this value by not reporting these users as attributed to X in user-level data (BI postbacks, exports), but they are still included in aggregate reporting.