ネットワーク分析

Network Analytics レポートを使用して、ネットワーク メンバーの購入と販売の両方のデータを表示できます。

• 直接広告主のインプレッション (直接のパブリッシャー間で購入され、リアルタイムインベントリ)
• 直接パブリッシャー (直接広告主やその他のプラットフォーム購入者全体で販売)

特定の広告主またはパブリッシャーの詳細な分析にドリルダウンするには、 Network Advertiser Analytics レポートと Network Publisher Analytics レポートを参照してください。

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

期限

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

• current_hour
• last_hour
• 今日
• yesterday
• last_48_hours
• last_7_days
• last_30_days
• month_to_date
• month_to_yesterday
• last_2_days
• quarter_to_date
• last_month
• 一生

データ保持期間

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

• 100 日は、時間単位のデータに関するレポートを作成できなくなります。 ただし、日単位、月単位、累積間隔は引き続き使用できます。
• 14 か月間、個人に関するレポートを作成できなくなります。
  • クリエイティブ
  • プレースメント
  • ブランド

場合によっては、特定の広告主またはパブリッシャーの投資または収益化に関する他の場所に表示される統計と一致しない配信がアナリティクス レポートに表示される場合があります。 これは、100 日と 14 か月を超える Analytics レポート データを集計する方法が原因です。 課金レポートのデータは、非集計形式で無期限に保持されます。 詳細については、UI ドキュメント の「レポートの日付と時刻 」を参照してください。

45 日前より前に発生した日付を含む時間範囲

report_intervalを"lifetime"または"quarter_to_date"に設定してネットワーク分析レポートを作成する場合 (終了日が今日から 45 日を超える場合)、レポートは (含まれているメトリックに関係なく) "resource-intensive"レポートの特別なキューに追加されます。 その結果、レポートの完了に通常より時間がかかる場合があります。 さらに、これらのリソースを集中的に使用するレポートは、要求されるデータの量が原因で、完了する前に失敗する可能性があります。 レポートの完了に失敗した場合は、通知を受け取ります。 レポート要求が失敗した場合、または削除された場合は、次のことができます。

• 後でレポートを再実行します。
• network_analytics以外のレポートの種類を使用します。
• レポートの構成方法 (可能な場合) を変更して、45 日前より前の日付を含めないようにします。

45 日前より前の日付を含む API を介してネットワーク分析レポートを頻繁に要求する場合は、データのキャッシュと 一括レポート フィード または ログ レベル データ (LLD) フィードの使用を検討する必要があります。

Dimensions

指標

カスタムの表示可能な定義メトリック

例

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

JSON ファイルには、 report_type"network_analytics"と、取得する列 (ディメンションとメトリック) と report_interval が含まれている必要があります。 また、特定のディメンションをフィルター処理し、粒度 (year、 month、 day) を定義し、データを返す形式 (csv、 excel、または html) を指定することもできます。 JSON ファイルに含めることができるフィールドの詳細については、 レポート サービスに関するページを参照してください。

{code}$ cat network_analytics

{
    "report":
    {
        "report_type":"network_analytics",
        "columns":[
            "hour",
            "seller_member_name",
            "buyer_member_name",
            "advertiser_name",
            "publisher_name",
            "imps",
            "clicks",
            "total_convs",
            "ctr",
            "convs_rate"
        ],
        "report_interval":"last_48_hours",
        "format":"csv"
    }
}
{code}

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

{code}$ curl -b cookies -X POST -d @network_analytics 'https://api.appnexus.com/report'
{
   "response":{
      "status":"OK",
      "report_id":"097f59fc3ab7d02c5d60db42081d9b69"
   }
}
{code}

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

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

{code}$ curl -b cookies 'https://api.appnexus.com/report?id=097f59fc3ab7d02c5d60db42081d9b69'
{
   "response":{
      "status":"OK",
      "report":{
         "name":null,
         "created_on":"2010-05-25 19:19:53",
         "json_request":"{\"report\":{\"report_type\":\"network_analytics\",\"columns\":[\"hour\",\"seller_member_name\",
            \"buyer_member_name\",\"advertiser_name\",\"publisher_name\",\"imps\",\"clicks\",\"total_convs\",\"ctr\",\"convs_rate\"],
            \"row_per\":[\"hour\",\"seller_member_id\",\"buyer_member_id\",\"advertiser_id\",\"publisher_id\"],
            \"report_interval\":\"last_48_hours\"}}",
         "url": "report-download?id=b97897a7864dd8f34e7457226c7af592"
      },
      "execution_status":"ready"
   }
}
{code}

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

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

{code}$ curl -b cookies 'https://api.appnexus.com/report-download?id=b97897a7864dd8f34e7457226c7af592' > /tmp/network_analytics.csv{code}