剖析 SegmentRequest

在即時精選功能中，Google 會將 JSON SegmentRequest傳送至精選端點，提供一或多個曝光的信號，讓您判斷每個曝光適用的資料區隔。本指南說明如何開發處理 SegmentRequest 的精選邏輯。

使用 gzip 編碼

Google 會在將 SegmentRequest 傳送至端點時使用 gzip 編碼。端點必須能夠接收及回應 gzip 編碼。

使用比對內容信號或安全信號端點進行收錄

建立即時精選端點時，必須選取要接收脈絡信號或安全信號。您選取的信號會影響傳送至端點的區隔要求填入方式、產生傳送至端點區隔要求的廣告空間數量，以及整合作業中使用的策展邏輯。

使用比對內容信號

內容比對信號包含發布商、裝置和使用者資訊，可說明曝光的來源。以下列出可用的信號：

  • SegmentRequest.site： 說明顯示曝光的網站，例如網站網址。SegmentRequest.site 和 SegmentRequest.app 只能在 SegmentRequest 中填入其中一個。
  • SegmentRequest.app： 說明顯示曝光的應用程式，例如應用程式的平台專屬應用程式 ID。在 SegmentRequest 中，只能填入 SegmentRequest.site 和 SegmentRequest.app 其中之一。
  • SegmentRequest.pub： 說明顯示曝光的媒體發布者，例如發布者 ID。
  • SegmentRequest.user： 說明使用者對個人資料處理方式的選擇，例如資訊公開和同意聲明架構同意聲明字串。
  • SegmentRequest.device： 說明裝置相關資訊，例如裝置在都會區層級的地理位置精確度。

您可以使用內容比對信號實作管理邏輯，判斷要在 SegmentResponse 中傳回的適用資料區隔。

使用安全信號

安全信號是發布商建立的資料，可選擇與一或多個合作夥伴共用。這些 ID 會先經過模糊處理，再透過廣告請求與 Google 分享，並以模糊處理的形式顯示在即時精選的 SegmentRequest.user.eids.uids.id 中。

如果端點已設定為使用安全信號，則端點只會收到發布商廣告空間的區隔要求，而這些發布商已選擇與您的策劃帳戶共用安全信號。因此，與內容信號端點相比，可傳送至安全信號端點的曝光總數較少。

端點的策展邏輯必須解讀安全信號，並使用安全信號判斷適用的資料區隔，然後在 SegmentResponse 中傳回。

SegmentRequest 範例

比對內容信號即時精選端點

{
  "site":{
    "page":"https://dfpgpt.appspot.com/smd/"
  },
  "pub":{
    "id":"pub-1234567890987654"
  },
  "device":{
    "geo":{
      "country":"US",
        "metro":"501"
      }
    }
  }
}

安全信號即時精選端點

{
  "user": {
    "eids" : [ {
      "source": "pubcid.org",
      "uids":[
        { "id" :"OMITTED_SECURE_SIGNAL" }
      ]
    }]
  }
}

後續步驟