接收曝光通知

每當 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} 代表競價得標價格的字串。 價格為單次曝光費用 (單次曝光出價)，以百萬分之一美元表示。舉例來說，如果即時出價出價為 $5 美元千次曝光出價，則在即時精選曝光通知中，${AUCTION_PRICE} 巨集會擴展為 5000 微美元單次安裝出價。
${DEAL_ID} 贏得競價的交易或套裝方案 ID。這是指以一或多個資料區隔 ID 為目標的交易或套裝組合，可使用 ${SEGMENT_IDS} 巨集識別。
${BUYER_SEAT_ID} 贏得曝光的買家帳戶 ID，由出價方在勝出出價中指定。舉例來說，買方席位可以是代理商或廣告主。

後續步驟