安卓第三方应用商店（multi-store）配置指南

安卓包名决定了归因数据发往哪个应用面板。在单一应用面板的场景下，所有的商店/渠道包的包名是一致的。此处无需再使用channel渠道号。 除去一种情况：即您在添加单一面板时，使用了out of store方式，此时仍需上报channel号确保包名一致。

SDK中的AF_STORE参数对应原始数据和上文中的install_app_store，即每个APK包的下载来源。

集成打包APK：

1. 创建App build 副本。注意 ：请勿更改安卓包名。
2. 为不同APK包/商店包/渠道包名赋值：
   • Manifest方法：在AndroidManifest.xml中的<application>标记内添加以下代码。为每APK包/商店包/渠道包设置AF_STORE值。

     <application>
        ...
        <meta-data android:name="AF_STORE" android:value="enter_store_name_here"/>
        ...
     </application>

     --或者--
   • API方法： 每个国内第三方应用商店分别准备一个单独的APK。调用setOutOfStore API以设置AF_STORE值。为每个商店设置唯一AF_STORE值。(注意：如果您使用的国内第三方应用商店较多，建议使用此方法)
     

     AppsFlyerLib.getInstance().setOutOfStore("example_store")

AF_STORE对应AppsFlyer原始数据中的install_app_store字段。目前包含该字段的报告和API包括：

• 面板群组分析报告
• 原始数据报告 （原始数据报告是AppsFlyer高级功能）

1. 前往 > 合作伙伴配置，然后选择对应的媒体渠道。
2. 在“归因链接”标签页，设置“out-of-store URL”参数。该配置对应af_r参数，会直接填充至af_r中，以确保用户重定向到正确的落地页。例如， &af_r=http://www.destinationurl.com默认URL在 App Settings 页面中设置。
3. 注意配置链接中的af_r参数，以设定落地页地址。
4. 设置其他需要的归因链接参数。
5. 媒体渠道可使用设备ID进行归因，同时AppsFlyer也支持概率模型作为后备方案，以应对设备ID缺失的场景。
6. 建议在归因链接中使用一个或多个设备ID参数：
   • android_id
   • advertising_id
   • oaid
7. 复制归因链接，填写至广告平台。

此处完整包名为：物理包名，加后缀“-channel”，因此归因数据会显示在对应的完整包名下。

为每APK包/商店包/渠道包配置manifest:

• 在AndroidManifest.xml的<application>中添加以下代码为channel赋值。为每APK包/商店包/渠道包配置channel名/渠道号。

  <application>
       ...
       <meta-data android:name="CHANNEL" android:value="enter_store_name_here"/>
       ...
  </application>

  注意： 参数区分大小写。

添加应用面板，对应物理包名和后缀“-channel”。示例：物理包名com.myapp ，channel名配置为abcstore，，那么AppsFlyer面板显示的完整包名为com.myapp-abcstore 。

在AppsFlyer后台，为每个商店添加多个面板：

1. Go to, My apps, click Add app.
   The Add your app window opens.

   

2. 选择第三方商店Android APK (Standalone, Amazon 等)
3. 完成：
   • Android物理包名：在app package中显示的包名
   • channel名：APK包/商店包/渠道包的唯一标识符，以区分具有相同物理包名的多个面板。请注意此处填写的channel名需要与manifest配置的channel名称完全一致，大小写敏感。
   • App URL： 即 默认落地页地址，如此处配置了URL信息，则会在媒体配置归因链接中，自动填充在af_r 参数里。通常可设置为默认的APK下载地址或落地页。您无需立刻设置，也可以在后续配置归因链接时再添加。
4. Click Save.
   The app is created. 

非自然安装

测试非自然激活：

1. Use an Android device that does not have your app installed or register the device.
2. 参考“自定义媒体配置”生成测试归因链接。使用test作为媒体名称（“＆pid = test”）。
3. 将设备ID（GAID，OAID，IMEI或Android ID）添加到点击URL。参数写法参考：AppsFlyer归因链接结构和参数

   http://app.appsflyer.com/com.greatapp?pid=test 
   ＆af_r = http：//www.destinationurl.com&advertising_id=b5a3-78d9b5-0f12345-xxxx

   4. 通过电子邮件把该归因链接发送给自己，然后点击它。跳转后, 无需担心跳转地址，也无需从商店安装。请直接安装并打开，已集成了AppsFlyer SDK的APK即可。

自然安装

测试自然激活：

1. Use an Android device that does not have your app installed or that is registered.
2. 安装并打开，已集成了AppsFlyer SDK的APK。
3. 查看数据：

请参考单一面板的步骤指南直接打包新的APK即可。

1. 在Facebook应用设置页面下的Android部分配置跳转链接。
2. 以应用管理员的身份登录到Facebook，前往https://developers.facebook.com/apps/ 并选择相应应用。
3. 进入设置页面找到您的Android设置，如果您还没有配置Android的话，先添加该平台。
4. 填写所有内容，包括该应用的amazon应用商店URL。
   
   
5. 在AppsFlyer控制面板的已对接合作伙伴里选择 Facebook, 并输入与记录Facebook店内移动应用安装时相同的Facebook 应用ID。
6. 在Facebook设置Advert Sets时，选择 “Amazon Appstore”。
   
   

注意：该屏幕快照取自Facebook Power Editor，在FMP平台中可能会有所不同。

您可以通过以下方法查看获取数据。

• 群组报告：
  • 在一个报表中集合多个面板/应用的数据。
  • 以install_app_store 作为分组维度，查看各个应用面板的数据。
• Pull API（适合查看单一面板的install app store数据）：后台显示的 Pull API默认链接中不包含Install App Store 。请单独添加以下参数： &additional_fields=install_app_store，即可使用Pull API获取该字段。
• 自定义面板（适合集中查看多个面板）：可通过自定义面板选择多个应用，从而建立一个统一的自定义面板，直接查看各个应用商店/APK包的数据。

• 截止2022年9月份，支持referrer的商店包括Google Play、华为应用商店、三星应用商店和小米GetApps商店。
• 请使用Android SDK V5.4或更高版本，以启用第三方应用商店（非Google Play的三方商店）的referrer归因除此之外，无需进行其他设置。
• 通过第三方应用商店referrer归因的数据在原始数据中呈现为：
  • match type: 对应的第三方应用商店名称例如，huawei_referrer
  • 某些情况下，Google Play可能会以助攻的形式参与了下载激活，但不会被归因。这部分数据会显示在助攻字段中。同理，第三方应用商店也可能助攻Google Play。
  • 第三方应用商店的referrer具体信息目前还不会显示在原始数据中。