Tracking Links for Feeds

A feed is a file containing product names, descriptions, prices, technical specifications, and other product information that helps quickly transfer assortment data to various services. In Direct, feeds are used to create ads, including product ads for promoting mobile applications and Web+App campaigns.

You can review the complete requirements for feeds for mobile app promotion in the Yandex Direct documentation.

Step 1. Application Settings

App developers configure user routing in the application via deeplink and Universal Link. It's important that each end product planned for promotion has a deeplink/Universal Link scheme that opens the corresponding page in the application.

Step 2. Create a Tracker

  1. In the AppMetrica interface, go to TrackingCreate tracker.

  2. Specify the tracker name.

  3. Select the partner - Yandex.Direct.

  4. Fill in the remaining fields. Settings will differ depending on the campaign type and user scenario.

    To open a specific product, you need to pass parameters from the tracking link to the deeplink or target link. Learn more about tracking link parameters.

Scenario: if no app - redirect to app store, if app exists - redirect to product page in the app.

Platforms: Android, iOS.

SmartLink option: disabled.

  • Target link: specify the link to your app in the app store.

  • Deeplink for Android: specify the deeplink template for products in the app. Specify the common part of the deeplink path, and write the variable part (e.g., product ID) as a macro.

    For example, the deeplink looks like: myapp://catalog/product/12345, where 12345 is the unique product ID, and the path catalog/product/ is the same for all products.

    Then in the tracker specify: myapp://catalog/product/{item_id}.

    You can use any convenient macro to denote the product ID. In this case, use the corresponding parameter name in the app-to-app link.

  • App-to-app link:

    Add the value for the {item_id} macro to the link as a parameter. For example, item_id=12345. The value will be passed to the deeplink instead of the macro, so the redirect will go to the deeplink: myapp://catalog/product/12345.

    Example link: https://1111.redirect.appmetrica.yandex.com?appmetrica_tracking_id=123456789&referrer=reattribution%3D1&item_id=12345.

    If you use a different macro name in the deeplink, then specify it as a parameter in the link.

  • Target link: specify the link to your app in the app store.

  • App-to-app link: specify the path to the product in the app-to-app link. For example: https://1111.redirect.appmetrica.yandex.com/catalog/product/12345?appmetrica_tracking_id=123456789&referrer=reattribution%3D1.

Scenario: if no app - redirect to product page on website, if app exists - redirect to product page in the app.

Platforms: Android, iOS, fallback.

SmartLink option: enabled.

  • Target link: specify the URL template for products on the website. Specify the common part of the URL path, and write the variable part (e.g., product ID) as a macro.

    For example, the URL looks like:

    https://example.ru/catalog/product/12345, where 12345 is the unique product ID, and the path catalog/product/ is the same for all products.

    Then in the tracker specify: https://example.ru/catalog/product/{item_id}.

    You can use any convenient macro to denote the product ID. In this case, use the corresponding parameter name in the app-to-app link.

  • Deeplink for Android: specify the deeplink template for products in the app. Specify the common part of the deeplink path, and write the variable part (e.g., product ID) as a macro.

    For example, the deeplink looks like: myapp://catalog/product/12345, where 12345 is the unique product ID, and the path catalog/product/ is the same for all products.

    Then in the tracker specify: myapp://catalog/product/{item_id}.

    You can use any convenient macro to denote the product ID. In this case, use the corresponding parameter name in the app-to-app link.

    Add parameters click_id={click_id} and yclid={yclid} to the deeplink.

    Example: myapp://catalog/product/{item_id}?click_id={click_id}&yclid={yclid}.

  • Target link: specify the URL template for products on the website. Specify the common part of the URL path, and write the variable part (e.g., product ID) as a macro.

    For example, the URL looks like:

    https://example.ru/catalog/product/12345, where 12345 is the unique product ID, and the path catalog/product/ is the same for all products.

    Then in the tracker specify: https://example.ru/catalog/product/{item_id}.

    You can use any convenient macro to denote the product ID. In this case, use the corresponding parameter name in the app-to-app link.

  • Target link: укажите шаблон ссылки на товары на сайте. Для этого укажите общую часть пути URL, а меняющуюся часть пути (например, ID товара) запишите в виде макроса.

    For example, the URL looks like: 
    
    `https://example.ru/catalog/product/12345`, where 12345 is the unique product ID, and the path `catalog/product/` is the same for all products.
    
    Then in the tracker specify: `https://example.ru/catalog/product/{item_id}`.
    
    You can use any convenient macro to denote the product ID. In this case, use the corresponding parameter name in the app-to-app link.               
    
  • App-to-app link:

    1. Add the value for the {item_id} macro to the link as a parameter. For example, item_id=12345. The value will be passed to the deeplink instead of the macro, so the redirect will go to the deeplink: myapp://catalog/product/12345.

    2. Specify the path to the product in the app-to-app link. For example, the final link will look like: https://1111.redirect.appmetrica.yandex.com/catalog/product/12345?appmetrica_tracking_id=123456789&referrer=reattribution%3D1&item_id=12345.

    If you use a different macro name in the deeplink and target link, then specify it as a parameter in the link.

Step 3. Additional Tracker Settings

Implement the remaining tracker and campaign settings according to the campaign type. Save the tracker.

Specify the final app-to-app link in the feed. Generate links for the remaining products by analogy.

Frequently Asked Questions

Can I use universal links like http://example.ru/ instead of tracking links when creating a feed?

Yes, such links are suitable for Web+App campaigns. In this case, you must add the parameter referrer=reattribution%3D1 to the final landing page.

Do I need to specify Deeplink for iOS?

This is not necessary: for iOS versions above 12.3.1, deeplinks in tracking links do not work. App opening on iOS is done via direct link using Universal Link technology.

If you didn't find the answer you were looking for, you can use the feedback form to submit your question. Please describe the problem in as much detail as possible. Attach a screenshot if possible.

Contact support Suggest an improvement for documentation