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.track API:

1. ADJAdobeAdjustActionTrackEvent: a string value that maps to the Adjust trackEvent method.
2. data: a dictionary of values used to configure your event.

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

Reference

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

The following keys are supported:

ADJAdobeAdjustEventToken

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

ADJAdobeAdjustEventRevenue

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

ADJAdobeAdjustEventCurrency.

AnISO 4217currency code.

ADJAdobeAdjustEventCallbackParamPrefix

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

ADJAdobeAdjustEventPartnerParamPrefix

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 your View Controller from the integration guide and send a new event to Adjust 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 AEPCore
2
import AdjustAdobeExtension
3

4
class ViewController: UIViewController {
5

6
   override func viewDidLoad() {
7
      super.viewDidLoad()
8

9
      var dataDict: Dictionary = [String : String]()
10
      dataDict[ADJAdobeAdjustEventToken] = "g3mfiw"
11
      dataDict[ADJAdobeAdjustEventRevenue] = "0.01"
12
      dataDict[ADJAdobeAdjustEventCurrency] = "EUR"
13
      dataDict[ADJAdobeAdjustEventCallbackParamPrefix.appending("user_id")] = "855"
14
      dataDict[ADJAdobeAdjustEventPartnerParamPrefix.appending("event_token")] = "g3mfiw"
15
      MobileCore.track(action: ADJAdobeAdjustActionTrackEvent, data: dataDict)
16
   }
17
}

1
#import "ViewController.h"
2
@import AEPCore;
3
#import <AdjustAdobeExtension/AdjustAdobeExtension.h>
4

5
@implementation ViewController
6

7
- (void)viewDidLoad {
8
   [super viewDidLoad];
9

10
   NSMutableDictionary * dataDict = [NSMutableDictionary dictionary];
11
   [dataDict setValue:@"g3mfiw" forKey:ADJAdobeAdjustEventToken];
12
   [dataDict setValue:@"1.0" forKey:ADJAdobeAdjustEventRevenue];
13
   [dataDict setValue:@"EUR" forKey:ADJAdobeAdjustEventCurrency];
14
   [dataDict setValue:@"855" forKey:[ADJAdobeAdjustEventCallbackParamPrefix stringByAppendingString:@"user_id"]];
15
   [dataDict setValue:@"855" forKey:[ADJAdobeAdjustEventPartnerParamPrefix stringByAppendingString:@"event_token"]];
16
   [AEPMobileCore trackAction:ADJAdobeAdjustActionTrackEvent
17
                        data:dataDict];
18
   [dataDict removeAllObjects];
19
}
20

21
@end

Here's what you need to do:

1. Inside your viewDidLoad function block, create a new dictionary called dataDict. This is used to hold the properties of the event.

   • Swift
   • Objective-C

   6
   override func viewDidLoad() {
   7
      super.viewDidLoad()
   8
   
   9
      var dataDict: Dictionary = [String : String]()
   10
   }

   6
   - (void)viewDidLoad {
   7
      [super viewDidLoad];
   8
   
   9
      NSMutableDictionary * dataDict = [NSMutableDictionary dictionary];
   10
   }

2. Add your Adjust event token to the dictionary using the ADJAdobeAdjustEventToken key. This is required to inform Adjust which event you're trying to send.

   • Swift
   • Objective-C

   6
   override func viewDidLoad() {
   7
      super.viewDidLoad()
   8
   
   9
      var dataDict: Dictionary = [String : String]()
   10
      dataDict[ADJAdobeAdjustEventToken] = "g3mfiw"
   11
   }

   6
   - (void)viewDidLoad {
   7
      [super viewDidLoad];
   8
   
   9
      NSMutableDictionary * dataDict = [NSMutableDictionary dictionary];
   10
      [dataDict setValue:@"g3mfiw" forKey:ADJAdobeAdjustEventToken];
   11
   }

3. Add the event revenue amount using ADJAdobeAdjustEventRevenue for the amount and ADJAdobeAdjustEventCurrency for the currency. Both values MUST be passed as strings.

   • Swift
   • Objective-C

   6
   override func viewDidLoad() {
   7
      super.viewDidLoad()
   8
   
   9
      var dataDict: Dictionary = [String : String]()
   10
      dataDict[ADJAdobeAdjustEventToken] = "g3mfiw"
   11
      dataDict[ADJAdobeAdjustEventRevenue] = "0.01"
   12
      dataDict[ADJAdobeAdjustEventCurrency] = "EUR"
   13
   }

   6
   - (void)viewDidLoad {
   7
      [super viewDidLoad];
   8
   
   9
      NSMutableDictionary * dataDict = [NSMutableDictionary dictionary];
   10
      [dataDict setValue:@"g3mfiw" forKey:ADJAdobeAdjustEventToken];
   11
      [dataDict setValue:@"1.0" forKey:ADJAdobeAdjustEventRevenue];
   12
      [dataDict setValue:@"EUR" forKey:ADJAdobeAdjustEventCurrency];
   13
   }

