メンバー構成

[アーティクル]
03/02/2024

API を使用してオブジェクトを作成する前に、最初にメンバーを完全に構成することをお勧めします。その理由は、メンバーの下の子オブジェクトにカスケードするメンバーレベルで指定できる既定値があるためです。

メンバーレベルで構成できるさまざまなパラメーターがいくつかあります。

再販の優先順位なし

この設定は、パラメーターに "no_reselling_priority" 格納され、マネージドインプレッションを再売しない優先順位を指定します。別の言い方をすると、この優先度以上のキャンペーンがあり、配信資格がある場合は、常に他の購入者からの RTB キャンペーンの上に配信されます。同じ優先順位の管理されたキャンペーンの中で、通常のオークションの仕組みが引き続き適用されます。次のサンプル JSON は、このパラメーターを設定する方法を示しています。

{
  "member": {
    "no_reselling_priority": 5
  }
}

コンテンツカテゴリ

このパラメーターは、パラメーターに "content_categories" 格納され、管理されたインベントリの分類に使用できるカスタムコンテンツカテゴリの一覧を定義します。

注:

これらのカテゴリは、他の購入者の対象になりません。

次のサンプル JSON は、このパラメーターを設定する方法を示しています。

{
  "member": {
    "content_categories": [
      {"id":"2950","name":"Animals"},
      {"id":"2951","name":"Arts & Humanities"},
      ... ,
      {"id":"2977","name":"Travel"}
    ]
  }
  }

標準サイズ

パラメーターに "standard_sizes" 格納されているこの設定は、表示されるクリエイティブサイズと配置サイズを指定します。次のサンプル JSON は、このパラメーターを設定する方法を示しています。

{
  "member": {
    "standard_sizes": [
      {"width": "120", "height": "600", "is_standard": true},
      {"width": "160", "height": "600", "is_standard": true},
      ... ,
      {"width": "728", "height": "90", "is_standard": true},
      {"width": "800", "height": "60", "is_standard": false}
    ]
  }
  }

タイムゾーン

フィールドに格納されているこのパラメーターは、作成時に "timezone" 特に指定しない限り、新しく作成されたオブジェクトに適用される既定のタイムゾーンを定義します。有効なタイムゾーン値の一覧については、「 API タイムゾーン」を参照してください。次のサンプル JSON は、このパラメーターを設定する方法を示しています。

{
  "member": {
    "timezone": "EST5EDT"
  }
  }

ドングル

ドングルは、オークションをデバッグするためのパスワードとして使用されます。このパスワードは、クエリ文字列の配置呼び出しで使用され、プラットフォームでオークションをシミュレートし、そのタグに対する入札方法を表示するように求められます。これは、キャンペーンが特定の在庫に対して入札されない理由を判断するのに役立ちます。次のサンプル JSON は、このパラメーターを設定する方法を示しています。

{
  "member": {
    "dongle": "keepitsecret"
  }
  }

プラットフォームの公開

プラットフォーム公開設定は、プラットフォーム上の他のメンバーにアカウントを表示する方法を決定します。次に示すように、動作が若干異なる 3 つの値があります。

プラットフォームの露出値	動作
public	課金名を使用してメンバーが表示されます。
プライベート	メンバーは "メンバー 123" として表示されます。ここで、123 はメンバー ID です。
hidden	メンバーは表示されません。

次のサンプル JSON は、このパラメーターを設定する方法を示しています。

{
  "member": {
    "platform_exposure": "public"
  }
}

既定の通貨

タイムゾーンなどの既定の通貨は、それらのオブジェクトの作成時に特に指定がない限り、広告主や広告申込情報に適用されます。次のサンプル JSON は、このパラメーターを設定する方法を示しています。

{
  "member": {
    "default_currency": "USD"
  }
  }

挿入順序を使用する

パラメーターに "use_insertion_orders" 格納されているこの設定は、アカウント内のすべての広告主で挿入注文を使用するかどうかを指定します。この設定は、広告主ごとに利用することもできます。次のサンプル JSON は、このパラメーターを設定する方法を示しています。

{
  "member": {
    "use_insertion_orders": false
  }
  }

概要の例

上記の JSON サンプルを 1 つのメンバーオブジェクトにまとめた概要を次に示します。この例では、メンバー指定はテキストファイル内にあります。

$cat member
{
  "member": {
    "no_reselling_priority": 5,
    "content_categories": [
      {"id":"2950","name":"Animals"},
      {"id":"2951","name":"Arts & Humanities"},
      ... ,
      {"id":"2977","name":"Travel"}
    ],
    "standard_sizes": [
      {"width": "120", "height": "600", "is_standard": true},
      {"width": "160", "height": "600", "is_standard": true},
      ... ,
      {"width": "728", "height": "90", "is_standard": true},
      {"width": "800", "height": "60", "is_standard": false}
    ],
    "timezone": "EST5EDT",
    "dongle": "keepitsecret",
    "platform_exposure": "public",
    "default_currency": "USD",
    "use_insertion_orders": false
  }
}

