Setting up an MMP

Data format for Text & Image Ads

Rich In-App Events are supported.

Data format for product ads and catalog page ads

The following Rich In-App Events are required:

• Product viewed: af_content_view.
• Product added to cart: af_add_to_cart.
• Product removed from cart: remove_from_cart.
• Purchased: af_purchase.

Make sure to add the af_content_id parameter used to pass the product ID to all the events.

For more information, see your MMP's documentation for implementing the event code.

Requirements for the Maximum conversions strategy with a CRR limit

You need to set up revenue collection in the af_revenue parameter for in-app events. Instructions for developers:

• Android
• iOS

Data format for Text & Image Ads

All Adjust events are supported.

Data format for product ads and catalog page ads

The format supports events with Partner Parameters (available in the Adjust SDK version 4.0 or higher) that expect offer_id, which can either be a Product ID or a list of products in JSON format.

AdjustEvent event = new AdjustEvent("VIEWED_CONTENT");
event.addPartnerParameter("offer_id", "10001");
Adjust.trackEvent(event);

AdjustEvent event = new AdjustEvent("PURCHASED");
event.addPartnerParameter("offer_id", "[\"1234\",\"5678\"]");
Adjust.trackEvent(event);

If a product ID is used in event parameters but its name differs from offer_id, you don't need to make any edits to your app — you can edit this value when setting up event transmission to Yandex Direct using Parameter Mapping.

Attribution using deeplink tracking

Adjust needs to support deeplink tracking so it can attribute conversions after clicking to an app. Instructions for developers:

• Android
• iOS

Requirements for the Maximum conversions strategy with a CRR limit

You need to set up revenue collection in your in-app events. Instructions for developers:

• Android
• iOS

General setup rules

1. Open the Integrated Partners section and select Yandex Direct.

2. Go to the Integration tab.

3. Enable Activate partner.

4. In the Yandex App ID field, specify the App ID that you obtained when adding your mobile app to Yandex Direct.

5. Enable In-app events postback to send events.

6. Select events and set up SDK Event Name > Partner Event Identifier mapping. Use the EVENT_1, EVENT_2, or EVENT_3 IDs if none of the presets suits you.

7. Select Sending option: All media sources, including organic and Send revenue: Values & revenue to transmit revenue and event parameters.

Requirements for product ads and catalog page ads

1. In the Yandex Ecom Feed Counter ID field, specify the Yandex Metrica tag in 12345 format.

We recommend that you use the tag for the site where you have set up e-commerce: in this case, machine learning algorithms will include products viewed in the app for site users, and the other way round. This helps you increase the effectiveness of retargeting.

2. Select the events:

• 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).

3. Select Sending option: All media sources, including organic and Send revenue: Values & revenue to transmit revenue and event parameters.

Requirements for the Maximum conversions strategy with a CRR limit

Select Send revenue: Values & revenue to transmit the revenue.

General setup rules

1. Go to the app settings and open Partner Setup.

2. Select Add Partner → Yandex Direct → (+).

3. In the Yandex App ID field, specify the App ID that you obtained when adding your mobile app to Yandex Direct.

4. Enable In-App Revenue Forwarding, Parameter Forwarding, and Session Forwarding.

5. Set up event transmission in Event Linking by selecting the appropriate name from the list. All settings are specified for iOS and Android separately.

Requirements for product ads and catalog page ads

1. In the Yandex Ecom Feed Counter field, specify the Yandex Metrica tag in 12345 format.

We recommend that you use the tag for the site where you have set up e-commerce: in this case, machine learning algorithms will include products viewed in the app for site users, and the other way round. This helps you increase the effectiveness of retargeting.

2. In the Event Linking section, configure event transmission:

• Product viewed: Viewed content (required).

• Product added to cart: Added to cart (required).

• Product removed from cart: Removed from cart (recommended).

• Purchased: Purchased (required).

3. If, in the event parameters, the Product ID isn't named offer_id, click Partner Parameter Mapping. In the FROM APP field, enter the parameter's name in the SDK, and in the TO PARTNER field, specify the offer_id.

No other changes to the link are required. Clicks will be sent from Yandex Direct to AppsFlyer using the server-to-server tracking method.

Cross-server click sending is enabled when you set up a campaign in Yandex Direct. Start creating a campaign, select a goal for your mobile app. After that, a section will appear below on the page where you can enable sending clicks to your MMP.

Add the following parameters to the universal link:

• adjust_ya_click_id={logid};

• adjust_campaign={campaign_name};

• adjust_t=abc_def: enter the MMP's tracker token ID (this is the unique identification token automatically created for each tracker in Adjust). Replace abc in the case of Android and def in the case of iOS. Leave an underscore in the middle. If your app is multi-platform, specify a single MMP ID: adjust_t=abc. You can use the the adjust_tracker parameter instead of adjust_t.