4. Add a callback parameter using the ADJAdobeAdjustEventCallbackParamPrefix key. Append a callback identifier to the key to match the parameter in your callback URL.

   • Swift
   • Objective-C

   6
   override func viewDidLoad() {
   7
      super.viewDidLoad()
   8
   
   9
      var dataDict: Dictionary = [String : String]()
   10
      dataDict[ADJAdobeAdjustEventToken] = "g3mfiw"
   11
      dataDict[ADJAdobeAdjustEventRevenue] = "0.01"
   12
      dataDict[ADJAdobeAdjustEventCurrency] = "EUR"
   13
      dataDict[ADJAdobeAdjustEventCallbackParamPrefix.appending("user_id")] = "855"
   14
   }

   6
   - (void)viewDidLoad {
   7
      [super viewDidLoad];
   8
   
   9
      NSMutableDictionary * dataDict = [NSMutableDictionary dictionary];
   10
      [dataDict setValue:@"g3mfiw" forKey:ADJAdobeAdjustEventToken];
   11
      [dataDict setValue:@"1.0" forKey:ADJAdobeAdjustEventRevenue];
   12
      [dataDict setValue:@"EUR" forKey:ADJAdobeAdjustEventCurrency];
   13
      [dataDict setValue:@"855" forKey:[ADJAdobeAdjustEventCallbackParamPrefix stringByAppendingString:@"user_id"]];
   14
   }

5. Add a partner parameter using the ADJAdobeAdjustEventPartnerParamPrefix key. Append a callback identifier to the key to map it to your partner's placeholder.

   • Swift
   • Objective-C

   6
   override func viewDidLoad() {
   7
      super.viewDidLoad()
   8
   
   9
      var dataDict: Dictionary = [String : String]()
   10
      dataDict[ADJAdobeAdjustEventToken] = "g3mfiw"
   11
      dataDict[ADJAdobeAdjustEventRevenue] = "0.01"
   12
      dataDict[ADJAdobeAdjustEventCurrency] = "EUR"
   13
      dataDict[ADJAdobeAdjustEventCallbackParamPrefix.appending("user_id")] = "855"
   14
      dataDict[ADJAdobeAdjustEventPartnerParamPrefix.appending("event_token")] = "g3mfiw"
   15
   }

   6
   - (void)viewDidLoad {
   7
      [super viewDidLoad];
   8
   
   9
      NSMutableDictionary * dataDict = [NSMutableDictionary dictionary];
   10
      [dataDict setValue:@"g3mfiw" forKey:ADJAdobeAdjustEventToken];
   11
      [dataDict setValue:@"1.0" forKey:ADJAdobeAdjustEventRevenue];
   12
      [dataDict setValue:@"EUR" forKey:ADJAdobeAdjustEventCurrency];
   13
      [dataDict setValue:@"855" forKey:[ADJAdobeAdjustEventCallbackParamPrefix stringByAppendingString:@"user_id"]];
   14
      [dataDict setValue:@"855" forKey:[ADJAdobeAdjustEventPartnerParamPrefix stringByAppendingString:@"event_token"]];
   15
   }

6. Finally, to send the event information to Adjust, call MobileCore.track with ADJAdobeAdjustActionTrackEvent and your dataDict dictionary. If you're using Objective-C, call removeAllObjects on your dataDict dictionary to deallocate it.

   • Swift
   • Objective-C

   6
   override func viewDidLoad() {
   7
      super.viewDidLoad()
   8
   
   9
      var dataDict: Dictionary = [String : String]()
   10
      dataDict[ADJAdobeAdjustEventToken] = "g3mfiw"
   11
      dataDict[ADJAdobeAdjustEventRevenue] = "0.01"
   12
      dataDict[ADJAdobeAdjustEventCurrency] = "EUR"
   13
      dataDict[ADJAdobeAdjustEventCallbackParamPrefix.appending("user_id")] = "855"
   14
      dataDict[ADJAdobeAdjustEventPartnerParamPrefix.appending("event_token")] = "g3mfiw"
   15
      MobileCore.track(action: ADJAdobeAdjustActionTrackEvent, data: dataDict)
   16
   }

   6
   - (void)viewDidLoad {
   7
      [super viewDidLoad];
   8
   
   9
      NSMutableDictionary * dataDict = [NSMutableDictionary dictionary];
   10
      [dataDict setValue:@"g3mfiw" forKey:ADJAdobeAdjustEventToken];
   11
      [dataDict setValue:@"1.0" forKey:ADJAdobeAdjustEventRevenue];
   12
      [dataDict setValue:@"EUR" forKey:ADJAdobeAdjustEventCurrency];
   13
      [dataDict setValue:@"855" forKey:[ADJAdobeAdjustEventCallbackParamPrefix stringByAppendingString:@"user_id"]];
   14
      [dataDict setValue:@"855" forKey:[ADJAdobeAdjustEventPartnerParamPrefix stringByAppendingString:@"event_token"]];
   15
      [AEPMobileCore trackAction:ADJAdobeAdjustActionTrackEvent
   16
                     data:dataDict];
   17
      [dataDict removeAllObjects];
   18
   }

That's it! Your View Controller constructs an event and sends to Adjust.