英語で読む

次の方法で共有


Bidders - 広告プロファイル サービス

インベントリを所有するメンバーは、品質管理目的でページ上で実行できる広告と実行できない広告の種類を定義するために、"広告承認プロファイル" を作成できます。 広告プロファイル サービスを使用すると、広告承認プロファイルを作成できます。 広告プロファイルを作成したら、 TinyTag サービス を介して個々の TinyTag に関連付けるか、 メンバー サービスを通じてメンバー レベルで広く設定できます。

承認プロファイルは、メンバー、ブランド、クリエイティブの 3 つの要素で構成されます。 広告プロファイルを作成するときは、システム内の各クリエイティブを個別に承認または禁止できますが、ブランドまたはメンバー全体を承認または禁止することで時間を節約できます。

  • 広告が 常に 受け入れられると思われる場合は、メンバーを信頼する必要があります。 たとえば、特定のメディアを信頼して質の高い広告を掲載することができます。そのため、各クリエイティブを監査する必要性を軽減できます。
  • このブランドの広告はほぼ 常に 受け入れられると思われる場合は、ブランドを信頼する必要があります。 ただし、特定のクリエイティブが "信頼できる" ブランドの一部であっても、常に禁止することができます。 特定のクリエイティブが禁止されていない場合は、既定で実行されます。
  • このブランドの広告は 決して 受け入れられないと思われる場合は、ブランドを禁止する必要があります。 "禁止" ブランドによって割り当てられた特定のクリエイティブを承認 することはできません
  • 既定のプロファイル (空白または ID を 0 に設定) にすると、他のメンバーからの不正な広告が禁止されます (つまり、クリエイティブの が TinyTag の 広告とはmember_id異なる場合member_id)。

Rest API

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 既存の広告プロファイルを削除します。

JSON フィールド

注意

"ブランド" と "クリエイティブ" は、広告プロファイルのサブセクションを構成します。

広告プロファイル

フィールド 種類 説明
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') 広告プロファイル内のメンバーのクリエイティブに使用するアクション。

新しい広告プロファイルを作成するには、JSON 形式のテキスト ファイルを作成します

次に、"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
         }
      ]
   }
}

POST リクエストでこの広告プロファイルをメンバー (25) に追加する

$ curl -b cookies -c cookies -d @ad_profile  "https://api.adnxs.com/ad-profile/25"
{
    "response": {
        "status": "OK",
        "id": "50"
    }
}

広告プロファイルの ID は 50 です。 GET 要求を使用して表示できます。

$ 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"
   }
}