Bidders - 広告プロファイル サービス
インベントリを所有するメンバーは、品質管理目的でページ上で実行できる広告と実行できない広告の種類を定義するために、"広告承認プロファイル" を作成できます。 広告プロファイル サービスを使用すると、広告承認プロファイルを作成できます。 広告プロファイルを作成したら、 TinyTag サービス を介して個々の TinyTag に関連付けるか、 メンバー サービスを通じてメンバー レベルで広く設定できます。
承認プロファイルは、メンバー、ブランド、クリエイティブの 3 つの要素で構成されます。 広告プロファイルを作成するときは、システム内の各クリエイティブを個別に承認または禁止できますが、ブランドまたはメンバー全体を承認または禁止することで時間を節約できます。
- 広告が 常に 受け入れられると思われる場合は、メンバーを信頼する必要があります。 たとえば、特定のメディアを信頼して質の高い広告を掲載することができます。そのため、各クリエイティブを監査する必要性を軽減できます。
- このブランドの広告はほぼ 常に 受け入れられると思われる場合は、ブランドを信頼する必要があります。 ただし、特定のクリエイティブが "信頼できる" ブランドの一部であっても、常に禁止することができます。 特定のクリエイティブが禁止されていない場合は、既定で実行されます。
- このブランドの広告は 決して 受け入れられないと思われる場合は、ブランドを禁止する必要があります。 "禁止" ブランドによって割り当てられた特定のクリエイティブを承認 することはできません 。
- 既定のプロファイル (空白または ID を 0 に設定) にすると、他のメンバーからの不正な広告が禁止されます (つまり、クリエイティブの が TinyTag の 広告とは
member_id
異なる場合member_id
)。
HTTP メソッド | エンドポイント | 説明 |
---|---|---|
GET | https://api.adnxs.com/ad-profile/MEMBER_ID |
メンバーのすべての広告プロファイルを表示します。 |
GET | https://api.adnxs.com/ad-profile/MEMBER_ID/AD_PROFILE_ID |
特定の広告プロファイルを表示します。 |
POST | https://api.adnxs.com/ad-profile/MEMBER_ID |
新しい広告プロファイルを追加します。 |
PUT | https://api.adnxs.com/ad-profile/MEMBER_ID/AD_PROFILE_ID |
既存の広告プロファイルを変更します。 |
DELETE | https://api.adnxs.com/ad-profile/MEMBER_ID/AD_PROFILE_ID |
既存の広告プロファイルを削除します。 |
注意
"ブランド" と "クリエイティブ" は、広告プロファイルのサブセクションを構成します。
フィールド | 種類 | 説明 |
---|---|---|
active |
ブール値 | 既定値: true 広告プロファイルの状態 (アクティブ/非アクティブ)。 |
default_brand_status |
enum ('trusted', 'banned') | 明示的な選択が行われなかった場合に既定で使用されるブランドの状態。 |
description |
string | 説明 (任意) |
id |
int | 必須: 更新 このad_profileを参照するために API によって割り当てられた Xandr ID。 |
last_activity |
timestamp | この広告プロファイルに対する最後の変更のタイムスタンプ。 |
member_id |
int | 必須 このad_profileを所有するメンバー ID。 |
フィールド | 種類 | 説明 |
---|---|---|
id |
int | 必須 Xandr のブランド リスト内のブランドの ID。 |
status |
enum ('trusted', 'banned') | 必須 指定したブランドの信頼設定。 注: が status に"trusted" 設定されている場合brand 、ブランドの全体的なカテゴリが である場合でも、そのブランドに関連付けられているクリエイティブが"banned" 配信されます。 たとえば、ブランドを "1 と 1 のインターネット" (ID 17310) として信頼済みとしてマークした場合、そのブランドに関連付けられているクリエイティブは、カテゴリ "電気通信" (ID 27) を禁止した場合でも配信されます。 ブランド ID を取得し、ブランドが属するカテゴリを確認するには、 ブランド サービスを使用します。 カテゴリ ID の場合は、 カテゴリ サービスを使用します。 |
フィールド | 種類 | 説明 |
---|---|---|
approved |
ブール値 | 必須 指定されたクリエイティブが承認または禁止されているかどうか。 |
id |
int | 必須 エクスチェンジ クリエイティブの Xandr セット内のクリエイティブの ID。 |
フィールド | 種類 | 説明 |
---|---|---|
id |
int | メンバー ID。 |
status |
enum ('trusted', 'banned') | 広告プロファイル内のメンバーのクリエイティブに使用するアクション。 |
次に、"cat" コマンドを使用して、広告プロファイル JSON ファイルの例を出力しました。
$ cat ad_profile
{
"ad_profile":{
"member_id":25,
"brands":[
{
"id":23,
"status":"trusted"
},
{
"id":120,
"status":"banned"
},
{
"id":123,
"status":"banned"
}
],
"creatives":[
{
"id":4,
"approved":true
},
{
"id":12,
"approved":true
},
{
"id":123,
"approved":false
}
]
}
}
$ curl -b cookies -c cookies -d @ad_profile "https://api.adnxs.com/ad-profile/25"
{
"response": {
"status": "OK",
"id": "50"
}
}
$ curl -b cookies -c cookies "https://api.adnxs.com/ad-profile/25/50"
{
"response":{
"ad_profile":[
{
"id":50,
"member_id":25,
"brands":[
{
"id":"23",
"status":"trusted"
},
{
"id":"120",
"status":"banned"
},
{
"id":"123",
"status":"banned"
}
],
"creatives":[
{
"id":"4",
"approved":"true"
},
{
"id":"12",
"approved":"true"
},
{
"id":"123",
"approved":"false"
}
],
"active":true,
"last_activity":"2009-01-03 05:29:57"
}
],
"status":"OK"
}
}