[L3882] Basic Acquisition Link Tracking - Adobe-Marketing-Cloud/aml-summit-lab GitHub Wiki

Set up tracking for marketing links

Objective

In this exercise, we will learn about the minimum SDK requirements to enable acquisition link tracking. We will then demonstrate an app install using the click-through of an acquisition link, and show the resulting data.

Pre-requisites

We will be using the Sample app for this lab exercise. If you need help, please see the Download the Sample App section of the Getting started page.

For this exercise, we will use the Marketing Links you created in the lab exercise on creating an acquisition link in Adobe Mobile Services.

Implementation steps

Enable Acquisition Tracking in the SDK

To speed things up in the lab, we have already done most of the steps required to enable acquisition in the sample app. We only need to complete the final step (step 4) in this section, but the rest are being provided to illustrate the minimum requirements to enable Acquisition tracking in the Adobe SDK.

  1. Open SummitMobileLab -> AdobeMobileLibrary -> ADBMobileConfig.json
  1. Make sure your config file has a server endpoint and appid for the app you created in Adobe Mobile Services.
  1. In your config file, make sure the value of referrerTimeout is greater than 0. We recommend using 5.
  1. In order for our fingerprinter server to accurately attribute our test installs, we need each sample app to use its own appid. To get your appid, go to this page and copy the value for your app. Then, paste it in for the appid value shown in step 2 above.

Simulate an install based on an Acquisition click-through

  1. In order to simulate an "Install", we have to make sure the app is not already on the target device. Delete the SummitMobileLab application from your iOS Simulator by clicking and holding on the icon, then hitting the "X" in the upper left-hand corner of the icon when it appears.

  1. Go back to your web browser and to copy the URL you created in the Creating an Acquisition Link in Adobe Mobile Services exercise. Your link should look something like this:

     https://c00.adobe.com/v3/799752ef587558a90ba136ab1766b226f0fd535a35124c3def885dc560ab931e/start?a_dl=58b85f818c07717805f435cf

  2. Launch Safari in your iOS Simulator. Paste your copied URL into Safari and hit enter.

  • Clicking an acquisition link will first take you to an Adobe server. You will then be auto-redirected to the destination we set up in Adobe Mobile Services.
  • Note - If this acquisition link is configured to take the user to the Apple App Store, Safari will give you a message saying the address is invalid. This is due to the fact that there is no "App Store" on the iOS Simulator. You can safely ignore this message.
  1. In Xcode, Run the app.
  1. Verify that your lifecycle hit contains acquisition data in the console log.

Related documentation

Read more about Mobile App Acquisition in the iOS SDK documentation.

Next steps

Learn how to leverage the acquisition data you've collected to make business decisions in your app in the Accessing Acquisition Data in your App exercise.