次の方法で共有

広告品質ルール サービス

  • [アーティクル]

広告品質ルールは、ネットワークが管理対象のパブリッシャーに対して定義できる広告品質設定を定義します。 1 つのネットワークで、パブリッシャーのインベントリ全体に複数の広告品質ルールが条件付きで適用される場合があります。 たとえば、特定の地理的な場所からのトラフィックでは、異なる広告品質設定が必要になる場合があります。

REST API

注:

  • publisher_code publisher_idの代わりに使用でき、ad_quality_rule_codeは以下のすべての呼び出しにad_quality_rule_idの代わりに使用できます。
  • 広告品質 (AQ) が "default_brand_status": "banned" に設定されていても、親ブランドが "status": "trusted"に設定されている場合、子ブランドは "default_brand_status" の設定をオーバーライドし、広告プロファイルのブランドオーバーライドリストで明示的に禁止されていない限り、配信できるようになります。
HTTP メソッド エンドポイント 説明
POST https://api.appnexus.com/ad-quality-rule?publisher_id=PUBLISHER_ID
(支払ルール JSON)		 広告品質ルールを追加します。
PUT https://api.appnexus.com/ad-quality-rule?id=AD_QUALITY_RULE_ID&p ublisher_id=PUBLISHER_ID
(パブリッシャー ルール JSON)		 既存の広告品質規則を変更します。
GET https://api.appnexus.com/ad-quality-rule?publisher_id=PUBLISHER_ID パブリッシャーのすべての広告品質ルールを表示します。
GET https://api.appnexus.com/ad-quality-rule?id=AD_QUALITY_RULE_ID パブリッシャーの特定の広告品質ルールを表示します。
GET https://api.appnexus.com/ad-quality-rule?id=1,2,3 コンマ区切りのリストを使用して、ID で複数の広告品質ルールを表示します。

JSON パラメーター

パラメーター 種類 説明
id int 広告品質ルールの一意識別子。
デフォルト： 自動インクリメントされた数値 (つまり 123)。
必須:PUT
code string 広告品質ルールを参照するために使用するオプションのカスタム コード。
デフォルト： ヌル
name string 広告品質ルールの説明に使用される名前。
デフォルト： 何一つ
必須:POST
description string 省略可能な説明。
ad_profile_id int このルールに適用する必要がある品質制限を定義する広告プロファイルを提供する必要があります。
必須:POST
publisher_id int この広告品質ルールが適用される発行元の ID。
必須のオン:POST そして PUT
member_id int この広告品質ルールが適用されるパブリッシャーのメンバーの ID。
profile_id int オプションの profile_id を使用して、広告品質ルールを適用するタイミングを決定します。 プロファイルは、インベントリをターゲットにするための一般的なルールのセットであり、特定の広告品質ルールは特定の広告枠にのみ適用されます。 詳細については、 プロファイル サービスに関するページを参照してください。
priority int 必要に応じて、他の支払ルールに対してこのルールを適用する必要があるレベルを定義する優先順位を指定できます。
既定値: 5
last_modified timestamp この広告品質ルールの最終変更時刻。

例

広告品質ルールを定義する

$ cat ad-quality-rule.json
{"ad-quality-rule":
      {
        "name": "Default Ad Quality Rule",
        "description": "These quality standards will serve as the catch-all settings for this publisher",
        "active": true,
        "publisher_id": 34147,
        "ad_profile_id": 32,
        "profile_id": null,
        "priority": 1
      }
}

POST パブリッシャーの広告品質ルール

$ curl -s -c cookies -b cookies -X POST -d @ad-quality-rule.json "https://api.appnexus.com/ad-quality-rule?publisher_id=34147" | json_reformat
{
  "response": {
    "status": "OK",
    "id": 103679,
    "dbg_info": {
      ...
    }
  }
}

特定の広告品質ルールを表示する

$ curl -s -c cookies -b cookies "https://api.appnexus.com/ad-quality-rule?id=103679" | json_reformat
{
  "response": {
    "status": "OK",
    "ad-quality-rule": {
      "id": 103679,
      "code": null,
      "name": "Default Ad Quality Rule",
      "description": "These quality standards will serve as the catch-all settings for this publisher",
      "active": true,
      "publisher_id": 34147,
      "ad_profile_id": 32,
      "profile_id": 0,
      "priority": 1
    },
    "dbg_info": {
      ...
    }
  }
}