広告主によるコンバージョン

[Advertiser Attributed Conversions] (広告主属性付きコンバージョン) レポートでは、コンバージョン ピクセル ID、注文 ID、属性付きクリックまたはインプレッションの回数、および属性付きコンバージョンに関連するその他の情報を表示できます。

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

このレポートは、メンバー ID と広告主 ID でフィルター処理されます。 メンバー ID はネットワーク ユーザーの認証に基づいて検出されますが、広告主 ID は URL の一部として指定する必要があります。次に例を示します。

https://api.appnexus.com/report?advertiser_id=ADVERTISER_ID

時間枠とタイム ゾーン

JSON 要求の report_interval フィールドは、次のいずれかに設定できます。

• current_hour
• last_hour
• 今日
• yesterday
• last_48_hours
• last_7_days
• last_30_days
• month_to_yesterday
• month_to_date
• last_30_days

または、[ start_date ] フィールドと [ end_date ] フィールドを過去 33 日以内の範囲に設定することもできます。 JSON 要求の timezone フィールドは UTC にのみ設定できますが、指定しない場合、タイムゾーンは既定で UTC になるため、これは必要ありません。

データ保持期間

このレポートは、過去 90 日間のデータを UTC タイムゾーンでのみ取得できます。

Dimensions

指標

例

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

この例では、コンバージョン ピクセル 9012 に関する情報を取得するフィルターを設定します。

$ cat attributed_conversions  {
    "report":
    {
        "report_type": "attributed_conversions",
        "columns": [
            "datetime",
            "pixel_id",
            "order_id",
            "post_click_or_post_view_conv",
            "post_click_or_post_view_revenue",
            "line_item_id",
            "creative_id",
            "campaign_id",
            "imp_time",
            "imp_type_id",
            "advertiser_id",
            "buyer_member_id"
        ],
        "filters": [{"pixel_id": 9012}],
        "report_interval": "last_7_days",
        "emails": ["js@email.com"],
        "format": "csv"
    }
}

POST レポート サービスへの要求

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

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

レポート ID を使用してレポート データを取得します

標準応答には、レポート データと、データをファイルに保存するために使用できるダウンロード URL が含まれます。 レポート データを含まずにダウンロード URL だけを取得する場合は、クエリ文字列に "without_data" を渡します。

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

{
    "response": {
        "status": "OK",
        "report": {
            "name": null,
            "created_on": "2011-11-22 23:51:22",
            "cache_hit": false,
            "fact_cache_hit": false,
            "json_request": "{\"report\":{\"report_type\":\"attributed_conversions\",\"columns\":
             [\"datetime\",\"pixel_id\",\"order_id\",\"post_click_or_post_view_conv\",
             \"post_click_or_post_view_revenue\",\"line_item_id\",\"creative_id\",\"campaign_id\",
             \"imp_time\",\"imp_type_id\",\"advertiser_id\",\"buyer_member_id\"],
             \"report_interval\":\"lifetime\",\"emails\":[\"js@email.com\"],\"filters\":
             [{\"buyer_member_id\":\"4567\"},{\"advertiser_id\":\"123\"}]}}",
            "header_info": "Report type:,conversion_pixel\u000d\u000a,\u000d\u000aRun at:,
             2011-11-22 23:51:22\u000d\u000aStart date:,2011-11-15 00:00:00\u000d\u000aEnd date:,
             2011-11-22 00:00:00\u000d\u000aTimezone:,\u000d\u000aUser:,John Smith (1432)
             \u000d\u000a",
            "data": "datetime,pixel_id,order_id,post_click_or_post_view_conv,
             post_click_or_post_view_revenue,line_item_id,creative_id,campaign_id,imp_time,
             imp_type_id,advertiser_id,buyer_member_id\u000d\u000a11704,8225230493273032227,
             123,8.7654A+32,4567,2011-11-18 06:00:13,2011-11-17 03:00:02,5,12345,678,9012,
             Post Click,.3.00\u000d\u000a11704,
             ..."
        },
        "execution_status": "ready",
        "dbg_info": {
            ...
        }
    }
}

必要に応じて、 ルックアップ サービス を使用して、オブジェクト ID を名前、コード、ステータスなどの他の関連データにマップします。

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

レポート データをファイルにダウンロードするには、レポート ID を使用してもう一度 GET 呼び出しを行いますが、今回は report-download サービスに対して行います。 サービス ID とレポート ID は、前の GET 応答の url フィールドにあります。 保存するファイルを特定する際は、最初のPOSTで指定した"format"のファイル拡張子を使用してください。

$ curl -b cookies -c cookies 'https://api.appnexus.com/report-download?id=b97897a7864dd8f34e7457226c7af592' > /tmp/attributed_conversions.csv