Digital Platform API - Publisher Analytics

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

レポートを取得する手順については、 レポート サービス または以下の 例を 参照してください。 このレポートでは、次のように 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 か月間、個人に関するレポートを作成できなくなります。
  • クリエイティブ
  • プレースメント
  • ブランド

場合によっては、特定の広告主またはパブリッシャーの Lifetime QuickStats と一致しない配信が Analytics レポートに表示される場合があります。 これは、100 日と 14 か月を超える Analytics レポート データを集計する方法が原因です。 課金レポートのデータは、非集計形式で無期限に保持されます。

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: POST レポート サービスへの要求 JSON

$ 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