Sample link:

https://example.ru/cars/new/group/bmw/3er/21398591-21398651?adjust_ya_click_id={logid}&adjust_t=abc_def&adjust_campaign={campaign_name}

Make sure to test universal links before using them in your campaign. This way, you can ensure that these links are properly configured and tracked by Adjust and that the intended content is delivered to the user.

also Universal links FAQs.

How to set it up

1. Set up links:

• iOS
• Android App Links
• Samsung OS: URI schemes

2. Add a OneLink template.

It governs the redirection logic in scenarios for all OneLink links used in ad campaigns:

• The app is not installed: The user is redirected to the appropriate app store or a mobile web address.

  Settings

  Instructions: Complete Steps 1–8 and 10. Depending on the scenario, in Step 6, configure redirection to the app store or a mobile web page. Add a branded domain if needed. Learn more in the AppsFlyer article.

• The app is already installed: The user opens the app using Android App Links, iOS Universal Links, or URI schemes.

  Settings

  Instructions.

  • For iOS Universal Links, specify the Team ID.

  • For Android App Links, specify the SHA256 fingerprint and save the automatically generated code for the intent filter: you'll need it to complete the Android App Links setup.

3. Set up OneLink links: These are clickable links that are displayed in ads.

Required link parameters

• pid=yandexdirect_int
• clickid={logid}
• is_retargeting=true

You can add UTM tags and other custom parameters in the OneLink template settings.

Sample link:

https://app.appsflyer.com/ru.magnit.express.android?c={campaign_name}&af_siteid={source_type}{source}&af_adset_id={gbid}&af_ad_id={ad_id}&af_keywords={keyword}&keyword_id={phrase_id}&is_retargeting=true&af_click_lookback=7d&af_reengagement_window=30d&af_inactivity_window=0d&google_aid={google_aid}&android_id={android_id}&af_ad={ad_id}&af_sub1={region_neme}&af_sub2={match_type}&af_sub3={position_type}_{position}&af_sub4={keyword}&af_ip={client_ip}&af_ua={user_agent}&af_lang={device_lang}&af_web_dp=https%3A%2F%2Fdostavka.magnit.ru%2Fexpress%2Fpromotion&af_xp=social&deep_link_value=magnit.dostavka%3A%2F%2Fexpress%2Fpromotion&af_dp=magnit.dostavka%3A%2F%2Fexpress%2Fpromotion&deep_link_sub1=magnit.dostavka%3A%2F%2Fexpress%2Fpromotion&advertising_id={google_aid}&oaid={oaid}&pid=yandexdirect_int&clickid={logid}&af_c_id=

Optional parameters

• af_click_lookback: The attribution window (between the click and opening the app). It's specified in days (for example, 14d). The default value (if you don't pass this parameter) is 7 days.
• af_reengagement_window: The re-engagement window (between attribution and conversion). It's specified in days. The default value is 30 days.

Updating links in the feed

Send the resulting link template to the developer to generate product links in the feed again.

Add a tracking link to the element including the product link. The link must redirect the user to a specific product (either on the site or in the app). For XML/YML feeds, follow the additional requirements.

Check the AppsFlyer Help to learn how to enable it.

See also Tracking links based on Universal Links.

How to set it up

1. Set up links for deeplinking in apps.

2. Set up links for reattribution and deferred deeplinking.

To enable deferred deeplinking, you need to:

• Support reattribution via deeplinks on iOS and Android.
• Include device ID (IDFA for iOS and GPS_ADID for Android) in the tracking link.

3. Set up a multi-platform universal tracking link:

• Create a multi-platform link based on the raw universal tracking link and tracker token.

