adjust-icon

发送推送标签 (Push token)

借助推送通知,您可以为客户提供个性化的内容。而使用深度链接,您可以将用户转到应用中的特定页面,并开展再归因监测。

  • 推送标签 (Push token) 是一种唯一的标识符,可用来对受众和客户端回传进行排序。
  • 卸载和重装监测也需要推送标签 (Push token)。

工作原理

每个设备都会生成唯一的推送标签,用于该设备的定向。下列信息被传递至 MobileCore.trackAction API 时,推送标签将被发送至 Adjust:

  1. AdjustAdobeExtension.ADOBE_ADJUST_ACTION_SET_PUSH_TOKEN: 映射到 setPushToken 方法的字符串常数。
  2. contextData: 用于配置推送标签的值 HashMap。

当您使用这些参数调用 MobileCore.trackAction 时,Adjust 会将识别码扩展至 setPushToken 方法,并向 Adjust 发送信息。

参考

contextData HashMap 中包含有关操作的信息。要配置您的推送标签 (Push token),请将下列键值对添加至您的 HashMap。

AdjustAdobeExtension.ADOBE_ADJUST_PUSH_TOKEN

设备的推送标签。

示例:发送推送标签

要向 Adjust 发送推送标签 (Push token),您需要向主要活动 (main activity) 添加一个函数。参阅本教程,您将以集成指南中的 MainActivity.java 为基础,添加一个名为 sendPushTokenToAdjust 的新函数,并通过该函数向 Adjust 发送更新后的推送标签。最终结果将如下:

MainActivity.java
import android.content.Intent;
import android.net.Uri;
import android.os.Bundle;
import android.view.View;
import androidx.appcompat.app.AppCompatActivity;
import com.adjust.sdk.Adjust;
import com.adjust.sdk.AdjustDeeplink;
import com.adobe.marketing.mobile.MobileCore;
import java.util.HashMap;
import java.util.Map;
public class MainActivity extends AppCompatActivity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
Intent intent = getIntent();
Uri data = intent.getData();
AdjustDeeplink adjustDeeplink = new AdjustDeeplink(data);
Adjust.processDeeplink(adjustDeeplink, getApplicationContext());
}
public void sendPushTokenToAdjust(View view) {
String action = AdjustAdobeExtension.ADOBE_ADJUST_ACTION_TRACK_EVENT;
Map<String, String> contextData = new HashMap<String, String>();
contextData.put(AdjustAdobeExtension.ADOBE_ADJUST_PUSH_TOKEN, "de18dbf8-f38a-4962-8f1e-44abcf43055d");
MobileCore.trackAction(action, contextData);
}
}

您需要进行下列操作:

  1. 首先导入下列类:
    • com.adobe.marketing.mobile.MobileCore: 用于向 Adobe 和 Adjust 发送信息的类。
    • java.util.HashMap: 用于生成 contextData HashMap 的类。
    • java.util.Map: 用于输入 contextData HashMap 的类。
MainActivity.java
import android.content.Intent;
import android.net.Uri;
import android.os.Bundle;
import android.view.View;
import androidx.appcompat.app.AppCompatActivity;
import com.adjust.sdk.Adjust;
import com.adjust.sdk.AdjustDeeplink;
import com.adobe.marketing.mobile.MobileCore;
import java.util.HashMap;
import java.util.Map;
  1. 接下来,在 MainActivity 类中创建一个名为 sendPushTokenToAdjust 的新函数。该函数接受 View 作为参数并返回 void.
MainActivity.java
public class MainActivity extends AppCompatActivity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
Intent intent = getIntent();
Uri data = intent.getData();
AdjustDeeplink adjustDeeplink = new AdjustDeeplink(data);
Adjust.processDeeplink(adjustDeeplink, getApplicationContext());
}
public void sendPushTokenToAdjust(View view) {}
}
  1. sendPushTokenToAdjust 函数中,声明一个名为 action 的新 String 变量,并为其指定值 AdjustAdobeExtension.ADOBE_ADJUST_ACTION_SET_PUSH_TOKEN,用于指示 MobileCore.trackAction 要处理的操作。
MainActivity.java
public void sendPushTokenToAdjust(View view) {
String action = AdjustAdobeExtension.ADOBE_ADJUST_ACTION_SET_PUSH_TOKEN;
}
  1. 创建一个名为 contextData 的新 HashMap 变量,用于保存操作的属性。
MainActivity.java
public void sendPushTokenToAdjust(View view) {
String action = AdjustAdobeExtension.ADOBE_ADJUST_ACTION_SET_PUSH_TOKEN;
Map<String, String> contextData = new HashMap<String, String>();
}
  1. 使用 AdjustAdobeExtension.ADOBE_ADJUST_PUSH_TOKEN 键将推送标签加入 HashMap。在该示例中,推送标签为 "de18dbf8-f38a-4962-8f1e-44abcf43055d"
MainActivity.java
public void sendPushTokenToAdjust(View view) {
String action = AdjustAdobeExtension.ADOBE_ADJUST_ACTION_TRACK_EVENT;
Map<String, String> contextData = new HashMap<String, String>();
contextData.put(AdjustAdobeExtension.ADOBE_ADJUST_PUSH_TOKEN, "de18dbf8-f38a-4962-8f1e-44abcf43055d");
}
  1. 最后,使用 actioncontextData 变量调用 MobileCore.trackAction ,将推送标签发送至 Adjust。
MainActivity.java
public void sendPushTokenToAdjust(View view) {
String action = AdjustAdobeExtension.ADOBE_ADJUST_ACTION_TRACK_EVENT;
Map<String, String> contextData = new HashMap<String, String>();
contextData.put(AdjustAdobeExtension.ADOBE_ADJUST_PUSH_TOKEN, "de18dbf8-f38a-4962-8f1e-44abcf43055d");
MobileCore.trackAction(action, contextData);
}

完成了!当用户执行映射到 sendPushTokenToAdjust 函数的操作时,您的推送标签就会被发送至 Adjust。