コンバージョン ピクセルの最終起動

  • [アーティクル]

コンバージョン ピクセルの発生レポートでは、広告主のコンバージョン ピクセルが最後に発生した日時を表示できます。 この情報を使用して、正しく起動しているピクセルを確認し、トラブルシューティングを必要とするピクセルを特定できます。

コンバージョン ピクセルごとに、最後の火災は、ピクセルが配置されている Web ページにユーザーが最後にアクセスした時刻に対応している必要があります。 ピクセルが発生したことがない場合、または長い時間前に最後に発生した場合は、ピクセルがページに正しく配置されていない可能性があることを示します。

レポートを取得する手順については、 レポート サービス または以下の 例を 参照してください。

注:

コンバージョン ピクセルの発生は、キャンペーンの 1 つに起因するコンバージョンがあったとは限りません。 そのため、関連する広告申込情報にコンバージョンからの収益が表示されない場合でも、コンバージョン ピクセルが発生していることがわかります。 コンバージョン ピクセルの発生だけでなく、属性付きコンバージョンに関するデータを取得するには、[ 広告主の属性コンバージョン ] レポートを使用します。

時間枠

このレポートは、ピクセルの有効期間全体のデータを取得しますが、UTC タイムゾーンでのみ取得します。 JSON 要求のフィールドは report_interval 、 にのみ lifetime設定できますが、間隔が既定 lifetime で 指定されていない場合に に設定されるため、これは必要ありません。 同様に、JSON 要求の timezone フィールドは、 にのみ UTC設定できますが、タイムゾーンが指定されていない場合は既定値が に UTC 設定されるため、これは必要ありません。

Dimensions

Column 種類 フィルター。 例 説明
pixel_id int はい 10 変換ピクセルの ID。
advertiser_id int はい 234 ピクセルを所有する広告主の ID。
advertiser_name string いいえ Advertiser 1 ピクセルを所有する広告主の名前。
advertiser string いいえ Advertiser 1 (234) 非推奨 (2016 年 10 月 17 日現在)。
buyer_member_id int はい 567 購入メンバーの ID。
buyer_member_name string いいえ Member Name 購入メンバーの名前。
buyer_member string いいえ Member Name (567) 非推奨 (2016 年 10 月 17 日現在)。

指標

Column 種類 フィルター。 例 説明
last_fired time いいえ 2023-01-27 18:58:49 コンバージョン ピクセルが最後に発生した日付。 ピクセルが起動したことがない場合、これは 1900-01-01 00:00:00 になります。

例

JSON 形式のレポート要求を作成する

$ cat pixel_fired
  {
    "report": {
        "report_type": "pixel_fired",
        "columns": [
            "pixel_id",
            "last_fired",
            "advertiser_id",
            "buyer_member_id"
        ],
        "report_interval": "lifetime",
        "emails": ["js@email.com"],
        "format": "csv"
    }
}

POST Reporting Service への要求

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

{
    "response":{
        "status":"OK",
        "report_id":"07af1282c9485adcef49c95fa5d7496b"
    }
}

GET レポート サービスからのレポートの状態

レポート ID を GET 使用して呼び出しを行って、レポートの状態を取得します。 が "ready"になるまでこのGET呼び出しをexecution_status続けます。 次に、次の手順で説明するように、 レポート ダウンロード サービスを使用してレポート データをファイルに保存します。

$ curl -b cookies -c cookies 'https://api.appnexus.com/report?id=07af1282c9485adcef49c95fa5d7496b'

{
    "response": {
        "status": "OK",
        "report": {
            "name": null,
            "created_on": "2012-01-27 19:47:51",
            "cache_hit": false,
            "fact_cache_hit": false,
            "fact_cache_error": "did not find any cache table for 2,59",
            "json_request": "{\"report\":{\"report_type\":\"pixel_fired\",\"columns\":[\"pixel_id\",
             \"last_fired\",\"advertiser_id\",\"buyer_member_id\"],\"report_interval\":\"lifetime\",\"emails\":
             [\"js@email.com\"],\"filters\":[{\"buyer_member_id\":\"319\"}]}}",
            "header_info": "Report type:,pixel_fired\u000d\u000a,\u000d\u000aRun at:,2012-01-27 19:47:51\
             u000d\u000aStart date:,\u000d\u000aEnd date:,\u000d\u000aTimezone:,\u000d\u000aUser:,
             Sample User (2562)\u000d\u000a",
            "url": "report-download?id=677556dvds34013ff1108f159d7f39b"
        },
        "execution_status": "ready"
    }
}

GET レポート ダウンロード サービスからのレポート データ

レポート データをファイルにダウンロードするには、レポート ID を使用して別 GET の呼び出しを行いますが、今回は report-download サービスに対して呼び出します。 保存するファイルを識別する場合は、最初POSTの で指定した の"format"ファイル拡張子を使用してください。

注:

便宜上、前 GET の応答の url フィールドには、この呼び出しで使用するサービスと ID が提供されます。

curl -b cookies -c cookies 'https://api.appnexus.com/report-download?id=677556dvds34013ff1108f159d7f39b' > /tmp/pixel_fire.csv

注:

XLSX および Excel ファイルとしてダウンロードする場合、レポートごとに 100,000 行の制限があります。