次の方法で共有

Creative Folder サービス

  • [アーティクル]

クリエイティブ フォルダー サービスを使用すると、組織の目的でクリエイティブをグループ化できます。 複数のクリエイティブを作成するときに、1 つのフォルダーに一度に追加できます。

REST API

HTTP メソッド エンドポイント 説明
GET https://api.appnexus.com/creative-folder?advertiser_id=ADVERTISER_ID すべてのクリエイティブ フォルダーを表示します (広告主を指定する必要があります)。
GET https://api.appnexus.com/creative-folder?advertiser_id=ADVERTISER_ID&id=FOLDER_ID 特定のクリエイティブ フォルダーを表示します。
POST https://api.appnexus.com/creative-folder?advertiser_id=ADVERTISER_ID
(creative-folder JSON)		 新しいクリエイティブ フォルダーを追加します (このアクションで、または後でフォルダーにクリエイティブを追加できます)。
POST https://api.appnexus.com/creative-folder?advertiser_id=ADVERTISER_ID
(creative-folder JSON)		 いずれかのフォルダーに新しいクリエイティブを追加します。
PUT https://api.appnexus.com/creative-folder?id=CREATIVE_ID&advertiser_id=ADVERTISER_ID
(creative-folder JSON)		 既存のクリエイティブ フォルダーを変更します。
DELETE https://api.appnexus.com/creative-folder?advertiser_id=ADVERTISER_ID&id=FOLDER_ID 既存のクリエイティブ フォルダーを削除します。

JSON フィールド

フィールド 種類 説明
id int クリエイティブ フォルダーに関連付けられている内部 ID。
parent_id int 廃止。
name string クリエイティブ フォルダーの省略可能な名前。
advertiser_id int すべてのクリエイティブは、作成時に広告主またはパブリッシャーにアタッチされます。
creatives オブジェクトの配列 このフォルダーに含めるクリエイティブの一覧、または要求に応じてフォルダーに既に存在するクリエイティブの一覧。
last_modified timestamp クリエイティブ フォルダーが最後に変更された日時。

例

2 つの (既存の) クリエイティブを含むクリエイティブ フォルダーを追加する

{code}$ cat creative-folder

{
    "creative-folder":{
        "creatives":[{
                "id":246305
            },
            {
                "id":246221
            }
        ]
    }
}

$ curl -b cookies -c cookies -X POST -d @creative-folder 'https://api.appnexus.com/creative-folder?advertiser_id=493'

{
  "response": {
    "status": "OK",
    "id": 338
  }
}
{code}

広告主のすべてのフォルダーを表示する 493

{code}$ curl -b cookies -c cookies 'https://api.appnexus.com/creative-folder?advertiser_id=493'

{
  "response": {
    "creative-folders": [
      {
        "id": 81,
        "parent_id": null,
        "advertiser_id": 493,
        "name": "Hosted Images",
        "last_modified": "2010-03-31 21:26:59",
        "creatives": [
          {
            "id": "14900"
          }
        ]
      },
      {
        "id": 82,
        "parent_id": null,
        "advertiser_id": 493,
        "name": "3rd party images",
        "last_modified": "2010-03-31 21:27:07",
        "creatives": [
          {
            "id": "246305"
          }
        ]
      },
      {
        "id": 152,
        "parent_id": null,
        "advertiser_id": 493,
        "name": "an-creatives-2",
        "last_modified": "2010-08-05 15:18:50",
        "creatives": [
          {
            "id": "246214"
          },
          {
            "id": "246215"
          },
          {
            "id": "246216"
          },
          {
            "id": "246217"
          },
          {
            "id": "246218"
          },
          {
            "id": "246219"
          },
          {
            "id": "246220"
          },
          {
            "id": "246221"
          }
        ]
      },
      {
        "id": 338,
        "parent_id": null,
        "advertiser_id": 493,
        "name": null,
        "last_modified": "2011-06-20 19:15:18",
        "creatives": [
          {
            "id": "246221"
          },
          {
            "id": "246305"
          }
        ]
      }
    ],
    "status": "OK",
    "count": 4,
    "start_element": 0,
    "num_elements": 100
  }
}
{code}

既存のクリエイティブ フォルダーにクリエイティブを追加する

必ずクエリ ステートメントにを含めます append=true 。 オフにすると、フォルダー内のすべての既存のクリエイティブが上書きされます。

$ cat creative-folder

{
    "creative-folder":{
        "creatives":[{
                "id":876543
            }
        ]
    }
}

curl -b cookies -X PUT -d @creative-folder 'https://api.appnexus.com/creative-folder?id=338&advertiser_id=493&append=true'

{
  "response": {
    "status": "OK",
    "id": 338
  }
}