• Check if your app's path and query parameters are the same on iOS and Android. Make sure to use the right format:

  • iOS and Android share the same path and query parameters.
  • iOS and Android apps have different path and query parameters.

  We recommend using a deeplink generator when setting up a universal link.

  Screenshots of the generator UI with explanations

  

  PLATFORM: Enter your app platform's name as appears in the Adjust dashboard. Valid values include: Android, iOS, and Multiplatform.

  AD ENVIRONMENT: There are a number of different deep link formats that all work in different ad environments. For Yandex Direct, select Other.

  FORMAT: Depending upon your ad environment, there may be more than one deep link format that is supported. Here, you can specify what format you want to use. For Yandex Direct, select ulink (universal link).

  APP: Choose the app in the dropdown menu. This list includes all apps for the selected platform.

  TRACKER: Choose the tracker you want to use. All network-level trackers from the app are listed.

  RAW UNIVERSAL LINK: The raw universal link is automatically added when you select an app that's enabled in the dashboard and features universal linking.

  ANDROID APP SCHEME: The scheme is configured in your app and is specific to each mobile platform.

  IOS UNIVERSAL LINK PATH: Path to the in-app destination your users are taken to on iOS. Enter a template or a path to a specific product or section within the app. Learn more about templates and path syntax.

  ANDROID DEEPLINK PATH: Path to the in-app destination your users are taken to on Android. Enter a template or a path to a specific product or section within the app. Learn more about templates and path syntax.

  CAMPAIGN, ADGROUP, CREATIVE: Macros for Yandex Direct. These are suggested automatically. If you don't need a suggested parameter, remove the associated macro from the field.

  

  LABEL: Use this field to specify parameters that don't fit any other Adjust field.

  FALLBACK URL: URL of a specific landing page where you send off-platform users (i.e., clicks from an unsupported OS). Note: If your selected tracker supports iOS, Adjust may redirect MacOS traffic to the Apple App Store. To prevent this, enter a URL for MacOS in the REDIRECT MACOS field.

  REDIRECT URL/MACOS/iOS/Android: Add a redirect URL to override Adjust's default redirect to the app store and send users to a specific URL instead. You can redirect users by device platform (REDIRECT MACOS/iOS/Android) or send all users to one single location (REDIRECT URL).

  DEVICE ID MACROS: Macros for Yandex Direct. These are suggested automatically. If you don't need a suggested parameter, remove the associated macro from the field.

  Descriptions of the parameters in the Adjust documentation

  Link examples for different scenarios

  Different scenarios trigger the following links generated using the fields described above:

  • If you want to take users who don't have the app to the app store:

    • iOS, app installed: Universal link.

    • iOS, app not installed: Automatic redirection to the app store.

    • Android, app installed: Deeplink.

    • Android, app not installed: Automatic redirection to the app store.

    • Desktop: FALLBACK URL and REDIRECT MACOS.

    Sample link:

    https://nquw.adj.st/product/100586311342?adj_t=aflb3js&adj_fallback=https%3A%2F%2Fmarket.yandex.ru%2Fproduct--cold-steel-luzon-medium-20nql%2F388454980%3Fcpa%3D1%26sku%3D100586311342&adj_redirect_macos=https%3A%2F%2Fmarket.yandex.ru%2Fproduct--cold-steel-luzon-medium-20nql%2F388454980%3Fcpa%3D1%26sku%3D100586311342&adj_gps_adid=%7Bgoogle_aid%7D&yclid=%7Blogid%7D

  • If you want to take users who don't have the app to a webpage:

    • iOS, app installed: Universal link.

    • iOS, app not installed: REDIRECT URL IOS.

    • Android, app installed: Deeplink.

    • Android, app not installed: REDIRECT URL ANDROID.

    • Desktop: REDIRECT URL.

    Sample link:

    https://nquw.adj.st/product/100586311342?adj_t=aflb3js&adj_redirect_ios=https%3A%2F%2Fmarket.yandex.ru%2Fproduct--cold-steel-luzon-medium-20nql%2F388454980%3Fcpa%3D1%26sku%3D100586311342&adj_redirect_android=https%3A%2F%2Fmarket.yandex.ru%2Fproduct--cold-steel-luzon-medium-20nql%2F388454980%3Fcpa%3D1%26sku%3D100586311342&adj_gps_adid=%7Bgoogle_aid%7D&yclid=%7Blogid%7D&adj_redirect=https%3A%2F%2Fmarket.yandex.ru%2Fproduct--cold-steel-luzon-medium-20nql%2F388454980%3Fcpa%3D1%26sku%3D100586311342&adj_gps_adid=%7Bgoogle_aid%7D&yclid=%7Blogid%7D

Mandatory parameters

For accurate attribution of in-app events to Yandex Direct clicks, make sure to include the required tracking parameters in the link:

• In the tracking link: adj_ya_click_id={logid} or adjust_ya_click_id={logid}.

• In the fallback URL inside the tracking link: yclid={logid}

UTM tags are specified in the fallback URL.

Sample link:

https://sb00.adj.st/cars/new/group/bmw/3er/21398591-21398651?adjust_ya_click_id={logid}&adjust_t=abc_def&adjust_campaign={campaign_name}&adjust_deeplink=autoru%3A%2F%2Fcars%2Fnew%2Fgroup%2Fbmw%2F3er%2F21398591-21398651&adjust_redirect=https%3A%2F%2Fauto.ru%2Fcars%2Fnew%2Fgroup%2Fbmw%2F3er%2F21398591-21398651%3Fyclid%3D

See also Tracking links based on Universal Links.