Tracking systems
You can use a mobile app attribution platform to get data about new installations from the app store. This system compares new installations with click-throughs from ads and sends this data to Yandex Direct.
By connecting a mobile app attribution 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.
To connect a mobile app attribution platform to an ad, you must add a tracking link to it (in the Tracking link field on the page where you edit ad groups). 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. Learn more about using parameters and tags.
Verification
Verify your app to set up retargeting for users who have achieved the goals specified in the tracker.
- 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).
Tracking links
The tabs below describe how to set up tracking links using the platforms supported by Yandex Direct.
To get a tracking link, follow these steps:
Go to the Trackers tab and click +Create tracker.
Choose Yandex Direct in the Partners drop-down list.
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.
The integration setup is described in detail in the AppsFlyer documentation.
Recommended settings for the best performance of your ads in Yandex Direct:
- Select the partner Yandex Direct
- Click Integrated Partners.
- Select Yandex Direct as partner.
- Set up the desired parameters
- Click the Integration tab.
Enable Activate partner.
Copy the Yandex App ID from the mobile app library. Where do I find the App ID?
Paste the copied App ID to the Yandex App ID field.
Enable In-app events postback to send events.
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: .
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.
Important.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 app install data.
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
In the Adjust interface, go to the app settings.
- Click the Partner Setup tab.
- Click ADD PARTNER.
- Find Yandex Direct in the list and click (+).
- Set up the desired parameters
Enable the module Yandex Direct to transmit the installation data.
Copy the Yandex App ID from the mobile app library. Where do I find the App ID?
Paste the copied App ID to the Yandex App ID field.
Enable In-App Revenue Forwarding to send the revenue data and see it in the Report Wizard.
Enable Session Forwarding to transmit the session data.
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.
For each event, enter its name to be shown in Yandex Direct.
- Create a tracking link in the section 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.
Attention.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.
The integration setup is described in detail in the Branch documentation.
- Select the partner Yandex Direct
-
In the Branch interface, go to the Ads page.
Choose
.- Save your changes.
- Set up the desired parameters
-
Open the POSTBACK CONFIG tab.
Enable sending INSTALL events.
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, whereEVENT_NAME
has one of the 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.
To verify your app for all events in the POSTBACK URL field, add the
&ya-app-id=APP-ID
parameter whereAPP-ID
is the application ID in Yandex Direct.For all campaign events that use e-commerce, add the
&ecom_feed_counter_id=ECOM-ID
parameter under POSTBACK URL.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 fieldWhich 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.
The integration setup is described in detail in the myTracker documentation.
- Log in to Yandex Direct.
- Open the integration page in myTracker.
- Select the MyTracker account that the apps you need belong to.
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.
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.
If you have any questions about using tracking links, please contact MyTracker support.
The integration setup is described in detail in the Singular documentation.
- Select Yandex Direct as a partner
-
- In the Singular interface, go to.
- Select Yandex Direct as partner.
- Set up the desired parameters
-
- In the Configuration window, select the App for which you want to set up transmitting the installation data, then select the App Site.
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.
- 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.
- 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 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 - Enable Send Revenue to send revenue data based on events and see it in the Report Wizard.
Attention.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 app install data.
The integration setup is described in detail in the Tenjin documentation.
- Enable integration with Yandex
-
In the Tenjin interface, go to
.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:
- Select your account in Yandex Direct.
- Click Allow.
Click Add Account.
- Configure a campaign in Tenjin
-
- Make sure the Tenjin SDK is integrated into your app.
Go to Create Campaign.
and clickSelect your Yandex Direct account and app and enter a name for the campaign.
- Set up app event delivery from the tracker
-
Go to
and select your app.Click + New Callback.
- Select Yandex Install.
Fill in the Yandex App ID field and click Save Callback.
- Copy tracking links
-
Go to Click Tracking URL and Impression Tracking URL fields.
and select the campaign you created. In its properties, you'll see the links in theThey 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
-
- In the AirBridge interface, go to.
Look up “Yandex” in the search bar. Select “Yandex Direct”.
- Set up app event delivery from the tracker
-
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.
On the very same Postback tab, open the Postback URL subsection. Find the “Install (App)” event, expand it, and click Edit.
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.
- To save the changes, click Save at the bottom of the page.
- Create and copy tracking links
-
Go to “Yandex Direct” in the list of available channels and click Create tracking links.
. FindCopy the links.
You'll need the resulting tracking link for:
- Creating a mobile app campaign in the Campaign Wizard.
- Adding an app in the library if you place your ads in the expert mode.