# MMP 和合作伙伴对接教程

# 1. Mi Ads 支持回传事件列表

# 通用事件

事件分类事件名称事件含义建议
标准事件AD_REVENUEIAA 广告收入必传！
PURCHASE（values&revenue）付费必传！
FIRST_PURCHASE首次付费必传！
APP_OPEN打开 APP必传！
REGISTRATION注册必传！
LOGIN登录必传！
自定义事件CUSTOMIZE1自定义事件 1
CUSTOMIZE2自定义事件 2
CUSTOMIZE3自定义事件 3

# 分行业事件

行业分类事件名称事件含义建议
游戏行业AD_REVENUE广告变现收入必传！
PURCHASE(values&revenue)付费必传！
APP_OPEN打开 APP必传！
REGISTRATION注册必传！
CREATE_ROLE创建角色
TUTORIAL_COMPLETION完成新手教学
ACHIEVEMENT_UNLOCKED成就解锁
LEVEL_ACHIEVED通关级别
电商行业PURCHASE(values&revenue)付费必传！
REGISTRATION注册必传！
LOGIN登录必传！
ADD_TO_CART添加到购物车
ADD_TO_WISHLIST添加到种草清单
ADD_PAYMENT_INFO添加付款信息
金融行业LOAN_DISBURSAL贷款发放必传！
FIRST_TRADE首次交易必传！
FIRST_DEPOSIT首次充值(存款)必传！
REGISTRATION注册必传！
LOAN_CREDIT贷款授信
LOAN_APPROVAL贷款批准
社交，视频，音乐等SUBSCRIBE订阅

# 2. Appsflyer

# 第 1 步：登录并选择您的 App

登录 AppsFlyer。在启动页面的搜索栏中输入 App 名称，然后点击所选的 App。

# 第 2 步：查找并选择 Xiaomi Global 以配置回传设置

在左侧边栏中，点击 Active Integrations。在搜索栏中输入“Xiaomi Global”。然后点击并添加 Xiaomi Global。这将转到可配置回传设置的 Xiaomi Global integration 页面。

# 第 3 步：开启数据发送到 Xiaomi Global

  1. 广告主在“integrated partner"中找到广告平台，并开启"Active Partner"开关，开关显示”on"后右下角点击保存。请确保 Install view-through attribution 切换键已设置为开启。
  1. 对于 Default postbacks，从每个事件的下拉菜单中选择 All media sources, including organic。此选项支持您与 Xiaomi Global 共享所有回传数据，包括 Xiaomi Global 已归因数据、未归因数据和自然数据。

# 第 4 步：配置应用内事件回传窗口期

请确保将 In-app event postbacks 切换键设置为开启。您必须为 In-app event window 选择一个选项，以指定在安装、再归因或再互动后多久将应用内事件回传发送到 Xiaomi Global。对于 In-app event window，我们建议选择 Lifetime，确保应用内事件回传始终发送到 Xiaomi Global，以优化您的 Campaign。

# 第 5 步：配置应用内事件回传

  • 当前小米侧已支持直接在下拉框中勾选对应的事件，目前总共支持 22 个应用内事件，其中包括 3 个自定义事件，您可直接在下拉框中勾选需要映射给小米渠道的事件。
  • 注：因为没有改变您之前的配置，部分原有事件下会显示“legacy（旧版）”，您仍可将其替换为我们最新的事件，我们会从替换那天继续接收回传。

# 第 6 步：配置广告收入回传

开启 AD_REVENUE 的回传以支持小米对您的 IAA ROAS 进行优化，为了您优化的效果达到最佳，我们建议您回传来自全渠道的数据。具体收入的配置可参考support.appsflyer.com。完成以上配置后，点击 Save Integration 进行保存。

# 3. Adjust

# 第 1 步：配置并选择 partner：Xiaomi global

登入 Adjust。在起始页面，点击 Campaign Lab 下面的 New ad network。在搜索栏中输入“Xiaomi Global”，点击选项中出现的 Xiaomi Global。点击 Next 前往到下一步。

# 第 2 步：选择您的 APP

选择【Data sharing】，在提供的选项列表中，选择要设置回传的 app。点击 Next 前往到下一步。

# 第 3 步：确保安卓数据状态为 Enabled

# 第 4 步：配置应用内事件回传

