We constantly publish updates to our documentation, which may not yet be available in your language. For the most current information, use the English version.

开发者

归因回传

您可以注册一个委托回传，以获取跟踪链接归因变化的通知。Adjust SDK 无法同步提供此信息。这是因为归因时需要考虑不同的来源。

请按照本文中的步骤在应用中安装可选委托协议。

重要提示:

启用 SDK 前，您需要将归因回传添加到 config 实例。

Java

AdjustConfig config = new AdjustConfig(this, appToken, environment);

config.setOnAttributionChangedListener(new OnAttributionChangedListener() {
    @Override
    public void onAttributionChanged(AdjustAttribution attribution) {}
});

Adjust.onCreate(config);

Javascript

function attributionCallback(attribution) {}

// ...

let adjustConfig = new AdjustConfig(yourAppToken, environment);
adjustConfig.setAttributionCallback(attributionCallback);
Adjust.onCreate(adjustConfig);

SDK 接收到最终归因数据后，会调用监听器。在监听器函数内，您可以访问 AdjustAttribution 对象。以下是其属性的摘要：

所有属性都以 JSON 对象的形式返回。任何未填充的值都会返回 nil。

请注意:

只有在 config 对象的 needsCost 属性设为 true的情况下，成本数据 (costType、costAmount 和 costCurrency) 才可用。

值	数据类型	描述
`trackerToken`	字符串	设备当前归因跟踪链接的跟踪码
`trackerName`	字符串	设备当前归因跟踪链接的名称
`network`	字符串	设备当前归因渠道的名称
`campaign`	字符串	设备当前归因推广活动的名称
`adgroup`	字符串	设备当前归因广告组的名称
`creative`	字符串	设备当前归因素材的名称
`clickLabel`	字符串	安装被标记的点击标签
`adid`	字符串	设备的唯一 Adjust ID
`costType`	字符串	推广活动定价模型 (如 cpi)
`costAmount`	数字	安装成本
`costCurrency`	字符串	成本相关的货币代码。应符合 ISO 4217 标准且包含 3 个字符。
`fbInstallReferrer`	字符串	Facebook Install Referrer 信息。如果安装来自 Facebook 广告，则此处会被填充。

Facebook install referrer

Adjust SDK 通过 AdjustAttribution 对象字符串属性的形式接收 Facebook install referrer 信息。您可以将此内容作为 JSON 对象序列化，以此获取此信息。

Java

config.setOnAttributionChangedListener(new OnAttributionChangedListener() {
      @Override
      public void onAttributionChanged(AdjustAttribution adjustAttribution) {
        JSONObject fbInstallReferrerJSONObject = extractFBInstallReferrerJSON(adjustAttribution);
      }
});

@Nullable
JSONObject extractFBInstallReferrerJSON(AdjustAttribution adjustAttribution) {
  try {
    return new JSONObject(adjustAttribution.fbInstallReferrer);  
} catch (JSONException e) {
    Log.d("example", e.getMessage());  
  }
  return null;
}

Kotlin

config.setOnAttributionChangedListener {
    val fbInstallReferrerJSONObject = extractFBInstallReferrerJSON(it)
}

fun extractFBInstallReferrerJSON(adjustAttribution: AdjustAttribution): JSONObject? {
    try {
        return JSONObject(adjustAttribution.fbInstallReferrer)
    } catch (e: JSONException) {
        Log.d("example", e.message!!)
    }
    return null
}

用户归因

请注意:

此功能在 Adjust SDK v4.11.0 及更新版本中可用。

您可以调用Adjust.getAttribution方法来获取用户的当前归因。此操作会返回AdjustAttribution对象中发现的所有信息。

Java

Javascript

请注意:

后端跟踪到安装后，当前归因数据即可用。归因回传会为您调取此信息。