Analytics API reference

Version of the Analytics extension
The extensionVersion() API returns the version of the Analytics extension that is registered with the Mobile Core extension.
To get the version of the Analytics extension, use the following code sample:
Android
iOS
React Native
Flutter
Cordova
Unity
Xamarin
Android
Java
String analyticsExtensionVersion = Analytics.extensionVersion();
iOS
Objective C
NSString *analyticsExtensionVersion = [ACPAnalytics extensionVersion];
Swift
let analyticsExtensionVersion  = ACPAnalytics.extensionVersion()
React Native
JavaScript
ACPAnalytics.extensionVersion().then(analyticsExtensionVersion => console.log("AdobeExperienceSDK: ACPAnalytics version: " + analyticsExtensionVersion));
Flutter
Dart
String analyticsExtensionVersion = await FlutterACPAnalytics.extensionVersion;
Cordova
Cordova
ACPAnalytics.extensionVersion(function(version) {  
   console.log("ACPAnalytics version: " + version);
}, function(error) {  
   console.log(error);  
});
Unity
C#
string analyticsExtensionVersion = ACPAnalytics.ExtensionVersion();
Xamarin
C#
string analyticsExtensionVersion = ACPAnalytics.ExtensionVersion();
clearQueue
Force delete, without sending to Analytics, all hits being stored or batched on the SDK.
Android
iOS
React Native
Flutter
Cordova
Unity
Xamarin
Android
clearQueue
Warning: Use caution when manually clearing the queue. This process cannot be reversed.
Syntax
public static void clearQueue()
Example
Analytics.clearQueue();
iOS
clearQueue
Warning: Use caution when manually clearing the queue. This process cannot be reversed.
Syntax
+ (void) clearQueue;
Example
Objective-C
[ACPAnalytics clearQueue];
Swift
ACPAnalytics.clearQueue()
React Native
JavaScript
clearQueue
Syntax
clearQueue();
Warning: Use caution when manually clearing the queue. This process cannot be reversed.
Example
ACPAnalytics.clearQueue();
Flutter
Dart
clearQueue
Syntax
Future<void> clearQueue();
Warning: Use caution when manually clearing the queue. This process cannot be reversed.
Example
FlutterACPAnalytics.clearQueue();
Cordova
Cordova
clearQueue
ACPAnalytics.clearQueue = function(success, fail);
success is a callback containing a general success message if the clearQueue API executed without any errors.
fail is a callback containing error information if the clearQueue API was executed with errors.
Warning: Use caution when manually clearing the queue. This process cannot be reversed.
Example
ACPAnalytics.clearQueue(function (handleCallback) {
  console.log("AdobeExperienceSDK: Clear queued hits successful. " + handleCallback);
} ,function (handleError) {
  console.log("AdobeExperenceSDK: Failed to clear queued hits: " + handleError);
});
Unity
C#
ClearQueue
public static void ClearQueue()
Warning: Use caution when manually clearing the queue. This process cannot be reversed.
Example
ACPAnalytics.ClearQueue();
Xamarin
C#
ClearQueue
public static void ClearQueue ();
Warning: Use caution when manually clearing the queue. This process cannot be reversed.
Example
ACPAnalytics.ClearQueue();
getQueueSize
Retrieves the total number of Analytics hits in the tracking queue.
Android
iOS
React Native
Flutter
Cordova
Unity
Xamarin
Android
getQueueSize
Syntax
 public static void getQueueSize(final AdobeCallback<Long> callback)
