设置 MMP

文字图片广告的数据格式

支持Rich In-App Events。

产品广告和目录页面广告的数据格式

需要以下 Rich In-App Events：

• 已查看产品：af_content_view。
• 已添加至购物车的产品：af_add_to_cart。
• 从购物车中移除的产品：Removed from cart。
• 已购买：af_purchase。

确保添加用于将产品 ID 传递给所有事件的 af_content_id 参数。

有关详细信息，请参阅您的 MMP 文档以实现事件代码。

具有 CRR 限制的最大转化量策略的要求

您需要在移动应用事件的 af_revenue 参数中设置收入数据的收集。 开发人员须知：

• Android
• iOS

文字图片广告的数据格式

支持所有 Adjust 事件。

产品广告和目录页面广告的数据格式

该格式支持带有 Partner Parameters 的事件（在 Adjust SDK 版本 4.0 或更高版本中可用）需要 offer_id，它可以是产品 ID 或 JSON 格式的产品列表。

AdjustEvent event = new AdjustEvent("VIEWED_CONTENT");
event.addPartnerParameter("offer_id", "10001");
Adjust.trackEvent(event);

AdjustEvent event = new AdjustEvent("PURCHASED");
event.addPartnerParameter("offer_id", "[\"1234\",\"5678\"]");
Adjust.trackEvent(event);

如果在事件参数中有产品 ID，但其名称与 offer_id 不同，则您无需对应用进行任何编辑——您可以在设置通过 Parameter Mapping 到 Yandex Direct 传输事件时编辑此值。

使用深层链接跟踪的归因

Adjust 需要支持深层链接跟踪，以便在用户点击应用后进行转化归因。 开发人员须知：

• Android
• iOS

具有 CRR 限制的最大转化量策略的要求

您需要在应用内事件中设置收入数据收集。 开发人员须知：

• Android
• iOS

一般设置规则

1. 打开 Integrated Partners 部分，并选择 Yandex Direct。

2. 转到 Integration 选项卡。

3. 启用 Activate partner。

4. 在 Yandex App ID 字段中，指定在将应用添加到 Yandex Direct 时获得的 App ID。

5. 启用 In-app events postback 以发送事件数据。

6. 选择事件并设置 SDK Event Name > Partner Event Identifier 映射。 如果没有一个预设标识符适合您，请使用 EVENT_1、EVENT_2 或 EVENT_3 ID。

7. 选择 Sending option: All media sources, including organic 和 Send revenue: Values & revenue，以发送收入和事件参数。

产品广告和目录页面广告的要求

1. 在 Yandex Ecom Feed ID 字段中，以 12345 格式指定 Yandex Metrica 计数器。

我们建议您使用已设置 e-commerce 站点的计数器：在这种情况下，机器学习算法将包括站点用户在应用中查看的产品，反之亦然。 这有助于提高再营销的有效性。

2. 选择事件：

• af_content_view > VIEWED_CONTENT （必填）；

• af_added_to_cart > ADDED_TO_CART （必填）;

• remove_from_cart > REMOVED_FROM_CART（推荐）。

• af_purchase > PURCHASED （必填）。

3. 选择 Sending option: All media sources, including organic 和 Send revenue: Values & revenue，以发送收入和事件参数。

具有 CRR 限制的最大转化量策略的要求

选择 Send revenue: Values & revenue 以发送收入。

一般设置规则

1. 转到应用设置并打开 Partner Setup。

2. 选择 Add Partner → Yandex Direct → (+)。

3. 在 Yandex App ID 字段中，指定在将应用添加到 Yandex Direct 时获得的 App ID。

4. 启用 In-App Revenue Forwarding、Parameter Forwarding, 和 Session Forwarding。

5. 通过从列表中选择适当的名称，在 Event Linking 中设置事件发送。 所有设置分别为 iOS 和 Android 指定。

产品广告和目录页面广告的要求

