Setting up a link in a mobile measurement platform (MMP)

You can use a mobile measurement platform to get data about new installs from the app store. This system matches new installs and in-app action to ad clicks and sends this data to Yandex Direct to calculate the conversion rate.

By connecting a mobile measurement platform you can:

  • Optimize an ad campaign for installs and in-app events.

  • Collect accurate statistics on installations and in-app events and use these statistics both in Yandex Direct and the mobile app attribution platform.

Yandex Direct supports the following platforms: AppMetrica, AppsFlyer, Adjust, Branch, Kochava, MyTracker, Singular, Tenjin, and AirBridge. For campaigns running on iOS 14.5, SKAdNetwork is supported in AppMetrica, AppsFlyer, and Adjust.

Verifying an app in the mobile measurement platform

Verify your app in order to:

  • Set up retargeting for users who achieved the goals specified in the MMP.

  • Get SKAdNetwork statistics for campaigns running on iOS 14.5 or higher.

AppMetrica

If you use different usernames for AppMetrica and Yandex Direct, you must grant access to the Yandex Direct username in the AppMetrica account to verify the app. If the usernames match, you'll be verified automatically.

Adjust or AppsFlyer

Specify the App ID when setting up integration, and the app will be verified after receiving the first postback from the MMP (you'll see the icon in the app settings).

For AppsFlyer, to ensure that the verification is successful and Yandex Direct obtains enriched conversion data, in AppFlyer's Yandex Direct integration settings, disable the Aggregated Advanced Privacy framework.

Add your app to the Yandex Direct library

To connect Yandex Direct to your mobile measurement platform, add the app to the library.

  1. In the side menu, click Library and select Mobile apps. Click Add app.

  2. Enter the link to the app in the AppStore or Google Play. Yandex Direct will upload the icon, price, rating, number of ratings and app specifications from the store. Use the App ID you received after adding the app to set up tracking links.

Please note that the system retrieves information for the country indicated in your link to the app store. By default, data is uploaded for Russia. Use advanced parameters so that your ad leads to the app store of a particular country.

The country is specified in the part of the link that follows apps.apple.com.

https://apps.apple.com/ru/app/yandex-browser-for-iphone/id483693909

The country is specified in the glparameter.

https://play.google.com/store/apps/details?id=com.yandex.browser&gl=ru

After setting up the tracking link, go back to the app library and specify it for the desired app. When creating campaigns for an app, you can only use tracking links specified in the app library. You can't use different mobile measurement platforms, such as AppMetrica and AppsFlyer, for the same app. If you need to use two mobile measurement platforms, add the app to the library twice. First, specify the tracking link from one MMP, then enter the tracking link from the other MMP.

To link your mobile measurement platform with ad campaigns in Yandex Direct, add a tracking link to your ads. Furthermore, the SDK for the platform should be written into the mobile app code. SDKs are software modules that send system information about installations and app launches.

You can pass various parameters and tags (including UTM tags) in the links.

https://appmetrica.yandex.com/serve/7438548069196542965/?click_id={logid}&source={source}

These allow you to monitor various statistics, such as traffic sources. More information about using parameters and tag labels.

Warning

The link is created by the advertiser in the MMP.

The tabs below describe how to set up tracking links using the platforms supported by Yandex Direct.

Alert

If you use another platform, you can contact its owner or developer and request that they integrate it into Yandex Direct. Only platform owners can apply (using the feedback form) to integrate their mobile app attribution platforms into Yandex Direct. For more information on how Yandex Direct interacts with mobile app attribution platforms, see the documentation.

To get a tracking link, follow these steps:

  1. Go to the Trackers tab and click +Create tracker.

  2. Choose the app in the Apps drop-down list. The SDK should already be written into the app code. Learn more about how to add SDKs for Android and iOS.

  3. Choose Yandex Direct in the Partners drop-down list.

  4. Insert the tracking link you received into the ad.

Prescribed url format:

https://appmetrica.yandex.com/serve/7438548069196542965/?click_id={logid}

The link must include the click_id={LOGID} parameter.

See the Create tracker section in the AppMetrica documentation for more information.

Note

For the Maximum conversions strategy to run correctly, make sure the transfer of data on app installs in enabled in the tracker.

The integration setup is described in detail in the AppsFlyer documentation.

Recommended settings for the best performance of your ads in Yandex Direct:

  • Select Yandex Direct as a partner
  1. In the AppsFlyer interface, select CollaboratePartner Marketplace from the menu.

  2. Enter “Yandex Direct” in the search box.

  • Set up the desired parameters
  1. Click Set up integration.

  2. Enable the Activate partner option.

Tip

For iOS apps, leave the Advanced Privacy setting disabled. This doesn't affect data collection and helps to train your strategy more effectively.

  1. Copy the Yandex App ID from the mobile app library. Where do I find the App ID?

  2. Paste the copied App ID to the Yandex App ID field.

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

  4. Select the events that you want to send to Yandex Direct. You can view them in the Report Wizard and use them to optimize bids.

For each event sent, enter the name to show in Yandex Direct.

Select the method for transmitting events: All media sources, including organic.

Select Values & revenue to send the revenue data. You will see it in the Report Wizard.

Click Add Event and add af_app_opened to enable sending of sessions.

  • Create a tracking link in the section on the Attribution Link tab.

    You can use dynamic Yandex Direct parameters in the tracking links. If you want to use impression attribution in your campaigns, make sure that it's enabled in the mobile measurement platform settings: Configuration → Integrated partners → Impression attribution.

    For more information about creating a tracking link, see the AppsFlyer documentation. If you have any questions about using tracking links, please contact the AppsFlyer support service.

    Warning

    Make sure that you set the required parameters:

    • pid=yandexdirect_int

    • clickid={logid}

    • advertising_id={google_aid} (in Android campaigns)

    • idfa={ios_ifa} (in iOS campaigns)

    • is_retargeting=true (for retargeting campaigns)

    For the Optimize conversions strategy to run correctly, make sure that you enabled transmission of data about app installs.

The integration setup is described in detail in the Adjust documentation.

Recommended settings for the best performance of your ads in Yandex Direct:

  • Add Yandex Direct as a partner

    1. In the Adjust interface, go to the app settings.

    2. Click the Partner Setup tab.

    3. Click ADD PARTNER.

    4. Find Yandex Direct in the list and click (+).

  • Set up the desired parameters

    1. Enable the module Yandex Direct to transmit the installation data.

    2. Copy the Yandex App ID from the mobile app library. Where do I find the App ID?

    3. Paste the copied App ID to the Yandex App ID field.

    4. Enable In-App Revenue Forwarding to send the revenue data and see it in the Report Wizard.

    5. Enable Session Forwarding to transmit the session data.

    6. Set up sending of events to the Event Linking section. Select the events that you want to send to Yandex Direct. You can view them in the Report Wizard and use them to optimize bids.

    7. For each event, enter its name to be shown in Yandex Direct.

  • Create a tracking link under Tracker URLs

    Find the instructions on how to do this in the Adjust documentation. If you plan to use impression attribution in your campaigns, make sure that the Probabilistic matching option is enabled in the mobile measurement platform settings.

    You can use dynamic Yandex Direct parameters in the tracking links.

    Alert

    Make sure that the following parameters are used in the tracking links:

    • ya_click_id={logid}

    • gps_adid={google_aid} (in Android campaigns)

    • idfa={ios_ifa} (in iOS campaigns)

    If you omit those parameters, you might have issues with attribution or inaccurate calculation of conversions in the Yandex Direct interface.

    Make sure that Fingerprinting is enabled in the MMP settings for Yandex Direct.

Note

For the Maximum conversions strategy to run correctly, make sure the transfer of data on app installs in enabled in the tracker.

The integration setup is described in detail in the Branch documentation.

  • Select Yandex Direct as a partner

    1. In the Branch interface, go to the Ads page.

    2. Choose Partner Management → Yandex Direct.

    3. Save your changes.

  • Set up the desired parameters

    1. Open the POSTBACK CONFIG tab.

    2. Enable sending INSTALL events.

    3. Enable sending InApp events. For each event, specify the corresponding event name in Yandex Direct. For this, replace the &event=${(name)!} parameter with &event=EVENT_NAME in the POSTBACK URL field, where EVENT_NAME has one of the following values:

      • ACHIEVED_LEVEL: Completed goal.
      • ADDED_TO_CART: Added to cart.
      • ADDED_PAYMENT_INFO: Added payment information.
      • ADDED_TO_WISHLIST: Added to wish list.
      • APP_LAUNCHED: Launched app.
      • COMPLETED_REGISTRATION: Completed registration.
      • COMPLETED_TUTORIAL: Completed tutorial.
      • EVENT_1: Custom event 1.
      • EVENT_2: Custom event 2.
      • EVENT_3: Custom event 3.
      • INITIATED_CHECKOUT: Initiated order.
      • INSTALL_APP: App installation.
      • PURCHASED: Made a purchase.
      • RATED: Submitted rating.
      • SEARCHED: Performed search.
      • SHARED: User shared.
      • SPENT_CREDITS: Spent credits.
      • SPENT_TIME_IN_APP: Time spent in the app.
      • UNLOCKED_ACHIEVEMENT: Achievement unlocked.
      • VIEWED_CONTENT: Content viewed.
    4. To verify your app for all events in the POSTBACK URL field, add the &ya-app-id=APP-ID parameter, where APP-ID is the application ID in Yandex Direct.

    5. For all campaign events that use e-commerce, add the &ecom_feed_counter_id=ECOM-ID parameter under POSTBACK URL.

    6. Enable sending all events. To do this, enable the ALL EVENTS option.

      This will allow you to:

      • Avoid targeting users that already installed your app.
      • Launch retargeting campaigns.
      • Improve the overall effectiveness of campaigns.
  • Create a tracking link

    Follow the instructions to create a tracking link.

    Specify the link type: Ad Link.

    In the field Which Ad Partner is this for? in the Define step, select Yandex Direct.

    Set up the mandatory link parameters:

    • &click_id={logid}
    • &%243p=a_yandex_direct
  • Examples of macros for tracking links

    Campaign Info:

    • {click_id}: Click ID.
    • {goal_id}: Goal ID.
    • {secondary_publisher}: Publisher Name.
    • {secondary_publisher_ID}: Publisher ID.
    • {campaign_name}: Campaign Name.
    • {campaign_id}: Campaign ID.
    • {channel}: Ad Channel.
    • {ad_set_name}: Ad Set Name.
    • {ad_set_id}: Ad Set ID.
    • {ad_name}: Ad Set Name.
    • {ad_id}: Ad Set ID.
    • {creative_name}: Creative Name.
    • {creative_id}: Creative ID.

    Device info:

    • {idfa}: Apple Advertiser ID.
    • {idfa_md5}: Apple Advertiser ID MD5.
    • {idfa_sha1}: Apple Advertiser ID SHA1.
    • {aaid}: Google Advertiser ID.
    • {aaid_md5}: Google Advertiser ID MD5.
    • {aaid_sha1}: Google Advertiser ID SHA1.
    • {roku_rida} — Roku RIDA;
    • {samsung_ifa}: Samsung IFA.

The Kochava documentation describes how to create a tracking link. Tracking links must include the click_id={logid} parameter. If you have any questions about using tracking links, please contact the Kochava support service.

Note

For the Maximum conversions strategy to run correctly, make sure the transfer of data on app installs in enabled in the tracker.

The integration setup is described in detail in the myTracker documentation.

Connecting an account:

  1. Log in to Yandex Direct.

  2. Open the integration page in myTracker.

  3. Select the MyTracker account that the apps you need belong to.

  4. Click Link Yandex Direct account.

    If myTracker does not have access to your Yandex account yet, you'll be redirected to the Yandex OAuth server where you should click Allow.

    After a while, your Yandex Direct account will appear on the integration page with the synchronization status. Statistics for it will be received within a day.

  5. To create a tracking link, find the automatically created campaign in the list of campaigns by name:

    [Yandex Direct campaign ID::link number] Campaign name in Yandex Direct.

  6. On the Tracking links page, add a regular or smart tracking link.

If you have any questions about using tracking links, please contact MyTracker support.

Note

For the Maximum conversions strategy to run correctly, make sure the transfer of data on app installs in enabled in the tracker.

The integration setup is described in detail in the Singular documentation.

  • Select Yandex Direct as a partner

    1. In the Singular interface, go to AttributionPartner Configuration.

    2. Select Yandex Direct as partner.

  • Set up the desired parameters

    1. In the Configuration window, select the App for which you want to set up transmitting the installation data, then select the App Site.

    2. Under App-Specific Configuration, set up the postbacks to be sent to Yandex Direct. Enable the following options:

      • Enable Re-engagement Postbacks: To launch retargeted campaigns.

      • Include View-Through Attributions: To get conversions as a result of viewing your ad. If this option is disabled, you'll get conversions only as a result of clicks.

      • Send Postbacks to Network on All Installs lets you:

        • Avoid targeting users that already installed your app.
        • Launch retargeting campaigns.
        • Improve the overall effectiveness of campaigns.
    3. Set up event transmission under Event postbacks. Select the events that you want to send to Yandex Direct. You will see them in Report Wizard and use them to optimize campaigns.

    4. For each transmitted event (In-app (SDK) event name), enter the Event Name in Yandex Direct. You can assign one of seventeen standard events or one of three custom events.

      Event names in Yandex Direct

      Goal

      Event

      App installation (AppInstall)

      INSTALL_APP

      Completed goal

      ACHIEVED_LEVEL

      Launched app

      APP_LAUNCHED

      Added payment info

      ADDED_PAYMENT_INFO

      Added to cart

      ADDED_TO_CART

      Added to wish list

      ADDED_TO_WISHLIST

      Completed registration

      COMPLETED_REGISTRATION

      Completed tutorial

      COMPLETED_TUTORIAL

      Initiated order

      INITIATED_CHECKOUT

      Made a purchase

      PURCHASED

      Submitted rating

      RATED

      Performed search

      SEARCHED

      Spent credits

      SPENT_CREDITS

      Achievement unlocked

      ACHIEVEMENT_UNLOCKED

      Content viewed

      VIEWED_CONTENT

      Time spent in app

      SPENT_TIME_IN_APP

      User shared

      SHARED

      Custom event 1

      EVENT_1

      Custom event 2

      EVENT_2

      Custom event 3

      EVENT_3

    5. Enable Send Revenue to send revenue data based on events and see it in the Report Wizard.

      Alert

      Make sure that the following parameters are used in the tracking links:

      • cl={logid}

      • aifa={google_aid} (in Android campaigns)

      • idfa={ios_ifa} (in iOS campaigns)

      If you omit those parameters, you might have issues with attribution or inaccurate calculation of conversions in the Yandex Direct interface.

      For the Optimize conversions strategy to run correctly, make sure that you enabled transmission of data about app installs.

The integration setup is described in detail in the Tenjin documentation.

  • Enable integration with Yandex

    1. In the Tenjin interface, go to CONFIGURE → Channels.

    2. Add a channel named Yandex (if you haven't done that before). Click Add a Channel and select Yandex.

      If Tenjin does not have access to your Yandex account yet, you'll be redirected to the Yandex OAuth server:

      1. Select your account in Yandex Direct.

      2. Click Allow.

    3. Click Add Account.

  • Configure a campaign in Tenjin

    1. Make sure the Tenjin SDK is integrated into your app.

    2. Go to CONFIGURECampaigns and click Create Campaign.

    3. Select your Yandex Direct account and app and enter a name for the campaign.

  • Set up app event delivery from the mobile measurement Platform

    1. Go to CONFIGURE → Apps and select your app.

    2. Click + New Callback.

    3. Select Yandex Install.

    4. Copy the Yandex App ID from the Yandex Direct mobile app library. Where do I find the Yandex App ID?

    5. Fill in the Yandex App ID field and click Save Callback.

  • Copy tracking links

    Go to CONFIGURECampaigns and select the campaign you created. In its properties, you'll see the links in the Click Tracking URL and Impression Tracking URL fields.

    They will only be available after the SDK Tenjin and your app's integration is completed.

The integration setup is described in detail in the AirBridge documentation

  • Enable integration with Yandex

    1. In the AirBridge interface, go to Integrations Ad Channel Integration.

    2. Look up “Yandex” in the search bar. Select “Yandex Direct”.

  • Set up app event delivery from the mobile measurement platform

    1. On the Postback tab, open the Event Schema subsection. Make sure that the “Install (App)” event is present. Click Activate to enable event sending.

      Make sure that all the desired events have the “Sending” status.

    2. On the very same Postback tab, open the Postback URL subsection. Find the “Install (App)” event, expand it, and click Edit.

    3. In the window that opens, scroll to the end of the parameter list and click**+ Add**. Add a parameter named ya-app-id and specify your Yandex App ID as its value. Where do I find the Yandex App ID?

    4. To save the changes, click Save at the bottom of the page.

  • Create and copy tracking links

    1. Go to Tracking LinkCreate Tracking Links. Find “Yandex Direct” in the list of available channels and click Create tracking links.

    2. Copy the links.

You'll need the resulting tracking link when launching ads:

A deeplink is a required MMP parameter that is added to a retargeting campaign. It ensures that users land directly in the intended app section when they click your ad.

Add it when creating retargeting campaigns:

To set up a deeplink, contact your app developer.

A deferred deeplink is an additional parameter for ad campaigns with the Attract new users goal. It ensures that users land directly in the intended app section after installation.

Add:

  • In the Campaign Wizard: in the Tracking link field. For campaigns targeting a new audience.

  • In a unified performance campaign: in the Deferred deeplink field when creating an ad. Available only for campaigns with the Attract new users goal.

To set up a deeplink, contact your app developer.

Custom app pages

Available for Google Play and the App Store. When clicking the ad, new users usually land on the app's main store page. However, you can direct them to a custom page. To do this, enter its full URL. This way, you can handle different user action scenarios and highlight your app's advantages for different audience segments.

Add:

  • In the Campaign Wizard: a link to your custom page in the redirect parameter.

  • In a unified performance campaign: in the Custom app page field when creating an ad. Available only for campaigns with the Attract new users goal.

To prepare a custom app page, follow the instructions for your app store:

Questions?

Alert

Our customer service department can only help you with the campaigns created under the same username you use to contact us. You can check your username by opening ya.ru in another browser tab. Our team can access your data only when processing your request.

Message us on WhatsApp
Message us on Telegram
Call

You can contact us from 10:00 to 19:00 (UTC+3) by phone:

Moscow: +7 495 139-91-93

Russia: 8 (800) 700-47-45 (toll-free within Russia)

To access campaigns, the customer service specialist will need your PIN.

Leave a message


 

The mobile app conversion rate is the ratio of clicks that resulted in targeted user actions with the app to total clicks.