callback is invoked with the queue size value. When an AdobeCallbackWithError is provided, an AdobeError can be returned in the eventuality of an unexpected error or if the default timeout (5000ms) is met before the callback is returned with queue size.
Example
Analytics.getQueueSize(new AdobeCallback<Long>() {
    @Override
    public void call(final Long queueSize) {
        // handle the queueSize
    }
});
iOS
getQueueSize
Syntax
+ (void) getQueueSize: (nonnull void (^) (NSUInteger queueSize)) callback;
callback is invoked with the queue size value.
Example
Here are examples in Objective-C and Swift:
Objective-C
[ACPAnalytics getQueueSize: ^(NSUInteger queueSize) {    
    // use queue size
}];
Swift
ACPAnalytics.getQueueSize { (queueSize) in    
     // use queue size   
}
React Native
JavaScript
getQueueSize
Syntax
getQueueSize(): Promise<?integer>;
Example
ACPAnalytics.getQueueSize().then(size => console.log("AdobeExperienceSDK: Queue size: " + size));
Flutter
Dart
getQueueSize
Syntax
Future<int> getQueueSize;
Example
int queueSize;
​
try {
    queueSize = await FlutterACPAnalytics.queueSize;
} on PlatformException {
    log("Failed to get the queue size");
}
Cordova
Cordova
getQueueSize
Syntax
ACPAnalytics.getQueueSize = function(success, fail);
success is a callback containing the queue size if the getQueueSize API executed without any errors.
fail is a callback containing error information if the getQueueSize API was executed with errors.
Example
ACPAnalytics.getQueueSize(function (handleCallback) {
  console.log("AdobeExperienceSDK: Queue size: " + handleCallback);
} ,function (handleError) {
  console.log("AdobeExperenceSDK: Failed to get queue size: " + handleError);
});
Unity
C#
GetQueueSize
Syntax
public static void GetQueueSize(AdobeGetQueueSizeCallback callback)
callback is a callback containing the queue size if the GetQueueSize API executed without any errors.
Example
[MonoPInvokeCallback(typeof(AdobeGetQueueSizeCallback))]
public static void HandleAdobeGetQueueSizeCallback(long queueSize)
{
    Debug.Log("Queue size is : " + queueSize);
}
ACPAnalytics.GetQueueSize(HandleAdobeGetQueueSizeCallback);
Xamarin
C#
GetQueueSize
iOS Syntax
public unsafe static void GetQueueSize (Action<nuint> callback);
callback is a callback containing the queue size if the GetQueueSize API executed without any errors.
iOS Example
ACPAnalytics.GetQueueSize(callback => {
  Console.WriteLine("Queue size: " + callback);
});
Android Syntax
public unsafe static void GetQueueSize (IAdobeCallback callback);
callback is a callback containing the queue size if the GetQueueSize API executed without any errors.
Android Example
ACPAnalytics.GetQueueSize(new StringCallback());
​
class StringCallback : Java.Lang.Object, IAdobeCallback
{
  public void Call(Java.Lang.Object stringContent)
  {
    if (stringContent != null)
    {
      Console.WriteLine("Queue size: " + stringContent);
    }
    else
    {
      Console.WriteLine("null content in string callback");
    }
  }
}
getQueueSizeWithCompletionHandler
Retrieves the total number of Analytics hits in the tracking queue. Invoke the callback with NSError if unexpected error occures or request times out.
iOS
iOS
getQueueSizeWithCompletionHandler
Syntax
+ (void) getQueueSizeWithCompletionHandler: (nonnull void (^) (NSUInteger queueSize, NSError* __nullable error)) completionHandler;
completionHandler is invoked with the queue size value or an NSError if an unexpected error occurs or the request times out.
Example
Here are examples in Objective-C and Swift:
Objective-C
[ACPAnalytics getQueueSizeWithCompletionHandler: ^(NSUInteger queueSize, NSError * _Nullable error) {    
    // use queue size or handle error
}];
Swift
ACPAnalytics.getQueueSizeWithCompletionHandler { (queueSize, error) in    
     // use queue size or handle error  
}
getTrackingIdentifier
Before you use this API, see Identify unique visitors.
Retrieves the Analytics tracking identifier that is generated for this app/device instance. This identifier is an app-specific, unique visitor ID that is generated at the initial launch and is stored and used after the initial launch. The ID is preserved between app upgrades and is removed when the app is uninstalled.
If you have an Experience Cloud ID, and have not yet configured a visitor ID grace period, the value returned by getTrackingIdentifier might be null.
Android
iOS
React Native
Flutter
Cordova
Unity
Xamarin
Android
getTrackingIdentifier
Retrieves the Analytics tracking identifier.
Syntax
 public static void
   getTrackingIdentifier(final AdobeCallback<String> callback)
