クリエイティブ VAST サービス

Creative Vast サービスを使用して、 ビデオ または オーディオ クリエイティブを Xandr に追加できます。 すべてのクリエイティブを広告主またはパブリッシャーにアタッチする必要があります。

• 広告主サービスを呼び出すことで 、広告主 ID を表示できます。
• パブリッシャー サービスを呼び出すことで、 発行元 ID を表示できます。
• クリエイティブをパブリッシャーにアタッチして、プレースメントの既定のクリエイティブとして使用できます。 その後、プレースメント サービスを使用して、その ID を使用してクリエイティブを プレースメントにアタッチします。

監査

Xandrは、ブランドと評判を深く気にするメンバーと協力しています。 そのため、システムを通過する広告(クリエイティブ)が全ての関係者に受け入れられるよう注意を払っています。 品質保証のため、サード パーティの広告枠で配信するすべてのクリエイティブは、クリエイティブ サービスを使用して事前に登録する必要があります。

• クリエイティブは、media_url (サードパーティの広告サーバー URL または Flash またはビデオ ファイルのコンテンツ配信ネットワーク URL) によって識別されます。
• Xandr は、定期的にmedia_urlsをチェックします。 ファイルが消えた場合、クリエイティブは監査されていないものとして扱われます。
• クリエイティブが Xandr 監査に合格すると、クリエイティブに特定の変更が加えられると、そのクリエイティブは監査のために再送信されます。 詳細については、以下の 「再監査の原因となる変更 」を参照してください。
• 監査の詳細については、「 クリエイティブスタンダードと監査」を参照してください。

REST API

JSON フィールド

segments 例

"segments":[
{"id":11111,
"action":"add_on_view"
},
{"id":22222,
"action":"add_on_click"
}
]

categories 例

"categories":[{"id":"13","name":"Online Games"}]

adservers 例

"adservers":[{"id":"1","use_type":"adserver","name":"24/7 Real Media"}]

technical_attributes 例

"technical_attributes":[{"id":"1","name":"Image"}]

language 例

"language":{"id":"1","name":"English"}

media_assets 例

"media_assets":[
{
"media_asset_id":22,
"creative_field":null
}
]

オーディオ

行項目

line_items配列内の各オブジェクトには、次のフィールドが含まれます。 "id"または"code"フィールドの情報を取得するには、明細サービス - ALI を使用します。

キャンペーン

campaigns配列内の各オブジェクトには、次のフィールドが含まれます。 "id"または"code"フィールドの情報を取得するには、キャンペーン サービスを使用できます。

状態

競争力のあるブランド

Media-asset

media-asset オブジェクトには、次のフィールドが含まれます。

Media_asset_status

media_asset_status オブジェクトには、次のフィールドが含まれます。

テンプレート

template オブジェクトには、次のフィールドが含まれます。

競合カテゴリ

Video 属性

video_attribute は、 creative-vast エンドポイントのオーディオ クリエイティブとビデオ クリエイティブの両方に必要です。 テンプレート ID は次のとおりです。

• 6439 - ビデオ: Standard VAST
• 38745 - オーディオ: Standard VAST

video_attribute オブジェクトには、次のフィールドが含まれます。

Video Attribute Wrapper

wrapper オブジェクトには、次のフィールドが含まれています。

Video 属性ラッパー要素

elements配列には、次のフィールドが含まれています。

ビデオ ラッパー イベント トラッカー

レポートで追跡するすべてのイベントにピクセルをドロップできます (以下の vast_event_type_id 参照)。 クリエイティブにピクセルを trackers として追加します。 trackers配列には、次のフィールドが含まれています。

ビデオ ラッパー メディア ファイル

Video Attribute Inline

インライン線形オブジェクト

インライン 線形トラッカー

インライン 線形メディア ファイル

インライン コンパニオン広告オブジェクト

セグメント

これらのフィールドは、Segments 配列に含まれます。

ブランド

brand オブジェクトには、次のフィールドが含まれています。

最初の実行/最後の実行

GET応答にfirst_runフィールドとlast_runフィールドを含める場合は、クエリ文字列にflight_info=trueを渡します。 クリエイティブの最初と最後の配信時間に基づいて、次のようにフィルター処理することもできます。

