デジタル プラットフォーム API - パブリッシャー分析

パブリッシャー分析レポートを使用すると、特定のパブリッシャーのサイトとプレースメント全体の収益と利益データを表示できます。 このレポートは、ネットワーク ユーザーとパブリッシャー ユーザーの両方が利用できます。

レポートを取得する手順については、 レポート サービス または以下の 例 を参照してください。 このレポートでは、次のように URL の一部としてパブリッシャー ID を指定する必要があります。

https://api.appnexus.com/report?publisher_id=PUBLISHER_ID

時間枠

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

• current_hour
• last_hour
• 今日
• yesterday
• last_48_hours
• last_7_days
• last_30_days
• month_to_date
• month_to_yesterday
• quarter_to_date
• last_month
• 有効期間

データ保持期間

このレポートのほとんどのデータは永続的に維持されます (以下に記載の例外)。 後:

• 100 日後、時間ごとのデータをレポートできなくなります。 ただし、日次、月次、および累積の間隔は引き続き使用できます。
• 14 か月後、個々の項目を報告できなくなります。
  • クリエイティブ
  • プレースメント
  • ブランド

場合によっては、分析レポートに、特定の広告主またはパブリッシャーの有効期間 QuickStats と一致しない配信が表示されることがあります。 これは、100 日と 14 か月より前のアナリティクス レポート データを集計する方法に起因します。 課金レポートのデータは、集計されていない形式で無期限に保持されます。

Dimensions

指標

年齢バケット

例

手順 1: 通報要求を準備する

$ cat the-file.json

{
    "report": {
        "format": "csv",
        "report_interval": "yesterday",
        "columns": [
            "publisher_id",
            "imp_type",
            "geo_country",
            "placement_id",
            "imps_total",
            "imps_kept",
            "imps_resold",
            "publisher_filled_revenue",
            "total_convs"
        ],
        "report_type": "publisher_analytics"
    }
}

手順 2: リクエスト JSON をレポート サービスに POST する

$ curl -b cookies -c cookies -X POST -d @the-file.json 'https://api.appnexus.com/report?publisher_id=5555'

{
    "response": {
        "status": "OK",
        "report_id": "f589854c1697da8ff9ead66825c9bc04"
    }
}

手順 3: リクエストのステータスを確認する

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

{
    "response": {
        "status": "OK",
        "report": {
            "name": "",
            "created_on": "2013-10-30 21:15:36",
            "cache_hit": false,
            "fact_cache_hit": false,
            "fact_cache_error": "",
            "header_info": "",
            "row_count": "",
            "report_size": "",
            "internal_info": "",
            "user_id": "2027",
            "entity_id": "0",
            "started_on": "1970-01-01 00:00:01",
            "finished_on": "1970-01-01 00:00:01",
            "query_time": ""
        },
        "execution_status": "pending"
    }
}

手順 4: データをダウンロードする

curl -b cookies 'https://api.appnexus.com/report-download?id=f589854c1697da8ff9ead66825c9bc04' > /tmp/publisher_analytics.csv