Edit in GitHubLog an issue

Identity for Edge Network

The Identity for Edge Network mobile extension enables identity management, including the Experience Cloud ID (ECID), from your mobile app when using the Adobe Experience Platform Mobile SDK and the Edge Network extension.

Use the Identity for Edge Network extension when including the Edge Network extension into an application. The Identity for Edge Network extension is not used with Adobe Solution extensions, which must use the Identity for Experience Cloud ID Service extension.

Configure the Identity extension in the Data Collection UI

  1. In Data Collection UI, in your mobile property, select the Extensions tab.
  2. On the Catalog tab, locate or search for the Identity extension, and select Install.
  3. There are no configuration settings for Identity.
  4. Select Save.
  5. Follow the publishing process to update SDK configuration.

Identity for Edge Network extension configuration

Add the Identity For Edge Network extension to your app

Include Identity extension as an app dependency

Add MobileCore, Edge, EdgeIdentity extensions as dependencies to your project.

Add the required dependencies to your project by including them in the app's Gradle file.

Copied to your clipboard
implementation(platform("com.adobe.marketing.mobile:sdk-bom:3.+"))
implementation("com.adobe.marketing.mobile:core")
implementation("com.adobe.marketing.mobile:edge")
implementation("com.adobe.marketing.mobile:edgeidentity")

Initialize Adobe Experience Platform SDK with Identity for Edge Network Extension

Next, initialize the SDK by registering all the solution extensions that have been added as dependencies to your project with Mobile Core. For detailed instructions, refer to the initialization section of the getting started page.

Using the MobileCore.initialize API to initialize the Adobe Experience Platform Mobile SDK simplifies the process by automatically registering solution extensions and enabling lifecycle tracking.

Copied to your clipboard
import com.adobe.marketing.mobile.LoggingMode
import com.adobe.marketing.mobile.MobileCore
...
import android.app.Application
...


class MainApp : Application() {
  override fun onCreate() {
    super.onCreate()
    MobileCore.setLogLevel(LoggingMode.DEBUG)
    MobileCore.initialize(this, "ENVIRONMENT_ID")
  }
}

Advertising identifier

The Identity for Edge Network extension compares the previously stored advertising identifier value with the new value received from the setAdvertisingIdentifier API and handles the following scenarios:

Ad tracking enabled - when the new value sent to the API is:

  • A valid UUID string (example: "a127a99e-50be-4d87-bf6f-6ab9541c105b")

Process:

  1. Updates the client side XDM IdentityMap with the new value for IDFA/GAID, which is included in subsequent XDM Experience events. For more details, see the standard Identity namespaces.
  2. Sends a consent update event with ad ID consent preferences set to yes (only when a valid ad ID is absent from the IdentityMap and the Edge Consent extension is registered and properly configured).

Ad tracking disabled - Given a valid ad ID already exists in the IdentityMap, and the new value sent to the API is:

  • null/nil
  • Empty string ("")
  • All-zeros string ("00000000-0000-0000-0000-000000000000")

Process:

  1. Removes the ad ID from the client side XDM IdentityMap, which is removed from subsequent XDM Experience events.
  2. Sends a consent update event with ad ID consent preferences set to no (only when the Edge Consent extension is registered and properly configured).

No operations are executed when no changes are detected between the previously stored and new ad ID value.

Was this helpful?