Tracking Apple Search Ads campaigns
AppMetrica tracks Apple Search Ads campaigns. Apple links app installations from Search Ads on its own.
Note
For full attribution of Apple Search Ads on devices running iOS 14.5 and higher, we recommend using the AppMetrica SDK 3.15.1 and later.
For iOS versions 14.5 and higher, the user is asked for permission to access the advertising ID and use tracking. For users who do not grant access to the IDFA, a new attribution system is used: AdServices Framework.
For iOS versions 14.4 and below, the old iAd Framework tracking method is supported. The AppMetrica SDK 2.9.4 or higher is suitable for this purpose.
For iOS 14.5 and higher, you can also use the iAd Framework, but users who haven't granted access to IDFA aren't attributed.
Comparison of attribution systems
iAd framework |
AdServices framework |
|
Supported iOS versions |
10 and higher |
14.3 and higher |
Tracking for iOS 14.4 and lower |
Access to IDFA isn't required. The iAd framework will still work. |
Access to IDFA isn't required. The AdServices Framework works on devices running iOS versions 14.3–14.4. |
Tracking restrictions for iOS 14.5 and higher |
Only attributes users who have consented to tracking provided their IDFA is available in the app. Doesn't attribute users who haven't granted access to their IDFA: |
Users who haven't granted access to their IDFA are attributed with fewer details (without the click date). |
How to customize |
|
The AppMetrica SDK 3.15.1 or higher. |
Available campaign parameters |
|
Only entity IDs are supported.
Names aren't supported. |
- Step 1. Integrate the iAd Framework
-
Integrate the iAd Framework into an application with the AppMetrica SDK installed, so that Apple Search Ads can detect and link app installations. Integration instructions are available on the Search Ads site (see paragraph Add the iAd Framework to Your Xcode Project).
Enabling the iAd framework in Unity
In the Unity 3D interface, go to Settings → Other Settings → Scripting Define → Symbols. Add the APP_METRICA_ADD_IAD_FRAMEWORK directive.
Note
If you added the iAd Framework in the Xcode project, you don't need to add the directive.
After the iAd Framework is added, the AppMetrica SDK starts to detect installations from Apple Search Ads automatically.
- Step 2. Perform a test installation
-
Create a test advertising campaign for Search Ads and install the application through ad placement. The tracker for this source will appear in the AppMetrica interface automatically:
- Step 3. (Optional) Configure attribution
-
Set up the Search Ads attribution by using the tracker configuration:
- Go to the Trackers section. In order to filter the trackers by a media source, click on the Media Source drop-down list in the menu on the left and select Apple Search Ads.
- Choose the tracker to set up attribution for from the list. The tracker name matches the name of the Apple Search Ads campaign.
- Make the necessary changes to the Attribution settings section and click Save. Learn more about setting up attribution.
- Step 4. (Optional) Configure postbacks
-
The campaign parameters can be sent in postbacks similar to macros. For example, to pass the campaign ID in the
campaign_id
parameter in the postback URL, specifycampaign_id={iad-campaign-id}
. You can also use all system macros.Set up postbacks using the tracker settings:
- Go to the Trackers section. In order to filter the trackers by a media source, click on the Media Source drop-down list in the menu on the left and select Apple Search Ads.
- Choose the tracker to set up the postback for from the list. The tracker name matches the name of the Apple Search Ads campaign.
- Make the necessary changes to the Postback settings section and click Save. More information about setting up postbacks.
You can use AdServices Framework to attribute users who haven't allowed access to the advertising ID and tracking. To switch to this tracking system, update the AppMetrica SDK to version 3.15.1. No further configuration is necessary.
The AppMetrica SDK versions 3.15.0 and below don't support AdServices Framework, and you can't attribute users without access to the IDFA.
- Step 1. Perform a test installation
-
Create a test advertising campaign for Search Ads and install the application through ad placement. The tracker for this source will appear in the AppMetrica interface automatically:
- Step 2. (Optional) Configure attribution
-
Set up the Search Ads attribution by using the tracker configuration:
- Go to the Trackers section. In order to filter the trackers by a media source, click on the Media Source drop-down list in the menu on the left and select Apple Search Ads.
- Choose the tracker to set up attribution for from the list. The tracker name matches the name of the Apple Search Ads campaign.
- Make the necessary changes to the Attribution settings section and click Save. Learn more about setting up attribution.
- Step 3. (Optional) Configure postbacks
-
The campaign parameters can be sent in postbacks similar to macros. For example, to pass the campaign ID in the
campaign_id
parameter in the postback URL, specifycampaign_id={campaignId}
. You can also use all system macros.Set up postbacks using the tracker settings:
- Go to the Trackers section. In order to filter the trackers by a media source, click on the Media Source drop-down list in the menu on the left and select Apple Search Ads.
- Choose the tracker to set up the postback for from the list. The tracker name matches the name of the Apple Search Ads campaign.
- Make the necessary changes to the Postback settings section and click Save. More information about setting up postbacks.
If you didn't find the answer you were looking for, you can use the feedback form to submit your question. Please describe the problem in as much detail as possible. Attach a screenshot if possible.