[L3882] Tracking Apple Search Ads in the Adobe SDK - Adobe-Marketing-Cloud/aml-summit-lab GitHub Wiki

Tracking Apple Search Ads in the Adobe SDK

Objective

So you're thinking about buying some Apple Search Ads, but you're reluctant because you don't want your acquisition data fragmented. Worry not! With a very simple integration, the Adobe SDK can collect your Apple Search Ad data, and convert it into data that will report the same way as the Adobe Marketing Links you know and love.

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.

While not required, a basic understanding of Apple Search Ads will be helpful in understanding this lab exercise.

Implementation steps

Click on the SummitMobileLab project.

Select the SummitMobileLab Target.

Click the General tab.

Click the + button in the section titled Linked Frameworks and Libraries.

Select iAd.framework and hit the Add button.

Delete the SummitMobileLab app from your iOS Simulator.

Run the app.

Verify in the console log in Xcode that your app has received Apple Search Ad attribution data.

Note - Apple Search Ad data is available to you programmatically via ADBMobileDataEventAcquisitionLaunch and ADBMobileDataEventAcquisitionInstall events. For more information about getting access to your acquisition data at runtime, see the lab exercise on Accessing Acquisition Data in your App.

Reporting on Apple Search Ad data

On an app install, the SDK will check for the value "iad-attribution" = true; in the API response from iOS. If this line exists, all of the iad-* properties and values will be automatically included on the lifecycle install hit.

In addition, we will map the following iad values into our normal acquisition context data fields (which will make them available in our standard reporting):