Send push tokens

Push notifications enable you to deliver personalized content to your users. You can use deep links to direct users to specific pages in your app, and measure reattributions.

• The push token is a unique identifier that can be used to sort Audiences and client callbacks.
• Push tokens are also required for uninstall and reinstall measurement.

How it works

Each device generates a unique push token that's used to target it. The push token is sent to Adjust when the following information is passed to the MobileCore.trackAction API:

1. AdjustAdobeExtension.ADOBE_ADJUST_ACTION_SET_PUSH_TOKEN: a string constant that maps to the setPushToken method.
2. contextData: a HashMap of values used to configure your push token.

When you call MobileCore.trackAction with these arguments, the Adjust extension the token to the setPushToken method and sends the information to Adjust.

Reference

The contextData HashMap holds information about an action. To configure your push token, add the following key-value pair to your HashMap.

AdjustAdobeExtension.ADOBE_ADJUST_PUSH_TOKEN

The device's push token.

Example: Send a push token

To send a push token to Adjust, you need to add a function to your main activity. In this tutorial, you'll build on MainActivity.java from the integration guide and add a new function called sendPushTokenToAdjust which will send an updated push token to Adjust. The final result looks like this:

1
import android.content.Intent;
2
import android.net.Uri;
3
import android.os.Bundle;
4
import android.view.View;
5

6
import androidx.appcompat.app.AppCompatActivity;
7

8
import com.adjust.sdk.Adjust;
9
import com.adjust.sdk.AdjustDeeplink;
10
import com.adobe.marketing.mobile.MobileCore;
11

12
import java.util.HashMap;
13
import java.util.Map;
14

15
public class MainActivity extends AppCompatActivity {
16
   @Override
17
   protected void onCreate(Bundle savedInstanceState) {
18
      super.onCreate(savedInstanceState);
19
      setContentView(R.layout.activity_main);
20

21
      Intent intent = getIntent();
22
      Uri data = intent.getData();
23
      AdjustDeeplink adjustDeeplink = new AdjustDeeplink(data);
24
      Adjust.processDeeplink(adjustDeeplink, getApplicationContext());
25
   }
26

27
   public void sendPushTokenToAdjust(View view) {
28
      String action = AdjustAdobeExtension.ADOBE_ADJUST_ACTION_TRACK_EVENT;
29
      Map<String, String> contextData = new HashMap<String, String>();
30
      contextData.put(AdjustAdobeExtension.ADOBE_ADJUST_PUSH_TOKEN, "de18dbf8-f38a-4962-8f1e-44abcf43055d");
31

32
      MobileCore.trackAction(action, contextData);
33
   }
34
}

Here's what you need to do:

1. First, import the following classes:

   • com.adobe.marketing.mobile.MobileCore: this class is used to send information to Adobe and Adjust.
   • java.util.HashMap: this class is used to generate the contextData HashMap.
   • java.util.Map: this class is used to type the contextData HashMap.

   1
   import android.content.Intent;
   2
   import android.net.Uri;
   3
   import android.os.Bundle;
   4
   import android.view.View;
   5
   
   6
   import androidx.appcompat.app.AppCompatActivity;
   7
   
   8
   import com.adjust.sdk.Adjust;
   9
   import com.adjust.sdk.AdjustDeeplink;
   10
   import com.adobe.marketing.mobile.MobileCore;
   11
   
   12
   import java.util.HashMap;
   13
   import java.util.Map;

2. Next, create a new function inside the MainActivity class called sendPushTokenToAdjust. This function takes a View as an argument and returns void.

   15
   public class MainActivity extends AppCompatActivity {
   16
      @Override
   17
      protected void onCreate(Bundle savedInstanceState) {
   18
         super.onCreate(savedInstanceState);
   19
         setContentView(R.layout.activity_main);
   20
   
   21
         Intent intent = getIntent();
   22
         Uri data = intent.getData();
   23
         AdjustDeeplink adjustDeeplink = new AdjustDeeplink(data);
   24
         Adjust.processDeeplink(adjustDeeplink, getApplicationContext());
   25
      }
   26
   
   27
      public void sendPushTokenToAdjust(View view) {}
   28
   }

3. Inside the sendPushTokenToAdjust function, declare a new String variable called action and assign it the value AdjustAdobeExtension.ADOBE_ADJUST_ACTION_SET_PUSH_TOKEN. This is used to tell MobileCore.trackAction which action to handle.

   27
   public void sendPushTokenToAdjust(View view) {
   28
      String action = AdjustAdobeExtension.ADOBE_ADJUST_ACTION_SET_PUSH_TOKEN;
   29
   }

4. Create a new HashMap variable called contextData. This is used to hold the properties of the action.

   27
   public void sendPushTokenToAdjust(View view) {
   28
      String action = AdjustAdobeExtension.ADOBE_ADJUST_ACTION_SET_PUSH_TOKEN;
   29
      Map<String, String> contextData = new HashMap<String, String>();
   30
   }

5. Add your push token to the HashMap using the AdjustAdobeExtension.ADOBE_ADJUST_PUSH_TOKEN key. This example sets the push token to "de18dbf8-f38a-4962-8f1e-44abcf43055d".

   27
   public void sendPushTokenToAdjust(View view) {
   28
      String action = AdjustAdobeExtension.ADOBE_ADJUST_ACTION_TRACK_EVENT;
   29
      Map<String, String> contextData = new HashMap<String, String>();
   30
      contextData.put(AdjustAdobeExtension.ADOBE_ADJUST_PUSH_TOKEN, "de18dbf8-f38a-4962-8f1e-44abcf43055d");
   31
   }

6. Finally, call MobileCore.trackAction with your action and contextData variables to send the push token to Adjust.

   27
   public void sendPushTokenToAdjust(View view) {
   28
      String action = AdjustAdobeExtension.ADOBE_ADJUST_ACTION_TRACK_EVENT;
   29
      Map<String, String> contextData = new HashMap<String, String>();
   30
      contextData.put(AdjustAdobeExtension.ADOBE_ADJUST_PUSH_TOKEN, "de18dbf8-f38a-4962-8f1e-44abcf43055d");
   31
   
   32
      MobileCore.trackAction(action, contextData);
   33
   }

That's it! When the user performs an action that maps to the sendPushTokenToAdjust function, your push token is sent to Adjust.