依次回传对应KPI的事件，保证端内事件与Adjust上的事件映射关系正确。必须勾选 Sessions 和 In-app revenue (from in-app purchases) 旁的方框，建议勾选除 Parameters 以外所有可用选项旁的方框，以尽可能与我们分享多的数据。
  • 当前小米侧已支持直接在下拉框中勾选对应的事件，目前总共支持22个应用内事件，其中包括3个自定义事件，您可直接在下拉框中勾选需要映射给小米渠道的事件。

# 第 5 步：配置广告收入回传

开启广告收入数据的回传以支持小米对您的 ROAS 进行优化。

# 4. Tenjin

# 第 1 步：设置对接 Campaign

  1. 首先，创建广告计划 CONFIGURE -> Campaigns 点击 Create Campaign。
  1. 选择您需要投放的渠道及推广的应用。在这之前，请确保您已经正确添加 App 应用 and Ad network 投放渠道 ，并点击 "Create Campaign"。

# 第 2 步：添加归因渠道

在面板上 CONFIGURE -> Channels 页面，点击 Add a Channel，输入 xiaomi 即可自动出现小米渠道。

# 第 3 步：配置广告收入回传

  1. 首先，在 CONFIGURE -> Apps 选择您需要配置的应用，点击 + New Callback.
  1. 通过左上角筛选广告投放渠道，将选择相应的回调发送到该广告投放渠道，选择对应的 callback，这样所有激活都会即时回调给广告投放渠道。

# 第 4 步：配置应用内事件回传

  1. 点击左下角 add events，选择 xiaomi custom events。
  1. SDK 里面有发送的事件会显示在第二栏里，这里只有三个默认事件。user filter 决定是否发送全渠道/仅归因/仅归因+organic。
  1. Event（xiaomi）选择对应小米的 event 名称。
  • 当前小米侧已支持直接在下拉框中勾选对应的事件，目前总共支持 22 个应用内事件，其中包括 3 个自定义事件，您可直接在下拉框中勾选需要映射给小米渠道的事件。
  1. 打开全渠道回传。

USER FILTER 处选择“all users"可将所有回传数据发送到 Xiaomi，包括已归因数据、未归因数据和自然数据，以便进行 Campaign 优化。

# 5. Appmetrica

# 第 1 步：登录并选择您的 App

# 第 2 步：查找并选择 Xiaomi Global 以配置回传设置

在"Tracking"里选择中选择"Media sources"后搜索"Xiaomi Global"。

# 第 3 步：填写回传 URL

在“回传设置”下的“回传 URL”中填写：https://cc.ad.intl.xiaomi.com/track/m3rd/v1.0?partner=appmetrica&ext={click_id}&gaid={google_aid}，系统将生成追踪url。

# 第 4 步：配置应用内事件回传

  1. 在"Postback settings"处选择"+Add postback"
  2. "Postback destination"需要选择"Xiaomi Global"后选择"EVENT"
  3. 在 Postback template 处的事件都是可点击的，点击后会生成对应的回传模板，EVENT 处会展示你在 Appmetrica 打点的所有事件，可根据你想回传的事件生成对应的模板，回传给 Xiaomi Global。
  1. 打开全渠道回传。

我们建议您选择“all users"将所有回传数据发送到 Xiaomi，包括已归因数据、未归因数据和自然数据，以便进行 Campaign 优化。

# 第 5 步：配置广告收入回传

对于游戏客户，我们建议你回传 IAA 广告变现事件，在 Event 处选择 Ad revenue，生成对应的 postback url 回传给 Xiaomi Global。

完成所有事件的配置后，点击 Save 保存设置。

# 6. Branch

# 第 1 步：登录并选择您的 App

登录 Branch 平台。点击配置--合作伙伴管理。

# 第 2 步：查找并选择 XiaoMi Global 以配置回传设置

在左侧的广告合作伙伴部分中搜索 XiaoMi Global，然后点击右下角的保存并启用按钮。

# 第 3 步：勾选对应配置

将 XiaoMi Global 启用为广告合作伙伴后，点击回传配置选项卡。在此选项卡中，您可以找到所有单独的回传，还可以添加您想要转发给 XiaoMi Global 的其他回传事件。如果希望配置更多回传，向下滚动屏幕并点击添加新回传。确保勾选您要启用事件的所有事件框，然后点击右下角的保存按钮确认配置。

# 第 4 步：配置应用内事件回传

点击“新增新的回传”，下拉选择对应的应用内事件。

# 第 5 步：生成追踪链接

