次の方法で共有

インプレッション トラッカー サービス

  • [アーティクル]

インプレッション トラッカー サービスを使用すると、(AppNexus ではなく) サード パーティの広告サーバーが配信するクリエイティブのインプレッションを追跡できます。

次に、動作のしくみを示します。

  1. インプレッション トラッカー サービスを使用してインプレッション トラッカーを作成します。 インプレッション トラッカーは、関連付けられている広告申込情報と発行元を指定します。 必要に応じて、関連付けられている特定の配置または支払いルールを含めることができます。
  2. インプレッション トラッカーの URL を含む画像または JavaScript タグを作成し、広告サーバーにクリエイティブのピギーバック ピクセルとして使用するように依頼します。 インプレッション トラッカー URL は、https://ib.adnxs.com/imptr?id=12345&として書式設定する必要があります。t=2。ここで、12345 はインプレッション トラッカー ID、"t" はピクセルの種類を表します (t=1 は javascript 用、t=2 はイメージ用)。
  3. 広告サーバーがクリエイティブを配信すると、トラッカーは ib.adnxs.comを呼び出し、AppNexus はインプレッションを記録します。

クエリ文字列のパラメーター

インプレッション トラッカー URL のクエリ文字列で、次のパラメーターを AppNexus に渡すことができます。

パラメーター 説明
cachebuster ユーザーのブラウザーがインプレッション トラッカー URL をキャッシュできないようにします。 このパラメーターは、サード パーティの広告サーバーによって設定できます。
ancost インプレッションに対して支払ったメディア コスト。 パラメーターは、サード パーティの広告サーバーによって設定できます。
redir インプレッションが記録されると AppNexus がリダイレクトするリダイレクト URL。

イメージ タグの例

<!-- Imp Tracker - Test Impression Tracker - DO NOT MODIFY -->
<img src="media/imptr?id=531&cachebuster=[CACHEBUSTER]&ancost=[ANCOST]" width="1" height="1" />
<!-- End of Imp Tracker -->

JavaScript タグの例

<!-- Imp Tracker - Test Impression Tracker - DO NOT MODIFY -->
<script src="https://ib.adnxs.net/imptr?id=531&cachebuster=[CACHEBUSTER]&ancost=[ANCOST]" type="text/javascript"></script>
<!-- End of Imp Tracker -->

Reporting

外部インプレッションに関するレポートは、 Network Analytics、 Network Publisher Analytics、 Publisher Analytics の各レポートを使用して行うことができます。

REST API

HTTP メソッド エンドポイント 説明
POST https://api.appnexus.com/imptracker?advertiser_id=ADVERTISER_ID
(imptracker JSON)		 インプレッション トラッカーを追加します。
PUT https://api.appnexus.com/imptracker?id=IMP_TRACKER_ID
(imptracker JSON)		 インプレッション トラッカーを変更します。
GET https://api.appnexus.com/imptracker?id=IMP_TRACKER_ID インプレッション トラッカーを表示します。
GET https://api.appnexus.com/imptracker?id=1,2,3 コンマ区切りのリストを使用して、ID で複数のインプレッション トラッカーを表示します。
DELETE https://api.appnexus.com/imptracker?id=IMP_TRACKER_ID インプレッション トラッカーを削除します。

JSON フィールド

フィールド 種類 説明
id int インプレッション トラッカーの ID。
デフォルト： 自動インクリメントされた数値 (つまり、123)。
クエリ文字列で必要な On:PUT/DELETE。
member_id int 広告主が属するメンバーの ID。
読み取り専用。
advertiser_id int インプレッション トラッカーを所有する広告主の ID。
クエリ文字列で必要な On:POST。
name string インプレッション トラッカーの名前。
必須:POST
code string インプレッション トラッカーのカスタム コード。
state 列挙 インプレッション トラッカーの状態。
使用可能な値: "active" または "inactive"。
デフォルト："active"
publisher object インプレッション トラッカーが関連付けられている発行元。 詳細については、以下の パブリッシャー に関するページを参照してください。
必須:POST
tag 配列 インプレッション トラッカーが関連付けられている配置。 詳細については、以下の 「タグ」 を参照してください。
payment_rule object インプレッション トラッカーが関連付けられている支払いルール。 詳細については、以下の 「支払い規則 」を参照してください。
line_item object インプレッション トラッカーが関連付けられている広告主の広告申込情報。 詳細については、以下の 「行項目 」を参照してください。
必須:POST
clicktracker object 現在使用されていません。
last_modified timestamp インプレッション トラッカーが最後に変更された日時。
読み取り専用。

Publisher

パブリッシャー サービスを使用して、発行元に関する情報を取得できます。

フィールド 種類 説明
id int インプレッション トラッカーが関連付けられている発行元の ID。
name string インプレッション トラッカーが関連付けられている発行元の名前。
読み取り専用。

