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

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

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

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

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

  5. 最终用户看到和/或点击由 DDM 记录的广告。

  6. 当最终用户安装应用并/或完成转化事件(“玩游戏”等)时,第三方服务器会针对每个应用活动“Ping”DDM

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

    其中:

    • src 是作为 Floodlight 活动来源的广告客户 ID。
    • 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 对象。如果发生转化活动的应用不可用,请使用 app: {}
    • 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 the conversion can be attributed to a 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(如果 attribution = 1)是最后一次展示的广告 ID。
    • last_impression_site_id(如果 attribution = 1)是最终展示的网站 ID。
    • last_impression_placement_id(如果 attribution = 1)是最终展示的展示位置 ID。
    • last_impression_creative_id(如果 attribution = 1)是最终展示的广告素材 ID。
    • last_click_ad_id(如果 attribution = 1 且归因于归因)是最终点击的广告 ID。
    • last_click_site_id(如果 attribution = 1 且归因于点击)是最终点击的网站 ID。
    • last_click_placement_id(如果 attribution = 1 且归因于点击)是最终点击的展示位置 ID。
    • last_click_creative_id(如果 attribution = 1 且归因于点击)是最终点击的广告素材 ID。
    • last_click_exclid 对应通过 %eiid! 宏填充的唯一点击 ID

    替换为 HTTP 错误代码:

    • 如果超出了请求配额,则返回 HTTP 204
    • 如果请求被视为无效(例如缺少必需参数),且服务器已回退到像素跟踪,则返回 HTTP 400
    • 如果授权令牌无效,则返回 HTTP 401
    • HTTP 404(如果有错误请求)。

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