We constantly publish updates to our documentation, which may not yet be available in your language. For the most current information, use the English version.

for Marketers

Set up X (formerly Twitter)

As an X (formerly Twitter) Mobile App Conversion Tracking Partner (MACT), Adjust can measure your performance marketing efforts on X (formerly Twitter).

X (formerly Twitter) ads are organized by X (formerly Twitter) handles and X (formerly Twitter) Ads accounts. While each X (formerly Twitter) handle is directly associated with a specific Ads account, its access can be extended to include additional ad accounts within your X (formerly Twitter) interface. Therefore, apps in Adjust may be associated with various Ads accounts and any number of handles. All X (formerly Twitter) handles and X (formerly Twitter) Ads accounts can be precisely configured in managing data visibility and sharing.

When making changes to your X (formerly Twitter) account setup, we always recommend pausing your X (formerly Twitter) campaigns, since the MACT API requires a complete re-sync of all modified account data.

Important:

X (formerly Twitter) will only integrate with one MMP at a time. If you migrated from another MMP to Adjust, and the X (formerly Twitter) integration isn’t working, make sure you’ve disabled your X (formerly Twitter) integration with your previous MMP. If you’ve already closed your account with the previous MMP, contact them to confirm the X (formerly Twitter) integration is disabled.

Before you begin

Here's what you need to know before getting started.

Requirements

X (formerly Twitter) account credentials
Adjust SDK v4.0.0 and later to map SDK parameters to network parameters. Follow the guides linked below to use this feature.
iOS / Android / Windows / Unity / React Native / Flutter / Adobe Air / Cordova / Marmalade / Xamarin / Cocos2d-x / Titanium / Corona

Initial setup

To set up X (formerly Twitter) for your app, follow these steps.

Under Campaign Lab, select Partners.
Select New partner.
In the Partner selection screen, choose Twitter. Now, Adjust checks if you have added your X (formerly Twitter) account in DataWorks > Connections.
- If you have not added your X (formerly Twitter) account, go to the next step.
- If you have already added your X (formerly Twitter) account, go to Step 5.
Select Go to Connections to add your X (formerly Twitter) account, and follow these steps.
1. Accept Twitter's Mobile App Conversion Tracking (MACT) Terms & Conditions.
2. Select Sign in with Twitter.
3. Log in to X (formerly Twitter) with your account credentials, and select Authorize app. This automatically redirects you back to the Connections management page in DataWorks.
4. Select Reload accounts.
In the App selection screen, choose your app, and select Next.

Then, set your data sharing options, review your setup, and enable X (formerly Twitter) for your app.

Data sharing

Share data with X (formerly Twitter) to optimize your campaigns. In the Data sharing screen, follow these steps.

Enable data sharing for X (formerly Twitter)

Choose the X (formerly Twitter) accounts that you want to share data with. Expand the accordion to choose the accounts associated with an X (formerly Twitter) handle, and select the accounts that you want to send data.

Note:

Data that is sent to X (formerly Twitter) is determined by the accounts that you select for the selected app. The data sent is not separated by platform - Android or iOS.

Set your data sharing options

Once you enable data sharing, Adjust sends data from all attribution sources to X (formerly Twitter) by default. This includes data attributed to X (formerly Twitter), data attributed to other networks, and organic data. Additionally, you can choose to share the following data with X (formerly Twitter).

Select In-app revenue (from in-app purchases) to send detailed revenue data to X (formerly Twitter). You need to map events that generate revenue to share this data.
Select Parameters to share all partner parameters configured in the Adjust SDK for any activity you share with X (formerly Twitter). You usually need to map parameters to share this data.

Map events

Map your events to forward in-app event data directly to X (formerly Twitter).

If you selected In-app revenue (from in-app purchases) to send detailed revenue data to X (formerly Twitter), ensure that you map at least one revenue event to X (formerly Twitter).

To forward in-app events or revenue events to X (formerly Twitter), follow these steps.

Select Map event.
In the Adjust event list, select the Adjust event that you want to share with X (formerly Twitter).
In the Partner event list, select an applicable X (formerly Twitter) event.
Select Apply.

X (formerly Twitter) events available for mapping

Map parameters

If the raw data parameters you collect in the SDK differ from the values supported by X (formerly Twitter), you can define mappings so that X (formerly Twitter) can receive that data.

You can view this section only if you have selected Parameters under Set your data sharing options.

To map your parameters, follow these steps.

Select Map parameter.
In the SDK parameter field, enter the name of your Adjust partner parameter as written in the Adjust SDK.
In the Partner parameter field, enter the corresponding X (formerly Twitter) parameter name.
Select Apply.

After you set this up, Adjust forwards custom event details directly to X (formerly Twitter) for any of your linked events.

Supported X (formerly Twitter) parameters

Parameter name	Content	Example
`registration_method`	A string describing the method of registration for the app associated with this event	facebook, amazon
`content_id`	Product or content ID associated with an event (string)	9826193
`price_currency`	Currency code (three-letter ISO 4217)	EUR, USD, JPY
`price_micro`	Price associated with the event in micro-currency units	123450000 (i.e., $123.45)
`level`	A level, e.g., in a game	5
`number_items`	Number of items associated with the event	2
`search_string`	Any search string used	Adjust + twitter integration
`user_payment_info`	Boolean to denote whether or not the user's payment information is stored in the app	true or false
`max_rated_value`	A double value to indicate the maximum rated value of this event	3.5
`description`	Any miscellaneous string description	Adjust is nifty

Setup review

In the Setup review screen, review your choices. Make any changes, if required.
Select Enable network to enable X (formerly Twitter) for your app, and enable data sharing, if set up.

Note:

You do not need to create a link for X (formerly Twitter). The links are created automatically after you set up and start a campaign with X (formerly Twitter). Adjust then starts attributing users to your campaigns.

Next steps

Go to X (formerly Twitter) and set up your campaign.
- Corresponding links are created automatically and appear on the network details page.
(Optional) Customize your attribution settings from the Twitter network details page.

Receive X (formerly Twitter) attribution data via raw export data

Adjust always reports X (formerly Twitter) attributions. By default, raw data export displays X (formerly Twitter) attributions as Organic. To receive X (formerly Twitter) attribution data via raw data export, follow these steps.

Join the X (formerly Twitter) Advanced Mobile Measurement (AMM) Program. Sign into your X (formerly Twitter) account and complete this form. You may need to contact your X (formerly Twitter) Account Manager to complete this process.
Notify Adjust that you have joined the AMM program. Contact your Adjust Technical Account Manager or support@adjust.com for them to complete the process.

Once Adjust has completed the process, you can see X (formerly Twitter) attributions for eligible users in your raw data export.

Users who have opted out of additional information sharing with business partners on their X (formerly Twitter) accounts, or who are otherwise ineligible for information sharing, appear as Organic in your raw data export.

In order for Adjust to confirm that you are active in the AMM Program, you must currently be running X (formerly Twitter) campaigns. You may need to confirm with your X (formerly Twitter) Account Manager.