配信したことがないクリエイティブのみを取得する

クエリ文字列に never_run=true を渡します。

curl -b cookies -c cookies 'https://api.appnexus.com/creative-vast?advertiser_id=100&flight_info=true&never_run=true'

特定の日付以降に配信されたクリエイティブのみを取得する

クエリ文字列に min_first_run=YYYY-MM-DD HH:MM:SS を渡します。

curl -b cookies -c cookies 'https://api.appnexus.com/creative-vast?advertiser_id=100&flight_info=true&min_first_run=2012-01-01 00:00:00'

特定の日付以前に配信されたクリエイティブのみを取得する

クエリ文字列に max_first_run=YYYY-MM-DD HH:MM:SS を渡します。

curl -b cookies -c cookies 'https://api.appnexus.com/creative-vast?advertiser_id=100&flight_info=true&max_first_run=2012-08-01 00:00:00'

特定の日付範囲内で最初に配信されたクリエイティブのみを取得する

クエリ文字列に min_first_run=YYYY-MM-DD HH:MM:SS&max_first_run=YYYY-MM-DD HH:MM:SS を渡します。

curl -b cookies -c cookies 'https://api.appnexus.com/creative-vast?advertiser_id=100&flight_info=true&min_first_run=2012-01-01 00:00:00&max_first_run=2012-08-01 00:00:00'

特定の日付以降に最後に配信されたクリエイティブのみを取得する

クエリ文字列に min_last_run=YYYY-MM-DD HH:MM:SS を渡します。

curl -b cookies -c cookies 'https://api.appnexus.com/creative-vast?advertiser_id=100&flight_info=true&min_last_run=2012-01-01 00:00:00'

特定の日付以前に最後に配信されたクリエイティブのみを取得する

クエリ文字列に max_last_run=YYYY-MM-DD HH:MM:SS を渡します。

curl -b cookies -c cookies 'https://api.appnexus.com/creative-vast?advertiser_id=100&flight_info=true&max_last_run=2012-08-01 00:00:00'

特定の日付範囲内で最後に配信されたクリエイティブのみを取得する

クエリ文字列に min_last_run=YYYY-MM-DD HH:MM:SS&max_last_run=YYYY-MM-DD HH:MM:SS を渡します。

curl -b cookies -c cookies 'https://api.appnexus.com/creative-vast?advertiser_id=100&flight_info=true&min_last_run=2012-01-01 00:00:00&max_last_run=2012-08-01 00:00:00'

再監査の原因となる変更

クリエイティブが Xandr 監査に合格すると (audit_status が "audited")、次のいずれかのフィールドを変更すると、クリエイティブは監査のために再送信されます (allow_audit は "pending"に設定されます)。

• media_url
• click_url
• language
• categories
• technical_attributes
• brand_id
• pixel_url
• video_attribute
• media_assets

また、 audit_status が "no_audit"されている場合、 allow_audit を "false" から "true" に変更すると、クリエイティブが Xandr 監査のために再送信されます。

例

ビデオまたはオーディオ クリエイティブをアップロードする

Xandr を使用してホスティング用のクリエイティブをアップロードする場合:

手順 1: クリエイティブ アップロード サービスにアセットを アップロードします。

curl -X POST -H "Authorization: hbapi:139072:5761726637ada:nym2" --form "type=video" --form "file=@./Xandr_30_1280_720_2500k.mp4" "https://api.appnexus.com/creative-upload?member_id=123"

media_asset_idが返されます。

