基于Manifest的AppsFlyer出厂预装归因（安卓）

适配要求：必须使用V4.0+版本的SDK。

该方法是所有方法中最稳定可靠的，但需注意：预装完成后，所有应用激活（包括新增激活和重装激活）都会被归因到预装渠道。

系统属性（System Properties）方法需要应用开发人员和设备生产商双方都完成相应的操作。

开发人员

您需要向设备生产商或媒体渠道APK。该方法只需要用到默认APK，无需提供其他单独的APK。

创建一个名为pre_install.appsflyer的文件，并在该文件添加以下键值对：

<package_name>=<media_source>

com.appsflyer.sampleapp=huawei

请使用以下方式指定其他预装参数：

在pre_install.appsflyer文件中以JSON格式传递其他参数。例如:

com.appsflyer.sampleapp={"pid":"huawei", "c":"special_campaign","af_adset":"some_adset"}

pre_install.appsflyer配置完毕后，请将其连同APK一起发送给媒体渠道或设备生产商。

设备生产商

设备生产商需要将pre_install.appsflyer放置在其指定的文件路径中，并将pre_install.appsflyer的文件权限设置为744。

然后，设备生产商需要在该系统属性文件中添加一个键值对，以指向pre_install.appsflyer文件。

在安卓系统属性中添加键值对

adb shell su 
 setprop ro.appsflyer.preinstall.path /data/pre_install.appsflyer

另一种方法是从安卓文件系统中提取system-properties-file，并返回编辑完毕后的文件。

adb root
adb remount
adb pull /system/build.prop
echo ro.appsflyer.preinstall.path=/data/pre_install.appsflyer >> build.prop
adb push build.prop /system/build.prop
adb shell chmod 644 /system/build.prop
adb reboot

优势

无需分媒体渠道或厂商单独维护APK。对于在Google Play上架的应用，无需在其代码中添加路径。厂商可以使用自定义路径，并能在不同设备上预装多个应用，且这些应用之间不存在依赖关系。

此方法可确保将激活归因到预装广告系列和媒体渠道。即使用户在打开应用前先进行了更新，或在点击广告后才激活应用，AppsFlyer仍会将预装激活归因到预装渠道或厂商。

缺点

部分工作转移到了渠道和厂商侧，因此开发人员需要确保渠道或厂商完成必要操作。此外，该方法可能会增加开发人员的测试难度。

SDK API方法可以在本机层面指定预装激活的归因厂商或渠道名称。

如需使用SDK API，请在AFApplication类中添加以下方法，在SDK初始化之前调用：

setPreinstallAttribution(String mediaSource, String campaign, String siteId)

与媒体渠道合作时

AppsFlyerLib.getInstance().setPreinstallAttribution("MEDIA_SOURCE_NAME", "CAMPAIGN_NAME", "123");
AppsFlyerLib.getInstance().init(AF_DEV_KEY , conversionListener , getApplicationContext());

与厂商合作时

AppsFlyerLib.getInstance().setPreinstallAttribution(android.os.Build.MANUFACTURER, "CAMPAIGN_NAME", "123");
AppsFlyerLib.getInstance().init(AF_DEV_KEY , conversionListener , getApplicationContext());

优势

您可以使用SDK API以程序化的方式拉取厂商名称信息。无论您与哪个厂商合作，SDK方法都可以直接从设备中读取该厂商的名称。也就是说，即使您与多个厂商合作，也只需要维护一个APK。

您可以使用setPreinstallAttribution方法指定广告系列名称。您可以将各个厂商或媒体渠道划分为不同的广告系列，而不是全都设置为“Pre-install”广告系列。

缺点

如果您直接与厂商合作，就必须维护两个版本的APK，一个用于厂商预装，另一个用于Google Play上架。这两个场景都需要用到多个APK。

如果您通过多个渠道与厂商合作，还需要针对每个渠道维护单独的APK。

预装应用的激活在部分情况下不会被归因到预装媒体渠道：

• 用户使用新设备直接通过Google Play更新预装应用，然后才完成该应用的首次打开，这时AF会将该激活记录为自然量。
• 用户在新设备上点击广告后通过Google Play更新预装应用，这时AF会将该激活归因到展示广告的媒体渠道。

使用这个方法时，您需要在相关应用的Manifest文件中添加元数据标签，并针对每个合作渠道或厂商分别完成该操作。

如需使用该方法，请在关闭应用程序标签之前添加以下元数据标签：

...
    <meta-data android:name="AF_PRE_INSTALL_NAME" android:value="market_name"/>
  </application>
</manifest>

应用首次启动时，AppsFlyer SDK在manifest文件中检测到这个元数据标签，并根据该标签对激活进行归因。

优势

这是一种是较为简便的预装归因方案，只需要在Manifest中添加一个标签便可完成。此外，该方法也不涉及任何渠道或厂商侧的操作。

缺点

由于元数据标签指定了媒体渠道或厂商名称，因此您需要针对每个媒体渠道分别维护一组APK。

预装应用的激活在部分情况下不会被归因到预装媒体渠道：

