メンバー プロファイル サービスを使用すると、単一のグローバル プロファイルを確立して、サードパーティのインプレッションを受け入れる国/地域とドメインを制限できます。 メンバー プロファイルの要件に一致しないサードパーティのインプレッションに対しては、キャンペーンは入札されません。
キャンペーン プロファイルをメンバー プロファイルに合わせる
キャンペーン プロファイル をメンバー プロファイルに合わせるようにしてください。それ以外の場合、キャンペーンのターゲティングが効果的でない可能性があります。
- 例 1: 米国とカナダからのサードパーティのインプレッションを受け入れるようにメンバー プロファイルが設定されています。 米国、カナダ、メキシコからのインプレッションをターゲットにキャンペーンを設定しています。 この場合、メンバー プロファイルによりメキシコからのインプレッションを入札できないため、キャンペーンはメキシコからのインプレッションをターゲットにする機会がなくなります。
- 例 2: メンバー プロファイルが、ドメイン リスト 1 (apples.com、oranges.com、pears.com を含む) からサードパーティのインプレッションをブロックするように設定されています。 キャンペーンは、plums.com、bananas.com、apples.com を含むドメイン リスト 3 をターゲットとするように設定されています。 apples.com はドメイン リスト 1 とドメイン リスト 3 の両方に含まれます。 この場合、メンバー プロファイルがドメイン リスト 1 をブロックするため、キャンペーンは apples com からのインプレッションをターゲットにする機会がなくなります。
REST API
| HTTP メソッド | エンドポイント | 説明 |
|---|---|---|
POST |
https://api.appnexus.com/member-profile (member-profile JSON) |
メンバー プロファイルを作成する |
PUT |
https://api.appnexus.com/member-profile (member-profile JSON) |
メンバー プロファイルを更新する |
GET |
https://api.appnexus.com/member-profile |
メンバー プロファイルを表示する |
DELETE |
https://api.appnexus.com/member-profile |
メンバー プロファイルを削除する |
GET |
https://api.appnexus.com/member-profile/meta |
フィルター処理や並べ替えの基準となるフィールドを確認する |
注:
メンバー プロファイルは 1 つだけなので、 PUT、 GET、または DELETE 要求にプロファイル ID を含める必要はありません。
JSON フィールド
| フィールド | 種類 | 説明 |
|---|---|---|
id |
int | メンバー プロファイルの ID。 |
domain_list_action |
列挙 |
domain_list_targetsで実行するアクション。 使用可能な値: - "include" - サードパーティのインプレッションは、指定されたドメイン リスト内のドメインからのインプレッションのみを受け入れます。 - "exclude" - 指定されたドメイン リストに含まれるものを除くすべてのドメインからのサードパーティのインプレッションを受け入れます。既定値: "exclude" |
domain_list_targets |
配列 | 含めるまたは除外する ドメインのリスト 。 書式設定については、次の 例 を参照してください。 |
country_targets |
配列 | サードパーティのインプレッションを受け入れる国/地域。 これらの国/地域からのインプレッションのみを受け付けます。 国/地域を指定しない場合は、すべての国/地域からのサードパーティのインプレッションを受け入れることになります。 以下の 例 を参照してください。 |
last_modified |
date | 読み取り専用です。 メンバー プロファイルが最後に変更された日付。 |
inventory_url_list_targets |
オブジェクトの配列 | インベントリ リスト ID (許可リストまたはブロックリスト) のリストが含まれます。 1 つの許可リストまたは 1 つ以上のブロックリストをプロファイルに添付するために使用します。 - 許可リストには、プロファイルを使用する明細行項目の対象となるドメインまたはアプリのリストが含まれています。 許可リストが含まれている場合、許可リストに含まれていないドメインとアプリは対象になりません。 - 各ブロックリストには、プロファイルを使用するライン アイテムによるターゲティングから除外するドメインまたはアプリのリストが含まれています。 詳細については、「プロファイル サービスのインベントリ リスト」を参照してください。 |
require_transparency_and_consent_framework_string |
ブール値 |
trueの場合、有効な TCF 文字列が存在する場合にのみ、関連付けられたオブジェクトがインベントリを購入できるようにしますfalseする場合、関連付けられたオブジェクトが事前定義されたターゲティング宣言に含まれるインベントリを購入できるようにします。注: このパラメータは、GDPR が適用される地域から送信されるトラフィックにのみ適用されます。 既定値: false |
例
メンバー プロファイルの作成
$ cat profile { "member-profile": { "domain_list_action": "include", "domain_list_targets": [ { "id": 23620 }, { "id": 23625 } ], "country_targets": [ { "id": 1 }, { "id": 2 } ] } } $ curl -b cookies -X POST -d @profile 'https://api.appnexus.com/member-profile' { "response": { "status": "OK", "id": 121740 } }
メンバー プロフィールを更新して、別の国からのサードパーティのインプレッションを受け入れる
$ cat profile_update { "member-profile": { "country_targets": [ { "id": 233 }, { "id": 59 } ] } } $ curl -b cookies -X PUT -d @profile_update 'https://api.appnexus.com/member-profile' { "response": { "status": "OK", "id": 121740 } }
メンバー プロファイルの表示
$ curl -b cookies 'https://api.appnexus.com/member-profile' { "response": { "status": "OK", "member-profile": { "id": 121740, "domain_list_action": "include", "country_targets": [ { "id": 233, "name": "United States", "code": "US" }, { "id": 58, "name": "Czech Republic", "code": "CZ" }, { "id": 59, "name": "Germany", "code": "DE" } ], "domain_list_targets": [ { "id": "23620", "name": "Domain List 1", "description": "Include Domain List 1", "type": "white" }, { "id": "23625", "name": "Domain List 2", "description": "Include Domain List 2", "type": "white" } ], "last_modified": "2011-12-15 16:57:51" }, "count": 1, "start_element": 0, "num_elements": 100 } }
透明性と同意のフレームワーク文字列が必要
{
"profile": {
"require_transparency_and_consent_framework_string": "false",
}
}