次の方法で共有

[トラッカー サービス] をクリックします

  • [アーティクル]

クリック トラッカー サービスを使用すると、サード パーティの広告サーバーによって配信されたクリエイティブ (Xandr が提供するもの) のユーザークリックを追跡できます。 次に、動作のしくみを示します。

  1. クリック トラッカー サービスを使用して、クリック トラッカーを作成します。 クリック トラッカーは、クリック トラッカーが関連付けられている行項目と発行元を指定します。 一般に、クリエイティブのターゲット ランディング ページ URL も指定します (代替ケースについては、以下の redir パラメーターを参照してください)。 必要に応じて、関連付けられている特定の配置または支払いルールを含めることができます。
  2. クリック トラッカーの URL を作成し、広告サーバーにクリエイティブのランディング ページ URL として使用するように依頼します。 クリック トラッカー URL は https://ib.adnxs.com/clktr?id=12345形式にする必要があります。12345 はクリック トラッカー ID です。
  3. 広告サーバーがクリエイティブを配信し、誰かがクリックすると、最初に ib.adnxs.comに呼び出しが行われ、Xandr がクリックを記録した後、ターゲット ランディング ページにリダイレクトされます。

具体的な使用例については、「 例」を参照してください。

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

クリック トラッカー URL のクエリ文字列で、次のパラメーターを Xandr に渡すことができます。

パラメーター 説明
cachebuster ユーザーのブラウザーがクリック トラッカー URL をキャッシュできないようにします。 このパラメーターは、サード パーティの広告サーバーによって設定できます。
ancost 外部クリックに対して支払ったメディア コスト。 パラメーターは、サード パーティの広告サーバーによって設定できます。 最大値 "999999.999999" を渡すことができます。
redir リダイレクト URL。 クリック トラッカーで click_url が設定されていない場合は、このパラメーターを使用して、クリックが記録されたら Xandr がリダイレクトするターゲット ランディング ページ URL を渡す必要があります。

例

https://ib.adnxs.com/clktrb?id=1234&cachebuster=[CACHEBUSTER]&ancost=[ANCOST]&redir=https://test-landing-page.com

Reporting

clicktrackers Bulk Reporting Feed を使用すると、外部クリック トラッカーが Xandr に渡したデータ (クリック時間、関連付けられている Xandr オブジェクト、外部クリックに対して支払われた金額など) を表示できます。 外部クリックをさらに詳しく表示するには、 clicktrackers フィードを 広告主属性コンバージョン レポートと組み合わせて使用できます。

REST API

HTTP メソッド エンドポイント 説明
POST https://api.appnexus.com/clicktracker?advertiser_id=ADVERTISER_ID クリック トラッカーを追加します。
GET https://api.appnexus.com/clicktracker?id=CLICK_TRACKER_ID クリック トラッカーを表示します。
GET https://api.appnexus.com/clicktracker?id=1,2,3 コンマ区切りリストを使用して、ID で複数のクリック トラッカーを表示します。
PUT https://api.appnexus.com/clicktracker?id=CLICK_TRACKER_ID クリック トラッカーを変更します。
DELETE https://api.appnexus.com/clicktracker?id=CLICK_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
click_url string クリエイティブのターゲット ランディング ページ。 Xandr がクリエイティブのクリックを記録すると、Xandr がリダイレクトするページになります。

先端： このフィールドが設定されていない場合、ターゲット ランディング ページ URL は、クリック トラッカー URL のクエリ文字列の "redir" パラメーターとして渡す必要があります。 詳細については、上記の 「クエリ文字列パラメーター 」を参照してください。
publisher object クリック トラッカーが関連付けられている発行元。 詳細については、以下の パブリッシャー に関するページを参照してください。
必須:POST
line_item object クリック トラッカーが関連付けられている広告主の広告申込情報。 詳細については、以下の 「行項目 」を参照してください。
必須:POST
tag 配列 クリック トラッカーが関連付けられている配置。 詳細については、以下の 「タグ」 を参照してください。
payment_rule 配列 クリック トラッカーが関連付けられている支払ルール。 詳細については、以下の 「支払い規則 」を参照してください。
last_modified timestamp クリック トラッカーが最後に変更された日時。
読み取り専用。

Publisher

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

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

行項目

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

フィールド 種類 説明
id int クリック トラッカーが関連付けられている行項目の ID。
name string クリック トラッカーが関連付けられている行項目の名前。
読み取り専用。

Tag

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

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

支払いルール

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

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

例

新しいクリック トラッカーを作成する

$ cat clicktracker

{
    "clicktracker": {
        "name": "Test Click Tracker",
        "click_url": "https://test-landing-page.com",
        "publisher": {
            "id": 44449
        },
        "line_item": {
            "id": 74957
        }
    }
}

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

{
    "response": {
        "status": "OK",
        "count": 1,
        "id": 1425,
        "start_element": 0,
        "num_elements": 100,
        "clicktracker": {
            "id": 1425,
            "member_id": 958,
            "advertiser_id": 37236,
            "name": "Test Click Tracker",
            "code": null,
            "state": "active",
            "click_url": "https://test-landing-page.com",
            "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 clicktracker_update
{
    "clicktracker": {
        "tag": {
            "id": 474412
        }
    }
}

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

{
    "response": {
        "status": "OK",
        "count": 1,
        "id": "1425",
        "start_element": 0,
        "num_elements": 100,
        "clicktracker": {
            "id": 1425,
            "member_id": 958,
            "advertiser_id": 37236,
            "name": "Test Click Tracker",
            "code": null,
            "state": "active",
            "click_url": "https://test-landing-page.com",
            "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/clicktracker?id=582'

{
    "response": {
        "status": "OK",
        "count": 1,
        "start_element": 0,
        "num_elements": 100,
        "clicktracker": {
            "id": 582,
            "member_id": 1066,
            "advertiser_id": 35081,
            "name": "Test Click Tracker 1",
            "code": null,
            "state": "active",
            "click_url": "https://test-landing-page.com",
            "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/clicktracker?advertiser_id=35081'

{
    "response": {
        "status": "OK",
        "count": 2,
        "start_element": 0,
        "num_elements": 100,
        "clicktrackers": [
            {
                "id": 582,
                "member_id": 1066,
                "advertiser_id": 35081,
                "name": "Test Click Tracker 1",
                "code": null,
                "state": "active",
                "click_url": "https://test-landing-page.com",
                "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 Click Tracker 2",
                "code": null,
                "state": "active",
                "click_url": "https://another-landing-page.com",
                "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"
                }
            }
        ]
    }
}