Reporting API の詳細と、一般的なレポートの問題を解決する方法について説明します。
ヒント: はじめに Singular Reporting API をお読みください!
トラブルシューティング
- Get Report Status が返すエラーコードを確認し、Error Codesインデックスを使用して失敗の原因を調べてください。
- それでも問題が解決しない場合は、Singularのサポートチームに連絡してください。レポートIDを保存しておくことをお勧めします。チームはそれを使ってエラーを返した特定のAPIコールを見つけ、完了できなかった技術的な理由を確認することができます。
一般的に、昨日のデータはあなたのローカルタイムゾーンの午前8時までに準備されているはずです。もし準備できていなければ, Data Availabilityエンドポイントが返す "status "パラメータを確認してください.このパラメータには、問題についての詳細情報が含まれている可能性があります(詳細については、Data Availability Endpointのリファレンスを参照してください)。ログインに問題がある場合(Singularがデータを引き出すためにソースにログインできなかった)、SingularアプリのData Connectorsページに行き、認証情報を再入力してください。
しかし、ログインエラーのようなすぐに特定できる問題がない場合もあります。様々な理由でデータの取得が遅れることがあります。データの遅延についてはSingularチームに自動的に通知され、直ちに問題解決に取り掛かります。その間に
- 他のすべてのネットワークを照会し、遅延しているネットワークは後回しにしてください。
- 少なくとも1時間待ってから再度確認する
- 緊急の場合、お待ちいただいてもソースにデータが反映されない場合は、Singularサポートにお知らせください。
なぜ「該当なし」の値が表示されるのかを理解するには、レポートの「該当なし」とデータの欠落のトラブルシューティングをご覧ください。
キャンペーンのすべてのメトリクスが1行に表示されるのではなく、アドネットワークのメトリクス(コストなど)が1行に表示され、アトリビューショントラッカーのメトリクス(インストール数など)が2行に表示されることがあります。
なぜこのようなことが起こるのかについては、ネットワークとトラッカーのデータを結合する(ガイドの一部、単一レポートデータを理解する)を参照してください。
このエラーは、クエリに存在しないフィルタが含まれている場合に発生します。例えば、Appsページに存在しないアプリや、全く存在しないOSでフィルタリングしようとした可能性があります。返されたフィルター値を調べ、クエリを適切に修正してください。
フィルタリングできるすべてのフィールドと、各フィールドの有効な値のリストを取得するには、 filtersエンドポイントを使用してください。
クエリにカスタム・ディメンションを含めている場合は、カスタム・ディメンション・エンドポイントを使用して、そのディメンションがまだ使用可能であることを再確認してください。このエラーは、クエリが記述された後に、あなたまたはあなたのチームがカスタム・ディメンション設定ページで変更を行った場合に発生する可能性があります。
さらに、カスタム・ディメンションでは、"表示名" ではなくディメンジョン ID を使用するようにしてください。
詳細は、カスタム・ディメンション FAQ を参照してください。
クエリにコホート・メトリクスまたはイベントが含まれている場合は、Cohort Metrics エンドポイントを使用して、使用したメトリクスと期間が使用可能であることを再確認してください。表示名」ではなく「メトリック名」を使用していることを確認してください。
これは、データを取得する一部の広告ネットワークに関する技術的な問題を回避するために発生します。
キャンペーン内のクリエイティブに対する広告ネットワークのメトリックが、キャンペーンの広告ネットワークのメトリックと正確に一致しないことがあります。
例えば、クリエイティブレベルで取得したデータは50クリックですが、キャンペーンレベルで取得したデータは同じキャンペーンで45クリックです:
このような場合、データを整合させるために、Singularはデータベースにダミーのクリエイティブ行を追加し、クリエイティブのメトリックがキャンペーン全体のメトリックに加算されるように必要な値を与えます。この値はマイナスになることもあります。このダミー行のクリエイティブ名は、"Missing Creative Data "として与えられます。
これらのダミー行は通常API結果にのみ表示されます(Singularウェブプラットフォームで実行するレポートには表示されません)。クエリにdisplay_alignment=Falseを追加することで非表示にすることができます。
詳しくはクリエイティブレポートのFAQとトラブルシューティングをご覧ください。
Singularには、行内の他の指標に基づいて計算される指標があります。例えば、CPI(インストールあたりのコスト)は、コストをインストール数で割ったものです。APIレポートではこれらのメトリクスの使用を避けることをお勧めします 。集計されたクエリ(メトリクスの合計が「+」操作で行われる)では、意味のない結果が得られるからです。
例えば
クエリにクリエイティブディメンジョン(creative_id、creative_name、asset_id、asset_nameなど)が含まれているか確認してください。Google Adsのような一部のネットワークでは、キャンペーンごとの国データは提供されますが、クリエイティブごとの国データは提供されません。
Google Adsの機能と制限の詳細については、AdWords (Google Ads) Data Connectorを参照してください。
Singular APIとSingularユーザーインターフェース(app.singular.net)は同じコードを使ってSingularデータベースからデータを取り出します。もし一致しない場合は、全く同じクエリを実行していない可能性があります。
Singularユーザーインターフェースのクエリ設定とAPIクエリを比較し、特に以下の違いに注意してください:
- 異なる日付セットのクエリ
- 通常のメトリクスではなく、不一致メトリクスを使用する
- クリエイティブ・レポートでダミーの行を表示する(「クリエイティブ名」ディメンジョンで「クリエイティブ・データがありません」と表示されるのはなぜですか?)
開発者ツールを使用して、UI使用時に実行されるget_new_dataAPIコールを確認することもできます。
非同期レポートは同時に100件しか実行できません。すでに100件のレポートを提出している場合は、レポートが終了するまで待ってから次のレポートを提出してください。
様々な理由で発生する可能性があります。しばらく待ってからAPIコールを再試行してください.毎日同じコードを実行してレポートを取得している場合は、500エラーが発生した場合に備えてコードに再試行を追加してください。
問題が解決しない場合は、Singularサポートに連絡してください。
よくある質問
ほとんどのネットワークでは、Singularは毎日データを更新しますので、毎日レポートを実行することは良い習慣です。それ以上の頻度でデータを照会する理由はありません。詳しくはデイリーレポートの実行をご覧ください。