适用于第三方应用跟踪的 DDM 集成

以下端到端流程将介绍在使用第三方应用跟踪解决方案的情况下,为了在 DoubleClick 买方产品上投放广告系列而需要执行的广告客户设置和第三方实现。要详细了解 DoubleClick 数字营销概览以及应用内归因功能概览,请参阅 DoubleClick 数字营销背景信息页

  1. 广告客户在 DDM 中设置转化事件以表示安装/转化(仅限 Bid Manager - 转化像素)(Campaign Manager - Floodlight 活动)。
  2. 广告客户“关联”第三方界面中的 DDM 转化事件,并提供标识广告客户和转化活动组的主要变量。

    • src 是广告客户 ID,即 Floodlight 活动的来源。
    • cat 是活动代码字符串,Floodlight 服务器用它来识别活动所属的活动组。
    • type 是组代码字符串,可用于识别与 Floodlight 活动相关联的活动组。
    • u1, u2, ...(如果有)是自定义 Floodlight 变量键值。
  3. 此外,广告客户需要向第三方提供其特定的授权令牌:token 是特定于广告客户的字母数字字符串,必须随各个服务器请求一起传递到 DDM。

  4. 广告客户使用 DBM 在实时出价交易平台投放的广告代码或 DCM 在直接购买的媒体上投放的广告代码来投放应用内广告系列。

  5. 最终用户看到并/或点击广告。DDM 记录最终用户的活动数据。

  6. 如果最终用户安装应用并/或完成转化事件(“玩游戏”等),则第三方服务器会基于每个应用活动对 DDM 执行“ping”操作。

    https://ad.doubleclick.net/ddm/s2s/appactivity/src=1234567;cat=fghij456;type=abcde123;u1=[friendlyname1];ord=1312312312
    

    其中:

    • src 是广告客户 ID,即 Floodlight 活动的来源。
    • cat 是活动代码字符串,Floodlight 服务器用它来识别活动所属的活动组。
    • type 是组代码字符串,可用于识别与 Floodlight 活动相关联的活动组。
    • ord 是用于使 Floodlight 代码具有唯一性的随机数字。
    • u1, u2, ...(如果有)是自定义 Floodlight 变量键值。

    其他参数通过 HTTP POST 中的 JSON 有效负荷发送:

    {
      "app": {
        "bundle": "com.rovio.angrybirds"
      },
      "device": {
        "ua": "Mozilla/5.0 (iPhone; CPU iPhone OS 6_0 like Mac OS X) AppleWebKit/536.26 (KHTML, like Gecko) Version/6.0 Mobile/10A5376e Safari/8536.25",
        "ip": "108.176.57.230",
        "didmd5": "A2D2DA47AC2DE1BCA16883BD5CAA6F2F",
        "lmt": 1
      }
    }
    

    广告客户授权令牌在 HTTP 授权标头中传递:

    Authorization: Token token="[advertiser authorization token string]"
    

    其中:

    • app(如果有)是代表发生转化活动的应用的 JSON 对象。
    • bundle(如果有)是包含 Play 商店绑定名称或 App Store ID 的字符串值的应用对象字段。
    • device 是代表发生转化活动的设备的 JSON 对象。
    • ua 是代表记录活动的应用的用户代理字符串的设备对象字段。此参数必不可少。
    • ip(如果有)是分配到设备的设备 IPv4 地址。此参数必不可少。
    • didmd5 是大写 IDFA 或 Google Play 广告 ID 值的 MD5 哈希字符串。
    • lmt 是一个整数。如果用户使用 IDFA/AdID 启用了“限制广告跟踪”选项,则值为 1;如果未设置,则值为 0。

    DDM 会使用 JSON 响应进行回应,以指示转化事件是否归因于 DCM 投放的展示或点击;如果“是”,则会提供相关事件(最终展示或最终点击)的更多信息:

    - Ad ID
    - Site ID
    - Placement ID
    - Creative ID
    - Timestamp
    

    以下是一个 JSON 响应示例:

    {"attributed": 1,  // Whether or not conversion can be attributed to DCM event.
     "last_impression_ad_id":283641088,
     "last_impression_site_id":1408067,
     "last_impression_placement_id":107616368,
     "last_impression_creative_id":60162352,
     "last_impression_timestamp":1415647607,
     "last_click_ad_id":283641088,
     "last_click_site_id":1408067,
     "last_click_placement_id":107616368,
     "last_click_creative_id":60162352,
     "last_click_timestamp":1415647657,
     "last_click_exclid":"CKm0nLKhyssCFceH2wod8l4I4A"}
    

    其中:

    • attributed 的值为 1(如果转化可归因于某次展示或点击),或者 0(如果不可归因)。
    • last_impression_ad_id(如果 attributed = 1)是最终展示的广告 ID。
    • last_impression_site_id(如果 attributed = 1)是最终展示的网站 ID。
    • last_impression_placement_id(如果 attributed = 1)是最终展示的展示位置 ID。
    • last_impression_creative_id(如果 attributed = 1)是最终展示的广告素材 ID。
    • last_click_ad_id(如果 attributed = 1 且已归因为点击)是最终点击的广告 ID。
    • last_click_site_id(如果 attributed = 1 且已归因为点击)是最终点击的网站 ID。
    • last_click_placement_id(如果 attributed = 1 且已归因为点击)是最终点击的展示位置 ID。
    • last_click_creative_id(如果 attributed = 1 且已归因为点击)是最终点击的广告素材 ID。
    • last_click_exclid 对应通过 %eiid! 宏填充的唯一点击 ID

    以及 HTTP 错误代码(对应以下情况):

    • 如果授权令牌无效,则返回 HTTP 401
    • 如果超出了请求配额,则返回 HTTP 204
    • 如果是错误请求,则返回 HTTP 404

    广告客户可以在您的系统中查看广告系列报告,还可以在 DCM 中查看包含上述参数的转化报告。