変更を行うには、API に対するメンバー指定を行う必要があります PUT 。

$ curl -b cookies -c cookies -X PUT --data-binary @member 'https://api.appnexus.com/member?id=123'
{
   "response":{
      "status": "OK",
      "id": 1234
   }
}

変更が行われたかどうかを確認するには、要求を使用して API からメンバーを GET プルダウンします。

$ curl -b cookies -c cookies 'https://api.appnexus.com/member?id=123'
{
  "response": {
    "status": "OK",
    "member": {
      "id": 123,
      "name": "Member",
      "whitelabel_support_email": null,
      "reselling_description": null,
      "state": "active",
      "expose_ixi_support": false,
      "enable_advertisers": true,
      "no_reselling_priority": 5,
      "entity_type": "reseller",
      "expose_global_inventory_sources": true,
      "buyer_clearing_fee_pct": null,
      "default_placement_id": null,
      "default_buyer_group_id": 0,
      "max_daily_credit_pct": 0,
      "interface_domain": null,
      "interface_domain_beta": null,
      "content_categories": [
        {"id":"2950","name":"Animals"},
        {"id":"2951","name":"Arts & Humanities"},
        ... ,
        {"id":"2977","name":"Travel"}
      ],
      "dw_member": true,
      "contracts": [
        {
          "id": 75,
          "start_date": "2010-01-01 00:00:00",
          "end_date": null,
          ...
        }
      ],
      "default_inv_source_id": null,
      "default_ad_profile_id": null,
      "email_code": null,
      "serving_domain": null,
      "contract_approved": true,
      "reselling_exposure": "public",
      "reselling_exposed_on": "0000-00-00 00:00:00",
      "last_modified": "2011-07-13 16:00:43",
      "standard_sizes": [
        {"width": "120", "height": "600", "is_standard": true},
        {"width": "160", "height": "600", "is_standard": true},
        ... ,
        {"width": "728", "height": "90", "is_standard": true},
        {"width": "800", "height": "60", "is_standard": false}
      ],
      "buyer_credit_limit": 1000000,
      "timezone": "EST5EDT",
      "seller_revshare_pct": 95,
      "is_billable": true,
      "note": null,
      "default_country": null,
      "dongle": "keepitsecret",
      "primary_type": "buyer",
      "platform_exposure": "public",
      "contact_email": null,
      "allow_ad_profile_override": true,
      "account_owner_user": null,
      "default_currency": "USD",
      "use_insertion_orders": false,
      "expose_optimization_levers": false,
      "pops_enabled_UI": false,
      "default_accept_supply_partner_usersync": true,
      "default_accept_data_provider_usersync": true,
      "default_accept_demand_partner_usersync": true,
      "short_name": "",
      "expose_eap_ecp_placement_settings": false,
      "daily_imps_verified": null,
      "daily_imps_self_audited": null,
      "daily_imps_unaudited": null,
      "is_iash_compliant": false,
      "deal_types": null,
      "allow_non_cpm_payment": true,
      "default_allow_cpc": true,
      "default_allow_cpa": true,
      "visibility_profile_id": 15,
      "inventory_trust": {
        "default_trust": "appnexus",
        "default_allow_unaudited": false,
        "default_is_banned": false,
        "members": [...]
      },
      "default_campaign_trust": "appnexus",
      "default_campaign_allow_unaudited": false,
      "contract_allows_unaudited": true,
      "enable_budget_check": false,
      "active_contract": {
        "auditing_fee_per_creative": 1,
        "creative_priority_fee_1": 25,
        "creative_priority_fee_2": 25
      },
      "allow_priority_audit": false,
      "enable_mobile_ui": false,
      "audit_notify_email": null,
      "default_external_audit": false,
      "contact_info": null
    },
    "count": 1,
    "start_element": null,
    "num_elements": null,
    "dbg_info": {
      ...
    }
  }
}

次の方法で共有

メンバー構成

再販の優先順位なし

コンテンツカテゴリ

標準サイズ

タイムゾーン

ドングル

プラットフォームの公開

既定の通貨

挿入順序を使用する

概要の例

その他のリソース

次の方法で共有

メンバー構成

再販の優先順位なし

コンテンツ カテゴリ

標準サイズ

タイムゾーン

ドングル

プラットフォームの公開

既定の通貨

挿入順序を使用する

概要の例

その他のリソース

コンテンツカテゴリ