剖析 SegmentRequest

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

使用 gzip 編碼

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

使用比對內容信號或目標對象信號端點進行精選

建立 Real-time Curation 端點時,您必須選取要接收脈絡信號或目標對象信號。您選取的信號會影響傳送至端點的區隔要求填入方式、產生傳送至端點區隔要求的廣告空間量,以及整合中使用的策展邏輯。

使用比對內容信號

情境信號包括發布商、裝置和使用者資訊,用於說明曝光的來源。以下列出可用的信號:

  • SegmentRequest.site:說明顯示曝光的網站,例如網站網址。在 SegmentRequest 中,只能填入 SegmentRequest.site 和 SegmentRequest.app 其中之一。
  • 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"
      }
  }
}

目標對象信號即時策劃端點

{
  "device":{
    "ifa":"OMITTED_IFA"
  },
  "user": {
    "eids" : [ {
      "source": "pubcid.org",
      "uids":[
        { "id" :"OMITTED_SECURE_SIGNAL" }
      ]
    }],
    "buyeruid": "OMITTED_BUYERUID",
    "id": "OMITTED_ID"
  }
}

後續步驟