ユーザー プロフィールとは、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 TCF v2.0 の仕様で使用される TC 文字列について詳しくは、グローバル ベンダー リストと CMP リストの形式の透明性と同意の文字列をご覧ください。また、認定バイヤー様による IAB ヨーロッパの TCF の統合について詳しくは、認定バイヤーのコンテキストで TCF v2.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 文字列のパブリッシャーの制限セクションを表示して、パブリッシャーが目的 3
に必要なベンダー ID を制限しているかどうかを確認します。パブリッシャーの制限と TC 文字列に含まれるその他のデータについて詳しくは、
TC 文字列にはどのような情報が保存されますか?をご覧ください。
地域の追加条件を遵守する
追加の条件はオークションの結果によって異なり、特定の地域では、対応する入札リクエストのデータがユーザー
プロフィールの作成に使用できるかどうかを判断するために必要です。ユーザーのデバイスの位置情報は、BidRequest.device.geo
フィールドで確認できます。
BidRequest.device.geo フィールドを使用してユーザーのデバイスの位置情報を特定する方法について詳しくは、
地域ターゲティング ガイドをご覧ください。
EEA、英国、スイスの追加条件について
欧州経済領域(EEA)、英国、スイスのユーザー デバイスに配信されるインプレッションの入札リクエストのデータを使用してユーザー プロフィールを作成できるのは、対応する入札がオークションに参加して落札した場合のみです。
EEA、英国、スイス以外の地域の追加条件について
欧州経済領域(EEA)、英国、スイス以外のユーザー デバイスに配信されるインプレッションの入札リクエストのデータを使用してユーザー プロフィールを作成できるのは、対応する入札が次のいずれかの条件を満たしている場合のみです。
- 入札がオークションに参加して落札した。
- 入札がオークションに参加したが、価格競争で負けた。
- 入札がオークションに参加したが、入札単価がパブリッシャーの最小インプレッション単価を下回ったか、最小価格を下回ったため除外された。最小価格は、入札リクエストに含まれていない場合があります。
リアルタイム フィードバックを使用してオークションの結果を判断する
リアルタイム フィードバック
を使用すると、受信した入札
リクエストから、以前に送信した入札のオークションの結果を確認できます。以下に、openrtb-adx.proto
ファイルの BidFeedback メッセージの関連フィールドについて説明します。
| フィールド | 説明 |
|---|---|
request_id
|
対応する入札リクエストを識別するために使用される一意のリクエスト ID。このフィールドは、対応する入札リクエストの BidRequest.id フィールドと同じ値に設定されます。 |
creative_status_code
|
オークションの結果を説明するために使用されるステータス コード。 使用可能なステータス コードとその 意味については、creative-status-codes.txt をご覧ください。 |
落札通知と不落札通知を使用してオークションの結果を判断する
落札通知 URL または不落札通知 URL が ping されたときに、落札通知と不落札通知
を使用して、以前に送信した入札のオークションの結果を確認できます。落札通知 URL は BidResponse.seatbid.bid.nurl フィールドを使用して設定し、不落札通知 URL は BidResponse.seatbid.bid.lurl フィールドを使用して設定します。
オークションの結果に関する追加情報については、どちらかの通知 URL に設定されたクエリ文字列パラメータの値としてマクロ を指定できます。指定したエンドポイントが ping されると、対応する値に置き換えられます。関連するマクロについて以下に説明します。
| マクロ | 説明 |
|---|---|
${AUCTION_ID}
|
対応する入札リクエストを識別するために使用される一意のリクエスト ID。このフィールドは、対応する入札リクエストの BidRequest.id フィールドと同じ値に設定されます。 |
${CREATIVE_STATUS_CODE}
|
オークションの結果を説明するために使用されるステータス コード。使用可能なステータス コード とその意味については、creative-status-codes.txt をご覧ください。 |
クリエイティブのステータス コードを使用して追加条件を遵守する
追加条件を遵守するためのクリエイティブのステータス コードの値は次のとおりです。
| クリエイティブのステータス コード | 説明 | コンプライアンスの詳細 |
|---|---|---|
| 1 | 入札がオークションで落札されました。 | すべての地域で条件を満たしています。 |
| 79 | 価格競争で負けました。 | EEA、英国、スイス以外の地域で条件を満たしています。 |
| 80 | 入札単価が最小価格を下回っていました。 | EEA、英国、スイス以外の地域で条件を満たしています。 |
入札リクエストのデータを使用してユーザー プロフィールを作成できるのは、対応する入札レスポンスがユーザーのデバイスがある地域の追加条件を満たしている場合のみです。
対応例の確認
次の例では、入札リクエストがユーザー プロフィールの作成に使用できるかどうかを判断する方法を示す一連のイベントについて説明します。 簡潔にするため、これらの例に含まれる 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" }入札がオークションで落札され、落札通知 URL が
${AUCTION_ID}の展開された値で ping されます。http://example.com/win?bid_request_id=D3x8RPLO96R6T137tQ6168結論: 次の理由により、ベンダー ID
755と ATP ID99999は 、ID が「D3x8RPLO96R6T137tQ6168」の入札リクエストを使用して 、英国の Google ユーザー ID「D17oNZQUJqB4Rt4n4Ec61AC9tee」のユーザー プロフィールを作成できることがわかりました 。- 入札リクエストは次のことを示しています。
- ユーザーのデバイスは、IAB TCF が適用される地域にあります。
- TC 文字列は次のことを示しています。
- ユーザーがベンダー ID
755の目的 3 に同意しているため、ベンダー ID755はユーザー プロフィールを作成できます。 - パブリッシャーの制限はありません。
- ユーザーがベンダー ID
- ATP ID が
consented_providersフィールドに含まれているため、ATP ID99999もユーザー プロフィールを作成できます。 - パブリッシャーはユーザーデータの収集を許可しています。
- 入札リクエスト 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": "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" }入札がオークションで落札されなかったため、不落札通知 URL が
${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の目的 3 に同意しているため、ベンダー ID755はユーザー プロフィールを作成できます。 - パブリッシャーの制限はありません。
- ユーザーがベンダー ID
- パブリッシャーはユーザーデータの収集を許可しています。
- 入札リクエスト 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の目的 3 に同意しているため、ベンダー ID755はユーザー プロフィールを作成できます。 - ベンダー ID
755をターゲットとする目的 3 にはパブリッシャーの制限があります。
- ユーザーがベンダー ID
- パブリッシャーはユーザーデータの収集を許可しています。
- 入札リクエスト ID は「
D3x8RPLO96R6T137tQ6168」です。 - Google ユーザー ID は「
D17oNZQUJqB4Rt4n4Ec61AC9tee」です。 - ユーザーのデバイスは「
GBR」にあります。
- パブリッシャーの権限要件が満たされていません。
- 入札リクエストは次のことを示しています。
EEA 以外の入札リクエストが対象となる
次の例では、リアルタイム フィードバックを使用して、入札がオークションに参加したため、EEA 以外の地域からの入札リクエストが除外されたにもかかわらず対象となることを確認します。
入札エンドポイントが入札リクエストを受信します。
{ "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」の入札リクエストがオークションで落札されなかったことを示す入札リクエスト フィードバックを受け取りました。日本などの EEA 以外の国では、オークションに参加してこの理由で除外されると、追加条件が満たされます。 - 日本のパブリッシャーの権限と追加条件の要件が満たされています。
- 入札リクエストは次のことを示しています。
EEA 以外の入札リクエストが対象外となる
次の例では、リアルタイム フィードバックを使用して、オークションの前に除外されたため、EEA 以外の地域からの入札リクエストが対象外となることを確認します。
入札エンドポイントが入札リクエストを受信します。
{ "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」の入札リクエストがオークションに参加しなかったことを示す入札リクエスト フィードバックを受け取りました。 - 日本などの EEA 以外の国の追加条件の要件が満たされていません。
- 入札リクエストは次のことを示しています。
次のステップ
- RTB API UserLists リソース リファレンス: リマーケティングに使用されるユーザーリストの作成と変更に使用される リアルタイム ビッダー API の userLists リソースのリファレンス。
- Cookie Matching: リマーケティングに使用される Cookie Matching Service とその他の関連サービスのリファレンス。
- 広告 ID をユーザーリストにアップロードする: 識別子を ユーザーリストにアップロードするために使用される Bulk Uploader API のリファレンス。