{"id":7999,"date":"2024-08-19T16:51:06","date_gmt":"2024-08-19T07:51:06","guid":{"rendered":"https:\/\/help-ads.smartnews.com\/?p=7999"},"modified":"2025-10-20T17:30:24","modified_gmt":"2025-10-20T08:30:24","slug":"item-3673","status":"publish","type":"post","link":"https:\/\/help-ads.smartnews.com\/en\/item-3673\/","title":{"rendered":"App Promotion campaigns"},"content":{"rendered":"\n

The \u201cApp Promotion\u201d campaign type is designed to track user interaction with mobile apps. These campaigns support mobile measurement partner (MMP) tracking from Adjust, AppsFlyer, and Singular allowing your SmartNews campaigns to report results as part of your MMP\u2019s analytics.<\/p>\n\n\n\n

App campaigns at a glance<\/h2>\n\n\n\n

Here are the key differences between SmartNews\u2019 app campaign objectives and strategies.<\/p>\n\n\n\n

Campaign type<\/th>App install campaign<\/td>App install campaign with In-App Event Optimization enabled (IAEO)<\/td><\/tr>
Use case<\/th>Maximizing the number of new installs<\/td>Gaining fewer installs but with more high-value conversions<\/td><\/tr>
Target audience<\/th>People who haven\u2019t yet installed your app*<\/mark><\/td>People who haven\u2019t yet installed your app*<\/mark><\/td><\/tr>
Optimization target<\/th>New installs<\/td>Post-install app events as a proxy for high-quality installs<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

*Note that due to privacy protections in Apple\u2019s SKAdNetwork, we can\u2019t always exclude users who have already installed the app.<\/mark><\/p>\n\n\n\n

How to set up an App Promotion campaign<\/h2>\n\n\n\n

1<\/i>From the \u201cCampaigns\u201d tab, select \u201cCreate campaign\u201d<\/strong><\/span><\/h6>\n\n\n\n
\"\"<\/figure>\n\n\n\n
\uff12<\/i>Choose \u201cApp Promotion\u201d from the campaign type selection pop-up<\/strong><\/span><\/h6>\n\n\n\n
\"\"<\/figure>\n\n\n\n
3<\/i>Enter app platform and ID<\/strong><\/span><\/h6>\n\n\n\n

Pick either Android or iOS, and enter your app\u2019s store ID or URL. Note that an App Promotion campaign works with either Google Play or App Store\u2014not both. Create separate campaigns for each platform.<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n
4<\/i>Choose your MMP and enter the tracking URL according to their instructions<\/strong><\/span><\/h6>\n\n\n\n
\"\"<\/figure>\n\n\n\n
5<\/i>Save your changes<\/strong><\/span><\/h6>\n\n\n\n

Your campaign is now ready to track app installs and relay events to your MMP. With this setup, you can monitor your App Promotion campaign\u2019s performance, including metrics like install rates and in-app events. Remember to review your campaign\u2019s performance regularly and adjust your strategy to optimize results.<\/p>\n\n\n\n

<\/p>\n\n\n\n

Tracking URL Settings<\/h1>\n\n\n\n

Adjust<\/h2>\n\n\n\n

1<\/i>Generate an clink link URL in Adjust.<\/strong><\/span><\/h6>\n\n\n\n

Example URL:<\/span><\/span><\/p>\n\n\n\n

https://app.adjust.com\/abc123?campaign=Example_CampaignName&adgroup=Example_PublisherID&creative=Example_CreativeID\n<\/code><\/pre>\n\n\n\n
2<\/i>Add or replace example parameters as needed. <\/strong><\/span><\/h6>\n\n\n\n
Example:<\/span>
Example_CampaignName<\/mark> \u2192{campaign_id}<\/mark> 
Any optional placeholder parameters can be removed.<\/p>\n\n\n\n
3<\/i>Enter the final URL in the \u201cTracking URL\u201d field (replace abc123<\/mark> with the token ID provided by Adjust.). This is a minimal example URL required to create a campaign.
<\/strong><\/h6>\n\n\n\n
https://app.adjust.com\/abc123?campaign={campaign_id}&idfa={idfa}\n<\/code><\/pre>\n\n\n\n
Note that your Adjust URL:<\/strong><\/h4>\n\n\n\n
    \n
  • Cannot include any spaces<\/li>\n\n\n\n
  • Must begin with https:\/\/app.adjust.com\/{link_token}<\/mark><\/li>\n\n\n\n
  • Must contain an Adjust link token between 6 to 8 lowercase alphanumeric characters<\/li>\n\n\n\n
  • Must include at least one of the following parameters for advertiser ID:<\/li>\n<\/ul>\n\n\n\n
    Parameter<\/th>Valid values<\/th><\/tr><\/thead>
    idfa<\/td>{idfa}<\/td><\/tr>
    gps_adid<\/td>{gaid}<\/td><\/tr>
    idfa_lower_md5<\/td>{lower_case_ad_id_md5}<\/td><\/tr>
    gps_adid_lower_sha1<\/td>{lower_case_ad_id_sha1}<\/td><\/tr>
    idfa_lower_sha1<\/td>{lower_case_ad_id_sha1}<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
      \n
    • Must include at least one campaign structure parameter:<\/li>\n<\/ul>\n\n\n\n
      Parameter<\/th>Valid values<\/th><\/tr><\/thead>
      campaign<\/td>{campaign_id}
      {campaign_name}<\/td><\/tr>
      adgroup<\/td>{adgroup_id}
      {adgroup_name}<\/td><\/tr>
      creative<\/td>{ad_name}<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
      Suggested Adjust parameters<\/strong><\/p>\n\n\n\n
      Adjust parameter<\/th>Valid values<\/th>Required<\/th>Note<\/th><\/tr><\/thead>
      smartnews_click_id<\/td>{click_id}<\/td>Yes<\/td><\/td><\/tr>
      gps_adid<\/td>{gaid}<\/td>Yes<\/td>Google advertising ID, only required for Google Play app<\/td><\/tr>
      idfa<\/td>{idfa}<\/td>Yes<\/td>iOS advertising ID, only required for AppStore app<\/td><\/tr>
      ip_address<\/td>{ip_address}<\/td>No<\/td><\/td><\/tr>
      user_agent<\/td>{user_agent}<\/td>No<\/td><\/td><\/tr>
      campaign<\/td>{campaign_name}<\/td>No<\/td><\/td><\/tr>
      creative<\/td>{ad_name}<\/td>No<\/td><\/td><\/tr>
      adgroup<\/td>{adgroup_name}<\/td>No<\/td><\/td><\/tr>
      s2s<\/td>1<\/td>No<\/td>Added by default<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
      AppsFlyer<\/h2>\n\n\n\n
      1<\/i>Generate a single-platform link starting with https:\/\/app.appsflyer.com\/<\/mark><\/strong><\/h6>\n\n\n\n
      2<\/i>Replace the placeholder parameters with your app\u2019s ID and relevant SmartNews macros in curly braces, like {gaid}<\/mark> \/ {idfa}<\/mark> .<\/mark><\/strong><\/span><\/h6>\n\n\n\n
      3<\/i>Enter the final URL in the \u201cTracking URL\u201d field like in the example below:<\/strong><\/span><\/h6>\n\n\n\n
      https://app.appsflyer.com\/id123456789?pid=smartnewsads_int&af_siteid=smartnews_ads&clickid={click_id}&c={campaign_name}&af_c_id={campaign_id}&af_adset={adgroup_name}&af_adset_id={adgroup_name}&af_ad={ad_name}&af_ad_id={ad_id}&idfa={idfa}&af_ip={ip_address}&af_ua={user_agent}\n<\/code><\/pre>\n\n\n\n
      Note that your AppsFlyer URL:<\/h4>\n\n\n\n
        \n
      • Cannot include any spaces<\/li>\n\n\n\n
      • Must begin with https:\/\/app.appsflyer.com\/{app_id}<\/mark><\/li>\n\n\n\n
      • Must include at least one parameter for advertising ID (idfa<\/mark> or advertising_id<\/mark>)<\/li>\n\n\n\n
      • Must contain at least one campaign_structure<\/mark> parameter (c<\/mark>, af_c_id<\/mark>, af_adset<\/mark>, af_adset_id<\/mark>, af_ad<\/mark>, af_ad_id<\/mark>)<\/li>\n<\/ul>\n\n\n\n
        Suggested AppsFlyer parameters<\/strong><\/p>\n\n\n\n
        AppsFlyer parameter<\/th>Valid values<\/th>Type<\/th>Required<\/th>Note<\/th><\/tr><\/thead>
        pid<\/td>smartnewsads_int<\/td><\/td>Yes<\/td><\/td><\/tr>
        af_siteid<\/td>smartnews_ad<\/td><\/td>Yes<\/td><\/td><\/tr>
        clickid<\/td>{click_id}<\/td><\/td>Yes<\/td><\/td><\/tr>
        c<\/td>{campaign_name}<\/td>Campaign structure<\/td>No<\/td><\/td><\/tr>
        af_c_id<\/td>{campaign_id}<\/td>Campaign structure<\/td>No<\/td><\/td><\/tr>
        af_adset<\/td>{adgroup_name}<\/td>Campaign structure<\/td>No<\/td><\/td><\/tr>
        af_adset_id<\/td>{adgroup_id}<\/td>Campaign structure<\/td>No<\/td><\/td><\/tr>
        af_ad<\/td>{ad_name}<\/td>Campaign structure<\/td>No<\/td><\/td><\/tr>
        af_ad_id<\/td>{ad_id}<\/td>Campaign structure<\/td>No<\/td><\/td><\/tr>
        idfa<\/td>{idfa}<\/td>Advertising ID<\/td>Yes<\/td>iOS advertising ID, only required for AppStore app<\/td><\/tr>
        advertising_id<\/td>{gaid}<\/td>Advertising ID<\/td>Yes<\/td>Google advertising ID, only required for Google Play app<\/td><\/tr>
        af_ua<\/td>{user_agent}<\/td>Probabilistic attribution<\/td>No<\/td>Sent to AppsFlyer by default to enable probabilistic attribution<\/td><\/tr>
        af_ip<\/td>{ip_address}<\/td>Probabilistic attribution<\/td>No<\/td>Sent to AppsFlyer by default to enable probabilistic attribution<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
        Singular<\/h2>\n\n\n\n
        1<\/i>Generate a single-platform link starting with https:\/\/{advertiser_subdomain}.sng.link\/{app_id_singular}\/{link_id_singular}<\/mark><\/strong><\/h6>\n\n\n\n
        2<\/i>Replace the placeholder parameters with your specific Singular subdomain and IDs.<\/strong><\/span><\/h6>\n\n\n\n
        3<\/i>Enter the final URL in the \u201cTracking URL\u201d field like in the example below<\/strong><\/span><\/h6>\n\n\n\n
        https://sample.sng.link\/D59c0\/sfxf?idfa={idfa}&cl={click_id}&\npcid={campaign_id}&pcn={campaign_name}&pscid={ad_group_id}&\npscn={ad_group_name}&pcrid={ad_id}&pcrn={ad_name}&p={platform}&\npsn=SmartNews&psid={sn_app_id}\n<\/code><\/pre>\n\n\n\n
        Note that your Singular URL:<\/h4>\n\n\n\n
          \n
        • Cannot include any spaces<\/li>\n\n\n\n
        • Must begin with 
          https:\/\/{advertiser_subdomain}.sng.link\/{app_id_singular}\/{link_id_singular}<\/mark><\/li>\n\n\n\n
        • Must include at least one parameter for advertising ID (idfa<\/mark> or gaid<\/mark>)<\/li>\n\n\n\n
        • Must contain at least one campaign_structure parameter (pcid<\/mark> , pcn<\/mark> , pscid<\/mark> , pscn<\/mark> , pcrid<\/mark> , pcrn<\/mark> )<\/li>\n<\/ul>\n\n\n\n
          Suggested Singular parameters<\/strong><\/p>\n\n\n\n
          Singular parameter<\/th>Valid values<\/th>Type<\/th>Required<\/th>Note<\/th><\/tr><\/thead>
          psid<\/td>SmartNewsAppId<\/td><\/td>Yes<\/td><\/td><\/tr>
          psn<\/td>SmartNews<\/td><\/td>Yes<\/td><\/td><\/tr>
          cl<\/td>{click_id}<\/td><\/td>Yes<\/td><\/td><\/tr>
          idfa<\/td>{idfa}<\/td>Advertising ID<\/td>Yes<\/td>iOS advertising ID, only required for AppStore app<\/td><\/tr>
          aifa<\/td>{gaid}<\/td>Advertising ID<\/td>Yes<\/td>Google advertising ID, only required for Google Play app<\/td><\/tr>
          pcn<\/td>{campaign_name}<\/td>Campaign structure<\/td>No<\/td>At least one campaign_structure parameter is required.<\/td><\/tr>
          pcid<\/td>{campaign_id}<\/td>Campaign structure<\/td>No<\/td>At least one campaign_structure parameter is required.<\/td><\/tr>
          pscn<\/td>{adgroup_name}<\/td>Campaign structure<\/td>No<\/td>At least one campaign_structure parameter is required.<\/td><\/tr>
          pscid<\/td>{adgroup_id}<\/td>Campaign structure<\/td>No<\/td>At least one campaign_structure parameter is required.<\/td><\/tr>
          pcrn<\/td>{ad_name}<\/td>Campaign structure<\/td>No<\/td>At least one campaign_structure parameter is required.<\/td><\/tr>
          pcrid<\/td>{ad_id}<\/td>Campaign structure<\/td>No<\/td>At least one campaign_structure parameter is required.<\/td><\/tr>
          ua<\/td>{user_agent}<\/td>Probabilistic attribution<\/td>No<\/td>Sent to Singular by default to enable probabilistic attribution<\/td><\/tr>
          ip<\/td>{ip_address}<\/td>Probabilistic attribution<\/td>No<\/td>Sent to Singular by default to enable probabilistic attribution<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
          Consider these best practices for managing your App Promotion campaign<\/h2>\n\n\n\n
            \n
          • Closely monitor your campaign performance in the first few days to ensure correct tracking.<\/li>\n\n\n\n
          • Test different ad creatives and calls-to-action to boost conversion rates.<\/li>\n<\/ul>\n\n\n\n
            If you run into any issues or have questions about your App Promotion campaign, please don\u2019t hesitate to contact our support team for help.<\/p>\n","protected":false},"excerpt":{"rendered":"The \u201cApp Promotion\u201d campaign type is designed to track user interaction with mobile apps. These campaigns support mobile measurement partner (MMP) tracking from Adjust, AppsFlyer, and Singular allowing your SmartNews campaigns to report results as part of your MMP\u2019s analytics. App campaigns at a glance Here are the key differences between SmartNews\u2019 app campaign objectives and strategies. Campaign typeApp install campaignApp install campaign with In-App Event Optimization enabled (IAEO)Use caseMaximizing the number of new installsGaining fewer installs but with more high-value conversionsTarget audiencePeople who haven\u2019t yet installed your app*People who haven\u2019t yet installed your app*Optimization targetNew installsPost-install app events as a proxy for high-quality installs *Note that due to privacy […]","protected":false},"author":23,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"inline_featured_image":false,"footnotes":""},"categories":[181,1],"tags":[],"label":[125],"class_list":["post-7999","post","type-post","status-publish","format-standard","hentry","category-campaign-creation-en","category-1","label--v2"],"acf":[],"aioseo_notices":[],"_links":{"self":[{"href":"https:\/\/help-ads.smartnews.com\/en\/wp-json\/wp\/v2\/posts\/7999","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/help-ads.smartnews.com\/en\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/help-ads.smartnews.com\/en\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/help-ads.smartnews.com\/en\/wp-json\/wp\/v2\/users\/23"}],"replies":[{"embeddable":true,"href":"https:\/\/help-ads.smartnews.com\/en\/wp-json\/wp\/v2\/comments?post=7999"}],"version-history":[{"count":27,"href":"https:\/\/help-ads.smartnews.com\/en\/wp-json\/wp\/v2\/posts\/7999\/revisions"}],"predecessor-version":[{"id":8394,"href":"https:\/\/help-ads.smartnews.com\/en\/wp-json\/wp\/v2\/posts\/7999\/revisions\/8394"}],"wp:attachment":[{"href":"https:\/\/help-ads.smartnews.com\/en\/wp-json\/wp\/v2\/media?parent=7999"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/help-ads.smartnews.com\/en\/wp-json\/wp\/v2\/categories?post=7999"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/help-ads.smartnews.com\/en\/wp-json\/wp\/v2\/tags?post=7999"},{"taxonomy":"label","embeddable":true,"href":"https:\/\/help-ads.smartnews.com\/en\/wp-json\/wp\/v2\/label?post=7999"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}