1. 在 Yandex Ecom Feed ID 字段中，以 12345 格式指定 Yandex Metrica 计数器。

我们建议您使用已设置 e-commerce 站点的计数器：在这种情况下，机器学习算法将包括站点用户在应用中查看的产品，反之亦然。 这有助于提高再营销的有效性。

2. 在 Event Linking 部分，设置事件的发送：

• 已查看产品: Viewed content（必填）。

• 将产品添加到购物车: Added to cart（必填）。

• 从购物车中移除的产品：Removed from cart（推荐）。

• 购买：Purchased（必填）。

3. 如果在事件参数中，Product ID未命名为offer_id，请单击 Partner Parameter Mapping。 在 FROM APP 字段中，输入 SDK 中的参数名称，并在 TO PARTNER 字段中指定 offer_id。

不需要对链接进行其他更改。 点击将使用服务器到服务器跟踪方法从 Yandex Direct 发送到 AppsFlyer。

当您在 Yandex Direct 中设置广告系列时，会启用跨服务器点击发送。 开始制作广告系列，为您的移动应用选择一个目标。 之后，页面下方将出现一个部分，您可以在其中启用将点击发送到您的 MMP。

将以下参数添加到通用链接：

• adjust_ya_click_id={logid};

• adjust_campaign={campaign_name};

• adjust_t=abc_def：输入 MMP 的跟踪器令牌 ID（这是为 Adjust 中的每个跟踪器自动创建的唯一标识令牌）。 在 Android 的情况下替换abc，在 iOS 的情况下替换def。 中间留一个下划线。 如果您的应用是多平台的，请指定统一的 MMP ID：adjust_t=abc。 您可以使用adjust_tracker参数代替adjust_t。

示例链接：

https://example.ru/cars/new/group/bmw/3er/21398591-21398651?adjust_ya_click_id={logid}&adjust_t=abc_def&adjust_campaign={campaign_name}

在您的广告系列中使用通用链接之前，请务必先对其进行测试。 通过这种方式，您可以确保这些链接已由 Adjust 正确配置和跟踪，并且预期内容已传送给用户。

另请参见通用链接常见问题解答。

如何设置

1. 设置链接：

• iOS
• Android 应用链接。
• Samsung OS：URI 方案

2. 添加 OneLink 模板。

它管理广告系列中使用的所有 OneLink 链接在各种场景下的重定向逻辑：

• 应用未安装：用户被重定向到相应的应用商店或移动网址。

  设置

  说明：完成步骤 1–8 和 10。 根据场景，在步骤 6 中配置到应用商店或移动网页的重定向。 如果需要，添加品牌域。 有关更多信息，请参见 AppsFlyer 文章。

• 应用已安装：用户使用 Android 应用链接、iOS Universal Links 或 URI 方案打开应用。

  设置

  说明。

  • 对于 iOS 通用链接，指定Team ID。

  • 对于 Android 应用链接，请指定 SHA256 指纹并保存自动生成的意图过滤器代码：你需要使用它来完成 Android 应用链接设置。

3. 设置 OneLink 链接：这些是显示在广告中的可点击链接。

必需链接参数

• pid=yandexdirect_int
• clickid={logid}
• is_retargeting=true。

您可以在 OneLink 模板设置中添加 UTM 标签和其他自定义参数。

示例链接：

https://app.appsflyer.com/ru.magnit.express.android?c={campaign_name}&af_siteid={source_type}{source}&af_adset_id={gbid}&af_ad_id={ad_id}&af_keywords={keyword}&keyword_id={phrase_id}&is_retargeting=true&af_click_lookback=7d&af_reengagement_window=30d&af_inactivity_window=0d&google_aid={google_aid}&android_id={android_id}&af_ad={ad_id}&af_sub1={region_neme}&af_sub2={match_type}&af_sub3={position_type}_{position}&af_sub4={keyword}&af_ip={client_ip}&af_ua={user_agent}&af_lang={device_lang}&af_web_dp=https%3A%2F%2Fdostavka.magnit.ru%2Fexpress%2Fpromotion&af_xp=social&deep_link_value=magnit.dostavka%3A%2F%2Fexpress%2Fpromotion&af_dp=magnit.dostavka%3A%2F%2Fexpress%2Fpromotion&deep_link_sub1=magnit.dostavka%3A%2F%2Fexpress%2Fpromotion&advertising_id={google_aid}&oaid={oaid}&pid=yandexdirect_int&clickid={logid}&af_c_id=

