レポート サービスは、さまざまな種類のレポートへのアクセスを提供するために使用されます。 また、各ユーザー タイプがそのタイプに適したレポートにのみアクセスできるようにします。 たとえば、ネットワーク ユーザーはすべてのレポート タイプにアクセスできますが、広告主とパブリッシャーのユーザーは少数のレポート タイプにしかアクセスできません。
使用できる指標はレポートの種類によって異なりますが、在庫に費やされた金額、表示または販売されたインプレッションの数、獲得した収益などを含めることができます。 このドキュメントでは、レポート サービスからデータを要求およびダウンロードする方法について説明します。 また、サポートされている各レポートの種類に関する詳細情報を取得する方法についても説明し、各レポートの種類に関する詳細なドキュメントへのリンクも提供します。
注:
- Xandr データをレポート データベースに同期する方法の詳細については、「 一括レポート フィード」を参照してください。
- これは読み取り専用サービスです。JSON 形式のレポート要求を
POSTしますが、これによりサーバーに保存されているデータが変更されることはありません。
レポートの種類
| レポートの種類 | ユーザーの種類 | 説明 | データ保有期間 |
|---|---|---|---|
ネットワーク分析network_analytics |
Network | 何が起こっているかの一般的な概要。 買い側と売り側の両方で、何が役に立っているのか、何がうまくいっているのか。 | 有効期間 - 100 日後には一部のデータの粒度が低下します。 |
ネットワーク課金network_billing |
Network | 広告主に請求する必要があるもの、パブリッシャーまたは Xandr から請求される可能性のあるもの。 | 有効期間 - 100 日後には一部のデータの粒度が低下します。 |
請求レポートの購入buyer_invoice_report |
Network | 購入関連費用との財務調整のレポート。 | 1095 日 |
Selling Billing Reportseller_invoice_report |
Network | 販売関連費用との財務調整のレポート。 | 1095 日 |
ネットワーク広告主の分析network_advertiser_analytics |
Network | 広告主のネットワーク レポート。 | 有効期間 - 100 日後には一部のデータの粒度が低下します。 |
ネットワーク パブリッシャーの分析network_publisher_analytics |
Network | パブリッシャーに関するネットワーク レポート。 | 有効期間 - 100 日後には一部のデータの粒度が低下します。 |
パブリッシャー分析publisher_analytics |
ネットワーク、パブリッシャー | パブリッシャーが表示する必要がある内容についてのレポート。 | 有効期間 - 100 日後には一部のデータの粒度が低下します。 |
広告主の分析advertiser_analytics |
ネットワーク、広告主 | 広告主が見るべき内容についてのレポート。 | 有効期間 - 100 日後には一部のデータの粒度が低下します。 |
ネットワーク ビデオ分析video_analytics_network |
Network | 広告主とパブリッシャー全体でのビデオ イベント レポート。 | 420 日 |
ネットワーク広告主のビデオ分析video_analytics_network_advertiser |
Network | 1 つの広告主のビデオ イベント レポート。 | 420 日 |
ネットワーク パブリッシャー ビデオ分析video_analytics_network_publisher |
Network | 1 つのパブリッシャーのビデオ イベント レポート。 | 420 日 |
バイヤー セグメントのパフォーマンス レポートbuyer_segment_performance |
Network | キャンペーンと複数の広告主にわたるセグメントのパフォーマンスに関するレポート。 | 45 日 |
販売者ブランド レビュー レポートseller_brand_review |
Network | ネットワークのすべてのインベントリにわたるブランドのパフォーマンスに関するレポート。 | 428 日 |
パブリッシャー ブランド レビュー レポートpublisher_brand_review |
Publisher | パブリッシャーのすべての在庫にわたるブランドのパフォーマンスに関するレポート。 | 428 日 |
ネットワーク クリエイティブの頻度 & Recencynetwork_advertiser_frequency_recency |
Network | 1 つの広告主のクリエイティブの頻度と最新性に関するネットワーク レポート。 | 120 日間 |
広告主のクリエイティブの頻度 & の最新性advertiser_frequency_recency |
ネットワーク、広告主 | 広告主様が見るべきクリエイティブの頻度と最新性についてのレポート。 | 120 日間 |
ネットワーク サイト ドメインのパフォーマンスnetwork_site_domain_performance |
Network | 広告主全体のドメイン パフォーマンスに関するネットワーク レポート。 | 45 日 |
サイト ドメインのパフォーマンス レポートsite_domain_performance |
ネットワーク、広告主 | 1 つの広告主のドメインのパフォーマンスに関するレポート。 | 45 日 |
販売者サイト ドメインseller_site_domain |
Network | パブリッシャーから送信されるインベントリに関するレポート。 | 60 日 |
セグメント読み込みレポートsegment_load |
Network | セグメントのネットワーク レポート。 | 30 日間 |
広告主が属性付けしたコンバージョンattributed_conversions |
Network | 広告主の属性付きコンバージョンに関するネットワーク レポート。 | 90 日間 |
地理分析レポートgeo_analytics |
Network | キャンペーンの配信とパフォーマンスを地域別に分類します。 | 45 日 |
ネットワーク キャリア分析network_carrier_analytics |
Network | モバイル デバイス キャリアに基づくバイサイドおよびセルサイドのパフォーマンス データをレポートします。 | 46 日 |
ネットワーク デバイス分析network_device_analytics |
Network | インプレッションが配信されたデバイスに基づいてバイサイドとセルサイドのパフォーマンス データをレポートします。 | 428 日 |
変換ピクセルの最後の発射pixel_fired |
Network | 広告主のコンバージョン ピクセルの最終発生日時のネットワーク レポート。 | 有効期間 |
完了したクリエイティブ監査レポートcompleted_creative_audits |
Network | クリエイティブが監査プロセスをどのように進んでいるかを把握するために設計されたネットワーク レポート | 365 日 |
一括レポート フィードnetwork_analytics_feedclicktrackers |
Network | 集計レポートをレポート データベースに同期する機能。 | 30 日間 |
データ使用状況レポートbuyer_data_usage_analytics |
Network | サード パーティ (ユーザー セグメント プロバイダーなど) から提供されたデータの使用状況、そのデータ使用にかかるコスト、そのデータがターゲット ユーザーに使用された広告申込情報やキャンペーンに関する詳細を示すネットワーク レポート。 | 60 日 |
ベンダーの使用状況レポートbuyer_vendor_usage_analytics |
Network | サード パーティ ベンダー (ユーザー セグメント プロバイダーなど) が提供するデータまたはプラットフォームの使用状況、そのデータまたは機能の使用状況にかかるコスト、ベンダー コストが適用されたライン アイテム/キャンペーンに関する詳細を提供するネットワーク レポート。 | 60 日 |
バイヤー エンゲージメント レポート buyer_engagement_report |
広告主 | ディスプレイ クリエイティブとビデオ クリエイティブの表示可能な持続時間に関する分析情報を提供します。 | 過去 5 週間 |
Buyer Deal Metricsbuyer_deal_metrics |
広告主、ネットワーク | 購入者に関連する取引指標、パフォーマンス、却下理由に関する重要な情報。 | 30 日間 |
販売者取引メトリックseller_deal_metrics |
パブリッシャー、ネットワーク | 販売者に関連する取引メトリック、パフォーマンス、却下理由に関する重要な情報。 | 30 日間 |
マルチバイヤー出品者取引指標multi_buyer_seller_deal_metrics |
パブリッシャー、ネットワーク | 販売者に関連する取引メトリック、パフォーマンス、却下理由に関する重要な情報。 | 30 日間 |
Key Value Analyticskey_value_analytics |
Network | ネットワークで定義されたターゲティング キーと値に関連付けられている情報に関するネットワーク レポート。 キー/値ターゲティングを使用したインプレッションは、キー名に kw_ プレフィックスを含むプレースメント タグによって記録されたインプレッションについてのみ配信および報告されます。 | 428 日 |
キュレーター分析レポートcurator_analytics |
キュレーター | キュレーターは、キュレーションされたマーケットプレイス内で需要から供給にお金がどのように流れているかについての洞察を提供します。 | 14 か月 |
キュレーター セグメントのパフォーマンス レポートcurator_segment_performance |
キュレーター | ターゲット セグメントがキュレーションされた取引の全体的なパフォーマンスにどのように貢献しているかについて、キュレーターに分析情報を提供します。 | 14 か月 |
Buyer Reach And Frequencyレポートbuyer_approximate_unique_users_hourly |
Network | 広告にさらされた一意のデバイスまたはユーザーの数である "リーチ" と、一意のデバイスまたはユーザーのそれぞれが広告にさらされた平均回数である "頻度" に関連付けられている情報を提供します。 | 90 日間 |
オフライン アトリビューション レポートoffline_attribution |
広告主 | ターゲット オーディエンスの店舗での購入に影響を与える、お客様の品目のパフォーマンスに関する分析情報を提供します。 オフライン アトリビューション レポートにアクセスできるのは、ライン アイテムでオフライン セールス アトリビューションが有効になっているクライアントのみです。 | 120 日間 |
販売者 CMP 分析レポートcmp_analytics |
Network | エンドポイントへの販売者広告リクエストに関する IAB Transparency & Consent Framework (IAB TCF) 文字列の数、有効性、内容に関する分析情報を提供します。 | 30 日間 |
Prebid Server Premium 正常性分析レポートpsp_health_analytics |
Network | Prebid Server Premium の入札要求とトランザクションに関連するデータ。 トラブルシューティングと最適化に役立ちます。 レポートは、 PSP アクティビティの全量を推定するために乗算されたサンプル データに基づいています。 Monetize 履歴レポートまたはその他の Monetize レポートは、これらの目的のために使用する必要があります。 | 99 日 |
在庫状況レポートplatform_inventory_availability |
広告主、パブリッシャー | 在庫可用性レポートは、プラットフォームで利用可能なインベントリの種類に関する洞察を提供します。 | 30 日間 |
メタデータを表示するための REST API
| HTTP メソッド | エンドポイント | 説明 |
|---|---|---|
GET |
https://api.appnexus.com/report?meta | すべてのレポートのメタデータを返します。 |
GET |
https://api.appnexus.com/report?meta=REPORT_TYPE | 特定のレポート タイプのメタデータを返します。 |
メタデータを表示するための JSON フィールド
メタ配列には、次のフィールドが含まれます。
| フィールド | 説明 |
|---|---|
time_granularity |
レポートでデータを提供できる時間の粒度。 使用可能な値: - "hourly" - "daily" - "monthly" - "yearly" - "lifetime""hourly" または "lifetime" の場合は、年、月、日、時間のデータを使用できます。 "daily"、"monthly"、"yearly" の場合、年、月、日のデータのみを使用できます。 |
columns |
要求できる列。 各列の名前と種類が JSON 応答に一覧表示されます。 |
filters |
フィルターとして使用できる列。 各列の名前と種類が JSON 応答に一覧表示されます。 |
time_intervals |
レポートを実行できる時間範囲。 |
注:
レポートの種類によっては、カスタムの時間枠でレポートを実行できます。 これを行うには、レポート要求の start_date フィールドと end_date フィールドを設定します。
メタデータ応答の例 ( network_analytics レポートの使用)
$ curl -b cookies -c cookies 'https://api.appnexus.com/report?meta=network_analytics'
{
"response": {
"status": "OK",
"meta": {
"time_granularity": "hourly",
"columns": [
{
"column": "month",
"type": "date"
},
{
"column": "day",
"type": "date"
},
{
"column": "hour",
"type": "date"
},
{
"column": "buyer_member_id",
"type": "int"
},
{
"column": "seller_member_id",
"type": "int"
},
{
"column": "seller_member_name",
"type": "string"
},
{
"column": "seller_member",
"type": "string"
},
{
"column": "advertiser_id",
"type": "int"
},
...
],
"filters": [
{
"column": "hour",
"type": "date"
},
{
"column": "day",
"type": "date"
},
{
"column": "month",
"type": "date"
},
{
"column": "buyer_member_id",
"type": "int"
},
{
"column": "seller_member_id",
"type": "int"
},
...
],
"havings": [
{
"column": "imps"
},
{
"column": "clicks"
},
{
"column": "cost"
},
{
"column": "revenue"
},
{
"column": "booked_revenue"
},
{
"column": "reseller_revenue"
},
{
"column": "profit"
},
...
],
"time_intervals": [
"current_hour",
"last_hour",
"last_48_hours",
"today",
"yesterday",
"last_7_days",
"month_to_date",
"quarter_to_date",
"last_month",
"lifetime",
"mtd"
]
}
}
}
データ取得用の REST API
| HTTP メソッド | エンドポイント | 説明 |
|---|---|---|
POST |
https://api.appnexus.com/report (レポート JSON) |
レポートを要求します。 |
GET |
https://api.appnexus.com/report?id=REPORT_ID | レポートの状態を要求します。 |
GET |
https://api.appnexus.com/report-download?id=REPORT_ID | レポート データを取得します。 |
注:
ネットワーク ユーザーは、クエリ文字列に advertiser_id=ADVERTISER_ID または publisher_id=PUBLISHER_ID を付加することで、広告主およびパブリッシャー レベルのレポートを実行できます。
データ取得用の JSON フィールド
| フィールド | 必須 POST |
型 | 説明 |
|---|---|---|---|
report_type |
はい | 列挙 | これにより、返される情報が決まります。 使用可能な値: - "network_analytics"- "network_billing"- "buyer_invoice_report"- "seller_invoice_report"- "network_advertiser_analytics"- "network_publisher_analytics"- "network_site_domain_performance"- "advertiser_analytics"- "video_analytics_network"- "video_analytics_network_advertiser"- "video_analytics_network_publisher"- "buyer_segment_performance"- "seller_brand_review"- "publisher_brand_review"- "publisher_analytics"- "network_creative_search"- "publisher_creative_search"- "network_advertiser_frequency_recency"- "advertiser_frequency_recency"- "site_domain_performance"- "seller_site_domain"- "inventory_domain_analytics"- "inventory_source_analytics"- "inventory_daily_uniques"- "segment_load"- "attributed_conversions"- "pixel_fired"- "network_analytics_feed"- "clicktrackers"- "key_value_analytics"- "psp_health_analytics" |
timezone |
不要 | string (50) | これによって、データがどのタイム ゾーンで報告されるかが決まります。 使用可能なタイムゾーン値のリストについては、「 API タイムゾーン」を参照してください。 メモ: network_billing、network_analytics、network_advertiser_analytics、network_publisher_analytics、advertiser_analytics、publisher_analytics レポートの種類の場合、100 日より前のデータは UTC で報告されます。 また、 network_site_domain_performance、 site_domain_performance、 seller_site_domain など、時間ごとのデータを提供しないレポートの種類は UTC で報告されます。 |
filters |
不要 | 配列 | レポートに適用するフィルター オブジェクトの一覧。 以下の「レポートの実行方法」セクションの手順 1 を参照してください。 |
group_filters |
不要 | オブジェクトの配列 | 1 つまたは複数のフィルターに対して実行する操作を指定できます。 たとえば、キャンペーン別にグループ化された合計インプレッションを選択している場合、このフィールドを使用して、インプレッション数が 10,000 以上ないキャンペーンを除外できます。 |
columns |
はい | 文字列の配列 | レポートに含める列の一覧。 以下の JSON 形式のレポート要求の作成 を参照してください。 少なくとも 1 つの列を指定する必要があります。 |
row_per または groups |
不要 | 配列 |
注: 非推奨です。既定では、レポート結果は columns のディメンションによって自動的にグループ化されます。 これらのフィールドを渡しても効果はありません。ほとんどのレポートでは、選択したディメンションが自動的にグループ化されます。 たとえば、 "advertiser_id"、 "campaign_id"、 "creative_id"、 "imps" 列を含めると、レポート データの各行には、広告主、キャンペーン、クリエイティブの組み合わせごとのインプレッション数が表示されます。 |
start_date |
いいえ | string | レポートの開始日。 - 時間ごとのデータを提供するレポートタイプの場合、これは "YYYY-MM-DD HH:MM:SS"として書式設定する必要があります。注: MM:SS 分と秒間データは利用できないため、 00:00する必要があります。- 時間ごとのデータを提供しないレポート タイプの場合、これは "YYYY-MM-DD" として書式設定する必要があります。 |
end_date |
いいえ | string | レポートの終了日。 メモ: end_dateは包括的ではありません。 たとえば、レポートを "2017-07-01 00:00:00" で開始し、 "2017-07-01 23:00:00" で終了する場合、レポートにはその日の最後の 1 時間のデータは含まれません。 このデータを取得する正しい方法は、レポートを "2017-07-02 00:00:00" で終了することです。- 時間ごとのデータを提供するレポートタイプの場合、これは "YYYY-MM-DD HH:MM:SS"として書式設定する必要があります。 ただし、データは分と秒間は利用できないため、MM:SS00:00する必要があります。 たとえば、"2017-07-02 00:00:00"に"2017-07-01 00:00:00"すると、丸 1 日分のデータが取得されます。- 1 時間ごとの間隔 (例: 日次、週次など) にわたって集計されたレポートの場合、形式は "YYYY-MM-DD"にする必要があります。 たとえば、"2017-07-02"に"2017-07-01"すると、丸 1 日分のデータが取得されます。 |
report_interval |
不要 | 列挙 | レポートの時間範囲。 すべてのレポートがすべての間隔を受け入れるわけではありません。 詳しくは、各レポートのドキュメントとメタデータをご覧ください。 使用可能な値: - current_hour- last_hour- today- yesterday- last_48_hours- last_2_days- last_7_days- last_14_days- month_to_yesterday- month_to_date- quarter_to_date- last_month- lifetime- 30_days |
orders |
不要 | オブジェクトの配列 | 並べ替えの基準になる列のリスト。 以下の 「レポートの実行方法 」を参照してください。 |
format |
不要 | 列挙 | レポート データが返される形式。 このフィールドが指定されていない場合は、デフォルトで "csv" になります。使用可能な値: - "csv": コンマ区切り値- "excel": タブ区切りの値- "html" |
reporting_decimal_type |
不要 | 列挙 | レポートで使用されている小数点記号。 使用可能な値: - "comma"- "decimal" (ピリオド)このフィールドが渡されると、ユーザー レベルとメンバー レベルで設定されたレポートの 10 進数設定がオーバーライドされます。 |
emails |
不要 | 配列 | レポート データの送信先となるメール アドレスのリスト。 レポート データは添付ファイルとして送信され、メールの本文には以下の情報が含まれます。 - レポート・タイプ - メンバー、広告主、またはパブリッシャーの名前と ID - 実行日 - 開始日 - 終了日 - タイムゾーン - レポートを生成したユーザー。 メモ: 15 MB を超えるレポート結果はメールで送信されません。 結果が大きくなりすぎないようにする方法については、「 レポートのベスト プラクティス」を参照してください。 |
escape_fields |
いいえ | ブール値 |
trueすると、Excel に安全にインポートできるように、レポート出力の各フィールドの前後に引用符が追加されます。 これは、CSV とタブ区切りレポートにのみ適用されます。 |
group_filters 例文
{
"group_filters": [
{
"imps": {
"value": 10000,
"operator": ">="
}
}
]
}
レポートの実行方法
- 手順 1. JSON 形式のレポート要求を作成する
- 手順 2.
POSTレポート サービスへの要求 - 手順 3.
GETレポート サービスからのレポートの状態 - 手順 4.
GETレポート ダウンロード サービスからのレポート データ
手順 1: JSON 形式のレポート要求を作成する
JSON ファイルには、実行する特定の report_type と、取得する columns (サイズとメトリック) と report_interval ("today"、 "yesterday"、 "month_to_date" など) を含める必要があります。 また、ディメンションの filters を含め、粒度 (year、 month、 day) を定義し、データを返す format を指定することもできます。 次の format オプションがあります。
-
"csv"- コンマ区切りファイル -
"excel"- タブ区切りファイル -
"xlsx"- 最新の XML 互換 Excel 形式 (zip 形式)
注:
複数の値でディメンションをフィルター処理するには、配列を使用します。 例:
適切:
"filters": [{"bid_type": ["learn","optimized"]},
{"geo_country":"US"}]
不適切:
"filters": [{"bid_type":"learn"},
{"bid_type":"optimized"},`` {"geo_country":"US"}]
要求に含めることができるフィールドの詳細については、上記の JSON フィールド を参照してください。 使用可能なディメンションとメトリックの完全なリストについては、実行する特定のレポートタイプのドキュメントを参照するか、「 メタデータを表示するための REST API」で説明されているようにそのレポートのメタデータを取得します。
$ cat report_request
{
"report": {
"report_type": "network_analytics",
"report_interval": "last_48_hours",
"columns": ["day","imps","clicks"],
"filters": [{"geo_country":"US"}],
"orders": [{"order_by":"day", "direction":"ASC"},{"order_by":"imps", "direction":"DESC"}],
"format": "csv"
}
}
手順 2: 要求をレポート サービスに POST する
JSON 要求 POST すると、レポート ID が返されます。
$ curl -b cookies -c cookies -X POST -d @report_request 'https://api.appnexus.com/report'
{
"response": {
"status": "OK",
"report_id": "ca9955709eade9a0e89f5cda5345c12r"
}
}
または、保存されたレポート ID を使用して POST 要求を介してレポート ID を取得することもできます。 詳細については、 Saved Report Service を参照してください。
curl -c cookies -b cookies -X POST 'https://api.appnexus.com/report?saved_report_id=30'
手順 3: レポート サービスからレポートの状態 GET する
レポート ID を使用して GET 呼び出しを行い、レポートの状態を取得します。
execution_statusが"ready"されるまでこの呼び出しを続けます。 次に、 report-download サービスを使用してレポート データをファイルに保存します。 (これは次の手順で説明します。)
$ curl -b cookies -c cookies 'https://api.appnexus.com/report?id=ca9955709eade9a0e89f5cda5345c12r'
{
"response": {
"status": "OK",
"report": {
"name": null,
"created_on": "2017-03-13 18:15:48",
"cache_hit": false,
"fact_cache_hit": false,
"json_request": "{\"report\":{\"report_type\":\"network_analytics\",\"report_interval\":
\"last_48_hours\",\"columns\":[\"day\",\"imps\",\"clicks\"],\"filters\":[{\"geo_country\":
\"US\"},{\"entity_member_id\":\"514\"},{\"entity_member_id\":null}],\"orders\":
[{\"order_by\":\"day\",\"direction\":\"ASC\"},{\"order_by\":\"imps\",\"direction\":
\"DESC\"}]}}",
"header_info": "Report type:,network_analytics\r\n,\r\nRun at:,2017-03-13 18:15:48\r\nStart date:,
\r\nEnd date:,\r\nTimezone:,\r\nUser:,John Smith (9385)\r\n",
"report_size": "10",
"row_count": "35",
"url": "report-download?id=ca9955709eade9a0e89f5cda5345c12r"
},
"execution_status": "ready"
}
}
手順 4: レポート ダウンロード サービスからレポート データを GET する
レポート データをファイルにダウンロードするには、レポート ID を使用してもう一度 GET 呼び出しを行いますが、今回は report-download サービスに対して行います。 サービス ID とレポート ID は、前の GET 応答の url フィールドにあります。 保存するファイルを特定する際は、最初のPOSTで指定した"format"のファイル拡張子を使用してください。
注:
ダウンロード中にエラーが発生した場合、応答ヘッダーには HTTP エラー コードとメッセージが含まれます。 要求で -i または -v を使用して、応答ヘッダーを公開します。
curl -i -b cookies -c cookies 'https://api.appnexus.com/report-download?id=ca9955709eade9a0e89f5cda5345c12r' > /tmp/network_analytics.csv
これで、Microsoft Excel または同様のソフトウェアを使用して csv ファイルを開くことができます。
レポート データ サイズの制限
15 MB を超えるレポート結果は、JSON 要求で指定された受信者に電子メールで送信されません。
処理に 15 分以上かかるレポートはタイムアウトし、エラー状態で返されます。 この処理時間は、おおよそ 1MM 行のデータに相当します。 レポートが定期的にタイムアウトする場合は、次のいずれかのオプションを検討してください。
- これらのデータが本当に必要であることを確認します。 そうでない場合は、レポート要求の時間間隔を短くするか、ディメンションを小さくします。 レポートが不必要に大きくなったり、処理に時間がかかりすぎたりすることを防ぐためのヒントについては、以下の レポートのベスト プラクティス を参照してください。
- これらのデータをすべて本当に必要な場合は、「 レポートのページネーション」の指示に従ってください。
レポートの調整
すべての利用者に対して、当社システムができるだけ円滑に動作することを目的に、 通報サービス では、会員レベルと利用者レベルの両方で通報リクエストの抑制を行っています。 このページでは、制限の決定方法と、各メンバーおよび各ユーザーに定義されている制限を超える要求の処理方法について説明します。
ユーザーの制限
ユーザー A からレポートが送信されると、ユーザー A が過去 15 分間に 5 件のレポート要求を送信した (保留中の状態であるか、現在処理中である) かどうか、チェックが実行されます。 その場合は、エラーが通知されます。
メンバー制限
特定のメンバーは、同時に処理される n 個 のレポート要求に制限されます。ここで、 n はメンバーの契約によって決定されます (これは、api.member テーブルの max_concurrent_reports_processing フィールドによって内部的に指定されます)。制限に達した後に送信されたレポート要求は、キューに配置されます。 警告や警告は表示されません。
例
次の例に示すように、ユーザー レベルとメンバー レベルの調整は相互に相互作用します。 ユーザー A とユーザー B が同じメンバーに関連付けられているとします。このメンバーには、5 つの同時レポート要求の制限があります。 この例では、次のレポート要求がすべて 15 分以内に送信されると想定しています。
| レポート要求 | User | 結果 |
|---|---|---|
| 1 | ユーザー A | Processing |
| 2 | ユーザー A | Processing |
| 3 | ユーザー B | Processing |
| 4 | ユーザー B | Processing |
| 5 | ユーザー B | Processing |
| 6 | ユーザー A | エンキュー済み |
| 7 | ユーザー A | エンキュー済み |
| 8 | ユーザー A | エンキュー済み |
| 9 | ユーザー A | Error |
このメンバーに対して既に 5 つのレポート要求が処理中であるため、レポート要求 #6 はキューに配置されます。 同じ理由で、要求 # 6 から 8 もキューに配置されます。 最後に、ユーザー A が 15 分以内に 6 回目のレポート要求を送信したため、要求 # 9 でエラーが通知されていることがわかります。
コンバージョン データ
レポート内のコンバージョン (および関連データ) は非同期で処理されます。 その結果、一部のコンバージョン関連データがまだバックグラウンドで処理されている一方で、レポートをより迅速に利用できます。 詳細については、[ レポート データの可用性 ] ページの「非同期コンバージョン属性」を参照してください。
レポートのベスト プラクティス
報告が不必要に大きくなったり、処理に時間がかかったりしないようにするためのヒントをいくつか紹介します。
-
report_intervalを短くする (例:"lifetime"から"last_48_hours")。 - より上位レベルのフィルターを追加します (特定のパブリッシャー、広告主、キャンペーンなど)。
- 詳細なバイサイドとセルサイドのディメンション (クリエイティブやプレースメントなど) を組み合わせることは避けてください。行数が指数関数的に増加するためです。 このような組み合わせについてレポートする必要がある場合は、 一括レポート フィード または ログ レベル データ (LLD) フィードの使用を検討してください。
処理に時間がかかる大規模なレポートをプルする必要がある場合は、「 レポートのページ分割」の指示に従ってください。
レポートの最終更新日時を特定するには、 レポート ステータス サービスを使用します。