{
    "response": 
        "status": "OK",
        "count": 0,
        "start_element": 0,
        "num_elements": 0,
        "media-asset": [
            {
                "id": 54621,
                "parent_media_asset_id": null,
                "member_id": 123,
                "advertiser_id": null,
                "publisher_id": null,
                "file_name": "Xandr_30_1280_720_2500k.mp4",
                "size_in_bytes": 8358845,
                "cdn_uploaded_on": null,
                "cdn_url": null,
                "cdn_secure_url": null,
                "created_on": "2016-06-15 15:33:17",
                "last_modified": "2016-06-15 15:33:17",
                "deleted": false,
                "media_asset_status": [
                    {
                        "id": 54621,
                        "media_asset_id": 54621,
                        "error_message": null,
                        "local_path": "03/36/2e/66/03362e66-674a-41b3-9477-fcd979cdbf0b/03362e66-674a-41b3-9477-fcd979cdbf0b.mp4",
                        "cdn_upload_attempt_count": 0,
                        "created_on": "2016-06-15 15:33:17",
                        "last_modified": "2016-06-15 15:33:17",
                        "deleted": false,
                        "status": "on_shared_storage"
                    }
                ],
                "media_asset_video": null,
                "media_asset_html5": null,
                "asset_type": "video",
                "mime_type": "video/mp4",
                "duration": "32000"
            }
        ]
    }

手順 2:クリエイティブをアップロードするmedia_asset_idを使用します。

$ cat creative_video

{
    "creative-vast": {
        "name": "upload hosted video",
        "media_assets": [
            {
               "media_asset_id": 54621
            }
        ],
        "click_url": "https://appnexus.com",
        "video_attribute": {
            "inline": {
                "ad_title": "hosting test",
                "linear": {
                    "trackers": []
                }
            },
            "is_skippable": true,
            "duration_ms": "57000"
        },
        "template": {
            "id": 6439
        },
        "advertiser_id": 164979,
        "segments": null,
        "allow_audit": true,
        "is_self_audited": false,
        "sla": 0
    }
}

{
    "response": {
        "status": "OK",
        "count": 1,
        "id": 12345678,
        "start_element": 0,
        "num_elements": 100,
        "creative-vast": {
            "name": "hosted creative video",
            "brand_id": 1,
            "media_url": "http://appnexus.com",
            "id": 12345678,
            ...
            "track_clicks": true,
            "audit_status": "pending",
            ...
            "media_url_secure": "https://appnexus.com",
            ...
            "is_hosted": true,
            ...
            "language": {
                "id": 1,
                "name": "English"
            },
            ...
            },
            "template": {
                "id": 6439,
                "name": "Standard",
                "media_subtype_id": 64,
                "format_id": 10
            },
            ...
            "video_attribute": {
               "is_skippable": true,
                "duration_ms": 57000,
                "inline": {
                    "ad_title": "hosted video creative",
                    "ad_description": null,
                    "linear": {
                        "trackers": null,
                        "media_files": null
                    }
                },
                "video_frameworks": null
            },
            "media_assets": [
                {
                    "media_asset_id": 54621
                }
            ],
            ...
            "currency": "USD",
            "type": "video"
        },
        ...
    }
}

ラッパーの例を含む video_attribute オブジェクト

{
    "creative-vast": {
        "id": 145,
        ...
        "template_id": 6439,
        "video_attribute": {
            "is_skippable": true,
            "duration_ms": 21000,
            "wrapper": {
                "url": "http://www.doubleclick.net/...",
                "secure_url": "https://www.doubleclick.net/...",
                "elements": [
                    {
                        "vast_element_type_id": 1,
                        "name": "linear",
                        "trackers": [
                            {
                                "name": "startTracker",
                                "vast_event_type": "impression",
                                "url": "http://tracker.com/...",
                                "secure_url": "https://tracker.com/...",
                            }
                            {
                                "name": "completionTracker",
                                "vast_event_type_id": 8,
                                "url": "http://tracker.com/...",
                                "secure_url": "https://tracker.com/...",
                                "event_type": "completion"
                            }
                        ]
                    }
                ]
            }
        }
    }
    }

インライン VAST の例を含む video_attribute オブジェクト

{
    "creative-vast": {
        "name": "John-Doe test",
        "member_id": 1111,
        "advertiser_id": 2474202,
        "template": {
            "id": 6439
        },
        "video_attribute": {
            "duration_ms": 10000,
            "inline": {
                "ad_title": "John-Doe test",
                "linear": {
                    "trackers": []
                }
            }
        },
        "media_assets": [
            {
                "media_asset_id": 5375731,
                "creative_field": null
            }
        ]
    }
    }

関連項目

• Creative Upload Service - ファイル形式
• API のベスト プラクティス
• API セマンティクス