获取归因信息

用户与 Adjust 链接交互时，其归因信息会发生更新。用户与深度链接交互时可能会发生这种情况。用户归因相关信息会在 AdjustAttribution 类中展现。

AdjustAttribution 类属性

AdjustAttribution 类包含设备当前归因状态的细节。任何未针对用户填充的值都会返回 null 值。

值	数据类型	描述
`trackerToken`	`String`	设备当前归因链接的识别码
`trackerName`	`String`	设备当前归因链接的名称
`network`	`String`	设备当前归因渠道的名称
`campaign`	`String`	设备当前归因推广活动的名称
`adgroup`	`String`	设备当前归因广告组的名称
`creative`	`String`	设备当前归因素材的名称
`clickLabel`	`String`	用于标记安装的点击标签
`costType`	`String`	推广活动定价模型 (如 cpi)
`costAmount`	`Double`	安装成本
`costCurrency`	`String`	与成本关联的货币的 3 字符 ISO 4217 代码。
`fbInstallReferrer`	`String`	Facebook install referrer，
`jsonResponse`	`String`	后端发送给 SDK 的归因响应。

发生归因变化时触发函数

public void setOnAttributionChangedListener(OnAttributionChangedListener onAttributionChangedListener)

SDK 可监听归因变更并在发现更新时调用一个函数。要配置您的回传函数，请使用函数名称作为参数调用setOnAttributionChangedListener方法。

Kotlin
Java

1
val config = AdjustConfig(this, appToken, environment)
2
//...
3
config.setOnAttributionChangedListener {
4
   override fun onAttributionChanged(attribution: AdjustAttribution) {}
5
   }
6
//...
7
Adjust.initSdk(config)

1
AdjustConfig config = new AdjustConfig(this, appToken, environment);
2
//...
3
config.setOnAttributionChangedListener(new OnAttributionChangedListener() {
4
   @Override
5
   public void onAttributionChanged(AdjustAttribution attribution) {}
6
});
7
//...
8
Adjust.initSdk(config);

Facebook install referrer

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

Kotlin
Java

1
val config = AdjustConfig(this, appToken, environment)
2
//...
3
config.setOnAttributionChangedListener {
4
   val fbInstallReferrerJSONObject = extractFBInstallReferrerJSON(it)
5
}
6

7
fun extractFBInstallReferrerJSON(adjustAttribution: AdjustAttribution): JSONObject? {
8
   try {
9
      return JSONObject(adjustAttribution.fbInstallReferrer)
10
   } catch (e: JSONException) {
11
      Log.d("example", e.message!!)
12
   }
13
   return null
14
}
15
//...
16
Adjust.initSdk(config)

1
AdjustConfig config = new AdjustConfig(this, appToken, environment);
2
//...
3
config.setOnAttributionChangedListener(new OnAttributionChangedListener() {
4
   @Override
5
   public void onAttributionChanged(AdjustAttribution adjustAttribution) {
6
   JSONObject fbInstallReferrerJSONObject = extractFBInstallReferrerJSON(adjustAttribution);
7
   }
8
});
9

10
@Nullable
11
JSONObject extractFBInstallReferrerJSON(AdjustAttribution adjustAttribution) {
12
   try {
13
      return new JSONObject(adjustAttribution.fbInstallReferrer);
14
   } catch (JSONException e) {
15
      Log.d("example", e.getMessage());
16
   }
17
   return null;
18
}
19
//...
20
Adjust.initSdk(config);

获取当前归因信息

public static void getAttribution(final OnAttributionReadListener attributionReadListener)

用户安装您的应用时，Adjust 会将该安装归因至一个推广活动。Adjust SDK 可提供赢得安装归因的推广活动细节。要返回此信息，请将监听器函数传递至Adjust.getAttribution方法。 SDK 会异步提取信息并将其作为AdjustAttribution对象传递至您的监听器函数。

Kotlin
Java

1
Adjust.getAttribution {attribution ->
2
            // read attribution
3
        }

1
Adjust.getAttribution(new OnAttributionReadListener() {
2
    @Override
3
    public void onAttributionRead(AdjustAttribution attribution) {
4
    }
5
});

获取带有超时值的当前归因信息

public static void getAttributionWithTimeout(final Context context, final long timeoutInMilliSec, final OnAttributionReadListener attributionReadListener)

您也可以同时提供监听器函数和超时值 (以毫秒为单位)，通过调用 Adjust.getAttributionWithTimeout 请求当前归因信息。如果 SDK 在指定的时限内检索到归因数据，则会将其作为 AdjustAttribution 对象提供给您的监听器，否则会将 null 发送给您的监听器。

Kotlin
Java

1
Adjust.getAttributionWithTimeout {context, timeoutInMilliSec, attribution ->
2
            // read attribution
3
        }

1
Adjust.getAttributionWithTimeout(context, timeoutInMilliSec, new OnAttributionReadListener() {
2
    @Override
3
    public void onAttributionRead(AdjustAttribution attribution) {
4
    }
5
});