callback is invoked with the tracking Identifier string value. When an AdobeCallbackWithError is provided, an AdobeError can be returned in the eventuality of an unexpected error or if the default timeout (5000ms) is met before the callback is returned with analytics tracking identifier.
Example
Analytics.getTrackingIdentifier(new AdobeCallback<String>() {
    @Override
    public void call(final String trackingIdentifier) {
        // check the trackingIdentifier value    
    }
});
iOS
getTrackingIdentifier
Retrieves the Analytics tracking identifier.
Syntax
+ (void) getTrackingIdentifier: (nonnull void (^) (NSString* __nullable trackingIdentifier)) callback;
callback is invoked with the tracking Identifier string value.
Example
Here are examples in Objective-C and Swift:
Objective-C
[ACPAnalytics getTrackingIdentifier:^(NSString * _Nullable trackingIdentifier) {
    // check the trackingIdentifier value  
}];
Swift
ACPAnalytics.getTrackingIdentifier { (trackingIdentifier) in
    // check the trackingIdentifier value  
}
React Native
JavaScript
getTrackingIdentifier
Retrieves the Analytics tracking identifier.
Syntax
getTrackingIdentifier();
callback is invoked with the tracking Identifier string value.
Example
ACPAnalytics.getTrackingIdentifier().then(identifier => console.log("AdobeExperienceSDK: Tracking identifier: " + identifier));
Flutter
Dart
getTrackingIdentifier
Retrieves the Analytics tracking identifier.
Syntax
Future<String> getTrackingIdentifier;
Example
String trackingId;
​
try {
    trackingId = await FlutterACPAnalytics.trackingIdentifier;
} on PlatformException {
    log("Failed to get the tracking identifier");
}
Cordova
Cordova
getTrackingIdentifier
Retrieves the Analytics tracking identifier.
ACPAnalytics.getTrackingIdentifier = function(success, fail);
success is a callback containing the tracking Identifier string value.
fail is a callback containing error information if the getTrackingIdentifier API was executed with errors.
Example
ACPAnalytics.getTrackingIdentifier(function (handleCallback) {
  console.log("AdobeExperienceSDK: Retrieved tracking identifier: " + handleCallback);
} ,function (handleError) {
  console.log("AdobeExperenceSDK: Failed to retrieve tracking identifier: " + handleError);
});
Unity
C#
GetTrackingIdentifier
Retrieves the Analytics tracking identifier.
public static void GetTrackingIdentifier(AdobeGetTrackingIdentifierCallback callback)
callback is a callback containing the tracking Identifier string value.
Example
[MonoPInvokeCallback(typeof(AdobeGetTrackingIdentifierCallback))]
public static void HandleAdobeGetTrackingIdentifierCallback(string trackingIdentifier)
{
    Debug.Log("Tracking identifier is : " + trackingIdentifier);
}
ACPAnalytics.GetTrackingIdentifier(HandleAdobeGetTrackingIdentifierCallback);
Xamarin
C#
GetTrackingIdentifier
Retrieves the Analytics tracking identifier.
iOS Syntax
public unsafe static void GetTrackingIdentifier (Action<NSString> callback);
callback is a callback containing the tracking Identifier string value.
iOS Example
ACPAnalytics.GetTrackingIdentifier(callback => {
  Console.WriteLine("Tracking identifier: " + callback);
});
Android Syntax
public unsafe static void GetTrackingIdentifier (IAdobeCallback callback);
callback is a callback containing the tracking Identifier string value.
Android Example
ACPAnalytics.GetTrackingIdentifier(new StringCallback());
​
class StringCallback : Java.Lang.Object, IAdobeCallback
{
  public void Call(Java.Lang.Object stringContent)
  {
    if (stringContent != null)
    {
      Console.WriteLine("Tracking identifier: " + stringContent);
    }
    else
    {
      Console.WriteLine("null content in string callback");
    }
  }
}
getTrackingIdentifierWithCompletionHandler
Before you use this API, see Identify unique visitors.
Retrieves the Analytics tracking identifier that is generated for this app/device instance. This identifier is an app-specific, unique visitor ID that is generated at the initial launch and is stored and used after the initial launch. The ID is preserved between app upgrades and is removed when the app is uninstalled. Invoke the callback with NSError if unexpected error occures or request times out.
If you have an Experience Cloud ID, and have not yet configured a visitor ID grace period, the value returned by getTrackingIdentifier might be null.
iOS
iOS
getTrackingIdentifierWithCompletionHandler
Syntax
+ (void) getTrackingIdentifierWithCompletionHandler: (nonnull void (^) (NSString* __nullable trackingIdentifier, NSError* __nullable error)) completionHandler;
completionHandler is invoked with the tracking Identifier string value. or an NSError if an unexpected error occurs or the request times out.
Example
Here are examples in Objective-C and Swift:
Objective-C
[ACPAnalytics getTrackingIdentifierWithCompletionHandler:^(NSString * _Nullable trackingIdentifier, NSError * _Nullable error) {
    // use queue size or handle error
}];
Swift
ACPAnalytics.getTrackingIdentifierWithCompletionHandler { (trackingIdentifier, error) in    
     // use queue size or handle error  
}
getVisitorIdentifier
Before using this API, see Identify unique visitors.
This API gets a custom Analytics visitor identifier, which has been set previously using setVisitorIdentifier.
Android
iOS
React Native
Flutter
Cordova
Unity
Xamarin
Android
getVisitorIdentifier
Syntax
public static void getVisitorIdentifier(AdobeCallback<String> callback)
callback is invoked with the visitor identifier value. When an AdobeCallbackWithError is provided, an AdobeError can be returned in the eventuality of an unexpected error or if the default timeout (5000ms) is met before the callback is returned with visitor identifier.
Example
Analytics.getVisitorIdentifier(new AdobeCallback<String>() {
    @Override
    public void call(final String visitorIdentifier) {
        // check the visitorIdentifier value    
    }
});
iOS
getVisitorIdentifier
Syntax
+ (void) getVisitorIdentifier: (nonnull void (^) (NSString* __nullable visitorIdentifier)) callback;
callback is invoked with the visitor identifier value.
Example
Objective-C
[ACPAnalytics getVisitorIdentifier:^(NSString * _Nullable visitorIdentifier) {
    // check the visitorIdentifier value   
}];
Swift
ACPAnalytics.getVisitorIdentifier { (visitorIdentifier) in
    // check the visitorIdentifier value  
}
React Native
JavaScript
getVisitorIdentifier
Syntax
getVisitorIdentifier();
Example
ACPAnalytics.getVisitorIdentifier().then(vid => console.log("AdobeExperienceSDK: Visitor identifier: " + vid));
Flutter
Dart
getVisitorIdentifier
Syntax
Future<String> visitorIdentifier;
Example
String visitorId;
​
try {
    visitorId = await FlutterACPAnalytics.visitorIdentifier;
} on PlatformException {
    visitorId = "Failed to get the visitor identifier";
}
Cordova
Cordova
getVisitorIdentifier
Syntax
ACPAnalytics.getVisitorIdentifier = function(success, fail);
success is a callback containing the Visitor Identifier string if the getVisitorIdentifier API executed without any errors.
fail is a callback containing error information if the getVisitorIdentifier API was executed with errors.
Example
ACPAnalytics.getVisitorIdentifier(function (handleCallback) {
  console.log("AdobeExperienceSDK: Retrieved custom visitor identifier: " + handleCallback);
} ,function (handleError) {
  console.log("AdobeExperenceSDK: Failed to retrieve custom visitor identifier: " + handleError);
});
Unity
C#
GetVisitorIdentifier
Syntax
public static void GetVisitorIdentifier(AdobeGetVisitorIdentifierCallback callback)
callback is a callback containing the Visitor Identifier string if the GetVisitorIdentifier API executed without any errors.
Example
[MonoPInvokeCallback(typeof(AdobeGetVisitorIdentifierCallback))]
public static void HandleAdobeGetVisitorIdentifierCallback(string visitorIdentifier)
{
    Debug.Log("Visitor identifier is : " + visitorIdentifier);
}
ACPAnalytics.GetVisitorIdentifier(HandleAdobeGetVisitorIdentifierCallback);
Xamarin
C#
GetVisitorIdentifier
iOS Syntax
public unsafe static void GetVisitorIdentifier (Action<NSString> callback);
callback is a callback containing the visitor Identifier string value.
iOS Example
ACPAnalytics.GetVisitorIdentifier(callback => {
  Console.WriteLine("Visitor identifier: " + callback);
});
Android Syntax
public unsafe static void GetVisitorIdentifier (IAdobeCallback callback);
callback is a callback containing the visitor Identifier string value.
Android Example
ACPAnalytics.GetVisitorIdentifier(new StringCallback());
​
class StringCallback : Java.Lang.Object, IAdobeCallback
{
  public void Call(Java.Lang.Object stringContent)
  {
    if (stringContent != null)
    {
      Console.WriteLine("Visitor identifier: " + stringContent);
    }
    else
    {
      Console.WriteLine("null content in string callback");
    }
  }
}
getVisitorIdentifierWithCompletionHandler
Before using this API, see Identify unique visitors.
This API gets a custom Analytics visitor identifier, which has been set previously using setVisitorIdentifier. Callback with NSError if an unexpected error occurs or the request times out.
iOS
iOS
getVisitorIdentifier
Syntax
+ (void) getVisitorIdentifierWithCompletionHandler: (nonnull void (^) (NSString* __nullable visitorIdentifier, NSError* __nullable error)) completionHandler;
completionHandler is invoked with the visitor identifier value or an NSError if an unexpected error occurs or the request times out.
Example
Objective-C
[ACPAnalytics getVisitorIdentifierWithCompletionHandler:^(NSString * _Nullable visitorIdentifier, NSError * _Nullable error) {
    // check the visitorIdentifier value or handle error
}];
Swift
ACPAnalytics.getVisitorIdentifierWithCompletionHandler { (visitorIdentifier, error) in
    // check the visitorIdentifier value or handle error
}
sendQueuedHits
Sends all queued hits to Analytics, regardless of the current hit batch settings.
Android
iOS
React Native
Flutter
Cordova
Unity
Xamarin
Android
sendQueuedHits
Regardless of how many hits are currently queued, this method forces the library to send all hits in the offline queue.
Warning: Use caution when manually clearing the queue. This process cannot be reversed.
Syntax
public static void sendQueuedHits()
Example
Analytics.sendQueuedHits();
iOS
sendQueuedHits
Regardless of how many hits are currently queued, this method forces the library to send all hits in the offline queue.
Warning: Use caution when manually clearing the queue. This process cannot be reversed.
Syntax
+ (void) sendQueuedHits;
Example
Objective-C
[ACPAnalytics sendQueuedHits];
Swift
ACPAnalytics.sendQueuedHits()
React Native
JavaScript
sendQueuedHits
Regardless of how many hits are currently queued, this method forces the library to send all hits in the offline queue.
Syntax
sendQueuedHits();
Example
ACPAnalytics.sendQueuedHits();
Flutter
Dart
sendQueuedHits
Regardless of how many hits are currently queued, this method forces the library to send all hits in the offline queue.
Syntax
Future<void> sendQueuedHits();
Example
FlutterACPAnalytics.sendQueuedHits();
Cordova
Cordova
sendQueuedHits
Regardless of how many hits are currently queued, this method forces the library to send all hits in the offline queue.
Syntax
ACPAnalytics.sendQueuedHits = function(success, fail);
success is a callback containing a general success message if the sendQueuedHits API executed without any errors.
fail is a callback containing error information if the sendQueuedHits API was executed with errors.
Example
ACPAnalytics.sendQueuedHits(function (handleCallback) {
  console.log("AdobeExperienceSDK: Send queued hits successful. " + handleCallback);
} ,function (handleError) {
  console.log("AdobeExperenceSDK: Failed to send queued hits: " + handleError);
});
Unity
C#
SendQueuedHits
Regardless of how many hits are currently queued, this method forces the library to send all hits in the offline queue.
Syntax
public static void SendQueuedHits()
Example
ACPAnalytics.SendQueuedHits();
Xamarin
C#
SendQueuedHits
Regardless of how many hits are currently queued, this method forces the library to send all hits in the offline queue.
Syntax
public static void SendQueuedHits ();
Example
ACPAnalytics.SendQueuedHits();
setVisitorIdentifier
Before using this API, see Identify unique visitors.
Sets a custom Analytics visitor identifier. For more information, see Custom Visitor ID.
Android
iOS
React Native
Flutter
Cordova
Unity
Xamarin
Android
setVisitorIdentifier
Syntax
 public static void setVisitorIdentifier(final String visitorIdentifier)
