Retargeting to events from an app
Retargeting to events from a mobile app is a way to show smart banners to users that interact with your mobile app. For example, part of your audience visits an online store only from a smartphone and views more products in the app rather than on the site. Use app events to target smart banners to such users.
To capture events from your app, you'll need to support integration with mobile measurement SDKs (we support the most popular ones: AppMetrica, Adjust, and AppsFlyer). Set up event tracking: viewing an item, adding it to the cart, removing it from the cart, or checkout. Make sure that events from your app are passed to Yandex Direct.
In the feed, instead of links to your site, it's better to use tracking links based on Apple Universal Links or Android App Links.
Requirements for app events
Make sure that the following events and their parameters are configured in your mobile app. You don't have to transmit all these events. However, for maximum efficiency of smart banners, you can use all of them:
Event/Parameter | Product ID | Revenue | Currency |
---|---|---|---|
Product viewed | required | optional | optional |
Product added to cart | required | optional | optional |
Product removed from cart | required | optional | optional |
Purchase | required | optional | optional |
Event/Parameter | Product ID | Revenue | Currency |
---|---|---|---|
Product viewed | required | optional | optional |
Product added to cart | required | optional | optional |
Product removed from cart | required | optional | optional |
Purchase | required | optional | optional |
Product IDs in the app must exactly match the product IDs in the feed. It's better to use the same product IDs on the site and in the app: this way you can use the same retargeting feed for your site and app.
Data format and transmitting events
Data format
E-commerce event markup. Available as of versions 3.16.1 on Android and 3.12.0 on iOS. Learn more in the AppMetrica documentation.
The above events and parameters are enough for smart banners to work, other settings are optional and used in the Ecommerce report
Transmitting events
In the general app settings, specify the Yandex Metrica tag for the site in the Metrika counter binding field.
Data format
Partner parameters expect offer_id
that can either be a Product ID or a list of products in JSON format. Java code examples:
AdjustEvent event = new AdjustEvent("VIEWED_CONTENT");
event.addPartnerParameter("offer_id", "10001");
Adjust.trackEvent(event);
Or:AdjustEvent event = new AdjustEvent("PURCHASED");
event.addPartnerParameter("offer_id", "[\"1234\",\"5678\"]");
Adjust.trackEvent(event);
Transmitting events
Configure Adjust according to the recommendations:
- In the Yandex Ecom Feed Counter ID field, specify the Yandex Metrica tag for the site.
- In the Event Linking section, configure event transmission:
- Product viewed:
Viewed content
. - Product added to cart:
Added to cart
. - Product removed from cart:
Removed from cart
. - Purchase:
Purchased
.
- Enable Parameter Forwarding.
- Enable In-App Revenue Forwarding.
If the parameter names in events deviate from requirements, map the parameters using Parameter Mapping
Data format
Rich In-App Events are supported, including:
Transmitting events
- In the Yandex Ecom Feed Counter ID field, specify the Yandex Metrica tag for the site.
- Enable event transmission:
- Product viewed:
VIEWED_CONTENT
. - Product added to cart:
ADDED_TO_CART
. - Product removed from cart:
REMOVED_FROM_CART
. - Purchase:
PURCHASED
.
- The method for transmitting events: All media sources, including organic.
- Transmitting revenue and event parameters: send values and revenue.