Integration plan
Step 1: Set up universal links (to lead users to your app or website)
Step 2: Configure event transmission from your mobile measurement platform (MMP)* to Yango Ads Space
Step 3: Contact your manager and provided created link
Done! Event data will be automatically sent to Yango Ads Space
*We support Adjust, AppsFlyer, Branch and AppMetrica MMPs.
Step 1: Set up universal links
The app link must be suitable for counting conversions, which means that it must:
- Lead to the app if the app is installed.
- Lead to the site if the app is not installed or the link is clicked on a computer.
- Let the MMP attribute conversions to clicks.
How to set up universal links:
iOS Universal Links
Android App Links
If you can't or won't set up universal links for some reason, then you can use tracking links. They include the MMP's domain (for example, adj.st, onelink.me, redirect.appmetrica.com), and they are created in the MMP.
Step 2: Configure event transmission from your MMP to Yango Ads Space
How to configure AppsFlyer
- Login to the AppsFlyer Dashboard.
- Find the app (by name or ID) that you want to connect to Yango.
- Click on the app.
- Open App settings.
- Find the Yandex Direct integration.
- Go to the Integration tab and enter your Metrica Counter ID in the “Yandex Ecom Feed Counter” field. Leave the “Yandex App ID” field empty.
- Activate Event postbacks.
- Link events as follows:
- af_content_view > VIEWED_CONTENT (required)
- af_added_to_cart > ADDED_TO_CART (required)
- remove_from_cart > REMOVED_FROM_CART (recommended)
- af_purchase > PURCHASED (required)
- af_app_opened > APP_LAUNCHED (required)
Important! Select Sending option: All media sources, including organic and Send revenue: Values & revenue to transmit revenue and event parameters.
How to configure Adjust
- On the main page of the Adjust dashboard, click on “Campaign Lab” and select “Partners”.
- Click on the “+ New partner” button
- If you have already added Yandex as a partner, find Yandex Direct in the Partners list.
- Click on the Partner’s name, go to the “Data sharing” tab, and click on the “Edit” button.
- Enable data sharing for Yandex Direct. Enter your Metrica Counter ID in the “Yandex Ecom Feed Counter” field. Leave the ”Yandex App ID” field empty.
- Choose “Data from all attribution sources” and enable all the parameters in the list below:
- Sessions
- Uninstalls and reinstalls
- In-app revenue (from in-app purchases)
- Parameters
- Map the events we need:
- Product detail: Viewed content (required)
- App open: App launched (required)
- Add to basket: Added to cart (required)
- Removed from basket: Removed from cart (recommended)
- Purchase: Purchased (required)
- Check-out: Initiated Checkout (recommended)
- Map the parameters if needed (Product ID should be linked to “offer_id”).
- Next will be Attribution/Reattribution settings. In the “New users: attribution” block for clicks, turn on probabilistic modeling and set 24 hours as the attribution window.
- In the “Existing users: reattribution” block for clicks, enable reattribution and set the inactivity period to 0 days and the reattribution window to 30 days.
- In the Link URLs section, copy the “Click URL” and send it to your Account Manager.
- For iOS apps, you’ll need to enable probabilistic modeling for all users on iOS +14.5 on the app settings level in the attribution settings tab.
- Deep link reattribution for Android
- To reattribute the user, you need to make an extra call to the Adjust SDK within the app. Add a call to the appWillOpenUrl(Uri, Context) method when the app receives deep link content. The Adjust SDK will then look for new attribution data within the deep link. If the SDK finds new information, it will forward it to the Adjust backend for reattribution (more in the Adjust guide).
@Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); Intent intent = getIntent(); Uri data = intent.getData(); Adjust.appWillOpenUrl(data, getApplicationContext()); }
@Override protected void onNewIntent(Intent intent) { super.onNewIntent(intent); Uri data = intent.getData(); Adjust.appWillOpenUrl(data, getApplicationContext()); }
Important: Please use both of the above methods. onCreate method will be used in scenarios when the application is launched by deep link being loaded from memory. onNewIntent method will be used when the application is deployed by deep link, being collapsed into the background.
14. Deep link reattribution for iOS
- To reattribute the user from iOS, you need to set up direct deep linking. To enable deep linking, you’ll need to enable Associated Domains for your app and configure your deep links in Xcode (more in the Adjust guide).
- Enable Associated Domains: To get started, you need to enable Associated Domains in your Apple Developer account. This allows you to set universal link domains in your app.
- Log in to your Apple Developer account.
- Select Certificates, IDs & Profiles in the left menu.
- Select Identifiers in the left menu.
- Find your app and select it to open the edit page.
- Ensure that Associated Domains is checked under Capabilities.
- Select Save to save your changes.
- Configure deep links in Xcode
- Open your app project in Xcode.
- Select your project from the left menu.
- Select your app under Targets.
- Select Signing & Capabilities from the upper menu.
- Ensure that All is selected in the submenu below.
- Select the + sign to add a capability.
- Select Associated Domains.
- Enter the Adjust Universal Link domain with the prefix applinks:Example: the example.adj.st domain: applinks:example.adj.st.
How to check deep links
- Set up the upload of raw data for the application you will be testing on the Adjust side in the dashboard.
We recommend using “Callbacks”. They are sent in real-time (30 seconds – 2 minutes after the event), which is more convenient for testing:
raw data exports and
conditional callbacks
Example of a callback structure with dynamic parameters:
equal,{gps_adid},aebefdce-561e-4b65-a4d3-2aeb2b758840, https://your_domain.com/your_endpoint? activity_kind={activity_kind}& gps_adid={gps_adid}& idfa={idfa}& idfv={idfv}& adid={adid}& tracker_token={link_token}& tracker_name={link_name}& app_name={app_name}& activity_kind={activity_kind}& created_at={created_at}& click_time={click_time}& click_time_hour={click_time_hour}& is_deeplink_click={is_deeplink_click}& deeplink={deeplink}
- Callback must have parameters {is_deeplink_click} and {deeplink}.{is_deeplink_click} must be ”True”, and {deeplink} must contain the intent passed to the SDK.
- Condition for gps_adid is added to the callback to receive them only for the test device (you need to replace it with your gps_adid)
2. Prepare a link containing the tracker. This can be done through the Adjust interface. Example of a link (universal):
https://hdgf.adj.st/app_path? adj_t=asdjhhs& adj_campaign=test_campaign& adj_adgroup=test_adgroup
3. Click on the link on the test device.
4. In the received click callback, validate the is_deeplink_click and deep link parameters.
If the deep link is correctly transmitted to our SDK via the appWillOpenUrl, the deep link value must match the full tracker value.
https://hdgf.adj.st/app_path? adj_t=asdjhhs& adj_campaign=test_campaign& adj_adgroup=test_adgroup
Also recommended:
- Кun test builds in sandbox mode with Verbose logging level, as described here: