Support Home > Campaign Management > Create an Apple Search Ads Campaign

Create an Apple Search Ads Campaign

  • Feature Summary: The following document defines the process for creating an Apple Search Ads campaign within Kochava. Apple Search Ads is a mobile advertising platform which allows advertisements to be embedded into Apple products such as iPhones, iPods and iPads.

     

    iAd Framework vs AdServices Framework

    While both the iAd framework and AdServices framework produce attribution claims for Apple Search Ads claims, there are a number of notable differences.

     

    The AdServices Framework:

    • Supports attribution claims for devices on iOS14.3+ only.
    • Supports attribution claims for devices where the AppTrackingTransparency (ATT) setting is Opt-Out.
    • Has two types of payloads; a standard payload for cases where the ATT setting is Opt-Out and a detailed payload for cases where the ATT setting is Opt-In. The difference between the standard and detailed payload is that the standard payload does not contain a click timestamp.
    • Provides less campaign metadata than the iAd framework.
    • Will be the only source of Apple Search Ads attribution claims once the iAd framework is deprecated.
    • Requires that first an attribution token be generated on the client, which can then be used to retrieve attribution results.

    Overview of Attribution Claim Payload Differences:

    AdServices Detailed (Opt-In) AdServices Standard (Opt-Out) iAd
    attribution attribution iad-attribution
    orgId orgId iad-org-id
    campaignId campaignId iad-campaign-id
    conversionType conversionType iad-conversion-type
    clickDate Not included on original payload. Optionally manufactured for the purpose of attribution. iad-click-date
    adGroupId adGroupId iad-adgroup-id
    countryOrRegion countryOrRegion iad-country-or-region
    iad-country-or-region keywordId iad-keyword-id
    creativeSetId creativeSetId iad-creativeset-id
    iad-purchase-date
    iad-keyword
    iad-creativeset-name
    iad-lineitem-id
    iad-conversion-date
    iad-org-name
    iad-campaign-name
    iad-adgroup-name
    iad-keyword-matchtype
    iad-lineitem-name
    iad.iad-impression-date

     

    NOTES:

    • The issue affecting the Search Ads Attribution API has been resolved as of July 9, 2018, with iOS 11.4.1 release. Search Ads driven conversions will begin to attribute as expected as users adopt this latest iOS version. Data will continue to be unreported for devices running iOS 11.3 All requests will be returned with “iad-attribution” = “false”.
    • Apple Search Ads was formerly called iAd.
    • Apple Search Ads Campaigns are available for iOS apps only, no Postback is required and a tracking URL does not need to be provided to Apple Search Ads.

     

    Data Needed Before Beginning Process:

    • Kochava SDK must be implemented.
    • For retrieving claims via the iAd framework, SDK Version 20160720 or later must be implemented within the app. (Recommended)
    • For retrieving claims via the AdServices framework, SDK version 4.4.0 or later must be implemented within the app. (Recommended)
    • NOTE: Apple Search Ads may also be utilized with a Server-to-Server integration. For more information refer to our Install Notification Setup support documentation.

     

    Use Cases for Apple Search Ads Campaign:

    • An app marketing campaign with Apple Search Ads has been created.

    Create an Apple Search Ads Campaign

    1. Log in to Kochava.
    2. Select the desired Account and App.
    3. Select Links > Campaign Manager.
    4.  

       

    5. Click Add a Tracker or Select Segment Tools () > Add a Tracker.
      1. Select the Campaign.
      2. Select the Segment.

      NOTE: In order to streamline the Campaign/Segment/Tracker creation process a feature has been added to allow the creation of campaigns and segments while creating a new tracker. For more information about creating a campaign or segment while adding a new tracker, refer to our Create an Install Campaign support document. support documentation.

       

       

    6. Enter a unique Tracker Name.
    7. Select the Tracker Type > Acquisition.
    8. NOTE: By default the Tracker Type is set to Acquisition.

    9. Select Media Partner > Apple Search Ads.
    10. Select an Agency Partner. (optional)
    11. Check Share with Publisher. (optional)
    12. Enter the Install Destination URL.
    13. Enter a Deep Link. (optional)
    14. Select Pricing. (optional)
    15. Select Apple Search Ads Campaign Group IDs (optional)
      • Select Campaign Group IDs that would you like to associated with this tracker. This allows you to split your Apple Search Ads traffic to multiple trackers based on Campaign Group ID.

      NOTE: In order to select Campaign Group IDs you must first enter them within Partner Configuration for Apple Search Ads. See Install Postback Configuration section for more details.

    16. Click Save. (If no further trackers need to be created)
    17. Click Save & Add Another Tracker. (If additional trackers need to be created).

     

    A. Campaign and Segment selection/creation section.


    Install Postback Configuration (Optional)

    This step is only needed if you wish to make changes to the default method of handling attribution for standard AdServices attribution payloads, which do not contain a click timestamp. Apple will provide a standard payload in cases where the user did not opt in via the AppTrackingTransparency framework. Within Partner Configuration for Apple Search Ads, you can determine whether or not to attribute these claims. If you choose to attribute, you can determine the click timestamp Kochava manufactures, relative to the user’s install timestamp. By default, this is set to attribute standard ATT opt-out payloads and manufacture a click timestamp that is 29 days prior to the user’s install timestamp.

    1. Select Apps & Assets > Partner Configuration.
    2.  

       

    3. Click Add a Configuration.
    4. Select Media Partner > Apple Search Ads.
    5. Click Go.
    6. Select Install > Postback Tools () > Edit.
    7. Leave the ATTRIBUTION FOR ATT OPT-OUT USERS box checked if you wish to attribute Apple Search Ads claims for ATT opt-out users. Uncheck if you do not wish to attribute attribution claims on these users. By default this will be checked.
    8. If the ATTRIBUTION FOR ATT OPT-OUT USERS is checked, you can determine how Kochava should manufacture a click timestamp, relative to the user’s install timestamp. As an example, if the MANUFACTURED CLICK TIMESTAMP is set to 29 days, Kochava will assign a click timestamp that is 29 days prior to the user’s install timestamp.
    9. Enter Campaign Group IDs associated with this app.
    10. NOTE: Campaign Group IDs can be found within your Apple Search Ads account and/or within your Apple Search Ads campaign management partner’s account. Once entered, they will be selectable when creating or editing a tracker. This allows you to segment your traffic to different trackers based on Campaign Group ID. If you do not assign a Campaign Group ID to a specific tracker, it will be awarded to your default Apple Search Ads tracker.

    11. Click Save.

    Track Redownloads with Apple

    ATTENTION: The Install Reprocessing Lookback window is applied to all re-installs for the app and will consider all channels, not just for the purposes of tracking redownloads with Apple Search Ads.

     

    Apply the Install Reprocessing Setting:

    1. Select Apps & Assets > Partner Configuration.
    2.  

       

    3. In the upper right hand corner of the screen, Select Tools > Default Reconciliation Settings.
    4. Select the desired Install Reprocessing Lookback window.
    5. Click Save.

    Create a Reengagement Tracker:

    1. Select Links > Campaign Manager.
    2.  

       

    3. Click Add a Tracker or Select Segment Tools () > Add a Tracker.
      1. Select the Campaign.
      2. Select the Segment.

      NOTE: In order to streamline the Campaign/Segment/Tracker creation process a feature has been added to allow the creation of campaigns and segments while creating a new tracker. For more information about creating a campaign or segment while adding a new tracker, refer to our Create an Install Campaign support document.

    4. Enter Tracker Name.
    5. Select Tracker Type > Reengagement.
    6. Select Media Partner > Apple Search Ads.
    7. Select an Agency Partner. (optional)
    8. NOTE: The Share With Publisher setting allows the associated publisher to view the settings for this tracker. If unchecked, the associated publisher will not be able to view the settings for this tracker.

    9. Select the Destination URL Type > Custom.
    10. Enter an Install URL.
    11. Enter a Deep Link. (optional)
    12. NOTE: Optional and only relevant when using deferred deeplinking.

    13. Enter a Custom Parameter. (optional)
    14. Enter Pricing Type and Target Pricing. (optional)
    15. Select Event > _install for Redownload attribution.
    16. NOTE: The selected event(s) will be the point of conversion for the reengagement campaign. Attribution will be awarded to the click that led to the reengagement event based on attribution configuration. Any LTV (Lifetime Value) will also be awarded to the source that drove the reengagement.

      NOTE: The lookback window for each post-install event may be individually set. For more information on setting an event lookback window, refer to our Post-Install Event Creation and Configuration support documentation.

      NOTE: SessionBegin event is now available to be used for reengagement. One session a day is eligible to be reengaged per day.

    17. Click Save (If no further trackers need to be created).

     


    Apple Campaign Association to a Specific Tracker in Kochava (Optional):

    Locating the Tracker ID within Kochava —

    Unless a specific tracker ID has been associated with the Apple Search Ads campaign, redownloads will be associated with the latest created reengagment tracker within Kochava.

    1. Locate the Reengagement Tracker.
    2. Expand the tracker detail.
    3. Copy the Tracker ID.
    4.  

     

    Adding the Kochava Tracker ID to a New Apple Search Ads Campaign —

    1. Enter Tracker ID along with campaign name during creation flow.
    2.  

     

    Adding the Kochava Tracker ID to an Existing Apple Search Ads Campaign —

    1. Log in to Apple Search Ads.
    2. Click on Campaign.
    3. Edit Campaign Settings.
    4. Add Kochava Tracker ID to the Campaign Name.
    5. Click Save.
    6.  


  • Feature Summary: The following document defines accessing data associated with Apple Search Ads campaign within Kochava. Apple Search Ads is a mobile advertising platform which allows advertisements to be embedded into Apple products such as iPhones, iPods and iPads. Apple Search Ads campaign data can be located with Analytics, Reporting and Query, details and suggestions for locating and organizing your data can be found below.

     

    Analytics

    Within Analytics filters may be used in order to organize and display Apple Search Ads data specifically.

    NOTE: In the following example, Analytics Events Volume will be used to illustrate the display of Apple Search Ads data. The same process for applying filters may be used within any of the other Analytics views.

    1. Log in to Kochava.
    2. Select the desired Account and App.
    3. Select Analytics > Events Volume.
    4.  

    1. Click Add a Filter.
    2. Select Network Name.
    3. Select Apple Search Ads.
    4.  

      A. Select Network Name > Apple Search Ads.
      B. It is highly recommended to split the data by Site.
      C. Mouseover to view specific data.


    Reporting

    1. Log in to Kochava.
    2. Select the desired Account and App.
    3. Select Audiences & Reports > Reports.
    4.  


    1. Locate the desired report and Click Customize.
    2. Select Networks > Apple Search Ads.
    3. Adjust/Add/Remove any other settings.
    4. Click Create.
    5.  

      A. Including site and creative in the report can help organize your data.


      Query

      Below is a useful Query for understanding keyword and campaign-level performance for Apple Search Ads data. This Query must be run in Standard SQL dialect.