接收展示通知

每当 Google 检测到您的数据细分在实时出价竞价中赢得竞价并促成展示时，您都可以收到展示通知。Google 建议您与展示通知集成，以便详细了解数据细分受众群的使用情况。 如需启用展示通知，请与您的客户经理联系。

配置展示通知端点

您必须创建 HTTP 端点并与 Google 分享其网址，才能接收展示通知。您可以使用以下任一选项设置展示通知的发送网址：

  1. 为每个实时精选广告标示设置展示通知端点网址。
    • 您可以通过填充 SegmentResponse.burl 字段，动态设置您收到的每个实时内容精选标注的展示通知所用的网址。
    • 对于给定的实时甄选标注，您必须设置 SegmentResponse.burl 字段，才能接收该标注的展示通知。如果未填充 SegmentResponse.burl 字段，即使之前的宣传信息中设置了 SegmentResponse.burl 字段，也不会针对该宣传信息发送通知。
  2. 设置账号级展示通知端点网址。
    • 您可以与客户经理联系，为您的账号设置账号级展示通知端点网址。如果您的端点网址不经常更改，则此方法非常适合。
    • 所有实时甄选广告附加信息都将使用您为账号配置的账号级展示通知网址，除非您通过为单个实时甄选广告附加信息设置 SegmentResponse.burl 字段来替换账号级网址。

解析展示通知

展示通知中发送的信息取决于展示通知端点网址的配置。您的端点网址可以包含查询参数，并使用宏来添加有关以下方面的其他背景信息：赢得竞价（促成展示）的广告如何使用您的数据细分受众群。

了解宏的展开方式

如果您将端点网址配置为包含一个或多个设置为宏的查询参数，则发送到端点的展示通知将展开这些宏，并将其替换为相应的值。

例如，您可以将展示通知端点网址配置为如下所示：

https://testendpoint.com/impressions?segmentReqId=${SR_ID}&segmentIds=${SEGMENT_IDS}

收到展示通知时，宏会被替换，导致网址如下所示：

https://testendpoint.com/impressions?segmentReqId=8Mbl39sMOX5yg1NZgS35ET&segmentIds=test-ds-1|test-ds-2

了解支持的宏

以下是您可以添加到展示通知端点网址的查询参数中的宏。这些宏会被替换为与一个或多个数据段促成的胜出出价相关的值。

宏 说明
${SR_ID} 一个唯一的字符串 ID，相当于相应实时精选广告的 SegmentRequest.segment_request_id 字段。指您使用促成胜出出价的一个或多个数据细分受众群 ID 响应的细分受众群请求。
${SEGMENT_IDS} 促成胜出出价的字符串数据细分 ID 的列表。列表中的各项内容以“|”字符分隔。例如，此参数可以扩展为值列表，例如： "segmentId1|segmentId2|segmentId3" 填充列表的每个数据段 ID 都指 Marketplace API 中相应 curators.dataSegments 资源的资源 ID。
${AUCTION_PRICE} 表示竞价胜出价格的字符串。 价格是指单次展示的费用（每次展示费用，CPI），以微美元表示。例如，如果实时出价的每千次展示费用出价为 5 美元，则在实时甄选展示通知中，${AUCTION_PRICE} 宏会扩展为 5000 微美元 CPI。
${DEAL_ID} 赢得竞价的交易或竞价包的 ID。这是以一个或多个数据细分 ID 为定位条件的交易或套餐，可通过 ${SEGMENT_IDS} 宏进行标识。
${BUYER_SEAT_ID} 赢得展示机会的买方账号的 ID，由出价方在胜出出价中指定。例如，买方席位可以是代理机构或广告客户。

后续步骤