可选参数

• af_click_lookback: 归因窗口期（广告点击和打开应用之间）。 它以天为单位指定（例如，14d）。 默认值（如果您不传递此参数）是 7 天。
• af_reengagement_window：再互动窗口期（归因和转化之间）。 它以天为单位指定。 默认值为 30 天。

更新 Feed 中的链接

将生成的链接模板发送给开发人员，以便再次在 Feed 中生成产品链接。

将跟踪链接添加到包括产品链接的元素。 该链接必须将用户引导至特定产品（在网站上或在应用中）。 对于 XML/YML feed 文件，请遵循附加要求。

查看 AppsFlyer Help 以了解如何启用。

另请参阅基于 Universal Links 的跟踪链接。

如何设置

1. 为应用中的深层链接设置链接。

2. 为再归因和延迟深层链接设置链接。

要启用延迟深层链接，您需要：

• 支持通过 iOS 和 Android 上的深层链接进行再归因。
• 在跟踪链接中包含设备 ID（iOS 的 IDFA 和 Android 的 GPS_ADID）。

3. 设置多平台通用跟踪链接：

• 基于原始通用跟踪链接和跟踪器令牌创建多平台链接。

• 检查您的应用在 iOS 和 Android 上的路径和查询参数是否相同。 确保使用正确的格式：

  • iOS 和 Android 共享相同的路径和查询参数。
  • iOS 和 Android 应用拥有不同的路径和查询参数。

  我们建议在设置通用链接时使用深层链接生成器。

  带有解释的生成器用户界面截图

  

  PLATFORM（平台）：输入您的应用平台名称，该名称应与 Adjust 仪表板中显示的名称一致。 有效值包括：Android、iOS 和多平台应用。

  AD ENVIRONMENT（广告环境）：有许多不同的深层链接格式都适用于不同的广告环境。 对于 Yandex Direct，请选择 Other。

  FORMAT（格式）：根据您的广告环境，可能支持多种深层链接格式。 在这里，您可以指定要使用的格式。 对于 Yandex Direct，选择 ulink（通用链接）。

  APP（应用）：在下拉菜单中选择应用。 此列表包括所选平台的所有应用。

  TRACKER（跟踪器）：选择您要使用的跟踪器。 列出了应用中的所有网络级跟踪器。

  RAW UNIVERSAL LINK（原始通用链接）：当您选择在仪表板中已启用并具有通用链接功能的应用时，将自动添加原始通用链接。

  ANDROID APP SCHEME：方案在您的应用中配置，并且特定于每个移动平台。

  IOS UNIVERSAL LINK PATH：iOS 用户跳转到的应用内目标的路径。 输入应用中特定产品或部分的路径或模版。 了解有关模板和路径语法的更多信息。

  ANDROID DEEPLINK PATH：Android 用户跳转到的应用内目标的路径。 输入应用中特定产品或部分的路径或模版。 了解有关模板和路径语法的更多信息。

  CAMPAIGN, ADGROUP, CREATIVE： 将自动建议 Yandex Direct 的宏。 如果您不需要接受其中任何一个参数，请不要在字段中指定相应的宏。

  

  LABEL（标记）：使用此字段指定不适合任何其他 Adjust 字段的参数。

  FALLBACK URL：您将平台外用户（即，来自不受支持的操作系统的点击）发送到的特定着陆页的 URL。 注意：如果您选择的跟踪器支持 iOS，Adjust 可能会将 MacOS 流量重定向到 Apple App Store。 为了防止出现这种情况，请在 REDIRECT MACOS 字段中输入 MacOS 的 URL 地址。

  REDIRECT URL/MACOS/iOS/Android：添加重定向 URL 地址以更改 Adjust 到应用商店的默认重定向，并将用户转至特定 URL 地址。 您可以按设备平台重定向用户（REDIRECT MACOS/iOS/Android）或将所有用户发送到一个位置（REDIRECT URL）。

  DEVICE ID MACROS： 将自动建议 Yandex Direct 的宏。 如果您不需要接受其中任何一个参数，请不要在字段中指定相应的宏。

  Adjust 文档中的参数说明

  不同场景的链接示例

  不同场景会触发使用上述字段生成的以下链接：

  • 如果您想将未拥有该应用的用户带到应用商店：

    • iOS，应用已安装：Universal link。

    • iOS，应用未安装：自动重定向到应用商店。

    • Android，应用已安装：Deeplink。

    • Android，应用未安装：自动重定向到应用商店。

    • 桌面：FALLBACK URL 和 REDIRECT MACOS。

    示例链接：

    https://nquw.adj.st/product/100586311342?adj_t=aflb3js&adj_fallback=https%3A%2F%2Fmarket.yandex.ru%2Fproduct--cold-steel-luzon-medium-20nql%2F388454980%3Fcpa%3D1%26sku%3D100586311342&adj_redirect_macos=https%3A%2F%2Fmarket.yandex.ru%2Fproduct--cold-steel-luzon-medium-20nql%2F388454980%3Fcpa%3D1%26sku%3D100586311342&adj_gps_adid=%7Bgoogle_aid%7D&yclid=%7Blogid%7D

  • 如果您想将未拥有该应用的用户带到网页：

    • iOS，应用已安装：Universal link。

    • iOS，应用未安装：REDIRECT URL IOS。

    • Android，应用已安装：Deeplink。

    • Android，应用未安装：REDIRECT URL ANDROID。

    • 桌面：REDIRECT URL。

    示例链接：

    https://nquw.adj.st/product/100586311342?adj_t=aflb3js&adj_redirect_ios=https%3A%2F%2Fmarket.yandex.ru%2Fproduct--cold-steel-luzon-medium-20nql%2F388454980%3Fcpa%3D1%26sku%3D100586311342&adj_redirect_android=https%3A%2F%2Fmarket.yandex.ru%2Fproduct--cold-steel-luzon-medium-20nql%2F388454980%3Fcpa%3D1%26sku%3D100586311342&adj_gps_adid=%7Bgoogle_aid%7D&yclid=%7Blogid%7D&adj_redirect=https%3A%2F%2Fmarket.yandex.ru%2Fproduct--cold-steel-luzon-medium-20nql%2F388454980%3Fcpa%3D1%26sku%3D100586311342&adj_gps_adid=%7Bgoogle_aid%7D&yclid=%7Blogid%7D

强制性参数

为了将应用内事件准确归因于 Yandex Direct 点击，请确保在链接中包含所需的跟踪参数：

• 在跟踪链接中：adj_ya_click_id={logid} 或 adjust_ya_click_id={logid}。

• 在跟踪链接内的 fallback URL 中： yclid={logid}

UTM 标记在回退 URL 中指定。

示例链接：

https://sb00.adj.st/cars/new/group/bmw/3er/21398591-21398651?adjust_ya_click_id={logid}&adjust_t=abc_def&adjust_campaign={campaign_name}&adjust_deeplink=autoru%3A%2F%2Fcars%2Fnew%2Fgroup%2Fbmw%2F3er%2F21398591-21398651&adjust_redirect=https%3A%2F%2Fauto.ru%2Fcars%2Fnew%2Fgroup%2Fbmw%2F3er%2F21398591-21398651%3Fyclid%3D

另请参阅基于 Universal Links 的跟踪链接。