広告主の属性付きコンバージョン

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

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

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

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": {
            ...
        }
    }
}

必要に応じて、 Lookup Service を使用して、オブジェクト ID を他の関連データ (名前、コード、状態など) にマップします。

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

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

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