Profile

You can use the Profile extension to store attributes about your user on the client. This information can be used later to target and personalize messages during online or offline scenarios, without having to connect to a server for optimal performance. The Profile extension manages the Client-Side Operation Profile (CSOP) and provides a way to react to APIs, updates user profile attributes, and shares the user profile attributes with the rest of the system as a generated event.
The Profile data is used by other extensions to perform profile-related actions. An example is the Rules Engine extension that consumes the profile data and runs rules based on the profile data.
Important: The Profile extension does not require any configuration.
To get started with the Profile extension:
1.Configure the Profile Extension in Launch.
2.Add the Profile extension to your app.
3.Implement Profile APIs to:
Update user attributes.
Remove user attributes.
Install the Profile extension in the Data Collection UI
1.In the Data Collection UI, in your mobile property, select the Extensions tab.
2.On the Catalog tab, locate or search for the Profile extension, and select Install.
3.There are no configuration settings for Profile.
4.Select Save.
5.Follow the publishing process to update SDK configuration.
AEP Profile extension configuration
Add the Profile extension to your app
To add the Profile extension to your app:
Android
iOS (AEP 3.x)
iOS (ACP 2.x)
Cordova
Unity
Xamarin
Java
1.Add the UserProfile library to your project using the app's gradle file.
2.Import the UserProfile library and any other SDK library in your application's main activity.
1
import com.adobe.marketing.mobile.*;
Copied!
1.Add the Mobile Core and Profile extensions to your project using Cocoapods. Add following pods in your Podfile:
1
use_frameworks!
2
target 'YourTargetApp' do
3
    pod 'AEPCore', '~> 3.0'
4
    pod 'AEPUserProfile', '~> 3.0'
5
end
Copied!
1.Import the UserProfile library.
Swift
1
   import AEPCore
2
   import AEPUserProfile
Copied!
Objective-C
1
   @import AEPCore;
2
   @import AEPUserProfile;
Copied!
Objective-C
1.Add the Mobile Core and Profile extensions to your project using Cocoapods. Add following pods in your Podfile:
1
use_frameworks!
2
target 'YourTargetApp' do
3
    pod 'ACPCore'
4
    pod 'ACPUserProfile'
5
end
Copied!
1.Import the UserProfile library.
Swift
1
   import ACPCore
2
   import ACPUserProfile
Copied!
Objective-C
1
   #import "ACPCore.h"
2
   #import "ACPUserProfile.h"
Copied!
Cordova
After creating your Cordova app and adding the Android and iOS platforms, the UserProfile extension for Cordova can be added with this command:
1
cordova plugin add https://github.com/adobe/cordova-acpuserprofile.git
Copied!
C#
After importing the ACPUserProfile.unitypackage, the UserProfile extension for Unity can be added with following code in the MainScript
1
using com.adobe.marketing.mobile;
Copied!
C#
After adding the iOS ACPUserProfile NuGet package or the Android ACPUserProfile NuGet package, the UserProfile extension can be added by this import statement
1
using Com.Adobe.Marketing.Mobile;
Copied!
Register the extension
Android
iOS (AEP 3.x)
iOS (ACP 2.x)
React Native
Cordova
Flutter
Unity
Xamarin
Java
Required: The setApplication() method must be called once in the onCreate() method of your main activity.
1.The UserProfile extension must be registered with Mobile Core before calling an UserProfile API.
This can be done after calling setApplication() in the onCreate() method. Here is a code sample, which calls these set up methods:
1
   public class MobileApp extends Application {
2
​
3
       @Override
4
       public void onCreate() {
5
           super.onCreate();
6
           MobileCore.setApplication(this);
7
           try {
8
               // register other extensions
9
               UserProfile.registerExtension();
10
               MobileCore.start(new AdobeCallback () {
11
                   @Override
12
                   public void call(Object o) {
13
                       MobileCore.configureWithAppID("yourAppId");
14
                   }
15
               });    
16
           } catch (Exception e) {
17
               //Log the exception
18
            }
19
       }
20
   }
Copied!
Swift
1
// AppDelegate.swift
2
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
3
    MobileCore.registerExtensions([UserProfile.self], {
4
  })
5
  ...
6
}
Copied!
Objective-C
1
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
2
    [AEPMobileCore registerExtensions:@AEPMobileUserProfile.class] completion:^{
3
    ...
4
  }];
5
  ...
6
  // Override point for customization after application launch.
7
  return YES;
8
}
Copied!
Swift
1
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
2
     ACPCore.configure(withAppId: "yourAppId")   
3
     ACPUserProfile.registerExtension() 
4
     ACPCore.start(nil)
5
     // Override point for customization after application launch. 
6
     return true;
7
}
Copied!
Objective-C
1
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
2
  [ACPUserProfile registerExtension];
3
  // Override point for customization after application launch.
4
  return YES;
5
}
Copied!
JavaScript
When using React Native, register Profile with Mobile Core in native code as shown on the Android and iOS tabs.
Cordova
When using Cordova, register Profile with Mobile Core in native code as shown on the Android and iOS tabs.
Flutter
When using Flutter, register Profile with Mobile Core in native code as shown on the Android and iOS tabs.
C#
Register the extension in the start() function:
1
using com.adobe.marketing.mobile;
2
using using AOT;
3
​
4
public class MainScript : MonoBehaviour
5
{
6
    [MonoPInvokeCallback(typeof(AdobeStartCallback))]
7
    public static void HandleStartAdobeCallback()
8
    {   
9
        ACPCore.ConfigureWithAppID("yourAppId"); 
10
    }
11
​
12
    // Start is called before the first frame update
13
    void Start()
14
    {   
15
        ACPUserProfile.registerExtension();
16
        ACPCore.Start(HandleStartAdobeCallback);
17
    }
18
}
Copied!
C#
iOS
Register the User Profile extension in your app's FinishedLaunching() function:
1
public override bool FinishedLaunching(UIApplication app, NSDictionary options)
2
{
3
  global::Xamarin.Forms.Forms.Init();
4
  LoadApplication(new App());
5
  ACPUserProfile.RegisterExtension();
6
  // start core
7
  ACPCore.Start(startCallback);
8
  return base.FinishedLaunching(app, options);
9
}
10
​
11
private void startCallback()
12
{
13
  // set launch config
14
  ACPCore.ConfigureWithAppID("yourAppId");
15
}
Copied!
Android
Register the User Profile extension in your app's OnCreate() function:
1
protected override void OnCreate(Bundle savedInstanceState)
2
{
3
  base.OnCreate(savedInstanceState);
4
  global::Xamarin.Forms.Forms.Init(this, savedInstanceState);
5
  LoadApplication(new App());
6
  ACPUserProfile.RegisterExtension();
7
​
8
  // start core
9
  ACPCore.Start(new CoreStartCompletionCallback());
10
}
11
​
12
class CoreStartCompletionCallback : Java.Lang.Object, IAdobeCallback
13
{
14
  public void Call(Java.Lang.Object callback)
15
  {
16
    // set launch config
17
    ACPCore.ConfigureWithAppID("yourAppId");
18
  }
19
}
Copied!

Additional Location Service resources

Migrating to AEPUserProfile

Last modified 1d ago

Export as PDF

Copy link

Edit on GitHub

Contents

Install the Profile extension in the Data Collection UI

Add the Profile extension to your app