Send event information

The Adjust SDK provides an ADJEvent object which can be used to structure and send event information from your app to Adjust’s servers.

Instantiate an ADJEvent object

+ (nullable ADJEvent *)eventWithEventToken:(nonnull NSString *)eventToken;

To send event information with the Adjust SDK, you need to instantiate an ADJEvent object. This object contains variables that are sent to Adjust when an event occurs in your app.

To instantiate an event object, create a new ADJEvent instance and pass the following parameters:

eventToken (NSString): Your Adjust event token.

1
let event = ADJEvent(eventToken: "abc123")
2
Adjust.trackEvent(event)

1
ADJEvent *event = [ADJEvent eventWithEventToken:@"abc123"];
2
[Adjust trackEvent:event];

1
var adjustEvent = new AdjustEvent("abc123");
2
Adjust.trackEvent(adjustEvent);

Send an event

+ (void)trackEvent:(nullable ADJEvent *)event;

You can associate your Adjust event tokens to actions in your app to record them. To record an event:

Create a new Adjust event instance and pass your event token as a string argument.
Call the trackEvent method with your event instance as an argument.

1
let event = ADJEvent(eventToken: "abc123")
2
Adjust.trackEvent(event)

1
ADJEvent *event = [ADJEvent eventWithEventToken:@"abc123"];
2
[Adjust trackEvent:event];

1
var adjustEvent = new AdjustEvent("abc123");
2
Adjust.trackEvent(adjustEvent);

Example

This example shows how to record an event with the token g3mfiw whenever a user interacts with a button.

1
import Adjust
2
import UIKit
3

4
class ViewControllerSwift: UIViewController {
5
   @IBOutlet weak var btnRecordEventSimple: UIButton?
6

7
   @IBAction func btnRecordEventSimple(_sender: UIButton) {
8
      let event = ADJEvent(eventToken: "g3mfiw");
9
      Adjust.trackEvent(event);
10
   }
11
}

1
#import "Adjust.h"
2
#import "Constants.h"
3
#import "ViewControllerObjC.h"
4

5
@interface ViewControllerObjC ()
6

7
@property (weak, nonatomic) IBOutlet UIButton *btnRecordDeduplicatedEvent;
8

9
@end
10

11
@implementation ViewControllerObjC
12

13
- (IBAction)clickRecordSimpleEvent:(UIButton *)sender {
14
    ADJEvent *event = [ADJEvent eventWithEventToken: @"g3mfiw"];
15

16
    [Adjust trackEvent:event];
17
}
18

19
@end

1
<html>
2
   <body>
3
      <script>
