Mobile app attribution platforms
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 to calculate the conversion rate.
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, Kochava, MyTracker, and Singular. 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.
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 the app in the Apps drop-down list. The SDK should already be written into the app code. More information on how to add an SDK.
Choose Yandex.Direct in the Partners drop-down list.
Insert the tracking link you received into the ad.
Correct 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.
Settings recommended for the best performance of your ads in Yandex.Direct:
- Select the partner Yandex.Direct
- Click Integrated Partners.
- Select the partner Yandex.Direct.
- Set up the desired parameters
- Click the Integration tab.
Enable Activate partner.
Leave the field Yandex App ID empty.
Under Default postbacks, select the method for transmitting the installation data: All media sources, including organic.
Enable In-app events postback to send events.
Select the events that you want to send to Yandex.Direct. You will see them in 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 Report Wizard.
Click Add Event and add af_app_opened to enable transmitting session data.
- 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 data about app installs.
The integration setup is described in detail in the Adjust documentation.
Settings recommended 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.
Leave the field YANDEX APP ID empty.
Enable In-App Revenue Forwarding to transmit the revenue data and see it in Report Wizard.
Enable Session Forwarding to transmit the session data.
Set up transmitting events in the Event Linking section. Select the events that you want to send to Yandex.Direct. You will see them in the Report Wizard and use them to optimize bids.
For each event, enter the name to show in Yandex.Direct.
- Create a tracking link in 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 tracker settings for Yandex.Direct.
- Configure your existing campaigns
-
If you have active campaigns that use Adjust tracking, but without the modular integration, we recommend that you switch to it now:
- Set up the modular integration as described above.
- In Yandex.Direct, add the Adjust parameter ya_click_id={logid} to the tracking links
- In Yandex.Direct, remove all the callback parameters from the Adjust tracking links to avoid event duplication in the statistics.
Integration settings are detailed 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. To do this, replace the
&event=${(name)!}
parameter in the POSTBACK URL field with&event=EVENT_NAME
, 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 the MyTracker support service.
The integration setup is described in detail in the Singular documentation.
- Select Yandex Direct as a partner
-
- In the Singular interface, go to.
- Select the partner Yandex.Direct.
- 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 data about app installs.
You'll need the resulting tracking link for:
- Creating a mobile app campaign in the Campaign Wizard.
- Adding an app to the library if you place your ads in the expert mode.