Identity
The Identity extension is bundled with Mobile Core and enables your app with the Experience Cloud ID (ECID). This service helps with the synchronization of Adobe and other customer identifiers.
On web or other platforms, there might situations where this extension might not be required, and the implementation of this SDK extension on mobile apps is required.
To get started with Identity, complete the following steps:
- 1.Add the Identity extension to your app.
- 2.Implement the SDK APIs to complete the following tasks:
- Update customer IDs.
- Append Adobe visitor data to a URL string.
- Return customer IDs.
- Retrieve Experience Cloud IDs.
- Set advertising IDs.
- Set the device notification for push notifications.
Android
iOS (AEP 3.x)
iOS (ACP 2.x)
React Native
Flutter
Cordova
Unity
Xamarin
Java
Import the library:
import com.adobe.marketing.mobile.*;
iOS
Import the Identity extension:
Swift
import AEPCore
import AEPIdentity
Objective-C
@import AEPCore;
@import AEPIdentity;
iOS
Import the Identity extension:
Swift
In Swift, the ACPCore includes ACPIdentity :
import ACPCore
Objective-C
#import "ACPIdentity.h"
Import the Identity extension:
JavaScript
import {ACPIdentity} from '@adobe/react-native-acpcore';
Import the Identity extension:
Dart
import 'package:flutter_acpcore/flutter_acpidentity.dart';
After importing the ACPCore.unitypackage, the Identity extension for Unity can be added with following code in the MainScript
using com.adobe.marketing.mobile;
The
registerExtension()
API registers the Identity extension with the Mobile Core extension. This API allows the extension to send and receive events to and from the Mobile SDK.To register the Identity extension, use the following code sample:
Android
iOS (AEP 3.x)
iOS (ACP 2.x)
React Native
Flutter
Cordova
Unity
Xamarin
After calling the
setApplication()
method in the onCreate()
method, register the extension. If the registration was not successful, an InvalidInitException
is thrown.Java
public class MobileApp extends Application {
@Override
public void onCreate() {
super.onCreate();
MobileCore.setApplication(this);
try {
Identity.registerExtension();
// register other extensions
MobileCore.start(new AdobeCallback () {
@Override
public void call(Object o) {
MobileCore.configureWithAppID("yourAppId");
}
});
} catch (Exception e) {
//Log the exception
}
}
}
iOS
Register the Identity extension in your app's
didFinishLaunchingWithOptions
function:Swift
When including both Identity and Identity for Edge Network extensions, register the extensions using their full Swift module names.
MobileCore.registerExtensions([AEPIdentity.Identity.self, AEPEdgeIdentity.Identity.self, ...], { ... })
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
MobileCore.registerExtensions([Identity.self, ...], {
...
})
}
Objective-C
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
[AEPMobileCore registerExtensions:@[AEPMobileIdentity.class, ...] completion:^{
...
}];
return YES;
}
iOS
Register the Identity extension in your app's
didFinishLaunchingWithOptions
function:Swift
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
ACPIdentity.registerExtension();
// Override point for customization after application launch.
return true;
}
Objective-C
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
[ACPIdentity registerExtension];
// Override point for customization after application launch.
return YES;
}
JavaScript
When using React Native, registering Identity with Mobile Core should be done in native code which is shown under the Android and iOS tabs.
Dart
When using Flutter, registering Identity with Mobile Core should be done in native code which is shown under the Android and iOS tabs.
Cordova
When using Cordova, registering Identity with Mobile Core must be done in native code which is shown under the Android and iOS tabs.
C#
Register the Identity extension in your app's
Start()
function:void Start() {
ACPIdentity.RegisterExtension();
}
C#
iOS
Register the Identity extension in your app's
FinishedLaunching()
function:public override bool FinishedLaunching(UIApplication app, NSDictionary options)
{
global::Xamarin.Forms.Forms.Init();
LoadApplication(new App());
ACPIdentity.RegisterExtension();
// start core
ACPCore.Start(startCallback);
return base.FinishedLaunching(app, options);
}
private void startCallback()
{
// set launch config
ACPCore.ConfigureWithAppID("yourAppId");
}
Android
Register the Identity extension in your app's
OnCreate()
function:protected override void OnCreate(Bundle savedInstanceState)
{
base.OnCreate(savedInstanceState);
global::Xamarin.Forms.Forms.Init(this, savedInstanceState);
LoadApplication(new App());
ACPIdentity.RegisterExtension();
// start core
ACPCore.Start(new CoreStartCompletionCallback());
}
class CoreStartCompletionCallback : Java.Lang.Object, IAdobeCallback
{
public void Call(Java.Lang.Object callback)
{
// set launch config
ACPCore.ConfigureWithAppID("yourAppId");
}
}
Previously known as MCID, the Experience Cloud ID (ECID) uniquely identifies each visitor in the Adobe Experience Platform and is a 38-character ID.
After the configuration is complete, an ECID is generated and, where applicable, is included on all Analytics and Audience Manager hits. Other IDs, such as custom and automatically-generated IDs, continue to be sent with each hit.
The
extensionVersion()
API returns the version of the Identity extension that is registered with the Mobile Core extension.To get the version of the Identity extension, use the following code sample:
Android
iOS (AEP 3.x)
iOS (ACP 2.x)
React Native
Flutter
Cordova
Unity
Xamarin
Java
String identityExtensionVersion = Identity.extensionVersion();
iOS
Swift
var identityExtensionVersion = Identity.extensionVersion
Objective-C
NSString *identityExtensionVersion = [AEPMobileIdentity extensionVersion];
iOS
Swift
var identityExtensionVersion = ACPIdentity.extensionVersion()
Objective-C
NSString *identityExtensionVersion = [ACPIdentity extensionVersion];
JavaScript
ACPIdentity.extensionVersion().then(identityExtensionVersion => console.log("Identity version: " + identityExtensionVersion));
Dart
String identityExtensionVersion = await FlutterACPIdentity.extensionVersion;
Cordova
ACPIdentity.extensionVersion(function (handleCallback) {
console.log("AdobeExperienceSDK: ACPIdentity version: " + handleCallback)
}, function (handleError) {
console.log("AdobeExperenceSDK: failed to get extension version : " + handleError)
});
C#
string identityVersion = ACPIdentity.ExtensionVersion();
C#
string identityVersion = ACPIdentity.ExtensionVersion();
If your app opens mobile web content, you need to ensure that visitors are not identified separately as they move between the native and mobile web.
The Mobile SDK generates a unique visitor ID when the app is installed. This ECID is stored in persistent memory on the mobile device and is sent with every hit. The ECID is removed when the user uninstalls the app or when the user sets the Mobile SDK global privacy status to
optedout
.When the Mobile SDK privacy status is set to
optedout
, and the ECID is removed, a new unique visitor ID (ECID) is generated when the user sets the global privacy status to optedin
.App visitor IDs persist through upgrades.
Typical mobile web implementations use the same standard analytics
s_code.js
or AppMeasurement.js
that is used in desktop sites. The JavaScript libraries have their own methods of generating unique visitor IDs, which causes a different visitor ID to be generated when you open mobile web content from your app.To use the same visitor ID in the app and mobile web and pass the visitor ID to the mobile web in the URL, complete the following steps:
Android
iOS (AEP 3.x)
iOS (ACP 2.x)
React Native
Flutter
Cordova
Unity
Xamarin
Java
To append visitor information to the URL that is being used to open the web view, call appendVisitorInfoForUrl:
Identity.appendVisitorInfoForURL("https://example.com", new AdobeCallback<String>() {
@Override
public void call(String urlWithAdobeVisitorInfo) {
//handle the new URL here
//For example, open the URL on the device browser
//
Intent i = new Intent(Intent.ACTION_VIEW);
i.setData(Uri.parse(urlWithAdobeVisitorInfo));
startActivity(i);
}
});
Alternately, starting in SDK version 1.4.0 (Identity version 1.1.0), you can call getUrlVariables and build your own URL:
Identity.getUrlVariables(new AdobeCallback<String>() {
@Override
public void call(String stringWithAdobeVisitorInfo) {
//handle the URL query parameter string here
//For example, open the URL on the device browser
//
Intent i = new Intent(Intent.ACTION_VIEW);
i.setData(Uri.parse("https://example.com?" + urlWithAdobeVisitorInfo));
startActivity(i);
}
});
Swift
let url = URL(string: "https://example.com")
Identity.appendTo(url: url) { appendedUrl, error in
if error != nil {
// handle error here
} else {
// handle appended url here
}
}
Objective-C
NSURL *sampleUrl = [NSURL URLWithString:@"https://example.com"];
[AEPMobileIdentity appendToUrl:sampleUrl completion:^(NSURL * _Nullable appendedUrl, NSError *error) {
if (error != nil) {
// Handle error here
} else {
// Handle appended url here
}
}];
Swift
Identity.getUrlVariables { urlVariables, error in
if error != nil {
// handle error here
} else {
if let url = URL(string: "https://example.com?\(urlVariables ?? "")") {
DispatchQueue.main.async {
UIApplication.shared.open(url)
}
}
}
}
Objective-C
[AEPMobileIdentity getUrlVariables:^(NSString * _Nullable urlVariables, NSError *error) {
NSString *sampleURLString = @"https://example.com";
if (error != nil) {
// Handle variables being nil
} else {
NSString *stringWithData = [NSString stringWithFormat:@"%@?%@", sampleURLString, urlVariables];
NSURL *appendedUrl = [NSURL URLWithString:stringWithData];
dispatch_async(dispatch_get_main_queue(), ^{
[[UIApplication sharedApplication] openURL:appendedUrl options:@{} completionHandler:nil];
});
}
}];
Objective-C
NSURL* url = [[NSURL alloc] initWithString:@"www.example.com"];
[ACPIdentity appendToUrl:url withCallback:^(NSURL * _Nullable urlWithVisitorData) {
// handle the appended url here
}];
Alternately, starting with SDK version 2.3.0 (ACPIdentity version 2.1.0), you can call getUrlVariables and build your own URL:
[ACPIdentity getUrlVariables:^(NSString * _Nullable urlVariables) {
// handle the URL query parameter string here
NSString* urlString = @"https://example.com";
NSString* urlStringWithVisitorData = [NSString stringWithFormat:@"%@?%@", urlString, urlVariables];
NSURL* urlWithVisitorData = [NSURL URLWithString:urlStringWithVisitorData];
[[UIApplication sharedApplication] openURL:urlWithVisitorData options:@{} completionHandler:^(BOOL success) {
// handle openURL success
}];
}];
JavaScript
To append visitor information to the URL that is being used to open the web view, call appendVisitorInfoForUrl:
ACPIdentity.appendVisitorInfoForURL("www.example.com").then(urlWithVistorData => console.log("Url with Visitor Data = " + urlWithVisitorData));
ACPIdentity.getUrlVariables().then(urlVariables => console.log("query params = " + urlVariables));
Dart
To append visitor information to the URL that is being used to open the web view, call appendVisitorInfoForUrl:
String result = "";
try {
result = await FlutterACPIdentity.appendToUrl("www.example.com");
} on PlatformException {
log("Failed to append URL");
}
Alternately, starting with SDK version 1.0.0-beta.1, you can call getUrlVariables and build your own URL:
String result = "";
try {
result = await FlutterACPIdentity.urlVariables;
} on PlatformException {
log("Failed to get url variables");
}
Cordova
To append visitor information to the URL that is being used to open the web view, call appendVisitorInfoForUrl:
ACPIdentity.appendVisitorInfoForUrl("https://example.com", function(handleCallback) {
console.log("AdobeExperenceSDK: Url with Visitor Data = " + handleCallback);
}, function(handleError) {
console.log("AdobeExperenceSDK: Failed to append URL : " + handleError);
});
ACPIdentity.getUrlVariables(function (handleCallback) {
console.log("AdobeExperienceSDK: Url variables: " + handleCallback);
}, function (handleError) {
console.log("AdobeExperenceSDK: Failed to retrieve url variables : " + handleError);
});
C#
[MonoPInvokeCallback(typeof(AdobeIdentityAppendToUrlCallback))]
public static void HandleAdobeIdentityAppendToUrlCallback(string url)
{
print("Url is : " + url);
}
ACPIdentity.AppendToUrl("https://www.adobe.com", HandleAdobeIdentityAppendToUrlCallback);
[MonoPInvokeCallback(typeof(AdobeGetUrlVariables))]
public static void HandleAdobeGetUrlVariables(string urlVariables)
{
print("Url variables are : " + urlVariables);
}
ACPIdentity.GetUrlVariables(HandleAdobeGetUrlVariables);
C#
iOS
ACPIdentity.AppendToUrl(url, callback => {
Console.WriteLine("Appended url: " + callback);
});
To append visitor information to the URL that is being used to open the web view, call AppendVisitorInfoForUrl:
Android
ACPIdentity.AppendVisitorInfoForURL("https://example.com", new StringCallback());
class StringCallback : Java.Lang.Object, IAdobeCallback
{
public void Call(Java.Lang.Object stringContent)
{
if (stringContent != null)
{
Console.WriteLine("Appended url: " + stringContent);
}
else
{
Console.WriteLine("null content in string callback");
}
}
}
iOS
ACPIdentity.GetUrlVariables(callback => {
Console.WriteLine("Url variables: " + callback);
});
Android
ACPIdentity.GetUrlVariables(new StringCallback());
class StringCallback : Java.Lang.Object, IAdobeCallback
{
public void Call(Java.Lang.Object stringContent)
{
if (stringContent != null)
{
Console.WriteLine("Url variables: " + stringContent);
}
else
{
Console.WriteLine("null content in string callback");
}
}
}
The ID service code on the destination domain extracts the ECID from the URL instead of sending a request to Adobe for a new ID. The ID service code on the destination page uses this ECID to track the visitor. On hits from the mobile web content, verify that the
mid
parameter exists on each hit, and that this value matches the mid
value that is being sent by the app code.Last modified 5mo ago