Get attribution information

When a user interacts with an Adjust link, their attribution information updates. This can happen if the user interacts with a deep link. Information about a user’s attribution is represented in an Attribution object.

The Attribution object contains the following information:

export type AttributionMapT = $ReadOnly<{|
   adid: string,
   tracker_token: string,
   tracker_name: string,
   network?: string,
   campaign?: string,
   adgroup?: string,
   creative?: string,
   click_label?: string,
   state: string,
|}>;

Values	Data type	Description
`adid`	`string`	The device’s unique Adjust identifier.
`tracker_token`	`string`	The link token associated with the attribution.
`tracker_name`	`string`	The name of the campaign link.
`network`	`string`	The network associate with the campaign.
`campaign`	`string`	The name of the campaign associated with the attribution.
`adgroup`	`string`	The adgroup associated with the attribution.
`creative`	`string`	The creative associated with the attribution.
`click_label`	`string`	The click label associated with the attribution.
`state`	`string`	The current state of the attribution. Either `installed` or `reattributed`

Trigger a callback when attribution changes

attributionCallback: (string, Object) => mixed;

The SDK can listen for attribution changes and call a function when it detects an update. You can set an attribution callback method by specifying an attributionCallback function in the initSdk method. Within your function, you have access to the user’s attribution information.

1
Adjust.initSdk({
2
   appToken: "YOUR_APP_TOKEN",
3
   environment: "sandbox",
4
   attributionCallback: function (e, attribution) {
5
      console.log("Adid: " + attribution.adid);
6
      console.log("Tracker Token: " + attribution.tracker_token);
7
      console.log("Tracker Name: " + attribution.tracker_name);
8
      console.log("Network: " + attribution.network);
9
      console.log("Campaign: " + attribution.campaign);
10
      console.log("Adgroup: " + attribution.adgroup);
11
      console.log("Creative: " + attribution.creative);
12
      console.log("Click Label: " + attribution.click_label);
13
      console.log("Attribution State: " + attribution.state);
14
   },
15
});

Get current attribution information

Changed in 5.7.0

When a user installs your app, Adjust attributes the install to a campaign. The Adjust SDK gives you access to campaign attribution details for your install. The waitForAttribution method returns a promise that resolves when the SDK successfully receives attribution data from the server.

1
Adjust.waitForAttribution().then((attr) =>
2
   console.log(JSON.stringify(attr, undefined, 2)),
3
);

Set a referrer

function setReferrer(referrer: string): void;

You can set a referrer to trigger an SDK click with a custom click ID when the SDK starts. The SDK sends your custom click ID to Adjust’s servers for attribution purposes.

To set your referrer, call the setReferrer method and pass your referrer as a URL-encoded string argument.

Adjust.setReferrer("adjust_external_click_id%3DEXTERNAL_CLICK_ID");