在 Partner Management 窗口点击 Create XiaoMi Global Link。您会看到以下广告链接格式的选项：

  • App Install or Engagement
  • Create Display Link
  • Create Search Link

在 App Only 部分，选择 App Install or Engagement，并点击 Create Ad Link 窗口底部的 Confirm 按钮。

# 7. Singular

# 第 1 步：添加合作伙伴

登陆 Singular 平台，点击 Attribution > Partner Configuration > Add a Partner > 选择 Xiaomi Global

# 第 2 步：选择发送回传的 App

在弹出窗口中，在 "应用程序"下拉菜单中选择应用程序名称，在 "网站"下拉菜单中选择平台。

# 第 3 步：指定特定于应用程序的归因设置

  1. 直通归因：选中此复选框可允许 Singular 发送浏览型归因（展示）转化相关的回传。
  2. 点击归因：指定广告的安装时间
  3. 重新参与：使用非活动窗口

# 第 4 步：窗口期配置

将小米全球版设为合作伙伴时，您可能会看到以下内容：

向下滚动到 Click-through attribution lookback window，配置窗口期。建议您保留默认的窗口期（7 天）设置。

# 第 5 步：配置应用内事件回传

  1. 选择是否要向网络发送事件回传。通过指定 "应用内 (SDK) 事件名称"、"事件名称 "以及是否要包含其收入值（如果适用）来添加事件。
  2. 单击保存。对您设置的每个合作伙伴、应用程序和网站重复上述操作。
  • 当前小米侧已支持直接在下拉框中勾选对应的事件，目前总共支持 22 个应用内事件，其中包括 3 个自定义事件，您可直接在下拉框中勾选需要映射给小米渠道的事件。

# 8. Kochava

# 第 1 步：找到您所对应的 App

登录 Kochava 平台。在屏幕左侧的菜单上，点击 APPS & ASSETS -- ALL APPS。在搜索栏上搜索您的 App 名称，找到您的 App。

# 第 2 步：进入合作伙伴配置

进入 Kochava 的页面后，在左侧边栏找到合作伙伴配置，点击新增配置。

# 第 3 步：配置应用内事件回传

当前小米侧已支持直接在下拉框中勾选对应的事件，目前总共支持 22 个应用内事件，其中包括 3 个自定义事件，您可直接在下拉框中勾选需要映射给小米渠道的事件。

# 第 4 步：配置回传链接

  1. 进入广告计划设置，选择对应的产品，点击+Add 创建链接。
  1. 选择渠道为 Xiaomi——Xiaomi Global-Android
  1. 可针对已有事件修改回传链接。

# 9. MyTracker

# 第 1 步：添加广告合作伙伴

登录 MyTracker 平台。点击 Marketing--合作伙伴，在右侧边栏搜索小米后进入页面。

# 第 2 步：选择您的 App 以配置回调

# 第 3 步：配置应用内事件回传

  1. 在“事件发送”选项卡上，选择所需的应用。支持回发配置的常规事件和自定义事件列表将加载到表单中。
  1. 指定 Xiaomi 使用的事件名称，目前总共支持 22 个应用内事件，其中包括 3 个自定义事件，您可直接在下拉框中勾选需要映射给小米渠道的事件。您可以从列表中选择合作伙伴使用的事件名称，也可以选择“自定义”并输入任何其他事件名称。

# 第 4 步：添加应用内事件参数

添加"+event parameter"以明确发送回发的条件。例如，只有当“level”参数为“10”时，您才能发送“LEVEL_ACHIEVED”回发。

# 10. Airbridge

# 第 1 步：登录并选择您的 App

# 第 2 步：选择并进入小米渠道

在侧边栏中选择"Integrations"之后，选择"Ad Channel Integration"后搜索并进入 Xiaomi Global.

# 第 3 步：配置应用内事件回传

打开 Send postbacks 开关，并在"Postback"中选择"Postback event setup"以配置应用内事件回传，目前小米总共支持 22 个应用内事件，其中包括 3 个自定义事件，您可直接在下拉框中勾选需要映射给小米渠道的事件。

# 第 4 步：配置归因窗口期

点击"Attribution Rule"，可对您当前的回传设置激活的归因窗口期和应用内事件的归因窗口期。

# 第 5 步：生成点击追踪链接

当前 Airbrige 已有配置好的基础追踪链接，您可根据自己的广告计划添加特定的字段，并将该追踪链接复制到 Mi Ads 的创意编辑页中的点击地址处。