• 用户使用新设备直接通过Google Play更新预装应用，然后才完成该应用的首次打开，这时AF会将该激活记录为自然量。
• 用户在新设备上点击广告后通过Google Play安装相关应用，这时AF会将该激活归因到投放广告的媒体渠道。

此方法同时涉及开发侧和厂商侧的操作。

开发人员

使用此方法时，您可以指定一个文件路径，该文件中含有预装渠道或厂商的名称。您需要完成三个步骤：

1. 创建一个包含键值对的文件，并将该文件命名为pre_install.appsflyer。在该文件中，以<PACKAGE_NAME>=<MEDIA_SOURCE>的格式配置键值对，如com.appsflyer.sampleapp=my_media_source。
   
   

   传递其他预装参数

   您可以使用JSON在文件中指定其他预安装参数。例如，您可以在pre_install.appsflyer文件中添加以下键值对：

   com.appsflyer.sampleapp={"pid":"huawei", "c":"special_campaign","af_adset":"some_adset"}
   

    重要事项！

   使用此方案时，请务必注意以下事项：

   1. af_channel显示为"Pre-install"
   2. 如果JSON中没有pid，则媒体渠道显示为“无”。
   3. 如果JSON配置中没有c参数，则广告系列名称显示为“Pre-install”
   4. 如果JSON格式有误，则参数中的字符串会作为媒体渠道名称显示。

   pre_install.appsflyer配置完毕后，请将其连同APK一起发送给媒体渠道或设备生产商。

2. 与渠道或厂商讨论该文件的存放路径并达成一致。建议将路径设置为“ /data/local/tmp/pre_install.appsflyer”。
3. 在manifest文件中配置商定的路径。请在关闭应用程序标签之前添加以下代码段：
   

   <meta-data android:name="AF_PRE_INSTALL_PATH" 
         android:value="/data/local/temp/pre_install.appsflyer" />
   

设备生产商

厂商需要将文件放在约定的路径中，并将pre_install.appsflyer的文件权限设置为744。

应用启动后，SDK会读取到manifest文件中指定的路径，并根据该路径找到相应的文件，然后根据其中指定的媒体渠道对激活进行归因。

优势

AppsFlyer会按两个默认路径查找pre_install.appsflyer文件：

/data/local/tmp/pre_install.appsflyer
OR 
/etc/pre_install.appsflyer

部分厂商会选择将文件放在非默认路径中。这时，您可以在manifest文件中指定相应的非默认路径。

缺点

您需要为不同的媒体渠道或厂商维护单独的pre_install.appsflyer文件。

厂商可能希望将pre_install.appsflyer文件放在非默认路径中。在这种情况下，您需要为每个非默认路径维护单独的APK。

如果使用非默认路径，则无法保证预装应用的激活能被归因到预装媒体渠道：

• 用户使用新设备直接通过Google Play更新预装应用，然后才完成该应用的首次打开，这时AF会将该激活记录为自然量。
• 用户在新设备上点击广告后通过Google Play安装相关应用，这时AF会将该激活归因到投放广告的媒体渠道。

在Android Studio中构建应用程序，然后将其安装到测试设备上。应用程序启动后，在Android Studio中打开Logcat，然后按“AppsFlyer”筛选，您会看到被归因的激活及其详细信息。如下图所示：

如果配置成功，则面板中会出现归因到相关厂商或渠道的非自然激活，且该激活会列在“Pre-install”（预装）广告系列下。

进入您的AppsFlyer帐户，打开要测试应用的面板，然后按照以下步骤操作：

1. 在数据总览面板中按媒体渠道筛选数据，并选择相应的渠道：

   

2. 在按广告系列细分图表中，您可以看到被归因到“my media source”的激活来自预装广告系列：
   
   
   您也可以通过汇总效果报告来验证该激活的归因是否正确。在该报告中，您可以看到媒体渠道和广告系列信息。如下图截屏所示，媒体渠道为“My Media Source”，广告系列为Pre-install：
   
   
3. 针对各个预装推广合作厂商和渠道分别完成上述流程。

如果您在同一设备上预装了多个应用，则可以使用以下任一方法来和衡量归因：

• 在Manifest文件中指名——在每个应用的Manifest.xml中都指定媒体渠道或厂商。
• SDK API——在每个应用的SDK API方法中都指定预装渠道或厂商。
• 系统属性或路径——可以在pre_install.appsflyer文件中指定相关应用及其对应的媒体渠道。在该文件中，各应用的信息必须单独占用一行。例如:

  com.appsflyer.tester=market_name
  com.newapp.newapp=market_name
  com.game.king=market_name

如果您的合作渠道或厂商是AppsFlyer的对接渠道，就可以向其发送激活回传。

如需发送激活回传，请确保其媒体渠道名称与AppsFlyer配置的媒体渠道pid一致。

比如您与market_name合作，其pid为market_name_int。您可以在对接渠道的归因链接中查看该pid。

目前代理商尚无法获得预装激活的归因。

如果预装数据中包含af_prt（用于表达代理名称的参数），则用户激活预装应用后：

• 该用户会被归因到代理所使用的媒体渠道（pid=）。
• 广告主可以访问完整的用户级别数据。
• 用户不会归因给代理商。
• 代理商无法访问用户级别数据。