English

4. Receive consent status in raw data exports

The Adjust SDK sends the ATT status about a user's consent status in your raw data exports. If a user allows tracking, the Adjust SDK includes the IDFA in your raw data exports.

Placeholder: {att_status}

Use the {att_status} placeholder to receive information about how an iOS 14+ user chooses to share their data. Add the placeholder to your callback URL or CSV definition to receive ATT status in your raw data.

The user status is populated with the following values:

ValueStatusDescription
null-The user is on a pre-iOS 14 device, or the developer has not implemented the ATT framework in the app.
0Not DeterminedThe Allow Apps to Request to Track setting is ON, but the ATT prompt has not been shown to the user.
1RestrictedThe Allow Apps to Request to Track setting is OFF and cannot be toggled on by the user. The ATT prompt cannot be shown to the user.
2DeniedThe Allow Apps to Request to Track setting is ON, the ATT prompt has been shown to the user, and the user denies authorization to access app-related data that can be used for tracking the user or the device.
OR
The Allow Apps to Request to Track setting is OFF and the ATT prompt cannot be shown to the user.
3AuthorizedThe Allow Apps to Request to Track setting is ON, the ATT prompt has been shown to the user, and the user authorizes access to app-related data that can be used for tracking the user or the device.

Example: att_status=2

For more information about each of the status values for app tracking authorization, see Apple's developer documentation.

Callback activity type: att_update

Adjust uses the activity type att_update to send information about a user's consent status in your global callbacks.

If you are using global callbacks and a user’s authorization status changes, Adjust sends user-level data directly to your servers just seconds after tracking the event. To quickly find these events, filter {activity_kind} for att_update.

Update raw data setup

To receive ATT consent status, you need to update your raw data setup. To do so, follow these steps:

  1. Open your raw data exports setup in the Adjust dashboard.
  2. For your raw data export method, do the following:
Raw data export methodWhat you need to do
Single-event callbackAttach the {att_status} placeholder to your callback URL for any activity type that supports this placeholder.
Example: ATT update (iOS)
Global callbackThe ATT update (iOS) activity type is included by default in the global callback. In your global callbacks, filter the {activity_kind} for att_update to find information about a user's consent status.
CSV definitionAdd the {att_status} placeholder for any activity type that supports this placeholder.
Example: ATT update (iOS)
  1. If a device's ATT status changes to Authorized, Adjust can access the IDFA. For organic installs, Adjust reruns the attribution. If there is a change in attribution source, Adjust provides an updated attribution in your callbacks or CSV uploads.
Note:
If you have not started using the {att_status} placeholder, Adjust has made changes to the following existing placeholders to provide user consent status: