使用出價要求建立使用者設定檔

使用者設定檔會將使用者 ID (例如 BidRequest.user.id 中包含的 Google 使用者 ID) 對應至使用者資訊，您可使用這些資訊，透過按照興趣顯示的廣告出價，或使用使用者名單進行再行銷。

只有在符合下列所有條件時，您才能使用出價要求中的資料建立使用者個人資料：

出價要求允許放送個人化廣告。在特定地區，您也必須確認使用者已同意系統使用出價要求中的資料建立使用者個人資料。
發布商已授予您權限，可使用出價要求資料進行使用者剖析。
其他條件：使用者裝置所在地理區域的條件已符合。

本指南說明如何根據發布商權限和競價結果，判斷出價要求是否可用於建立使用者個人資料。

判斷是否允許顯示個人化廣告

檢查「`non_personalized_ads_reason`」欄位

非個人化出價要求不適用於使用者剖析。使用 BidRequest.ext.privacy_treatments.non_personalized_ads_reason 欄位確認是否允許顯示個人化廣告。如果 non_personalized_ads_reason 已填入值，則不允許放送個人化廣告。

使用資訊公開和同意聲明 (TC) 字串檢查 IAB 供應商的同意聲明

在適用《GDPR》的地區，系統會使用 IAB 的資訊公開和同意聲明架構 (TCF)，告知哪些資料處理活動獲得許可。您可以使用 BidRequest.user.consent 欄位中的資訊公開和同意聲明 (TC) 字串，判斷哪些供應商 ID 已取得使用者同意聲明，可建立使用者設定檔。如要進一步瞭解 IAB 資訊公開和同意聲明架構第 2.0 版規格中使用的資訊公開和同意聲明字串，請參閱全球供應商和 CMP 清單格式的資訊公開和同意聲明字串。此外，請參閱買方的「歐洲互動廣告協會 (IAB) 資訊公開和同意聲明架構」整合作業，進一步瞭解如何在 Authorized Buyers 中整合 TCF 第 2.0 版規格。

您必須確認使用者已同意 TCF 目的 3，授權相關供應商使用出價要求中的資料建立使用者個人資料。如要進一步瞭解 TCF 用途，請參閱 IAB 的用途參考資料。

判斷發布商是否已授予權限

您必須獲得發布商的授權，才能使用出價要求中的資料建立使用者個人資料。只有在發布商允許收集使用者資料，且沒有發布商限制適用於用途 3 的必要供應商 ID 時，您才能使用出價要求資料建立使用者個人資料。

檢查發布商是否允許資料收集

您可以使用 BidRequest.ext.privacy_treatments.allow_user_data_collection 欄位，檢查發布商是否允許收集使用者資料。只有在 allow_user_data_collection 欄位設為 true 時，您才能使用出價要求的資料進行使用者剖析。

使用資訊公開和同意聲明 (TC) 字串檢查發布商限制

您可以剖析 BidRequest.user.consent 中的資訊公開和同意聲明 (TC) 字串，檢查必要供應商 ID 是否有任何發布商限制。查看 TC 字串的「發布商限制」部分，判斷發布商是否對必要供應商 ID 限制目的 3。如要進一步瞭解發布商限制和 TC 字串中包含的其他資料，請參閱「TC 字串中儲存了哪些資訊？」一文。

遵守該區域的額外條件

其他條件取決於競價結果，且必須符合特定區域的規定，相應出價要求的資料才能用於建立使用者個人資料。您可以使用 BidRequest.device.geo 欄位找出使用者的裝置位置。如要進一步瞭解如何使用 BidRequest.device.geo 欄位判斷使用者裝置位置，請參閱指定地理區域指南。

瞭解歐洲經濟區、英國和瑞士的額外條件

只有在您相應的出價進入競價並贏得競價時，才能使用向歐洲經濟區 (EEA)、英國和瑞士境內使用者裝置放送的曝光出價要求資料，建立使用者個人資料。

瞭解非歐洲經濟區、英國或瑞士地區的額外條件

如果向歐洲經濟區、英國和瑞士境外的使用者裝置放送曝光，只有在相應出價符合下列其中一項條件時，才能使用出價請求中的資料建立使用者設定檔：

您的出價進入競價並勝出。
您的出價進入競價，但最後落選。
您的出價已進入競價，但因低於發布商的最低千次曝光出價門檻或出價底價而遭到篩除。出價要求不一定會包含底價。

根據即時回饋判斷競價結果

您可以透過即時意見回饋，瞭解先前透過傳入出價要求出價的競價結果。以下說明 openrtb-adx.proto 檔案中 BidFeedback 訊息的相關欄位：

欄位	說明
`request_id`	專屬要求 ID，用於識別相應的出價要求。這個欄位的值會與對應出價要求的 `BidRequest.id` 欄位相同。
`creative_status_code`	用來描述競價結果的狀態碼。您可以在 creative-status-codes.txt 中找到可能的狀態碼及其意義。

使用勝出和落敗通知判斷競價結果

當系統 ping 您的得標/落敗通知網址時，您可以使用得標和落敗通知，瞭解先前出價的競價結果。您可以使用 BidResponse.seatbid.bid.nurl 欄位設定勝出通知網址，並使用 BidResponse.seatbid.bid.lurl 欄位設定落敗通知網址。

您可以指定巨集做為查詢字串參數的值，並為通知網址設定這些參數，以取得競價結果的額外資訊。系統在 ping 指定端點時，會將這些預留位置換成對應值。以下說明相關巨集：

巨集	說明
`${AUCTION_ID}`	專屬要求 ID，用於識別相應的出價要求。這個欄位會設為與對應出價要求的 `BidRequest.id` 欄位相同的值。
`${CREATIVE_STATUS_CODE}`	用來描述競價結果的狀態碼。您可以在 creative-status-codes.txt 中找到可能的狀態碼及其意義

使用廣告素材狀態代碼遵守其他條件

如要遵守其他條件，相關廣告素材狀態代碼值包括：

廣告素材狀態碼	說明	法規遵循詳細資料
1	您的出價贏得競價。	所有區域都符合條件。
79	出價較低。	符合非歐洲經濟區、英國或瑞士地區的條件。
80	您的出價低於底價。	符合非歐洲經濟區、英國或瑞士地區的條件。

只有在相應的出價回應符合使用者裝置所在區域的額外條件時，您才能使用出價要求資料建構使用者個人資料。

查看範例

下列範例將逐步說明一連串事件，顯示如何判斷出價要求是否符合用於建立使用者個人資料的資格。為簡潔起見，這些範例中包含的 JSON 出價要求和出價回應物件，只會納入判斷資格所需的欄位。

由於發布商封鎖資料收集，因此出價要求不符合資格

出價端點會收到出價要求：

{
  "id": "D3x8RPLO96R6T137tQ6168",
  "device": {
    "geo": {
      "country": "GBR"
    }
  },
  "user": {
    "id": "D17oNZQUJqB4Rt4n4Ec61AC9tee"
  }
}

結論：出價要求不會填入 BidRequest.ext.privacy_treatments.allow_user_data_collection，因為該值為 false。因此，我們可以判斷這項出價要求不符合用於建立使用者設定檔的資格，因為發布商權限規定尚未符合。

找出符合英國資格的出價要求

以下範例使用勝出通知，判斷來自英國裝置的出價要求資料，是否符合用於供應商 ID 755 和 ATP ID 99999 的使用者剖析：

出價端點會收到出價要求：

{
  "id": "D3x8RPLO96R6T137tQ6168",
  "imp": [
    {
      "bidfloor": 140.414643547123,
      "bidfloorcur": "JPY"
    }
  ],
  "device": {
    "geo": {
      "country": "GBR"
    }
  },
  "user": {
    "consent": "CQhuOAQQhuOAQB7ACBENCOEIALAAAELAAAwIF5gAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAgXmAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACAAA.gF5gAAAAAAAAAAAAAAABAAAAAAAAAAAAAAAAEAAAAAAAAAAAAAAAAQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAg",
    "id": "D17oNZQUJqB4Rt4n4Ec61AC9tee",
    "ext": {
      "consented_providers_settings": {
        "consented_providers": [99999]
      }
    }
  },
  "regs": {
    "ext": {
      "gdpr": 1
    }
  },
  "ext": {
    "privacy_treatments": {
      "allow_user_data_collection": 1
    }
  }
}

您出價：

{
  "seatbid": [
    {
      "bid": [
        {
          "price": 149.83914184570312,
          "lurl": "http://example.com/loss?bid_request_id=${AUCTION_ID}&creative_status_code=${CREATIVE_STATUS_CODE}",
          "nurl": "http://example.com/win?bid_request_id=${AUCTION_ID}"
        }
      ]
    }
  ],
  "cur": "JPY"
}

您的出價在競價中勝出，系統會使用 ${AUCTION_ID} 的擴展值 Ping 您的勝出通知網址：

http://example.com/win?bid_request_id=D3x8RPLO96R6T137tQ6168
結論：您現在知道供應商 ID 755 和 ATP ID 99999 有資格使用 ID 為「D3x8RPLO96R6T137tQ6168」的出價要求，在英國為 Google 使用者 ID「D17oNZQUJqB4Rt4n4Ec61AC9tee」建立使用者設定檔，因為：
- 出價要求會指出下列事項：
  - 使用者裝置位於強制執行 IAB TCF 的地區。
  - 資訊公開和同意聲明 (TC) 字串指出：
    - 使用者允許供應商 ID 755 建立使用者個人資料，因為使用者已同意供應商 ID 755 的第 3 項目的。
    - 沒有發布商限制。
  - 使用者也允許 ATP ID 99999 建構使用者個人資料，因為 ATP ID 包含在 consented_providers 欄位中。
  - 發布商允許資料收集。
  - 出價要求 ID 為「D3x8RPLO96R6T137tQ6168」。
  - Google 使用者 ID 為「D17oNZQUJqB4Rt4n4Ec61AC9tee」。
  - 使用者裝置位於「GBR」。
- 系統會使用查詢字串參數 ping 您的勝出通知端點，指出 ID 為「D3x8RPLO96R6T137tQ6168」的出價要求已贏得競價。
- 已符合英國的使用者同意聲明、發布者權限和額外條件規定。

找出因競價落敗而無法放送的英國出價要求

以下範例判斷供應商 ID 755 無法使用出價要求進行使用者剖析，因為發布商已限制供應商 ID 755 的目的 3。

出價端點會收到出價要求：

{
  "id": "D3x8RPLO96R6T137tQ6168",
  "imp": [
    {
      "bidfloor": 140.414643547123,
      "bidfloorcur": "JPY"
    }
  ],
  "device": {
    "geo": {
      "country": "GBR"
    }
  },
  "user": {
    "consent": "CQhuOAQQhuOAQB7ACBENCOEIALAAAELAAAwIF5gAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAgXmAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACAAA.gF5gAAAAAAAAAAAAAAABAAAAAAAAAAAAAAAAEAAAAAAAAAAAAAAAAQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAg",
    "id": "D17oNZQUJqB4Rt4n4Ec61AC9tee"
  },
  "regs": {
    "ext": {
      "gdpr": 1
    }
  },
  "ext": {
    "privacy_treatments": {
      "allow_user_data_collection": 1
    }
  }
}

您出價：

{
  "seatbid": [
    {
      "bid": [
        {
          "price": 149.83914184570312,
          "lurl": "http://example.com/loss?bid_request_id=${AUCTION_ID}&creative_status_code=${CREATIVE_STATUS_CODE}",
          "nurl": "http://example.com/win?bid_request_id=${AUCTION_ID}"
        }
      ]
    }
  ],
  "cur": "JPY"
}

您的出價在競價中落敗，導致系統使用 ${AUCTION_ID} 和 ${CREATIVE_STATUS_CODE} 的擴展值，對您的落敗通知網址執行 Ping 操作：

http://example.com/loss?bid_request_id=D3x8RPLO96R6T137tQ6168&creative_status_code=79
結論：您現在知道，由於下列原因，ID 為「D3x8RPLO96R6T137tQ6168」的出價要求不符合在英國為 Google 使用者 ID「D17oNZQUJqB4Rt4n4Ec61AC9tee」建立使用者設定檔的資格：
- 出價要求會指出下列事項：
  - 使用者裝置位於強制執行 IAB TCF 的地區。
  - 資訊公開和同意聲明 (TC) 字串指出：
    - 使用者允許供應商 ID 755 建立使用者個人資料，因為使用者已同意供應商 ID 755 的第 3 項目的。
    - 沒有發布商限制。
  - 發布商允許資料收集。
  - 出價要求 ID 為「D3x8RPLO96R6T137tQ6168」。
  - Google 使用者 ID 為「D17oNZQUJqB4Rt4n4Ec61AC9tee」。
  - 使用者裝置位於「GBR」。
- 系統會使用查詢字串參數 Ping 您的損失通知端點，指出 ID 為「D3x8RPLO96R6T137tQ6168」的出價要求因出價較低而未贏得競價。
- 未符合英國的額外條件規定。

找出因發布商限制而無法在英國放送的出價要求

在下列範例中，發布商已限制供應商 ID 755 的目的 3，因此供應商 ID 755 無法使用出價要求進行使用者側寫。

出價端點會收到出價要求：

{
  "id": "D3x8RPLO96R6T137tQ6168",
  "imp": [
    {
      "bidfloor": 140.414643547123,
      "bidfloorcur": "JPY"
    }
  ],
  "device": {
    "geo": {
      "country": "GBR"
    }
  },
  "user": {
    "consent": "CQhuhyAQhuhyAB7ACBENCOEIALAAAELAAAwIF5gAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAgXmAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACAGCAAgLzDAAQF5iAAIC8w.gF5gAAAAAAAAAAAAAAABAAAAAAAAAAAAAAAAEAAAAAAAAAAAAAAAAQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAg"
  },
  "regs": {
    "ext": {
      "gdpr": 1
    }
  },
  "ext": {
    "privacy_treatments": {
      "allow_user_data_collection": 1
    }
  }
}

您出價：

{
  "seatbid": [
    {
      "bid": [
        {
          "price": 149.83914184570312,
          "lurl": "http://example.com/loss?bid_request_id=${AUCTION_ID}&creative_status_code=${CREATIVE_STATUS_CODE}",
          "nurl": "http://example.com/win?bid_request_id=${AUCTION_ID}"
        }
      ]
    }
  ],
  "cur": "JPY"
}

結論：您現在知道，供應商 ID 755 無法使用 ID 為「D3x8RPLO96R6T137tQ6168」的出價要求建立使用者設定檔，因為：
- 出價要求會指出下列事項：
  - 使用者裝置位於強制執行 IAB TCF 的地區。
  - 資訊公開和同意聲明 (TC) 字串指出：
    - 使用者允許供應商 ID 755 建立使用者個人資料，因為使用者已同意供應商 ID 755 的第 3 項目的。
    - 目的 3 指定目標供應商 ID 755 有發布商限制。
  - 發布商允許資料收集。
  - 出價要求 ID 為「D3x8RPLO96R6T137tQ6168」。
  - Google 使用者 ID 為「D17oNZQUJqB4Rt4n4Ec61AC9tee」。
  - 使用者裝置位於「GBR」。
- 不符合發布商權限規定。

找出符合資格的非歐盟出價要求

以下範例使用即時意見回饋判斷，雖然出價要求已遭篩選，但由於出價已進入競價，因此來自非歐洲經濟區的出價要求仍符合資格。

出價端點會收到出價要求：

{
  "id": "D3x8RPLO96R6T137tQ6168",
  "imp": [
    {
      "bidfloor": 140.414643547123,
      "bidfloorcur": "JPY"
    }
  ],
  "device": {
    "geo": {
      "country": "JPN"
    }
  },
  "user": {
    "id": "D17oNZQUJqB4Rt4n4Ec61AC9tee"
  },
  "ext": {
    "privacy_treatments": {
      "allow_user_data_collection": 1
    }
  }
}

您出價：

{
  "seatbid": [
    {
      "bid": [
        {
          "price": 120.846348234842
        }
      ]
    }
  ],
  "cur": "JPY"
}

您的出價在競價中落敗。在日後的出價要求中，出價端點會收到包含即時意見回饋的出價要求：

{
  "id": "9B5K1zj5T61jRM80t25s13",
  "ext": {
    "bid_feedback": [
      {
        "request_id": "3265hT3M9Uq7370Ou263Zp",
        "creative_status_code": 1
      },
      {
        "request_id": "D3x8RPLO96R6T137tQ6168",
        "creative_status_code": 80
      }
    ]
  }
}

結論：您現在知道，由於下列原因，ID 為「D3x8RPLO96R6T137tQ6168」的出價要求符合資格，可為日本的 Google 使用者 ID「D17oNZQUJqB4Rt4n4Ec61AC9tee」建立使用者設定檔：
- 出價要求會指出下列事項：
  - 使用者裝置位於未強制執行 IAB TCF 的地區。
  - 發布商允許資料收集。
  - 出價要求 ID 為「D3x8RPLO96R6T137tQ6168」。
  - Google 使用者 ID 為「D17oNZQUJqB4Rt4n4Ec61AC9tee」。
  - 使用者裝置位於「JPN」。
- 您收到出價要求意見回饋，指出 ID 為「D3x8RPLO96R6T137tQ6168」的出價要求因出價低於底價而落選。如果是日本等非歐洲經濟區國家/地區，只要進入競價並因此遭到篩除，即符合額外條件。
- 已符合日本的發布商權限和額外條件規定。

發現非歐洲經濟區出價要求不符合資格

以下範例使用即時意見回饋，判斷來自非歐洲經濟區的出價要求不符合資格，因為該要求在競價前遭到篩除。

出價端點會收到出價要求：

{
  "id": "D3x8RPLO96R6T137tQ6168",
  "imp": [
    {
      "bidfloor": 140.414643547123,
      "bidfloorcur": "JPY"
    }
  ],
  "device": {
    "geo": {
      "country": "JPN"
    }
  },
  "user": {
    "id": "D17oNZQUJqB4Rt4n4Ec61AC9tee"
  },
  "ext": {
    "privacy_treatments": {
      "allow_user_data_collection": 1
    }
  }
}

您出價：

{
  "seatbid": [
    {
      "bid": [
        {
          "price": 149.83914184570312
        }
      ]
    }
  ],
  "cur": "JPY"
}

您的出價在競價中落敗。在日後的出價要求中，出價端點會收到包含即時意見回饋的出價要求：

{
  "id": "9B5K1zj5T61jRM80t25s13",
  "ext": {
    "bid_feedback": [
      {
        "request_id": "3265hT3M9Uq7370Ou263Zp",
        "creative_status_code": 1
      },
      {
        "request_id": "D3x8RPLO96R6T137tQ6168",
        "creative_status_code": 10
      }
    ]
  }
}

結論：您現在知道，由於下列原因，ID 為「D3x8RPLO96R6T137tQ6168」的出價要求不符合資格，無法在日本為 Google 使用者 ID「D17oNZQUJqB4Rt4n4Ec61AC9tee」建立使用者設定檔：
- 出價要求會指出下列事項：
  - 使用者裝置位於未強制執行 IAB TCF 的地區。
  - 發布商允許資料收集。
  - 出價要求 ID 為「D3x8RPLO96R6T137tQ6168」。
  - Google 使用者 ID 為「D17oNZQUJqB4Rt4n4Ec61AC9tee」。
  - 使用者裝置位於「JPN」。
- 您收到出價要求意見回饋，指出出價要求 (ID 為「D3x8RPLO96R6T137tQ6168」) 因出價使用遭拒登的廣告素材而未進入競價。
- 尚未符合非歐洲經濟區國家/地區 (例如日本) 的額外條件規定。

後續步驟

RTB API UserLists 資源參考資料：即時出價 API 的 userLists 資源參考資料，用於建立及修改再行銷用的使用者名單。
Cookie 比對：再行銷使用的 Cookie 比對服務和其他相關服務參考資料。
將廣告 ID 上傳至使用者名單：用於將 ID 上傳至使用者名單的 Bulk Uploader API 參考資料。

使用出價要求建立使用者設定檔 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

判斷是否允許顯示個人化廣告

檢查「non_personalized_ads_reason」欄位

使用資訊公開和同意聲明 (TC) 字串檢查 IAB 供應商的同意聲明

判斷發布商是否已授予權限

檢查發布商是否允許資料收集

使用資訊公開和同意聲明 (TC) 字串檢查發布商限制

遵守該區域的額外條件

瞭解歐洲經濟區、英國和瑞士的額外條件

瞭解非歐洲經濟區、英國或瑞士地區的額外條件

根據即時回饋判斷競價結果

使用勝出和落敗通知判斷競價結果

使用廣告素材狀態代碼遵守其他條件

查看範例

由於發布商封鎖資料收集，因此出價要求不符合資格

找出符合英國資格的出價要求

找出因競價落敗而無法放送的英國出價要求

找出因發布商限制而無法在英國放送的出價要求

找出符合資格的非歐盟出價要求

發現非歐洲經濟區出價要求不符合資格

後續步驟

使用出價要求建立使用者設定檔

檢查「`non_personalized_ads_reason`」欄位