Unity插件V6版本接入指南——基础SDK对接

请从GitHub下载最新版的Unity插件。

您可以使用以下任意一种方式进行安装。

设置所需的Android权限：

请在AndroidManifest.xml中设置以下权限：

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />

API级别为31的应用（对应系统为Android 12）需要在AndroidManifest.xml中添加以下权限，才能读取Android Advertising Identifier（安卓广告标识符）：

<uses-permission android:name="com.google.android.gms.permission.AD_ID" />

• 该密钥是用来识别账户的唯一标识符。某些情况下存在应用层级的密钥。
• Dev key是必填项。

请按以下步骤获取dev key：

1. 从AppsFlyer后台进入配置 > 应用配置 。
2. 获取dev key。

发送事件前的准备工作：

• 指定事件的名称和参数。
• 查看相关列表：
  • 事件名称和结构推荐列表
  • 在AFInAppEvents类中的列表。

【推荐】建议使用事件名称和参数，原因如下：

• 命名标准化：AppsFlyer可以自动将事件映射到Facebook、Google和Twitter等SRN。
• 向后兼容性：即使AppsFlyer后台的事件名称或参数有所变化，仍能正常记录事件。应用内事件的设置是向后兼容的。

在应用内事件中添加af_revenue参数后，便可上报收入。

• af_revenue需要以数值填充，允许出现负值。
• AppsFlyer通过af_revenue参数用统计收入并填充原始数据中的相关字段，以便市场人员在面板中查看收入数据。
• 虽然您也可以使用其他参数发送收入，但是AppsFlyer是无法识别这些收入的。详情请见此文档。
• 收入值中不能带有逗号分隔符、货币符号或文本。
  收入值示例：1234.56

推荐做法：详见货币的设置、显示和换算。

设置收入事件的货币代码时需要注意以下几点：

• 默认货币：USD（美元）
• 必须使用3个字符的ISO 4217代码（示例如下）。
• 可通过调用API设置货币代码：
  

  AppsFlyer.setCurrencyCode("ZZZ")

示例 ：带有收入的应用内购买事件

假设某个购买事件的订单总额为200.12欧元。如果您想要让该事件的收入显示到面板上，就需要用到以下事件名称和参数：

System.Collections.Generic.Dictionary<string, string> purchaseEvent = new 
System.Collections.Generic.Dictionary<string, string> ();
purchaseEvent.Add(AFInAppEvents.CURRENCY, "EUR");
purchaseEvent.Add(AFInAppEvents.REVENUE, "200.12");
purchaseEvent.Add(AFInAppEvents.QUANTITY, "1");
purchaseEvent.Add(AFInAppEvents.CONTENT_TYPE, "category_a",);
AppsFlyer.sendEvent ("af_purchase", purchaseEvent);

记录负收入

您可以使用减号来记录负收入。

• 收入值前面带有减号的收入会记录为负收入。
• 负收入有专用的事件名称，即“cancel_purchase”，便于您在原始数据报告和面板上识别负收入事件。

示例：应用用户收到退款或取消订阅。

System.Collections.Generic.Dictionary<string, string> purchaseEvent = new 
System.Collections.Generic.ictionary<string, string> ();
purchaseEvent.Add(AFInAppEvents.CURRENCY, "USD");
purchaseEvent.Add(AFInAppEvents.REVENUE, "-200");
purchaseEvent.Add(AFInAppEvents.QUANTITY, "1");
purchaseEvent.Add(AFInAppEvents.CONTENT_TYPE, "category_a");
AppsFlyer.sendEvent ("cancel_purchase", purchaseEvent);

该插件可对应用内购进行服务器端验证。

以下是分操作系统的内购验证说明：

#if UNITY_ANDROID && !UNITY_EDITOR
 AppsFlyerAndroid.validateAndSendInAppPurchase(
"publicKey", 
 "signature", 
 "purchaseData", 
 "price", 
 "currency", 
 null, 
 this);
#endif

#if UNITY_IOS && !UNITY_EDITOR
 AppsFlyeriOS.validateAndSendInAppPurchase(
"productIdentifier", 
 "price", 
 "currency", 
 "tranactionId", 
 null, 
 this);
#endif

方法参数

• 事件名称：最多45个字符
• 事件值：不得超过1000个字符，否则数据会被截断
• 应用内事件（及其他API）可使用非英语字符
• 定价和收入：
  • 仅支持数字（可带小数点），例如5或5.2
  • 最多精确到小数点后5位，例如5.12345

您可以通过调用sendEvent来记录应用内事件，并设置事件名称和值参数。
详情请见应用内事件。

示例：如何记录应用内购买事件

请参考分垂类的富应用内事件指南，其中详尽列出了适用于各个垂类的现成代码片段。