4
         setupWebViewJavascriptBridge(function(bridge) {
5
            let adjustConfig = new AdjustConfig('2fm9gkqubvpc', AdjustConfig.EnvironmentSandbox);
6
            adjustConfig.setLogLevel(AdjustConfig.LogLevelVerbose);
7

8
            Adjust.appDidLaunch(adjustConfig);
9

10
            var btnRecordDeduplicatedEvent = document.getElementById('btnRecordDeduplicatedEvent')
11
            btnRecordDeduplicatedEvent.onclick = function(e) {
12
                  e.preventDefault()
13
                  var adjustEvent = new AdjustEvent('g3mfiw')
14
                  Adjust.trackEvent(adjustEvent)
15
            }
16
         }
17
      </script>
18
      <div id="buttons">
19
         <div style="width:300px;height:35px;text-align:center;">
20
            <button id="btnRecordDeduplicatedEvent">Record simple event</button>
21
         </div>
22
      </div>
23
   </body>
24
</html>

Path:      /event
ClientSdk: ios4.38.4
Parameters:
  app_token        2fm9gkqubvpc
  app_version      1.0
35 collapsed lines
  attribution_deeplink 1
  callback_params  {"key":"value","foo":"bar"}
  connectivity_type 1
  country          US
  cpu_type         arm64-v8a
  created_at       2024-01-25T14:13:16.151Z+0100
  currency         EUR
  device_manufacturer Apple
  device_type      phone
  display_height   2205
  display_width    1080
  environment      sandbox
  event_buffering_enabled 0
  event_count      3
  event_token      g3mfiw
  hardware_name    UE1A.230829.036
  language         en
  mcc              310
  mnc              260
  needs_response_details 1
  os_build         UE1A.230829.036
  os_name          ios
  os_version       14
  package_name     com.adjust.examples
  partner_params   {"key":"value","foo":"bar"}
  revenue          0.25
  screen_density   high
  screen_format    long
  screen_size      normal
  session_count    2
  session_length   23
  subsession_count 1
  time_spent       23
  tracking_enabled 1
  ui_mode          1

Record event revenue

- (void)setRevenue:(double)amount currency:(nonnull NSString *)currency;

You can record revenue associated with an event by setting the revenue and currency properties on your event instance. Use this feature to record revenue-generating actions in your app.

To set these properties, call the setRevenue method and pass the following arguments:

revenue (double): The amount of revenue generated by the event
currency (NSString): The ISO 4217 code of the event currency.

1
let event = ADJEvent(eventToken: "abc123")
2
event?.setRevenue(0.01, currency: "EUR")
3
Adjust.trackEvent(event)

1
ADJEvent *event = [ADJEvent eventWithEventToken:@"abc123"];
2
[event setRevenue:0.01 currency:@"EUR"];
3
[Adjust trackEvent:event];

1
var adjustEvent = new AdjustEvent(eventToken);
2
adjustEvent.setRevenue(0.01, "EUR");
3
Adjust.trackEvent(adjustEvent);

Example

This example shows how to record an event with the token g3mfiw whenever a user interacts with a button. The function sets the revenue property of this event to 0.25 and the currency property to EUR.

1
import Adjust
2
import UIKit
3

4
class ViewControllerSwift: UIViewController {
5
   @IBOutlet weak var btnRecordEventRevenue: UIButton?
6

7
   @IBAction func btnRecordEventRevenue(_sender: UIButton) {
8
      let event = ADJEvent(eventToken: "g3mfiw");
9
      event?.setRevenue(0.25, currency: "EUR");
10
      Adjust.trackEvent(event);
11
   }
12
}

1
#import "Adjust.h"
2
#import "Constants.h"
3
#import "ViewControllerObjC.h"
4

5
@interface ViewControllerObjC ()
6

7
@property (weak, nonatomic) IBOutlet UIButton *btnRecordRevenueEvent;
8

9
@end
10

11
@implementation ViewControllerObjC
12

13
- (IBAction)clickRecordRevenueEvent:(UIButton *)sender {
14
   ADJEvent *event = [ADJEvent eventWithEventToken:@"g3mfiw"];
15
   [event setRevenue:0.25 currency:@"EUR"];
16
   [Adjust trackEvent:event];
17
}
18

19
@end

1
<html>
2
   <body>
3
      <script>
4
         setupWebViewJavascriptBridge(function(bridge) {
5
            let adjustConfig = new AdjustConfig('2fm9gkqubvpc', AdjustConfig.EnvironmentSandbox);
6
            adjustConfig.setLogLevel(AdjustConfig.LogLevelVerbose);
7

8
            Adjust.appDidLaunch(adjustConfig);
9

10
            var btnRecordRevenueEvent = document.getElementById('btnRecordRevenueEvent')
11
            btnRecordRevenueEvent.onclick = function(e) {
12
                  e.preventDefault()
13
                  var adjustEvent = new AdjustEvent('g3mfiw')
14
                  adjustEvent.setRevenue(0.25, 'EUR')
15
                  Adjust.trackEvent(adjustEvent)
16
            }
17
         }
18
      </script>
19
      <div id="buttons">
20
         <div style="width:300px;height:35px;text-align:center;">
21
            <button id="btnRecordRevenueEvent">Record revenue event</button>
22
         </div>
23
      </div>
24
   </body>
25
</html>

Path:      /event
ClientSdk: ios4.38.4
Parameters:
  environment      sandbox
  event_count      3
  event_token      abc123
  currency         EUR
  revenue          0.25

Deduplicate revenue events

- (void)setTransactionId:(nonnull NSString *)transactionId;

You can pass an optional identifier to avoid recording duplicate events. The SDK stores the last ten identifiers and skips revenue events with duplicate transaction IDs.

To set the identifier, assign your transaction ID to the setTransactionId property of your event instance.

1
let event = ADJEvent(eventToken: "abc123")
2
event?.setTransactionId(transaction.transactionIdentifier)
3
Adjust.trackEvent(event)

1
ADJEvent *event = [ADJEvent eventWithEventToken:@"abc123"];
2
[event setTransactionId:transaction.transactionIdentifier];
3
[Adjust trackEvent:event];

1
var adjustEvent = new AdjustEvent(eventToken);
2
adjustEvent.setTransactionId(orderId);
3
Adjust.trackEvent(adjustEvent);

Example

This example shows how to record an event with the token g3mfiw whenever a user interacts with a button. The function sets the uniqueId to 5e85484b-1ebc-4141-aab7-25b869e54c49 using the setTransactionId method.

1
import Adjust
2
import UIKit
3

4
class ViewControllerSwift: UIViewController {
5
   @IBOutlet weak var btnRecordEventSimple: UIButton?
6

7
   @IBAction func btnRecordEventSimple(_sender: UIButton) {
8
      let event = ADJEvent(eventToken: "g3mfiw");
9
      event.setTransactionId("5e85484b-1ebc-4141-aab7-25b869e54c49")
10
      Adjust.trackEvent(event);
11
   }
12
}

1
#import "Adjust.h"
2
#import "Constants.h"
3
#import "ViewControllerObjC.h"
4

5
@interface ViewControllerObjC ()
6

7
@property (weak, nonatomic) IBOutlet UIButton *btnRecordDeduplicatedEvent;
8

9
@end
10

11
@implementation ViewControllerObjC
12

13
- (IBAction)clickRecordSimpleEvent:(UIButton *)sender {
14
    ADJEvent *event = [ADJEvent eventWithEventToken: @"g3mfiw"];
15
    [event setTransactionId: @"5e85484b-1ebc-4141-aab7-25b869e54c49"]
16
    [Adjust trackEvent:event];
17
}
18

19
@end

1
<html>
2
   <body>
3
      <script>
4
         setupWebViewJavascriptBridge(function(bridge) {
5
            let adjustConfig = new AdjustConfig('2fm9gkqubvpc', AdjustConfig.EnvironmentSandbox);
6
            adjustConfig.setLogLevel(AdjustConfig.LogLevelVerbose);
7

8
            Adjust.appDidLaunch(adjustConfig);
9

10
            var btnRecordDeduplicatedEvent = document.getElementById('btnRecordDeduplicatedEvent')
11
            btnRecordDeduplicatedEvent.onclick = function(e) {
12
                  e.preventDefault()
13
                  var adjustEvent = new AdjustEvent('g3mfiw')
14
                  adjustEvent.setTransactionId("5e85484b-1ebc-4141-aab7-25b869e54c49")
15
                  Adjust.trackEvent(adjustEvent)
16
            }
17
         }
18
      </script>
19
      <div id="buttons">
20
         <div style="width:300px;height:35px;text-align:center;">
21
            <button id="btnRecordDeduplicatedEvent">
22
               Record dedupicated event
23
            </button>
24
         </div>
25
      </div>
26
   </body>
27
</html>

Path:      /event
ClientSdk: ios4.38.4
Parameters:
  environment      sandbox
  event_count      3
  event_token      abc123
  transaction_id   5e85484b-1ebc-4141-aab7-25b869e54c49

Add callback parameters

- (void)addCallbackParameter:(nonnull NSString *)key value:(nonnull NSString *)value;

If you register a callback URL in the Adjust dashboard, the SDK sends a GET request to your callback URL when it records an event.

You can configure callback parameters to send to your servers. Once you configure parameters on an event, the SDK appends them to your callback URL. You can use this information to analyze your users’ in-app behavior with your BI system.

Add callback parameters to your event by calling the addCallbackParameter method with NSString key-value arguments. You can add multiple parameters by calling this method multiple times.

1
let event = ADJEvent(eventToken: "abc123")
2
event?.addCallbackParameter("key", value: "value")
3
event?.addCallbackParameter("foo", value: "bar")
4
Adjust.trackEvent(event)

1
ADJEvent *event = [ADJEvent eventWithEventToken:@"abc123"];
2
[event addCallbackParameter:@"key" value:@"value"];
3
[event addCallbackParameter:@"foo" value:@"bar"];
4
[Adjust trackEvent:event];

1
var adjustEvent = new AdjustEvent(eventToken);
2
adjustEvent.addCallbackParameter("key", "value");
3
adjustEvent.addCallbackParameter("foo", "bar");
4
Adjust.trackEvent(adjustEvent);

The Adjust SDK measures the event and sends a request to your URL with the callback parameters. For example, if you register the URL https://www.mydomain.com/callback, your callback looks like this:

1
https://www.mydomain.com/callback?key=value&foo=bar

If you’re using CSV uploads, make sure to add the parameters to your CSV definition.

Adjust supports many placeholders which you can use to pass information from the SDK to your URL. For example, the {idfa} placeholder for iOS and the {gps_adid} placeholder for Android. The {publisher_parameter} placeholder presents all callback parameters in a single string.

Example

This example shows how to record an event with the token g3mfiw whenever a user interacts with a button. The following callback parameters are added:

The event_token
The revenue_amount generated by the event

The resulting callback URL looks like this:

1
http://www.mydomain.com/callback?event_token=g3mfiw&revenue_amount=0.05

1
import Adjust
2
import UIKit
3

4
class ViewControllerSwift: UIViewController {
5
   @IBOutlet weak var btnRecordEventCallbacks: UIButton?
6

7
   @IBAction func btnRecordEventCallbacks(_sender: UIButton) {
8
      let event = ADJEvent(eventToken: "g3mfiw");
9
      event?.addCallbackParameter("event_token", value: "g3mfiw")
10
      event?.addCallbackParameter("revenue_amount", value: "0.05")
11
      Adjust.trackEvent(event);
12
   }
13
}

#import "Adjust.h"
#import "Constants.h"
#import "ViewControllerObjC.h"

@interface ViewControllerObjC ()

@property (weak, nonatomic) IBOutlet UIButton *btnRecordCallbackEvent;

@end

@implementation ViewControllerObjC

- (IBAction)clickRecordCallbackEvent:(UIButton *)sender {
   ADJEvent *event = [ADJEvent eventWithEventToken:@"g3mfiw"];
   [event addCallbackParameter:@"event_token" value:@"g3mfiw"];
   [event addCallbackParameter:@"revenue_amount" value:@"0.05"];
   [Adjust trackEvent:event];
}

@end

1
<html>
2
   <body>
3
      <script>
4
         setupWebViewJavascriptBridge(function(bridge) {
5
            let adjustConfig = new AdjustConfig('2fm9gkqubvpc', AdjustConfig.EnvironmentSandbox);
6
            adjustConfig.setLogLevel(AdjustConfig.LogLevelVerbose);
7

8
            Adjust.appDidLaunch(adjustConfig);
9

10
            var btnRecordCallbackEvent = document.getElementById('btnRecordCallbackEvent')
11
            btnRecordCallbackEvent.onclick = function(e) {
12
                  e.preventDefault()
13
                  var adjustEvent = new AdjustEvent('g3mfiw');
14
                  adjustEvent.addCallbackParameter('event_token', 'g3mfiw');
15
                  adjustEvent.addCallbackParameter('revenue_amount', '0.05');
16
                  Adjust.trackEvent(adjustEvent);
17
            }
18
         }
19
      </script>
20
      <div id="buttons">
21
         <div style="width:300px;height:35px;text-align:center;">
22
            <button id="btnRecordCallbackEvent">
23
               Record event with callback parameters
24
            </button>
25
         </div>
26
      </div>
27
   </body>
28
</html>

Path:      /event
ClientSdk: ios4.38.4
Parameters:
  callback_params  {"event_token":"g3mfiw","revenue_amount":"0.05"}
  environment      sandbox
  event_count      1
  event_token      g3mfiw

Add partner parameters

- (void)addPartnerParameter:(nonnull NSString *)key value:(nonnull NSString *)value;

You can send extra information to your network partners by adding partner parameters.

Adjust sends partner parameters to external partners you have set up. This information is useful for more granular analysis and retargeting purposes. Adjust’s servers forward these parameters once you have set them up and enabled them for a partner.

Add partner parameters to your event by calling the addPartnerParameter method with NSString key-value arguments. You can add multiple parameters by calling this method multiple times.

1
let event = ADJEvent(eventToken: "abc123")
2
event?.addPartnerParameter("key", value: "value")
3
event?.addPartnerParameter("foo", value: "bar")
4
Adjust.trackEvent(event)

1
ADJEvent *event = [ADJEvent eventWithEventToken:@"abc123"];
2
[event addPartnerParameter:@"key" value:@"value"];
3
[event addPartnerParameter:@"foo" value:@"bar"];
4
[Adjust trackEvent:event];

1
var adjustEvent = new AdjustEvent(eventToken);
2
adjustEvent.addPartnerParameter("key", "value");
3
adjustEvent.addPartnerParameter("foo", "bar");
4
Adjust.trackEvent(adjustEvent);

Example

This example shows how to record an event with the token g3mfiw whenever a user interacts with a button. The following partner parameters are added:

The product_id of the associated product
The user_id of the user who triggered the event

1
import Adjust
2
import UIKit
3

4
class ViewControllerSwift: UIViewController {
5
   @IBOutlet weak var btnRecordEventPartnerParams: UIButton?
6

7
   @IBAction func btnRecordEventPartnerParams(_sender: UIButton) {
8
      let event = ADJEvent(eventToken: "g3mfiw");
9
      event?.addPartnerParameter("product_id", value: "29")
10
      event?.addPartnerParameter("user_id", value: "835")
11
      Adjust.trackEvent(event);
12
   }
13
}

1
#import "Adjust.h"
2
#import "Constants.h"
3
#import "ViewControllerObjC.h"
4

5
@interface ViewControllerObjC ()
6

7
@property (weak, nonatomic) IBOutlet UIButton *btnRecordPartnerParamsEvent;
8

9
@end
10

11
@implementation ViewControllerObjC
12

13
- (IBAction)clickRecordPartnerParamsEvent:(UIButton *)sender {
14
   ADJEvent *event = [ADJEvent eventWithEventToken:@"g3mfiw"];
15
   [event addPartnerParameter:@"product_id" value:@"29"];
16
   [event addPartnerParameter:@"user_id" value:@"835"];
17
   [Adjust trackEvent:event];
18
}
19

20
@end

1
<html>
2
   <body>
3
      <script>
4
         setupWebViewJavascriptBridge(function(bridge) {
5
            let adjustConfig = new AdjustConfig('2fm9gkqubvpc', AdjustConfig.EnvironmentSandbox);
6
            adjustConfig.setLogLevel(AdjustConfig.LogLevelVerbose);
7

8
            Adjust.appDidLaunch(adjustConfig);
9

10
            var btnRecordPartnerParamsEvent = document.getElementById('btnRecordPartnerParamsEvent')
11
            btnRecordPartnerParamsEvent.onclick = function(e) {
12
                  e.preventDefault()
13
                  var adjustEvent = new AdjustEvent('g3mfiw');
14
                  adjustEvent.addPartnerParameter('product_id', '29');
15
                  adjustEvent.addPartnerParameter('user_id', '835');
16
                  Adjust.trackEvent(adjustEvent);
17
            }
18
         }
19
      </script>
20
      <div id="buttons">
21
         <div style="width:300px;height:35px;text-align:center;">
22
            <button id="btnRecordPartnerParamsEvent">
23
               Record event with partner parameters
24
            </button>
25
         </div>
26
      </div>
27
   </body>
28
</html>

Path:      /event
ClientSdk: ios4.38.4
Parameters:
  partner_params  {"product_id":"29","user_id":"835"}
  environment      sandbox
  event_count      1
  event_token      g3mfiw

Add a callback identifier

- (void)setCallbackId:(nonnull NSString *)callbackId;

You can add a custom string identifier to each event you want to measure. Adjust’s servers can report on this identifier in event callbacks. This enables you to keep track of which events have been successfully measured.

Set up this identifier by calling the setCallbackId method with your ID as an NSString argument.

1
let event = ADJEvent(eventToken: "abc123")
2
event?.setCallbackId("Your-Custom-ID")
3
Adjust.trackEvent(event)

1
ADJEvent *event = [ADJEvent eventWithEventToken:@"abc123"];
2
[event setCallbackId:@"Your-Custom-ID"];
3
[Adjust trackEvent:event];

1
var adjustEvent = new AdjustEvent("abc123");
2
adjustEvent.setCallbackId("Your-Custom-ID");
3
Adjust.trackEvent(adjustEvent);

Example

This example shows how to record an event with the token g3mfiw whenever a user interacts with a button. In this example, the callbackId is set to f2e728d8-271b-49ab-80ea-27830a215147.

1
import Adjust
2
import UIKit
3

4
class ViewControllerSwift: UIViewController {
5
   @IBOutlet weak var btnRecordEventCallbackId: UIButton?
6

7
   @IBAction func btnRecordEventCallbackId(_sender: UIButton) {
8
      let event = ADJEvent(eventToken: "g3mfiw");
9
      event?.setCallbackId("f2e728d8-271b-49ab-80ea-27830a215147")
10
      Adjust.trackEvent(event);
11
   }
12
}

1
#import "Adjust.h"
2
#import "Constants.h"
3
#import "ViewControllerObjC.h"
4

5
@interface ViewControllerObjC ()
6

7
@property (weak, nonatomic) IBOutlet UIButton *btnRecordCallbackIdEvent;
8

9
@end
10

11
@implementation ViewControllerObjC
12

13
- (IBAction)clickRecordCallbackIdEvent:(UIButton *)sender {
14
   ADJEvent *event = [ADJEvent eventWithEventToken:@"g3mfiw"];
15
   [event setCallbackId:@"f2e728d8-271b-49ab-80ea-27830a215147"];
16
   [Adjust trackEvent:event];
17
}
18

19
@end

1
<html>
2
   <body>
3
      <script>
4
         setupWebViewJavascriptBridge(function(bridge) {
5
            let adjustConfig = new AdjustConfig('2fm9gkqubvpc', AdjustConfig.EnvironmentSandbox);
6
            adjustConfig.setLogLevel(AdjustConfig.LogLevelVerbose);
7

8
            Adjust.appDidLaunch(adjustConfig);
9

10
            var btnRecordCallbackIdEvent = document.getElementById('btnRecordCallbackIdEvent')
11
            btnRecordCallbackIdEvent.onclick = function(e) {
12
                  e.preventDefault()
13
                  var adjustEvent = new AdjustEvent('g3mfiw');
14
                  adjustEvent.setCallbackId('f2e728d8-271b-49ab-80ea-27830a215147');
15
                  Adjust.trackEvent(adjustEvent);
16
            }
17
         }
18
      </script>
19
      <div id="buttons">
20
         <div style="width:300px;height:35px;text-align:center;">
21
            <button id="btnRecordCallbackIdEvent">
22
               Record event with callback ID
23
            </button>
24
         </div>
25
      </div>
26
   </body>
27
</html>

Path:      /event
ClientSdk: ios4.38.4
Parameters:
  callback_id      f2e728d8-271b-49ab-80ea-27830a215147
  environment      sandbox
  event_count      1
  event_token      g3mfiw