Tag

配置サービスを使用して、配置に関する情報を取得できます。

フィールド 種類 説明
id int インプレッション トラッカーが関連付けられている配置の ID。
name string インプレッション トラッカーが関連付けられている配置の名前。
読み取り専用。

支払いルール

支払ルール サービスを使用して、支払ルールに関する情報を取得できます。

フィールド 種類 説明
id int インプレッション トラッカーが関連付けられている支払いルールの ID。
name string インプレッション トラッカーが関連付けられている支払いルールの名前。
読み取り専用。

行項目

明細サービスを使用して 、明細 に関する情報を取得できます。

フィールド 種類 説明
id int インプレッション トラッカーが関連付けられている広告申込情報の ID。
name string インプレッション トラッカーが関連付けられている広告申込情報の名前。
読み取り専用。

例

新しいインプレッション トラッカーを作成する

$ cat imptracker

{
    "imptracker": {
        "name": "Test Impression Tracker",
        "publisher": {
            "id": 44449
        },
        "line_item": {
            "id": 74957
        }
    }
}

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

{
    "response": {
        "status": "OK",
        "count": 1,
        "id": 1425,
        "start_element": 0,
        "num_elements": 100,
        "imptracker": {
            "id": 1425,
            "member_id": 958,
            "advertiser_id": 37236,
            "name": "Test Impression Tracker",
            "code": null,
            "state": "active",
            "last_modified": "2012-01-10 16:02:15",
            "publisher": {
                "id": 44449,
                "name": "November Publisher"
            },
            "tag": null,
            "payment_rule": null,
            "line_item": {
                "id": 74957,
                "name": "Test Line Item"
            }
        }
    }
}

インプレッション トラッカーを更新する

この例では、 PUT 要求によって、配置がインプレッション トラッカー 1425 に関連付けられます。

$ cat imptracker_update
{
    "imptracker": {
        "tag": {
            "id": 474412
        }
    }
}

$ curl -b cookies -c cookies -X PUT -d @imptracker_update 'https://api.appnexus.com/imptracker?id=1425'

{
    "response": {
        "status": "OK",
        "count": 1,
        "id": "1425",
        "start_element": 0,
        "num_elements": 100,
        "imptracker": {
            "id": 1425,
            "member_id": 958,
            "advertiser_id": 37236,
            "name": "Test Impression Tracker",
            "code": null,
            "state": "active",
            "last_modified": "2012-01-10 16:10:12",
            "publisher": {
                "id": 44449,
                "name": "November Publisher"
            },
            "tag": {
                "id": 474412,
                "name": "[Demo Publisher] - Default"
            },
            "payment_rule": null,
            "line_item": {
                "id": 74957,
                "name": "Test Line Item"
            }
        }
    }
}

インプレッション トラッカーを表示する 582

$ curl -b cookies -c cookies 'https://api.appnexus.com/imptracker?id=582'

{
    "response": {
        "status": "OK",
        "count": 1,
        "start_element": 0,
        "num_elements": 100,
        "imptracker": {
            "id": 582,
            "member_id": 1066,
            "advertiser_id": 35081,
            "name": "Test Impression Tracker 1",
            "code": null,
            "state": "active",
            "last_modified": "2012-02-28 19:06:01",
            "publisher": {
                "id": 89287,
                "name": "Test Publisher 1"
            },
            "tag": null,
            "payment_rule": null,
            "line_item": {
                "id": 31189,
                "name": "Test Line Item 1"
            }
        }
    }
}

広告主 35081 のすべてのインプレッション トラッカーを表示する

$ curl -b cookies -c cookies 'https://api.appnexus.com/imptracker?advertiser_id=35081'

{
    "response": {
        "status": "OK",
        "count": 2,
        "start_element": 0,
        "num_elements": 100,
        "imptrackers": [
            {
                "id": 582,
                "member_id": 1066,
                "advertiser_id": 35081,
                "name": "Test Impression Tracker 1",
                "code": null,
                "state": "active",
                "last_modified": "2012-02-28 19:06:01",
                "publisher": {
                    "id": 89287,
                    "name": "Test Publisher 1"
                },
                "tag": null,
                "payment_rule": null,
                "line_item": {
                    "id": 31189,
                    "name": "Test Line Item 1"
                }
            },
            {
                "id": 584,
                "member_id": 1066,
                "advertiser_id": 35081,
                "name": "Test Impression Tracker 2",
                "code": null,
                "state": "active",
                "last_modified": "2012-02-28 19:40:48",
                "publisher": {
                    "id": 89288,
                    "name": "Test Publisher 2"
                },
                "tag": null,
                "payment_rule": null,
                "line_item": {
                    "id": 31190,
                    "name": "Test Line Item 2"
                }
            }
        ]
    }
}