System.Collections.Generic.Dictionary<string, string> purchaseEvent = new 
System.Collections.Generic.Dictionary<string, string> ();
purchaseEvent.Add(AFInAppEvents.CURRENCY, "USD");
purchaseEvent.Add(AFInAppEvents.REVENUE, "200");
purchaseEvent.Add(AFInAppEvents.QUANTITY, "2");
purchaseEvent.Add(AFInAppEvents.CONTENT_TYPE, "category_a");
purchaseEvent.Add(AFInAppEvents.CONTENT_ID, "092");
AppsFlyer.sendEvent (AFInAppEvents.PURCHASE, purchaseEvent);

用户在没有网络连接的情况下也可能会触发应用内事件。 AppsFlyer会把这些事件放到缓存中，等到有网络的时候再进行上报。

• 该插件将事件发送到AppsFlyer服务器并等待响应。
• 如果未收到200响应，则将事件存储在缓存中。
• 收到下一个200响应后，再将缓存的事件重新发送到服务器。
• 如果缓存中包含多个事件，则会将其依次发送到服务器。

OneLink:

• 当用户点击链接时识别设备类型（安卓、iOS、PC端等），然后
• 让用户跳转到与其设备对应的地址，如Google Play、iOS应用商店，第三方商店或网页。

详情请见OneLink跳转指南，其中说明了多平台归因链接的使用方式以及深度链接的基础信息。

您可以使用深度链接让现有用户跳转到应用中的具体页面或自定义内容。

使用OneLink实现深度链接需要应用所有者和开发人员共同协作：

• 应用所有者必须在AppsFlyer面板中完成相关操作
• 开发人员必须在应用中完成相关操作

请参阅使用OneLink设置深度链接 。

延迟深度链接可以让新用户在首次打开应用时通过深度链接跳转到应用内指定的页面和自定义内容。

标准的深度链接也可以让用户跳转到应用内指定的页面和自定义内容，但前提是他们的设备上已经安装了该应用。

使用OneLink设置延迟深度链接时：

• 开发人员需要在AppsFlyer后台完成相关操作。
• 延迟深度链接和标准深度链接在AppsFlyer后台的设置是相同的。
• 如需通过深度链接让用户在首次打开应用时跳转到自定义内容，必须在应用中添加相应的逻辑。

详情请见延迟深度链接。

每次安装或深层链接事件后，该插件都会提供转化或互动数据。使用此数据来自定义内容或应用程序的编程行为。

如需接收深度链接数据，请确保：

• 添加回调函数onAppOpenAttribution（在IAppsFlyerConversionData类中）；由AppsFlyer的插件调用。
• 返回的OneLink/归因链接参数触发应用打开。
• 解析参数值并应用逻辑来触发相关的应用页面。

public void onAppOpenAttribution(string attributionData)
 {
 AppsFlyer.AFLog("onAppOpenAttribution", attributionData);
 Dictionary<string, object> attributionDataDictionary = AppsFlyer.CallbackStringToDictionary(attributionData);
 // add direct deeplink logic here
 }

详情请见深度链接数据。

如需获取AppsFlyer转换数据，请完成以下操作：

1. 接入IAppsFlyerConversionDatabase 。
2. 调用initSDK方法，将其作为最后一个参数。
3. 使用onConversionDataSuccess方法实现用户跳转。

onConversionDataSuccess的详情请见API参考信息。

using AppsFlyerSDK;

public class AppsFlyerObjectScript : MonoBehaviour , IAppsFlyerConversionData
{
    void Start()
    {
        /* AppsFlyer.setDebugLog(true); */
        AppsFlyer.initSDK("devkey", "appID", this);
        AppsFlyer.startSDK();
    }

    public void onConversionDataSuccess(string conversionData)
    {
        AppsFlyer.AFLog("onConversionDataSuccess", conversionData);
        Dictionary<string, object> conversionDataDictionary = AppsFlyer.CallbackStringToDictionary(conversionData);
        // add deferred deeplink logic here
    }

    public void onConversionDataFail(string error)
    {
        AppsFlyer.AFLog("onConversionDataFail", error);
    }

    public void onAppOpenAttribution(string attributionData)
    {
        AppsFlyer.AFLog("onAppOpenAttribution", attributionData);
        Dictionary<string, object> attributionDataDictionary = AppsFlyer.CallbackStringToDictionary(attributionData);
        // add direct deeplink logic here
    }

    public void onAppOpenAttributionFailure(string error)
    {
        AppsFlyer.AFLog("onAppOpenAttributionFailure", error);
    }
}

为测试设备加白。

模拟自然和非自然激活。

模拟自然激活

自然激活是未归因到任何渠道的激活，通常是因为用户直接通过应用商店安装并激活应用。请根据相关说明模拟自然激活。

模拟非自然激活

非自然激活是归因到某个渠道的激活，通常是由广告互动促成的激活。请根据相关说明模拟非自然激活。