Send event information

You can use the Adjust Extension for Adobe Experience SDK to send event information to Adjust's servers when your users take specific actions. Adjust records these events and surfaces them in your Datascape reports, server callbacks, and cloud storage uploads.

For more information on configuring events in Adjust, visit the Add events guide in the Help Center.

How it works

Event information is sent to Adjust when the following information is passed to the MobileCore.trackAction API:

1. AdjustAdobeExtension.ADOBE_ADJUST_ACTION_TRACK_EVENT: a string value that maps to the Adjust trackEvent method.
2. contextData: a HashMap of values used to configure your event.

When you call MobileCore.trackAction with these arguments, the Adjust extension creates an event instance, passes it to the trackEvent method, and sends the information to Adjust.

Reference

The contextData HashMap holds information about an event. Each event is represented by a unique contextData HashMap. To configure your event instance, add values to HashMap.

The following keys are supported:

AdjustAdobeExtension.ADOBE_ADJUST_EVENT_TOKEN

Your Adjust event token. You MUST set this value to send event information to Adjust. Check outadd eventsfor more information.

AdjustAdobeExtension.ADOBE_ADJUST_REVENUE

The amount of revenue associated with the event. This value should be a string that represents a numerical value.

AdjustAdobeExtension.ADOBE_ADJUST_CURRENCY.

AnISO 4217currency code.

AdjustAdobeExtension.ADOBE_ADJUST_EVENT_CALLBACK_PARAM_PREFIX

Append a callback parameter key to this prefix and add your callback parameter value to send callbacks to Adjust.

AdjustAdobeExtension.ADOBE_ADJUST_EVENT_PARTNER_PARAM_PREFIX

Append a partner parameter key to this prefix and add your partner parameter value to send callbacks to third parties.

Tutorial: Send an event

To send event information, 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 sendEventToAdjust which will send an event with the following properties:

• An event token: "g3mfiw".
• 1 Euro of event revenue.
• A callback parameter with the key "user_id" and value "855".
• A partner parameter with the key "event_token and value "g3mfiw".

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 sendEventToAdjust(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_EVENT_TOKEN, "g3mfiw");
31
      contextData.put(AdjustAdobeExtension.ADOBE_ADJUST_REVENUE, "1.00");
32
      contextData.put(AdjustAdobeExtension.ADOBE_ADJUST_CURRENCY, "EUR");
33
      contextData.put(AdjustAdobeExtension.ADOBE_ADJUST_EVENT_CALLBACK_PARAM_PREFIX + "user_id", "855");
34
      contextData.put(AdjustAdobeExtension.ADOBE_ADJUST_EVENT_PARTNER_PARAM_PREFIX + "event_token", "g3mfiw");
35

36
      MobileCore.trackAction(action, contextData);
37
   }
38
}

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 com.adobe.marketing.mobile.MobileCore;
   2
   
   3
   import java.util.HashMap;
   4
   import java.util.Map;

2. Next, create a new function inside the MainActivity class called sendEventToAdjust. This function takes the application 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 sendEventToAdjust(View view) {}
   28
   }

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

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

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

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

Now that the contextData HashMap is initialized, add values to build the event. You can refer back to the contextData reference for more information about the uses of each key.

1. Add your Adjust event token to the HashMap using the AdjustAdobeExtension.ADOBE_ADJUST_EVENT_TOKEN key. This is required to inform Adjust which event you're trying to send.

   27
   public void sendEventToAdjust(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_EVENT_TOKEN, "g3mfiw");
   31
   }

2. Add the event revenue amount using AdjustAdobeExtension.ADOBE_ADJUST_REVENUE for the amount and AdjustAdobeExtension.ADOBE_ADJUST_CURRENCY for the currency. Both values MUST be passed as strings.

   27
   public void sendEventToAdjust(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_EVENT_TOKEN, "g3mfiw");
   31
      contextData.put(AdjustAdobeExtension.ADOBE_ADJUST_REVENUE, "1.00");
   32
      contextData.put(AdjustAdobeExtension.ADOBE_ADJUST_CURRENCY, "EUR");
   33
   }

3. Add a callback parameter using the AdjustAdobeExtension.ADOBE_ADJUST_EVENT_CALLBACK_PARAM_PREFIX key. Append a callback identifier to the key to match the parameter in your callback URL.

   27
   public void sendEventToAdjust(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_EVENT_TOKEN, "g3mfiw");
   31
      contextData.put(AdjustAdobeExtension.ADOBE_ADJUST_REVENUE, "1.00");
   32
      contextData.put(AdjustAdobeExtension.ADOBE_ADJUST_CURRENCY, "EUR");
   33
      contextData.put(AdjustAdobeExtension.ADOBE_ADJUST_EVENT_CALLBACK_PARAM_PREFIX + "user_id", "855");
   34
   }

4. Add a partner parameter using the AdjustAdobeExtension.ADOBE_ADJUST_EVENT_PARTNER_PARAM_PREFIX key. Append a callback identifier to the key to map it to your partner's placeholder.

   27
   public void sendEventToAdjust(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_EVENT_TOKEN, "g3mfiw");
   31
      contextData.put(AdjustAdobeExtension.ADOBE_ADJUST_REVENUE, "1.00");
   32
      contextData.put(AdjustAdobeExtension.ADOBE_ADJUST_CURRENCY, "EUR");
   33
      contextData.put(AdjustAdobeExtension.ADOBE_ADJUST_EVENT_CALLBACK_PARAM_PREFIX + "user_id", "855");
   34
      contextData.put(AdjustAdobeExtension.ADOBE_ADJUST_EVENT_PARTNER_PARAM_PREFIX + "event_token", "g3mfiw");
   35
   }

5. Finally, to send the event information to Adjust, call MobileCore.trackAction with your action and contextData variables.

   27
   public void sendEventToAdjust(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_EVENT_TOKEN, "g3mfiw");
   31
      contextData.put(AdjustAdobeExtension.ADOBE_ADJUST_REVENUE, "1.00");
   32
      contextData.put(AdjustAdobeExtension.ADOBE_ADJUST_CURRENCY, "EUR");
   33
      contextData.put(AdjustAdobeExtension.ADOBE_ADJUST_EVENT_CALLBACK_PARAM_PREFIX + "user_id", "855");
   34
      contextData.put(AdjustAdobeExtension.ADOBE_ADJUST_EVENT_PARTNER_PARAM_PREFIX + "event_token", "g3mfiw");
   35
   
   36
      MobileCore.trackAction(action, contextData);
   37
   }

That's it! When the user performs an action that maps to the sendEventToAdjust function, an event is constructed and sent to Adjust.