visitorIdentifier is the new value for the visitor identifier.
Example
Analytics.setVisitorIdentifier("custom_identifier");
iOS
setVisitorIdentifier
Syntax
+ (void) setVisitorIdentifier: (nonnull NSString*) visitorIdentifier;
visitorIdentifier is the new value for the visitor identifier.
Example
Here are examples in Objective-C and Swift:
Objective-C
[ACPAnalytics setVisitorIdentifier:@"custom_identifier"];
Swift
ACPAnalytics.setVisitorIdentifier("custom_identifier")
React Native
JavaScript
setVisitorIdentifier
Syntax
setVisitorIdentifier(visitorIdentifier);
visitorIdentifier is the new value for the visitor identifier.
Example
ACPAnalytics.setVisitorIdentifier("custom_identifier");
Flutter
Dart
setVisitorIdentifier
Syntax
Future<void> setVisitorIdentifier(visitorIdentifier);
visitorIdentifier is the new value for the visitor identifier.
Example
FlutterACPAnalytics.setVisitorIdentifier("yourVisitorId");
Cordova
Cordova
setVisitorIdentifier
Syntax
ACPAnalytics.setVisitorIdentifier(visitorIdentifier, success, fail);
visitorIdentifier is the new value for the visitor identifier.
success is a callback containing a general success message if the setVisitorIdentifier API executed without any errors.
fail is a callback containing error information if the setVisitorIdentifier API was executed with errors.
Example
ACPAnalytics.setVisitorIdentifier("custom_identifier", function (handleCallback) {
  console.log("AdobeExperienceSDK: Custom visitor identifier set successfully. " + handleCallback);
} ,function (handleError) {
  console.log("AdobeExperenceSDK: Failed to set custom visitor identifier: " + handleError);
});
Unity
C#
SetVisitorIdentifier
Syntax
public static void SetVisitorIdentifier(string visitorId)
visitorId is the new value for the visitor identifier.
Example
ACPAnalytics.SetVisitorIdentifier("VisitorIdentifier");
Xamarin
C#
SetVisitorIdentifier
iOS Syntax
public static void SetVisitorIdentifier (string visitorIdentifier);
visitorIdentifier is the new value for the visitor identifier.
Android Syntax
public unsafe static void SetVisitorIdentifier (string visitorID);
visitorID is the new value for the visitor identifier.
Example
ACPAnalytics.SetVisitorIdentifier("VisitorIdentifier");
Release Notes
Analytics event reference
Last updated 4 weeks ago