Add extensions

In this lesson, you will add extensions to your tag property.

Tags allows Adobe and third-party vendors to create extensions to make it easy to deploy their solutions. An extension is a package of code that extends the Data Collection interface and client functionality. Extensions give you the ability to choose only the parts of the Adobe Experience Platform Mobile SDK that you need for your specific app. You can think of tags as an operating system, and extensions are the apps you use to achieve your tasks.

Since you will be implementing the Adobe solutions (e.g. Target, Analytics, and Audience Manager), you will add the necessary extensions required to support them.

Prerequisites

Your tags user account needs permission to “Manage Extensions” in order to complete this lesson. If you are unable to complete any of these steps because the user interface options are not available to you, reach out to your Experience Cloud Administrator for access. For more information on tag user permissions, see the documentation.

You will need the following solution details:

• One Analytics report suite ID. If you don’t have a test/dev report suite that you can use for this tutorial, please create one. If you are unsure how to do that, see the documentation.

• Your Analytics tracking server. You can retrieve your tracking server from your current implementation, Adobe Consultant or Customer Care representative.

Learning Objectives

At the end of this lesson, you will be able to:

• Add Extensions to a mobile tag property
• Configure the Analytics extension
• Configure the Target extension

Review the Pre-installed extensions

1. Click the Extensions tab to go to the extensions page

2. Note that the Mobile Core and Profile extensions are pre-installed in your new mobile property

3. Click the Configure button on the Core extension to examine its settings

   

4. The Mobile Core extension represents the core Adobe Experience Platform Mobile SDK required for any app implementation. The core contains common set of functionality and frameworks such as an Experience Cloud Identity services, data event hub, rules engine, reusable networking, disk access routines, etc., which is required by all Adobe and third-party extensions. For more information on the Mobile Core extension, see the documentation.

   1. Note that your Experience Cloud Org ID is detected automatically and pre-populated
   2. The Experience Cloud Server field allows you to specify a custom endpoint for Visitor ID Service requests. Use the default setting (leave it blank) for this tutorial.
   3. The Session Timeout field allows you to specify when an app Lifecycle session should timeout. By default, it will timeout if the app is in the background for 300 seconds. Use the default setting for this tutorial.

5. Since you haven’t changed any of the settings, click Cancel to leave the extension configuration

   

6. The Profile extension allows the SDK to store data in a client-side profile. It has no configurations, so there is nothing to look at. For more information on the Profile extension, see the documentation.

Add the Solution Extensions

Now it’s time to get to the fun part and start adding the extensions for the solutions you will be implementing in this tutorial. When using tags with mobile applications, the app must be updated every time an extension is added or removed. In order to save time later, we will add all of the extensions in this lesson. Just skip any solutions which your company has not licensed.

Add the Adobe Analytics extension

To add the extension

1. Click on the Catalog tab to see the uninstalled extensions

2. Find the Adobe Analytics extension and click Install

   

3. Select your Report Suites from the pre-populated lists. These are the Report Suites to which the app will send data. You can select different report suites for your Development, Staging, and Production Environments.

4. Your Analytics Tracking Server may be pre-populated or you may need to select it from a pre-populated list or enter it manually. This is the domain to which the beacons will be sent, typically in the format yoursite.sc.omtrdc.net.

5. Check the box for Offline Enabled. When the Offline Enabled check box is selected, Analytics hits are queued when your device is offline and are sent later when your device is back online. To use offline tracking, ensure that your report suite is timestamp enabled. For more information, see the documentation.

6. Check the box for Audience Manager Forwarding. This will forward Analytics data to Audience Manager, so you won’t have to make an extra call from the app to Audience Manager. In this exercise we will assume that you have Audience Manager, and are therefore forwarding the data from Analytics. If you do not have Audience Manager, do not check this box as you set up Analytics for your own implementation.

7. Check the box to Backdate Previous Session Info

8. Click the Save button

   

Add the Target extension

The Adobe Target extension supports all of the API familiar to users of our earlier mobile SDKs to deliver personalized content into your app.

To add the extension

1. Click on the Catalog tab to see the uninstalled extensions

2. Find the Adobe Target extension and click Install

   

3. Your Client Code will pre-populate.

4. Leave the Environment Id blank. This setting is used in conjunction with the Hosts feature in Adobe Target, which allows you to send the data to different reporting environments (e.g. Dev, Staging, Production). By default, the data will be sent to the Production environment.

5. Leave the Target Workspace Property blank. This setting is used in conjunction with the Target Premium Enterprise User Permissions feature.

6. Leave the Timeout set to 5 seconds. This setting controls how long the app should wait for the Target response before displaying default content.

7. Click the Save button

   

That’s it! Now that you have added the extensions to your property, you can add them to a library:

Next “Create a Library” >