レポートAPI FAQとトラブルシューティング

ドキュメント

Reporting API の詳細と、一般的なレポートの問題を解決する方法について説明します。

ヒント: はじめに Singular Reporting API をお読みください!

トラブルシューティング

レポートが失敗したらどうすればいいですか?
  1. Get Report Status が返すエラーコードを確認し、Error Codesインデックスを使用して失敗の原因を調べてください。
  2. それでも問題が解決しない場合は、Singularのサポートチームに連絡してください。レポートIDを保存しておくことをお勧めします。チームはそれを使ってエラーを返した特定のAPIコールを見つけ、完了できなかった技術的な理由を確認することができます。
データの可用性エンドポイントを照会したところ、1つ以上のネットワークでデータが見つかりませんでした。どうすればいいですか?

一般的に、昨日のデータはあなたのローカルタイムゾーンの午前8時までに準備されているはずです。もし準備できていなければ, Data Availabilityエンドポイントが返す "status "パラメータを確認してください.このパラメータには、問題についての詳細情報が含まれている可能性があります(詳細については、Data Availability Endpointのリファレンスを参照してください)。ログインに問題がある場合(Singularがデータを引き出すためにソースにログインできなかった)、SingularアプリのData Connectorsページに行き、認証情報を再入力してください。

しかし、ログインエラーのようなすぐに特定できる問題がない場合もあります。様々な理由でデータの取得が遅れることがあります。データの遅延についてはSingularチームに自動的に通知され、直ちに問題解決に取り掛かります。その間に

  • 他のすべてのネットワークを照会し、遅延しているネットワークは後回しにしてください。
  • 少なくとも1時間待ってから再度確認する
  • 緊急の場合、お待ちいただいてもソースにデータが反映されない場合は、Singularサポートにお知らせください。
データの一部が欠落している(一部のメトリクスやディメンションで「該当なし」の値がある)のはなぜですか?

なぜ「該当なし」の値が表示されるのかを理解するには、レポートの「該当なし」とデータの欠落のトラブルシューティングをご覧ください。

同じキャンペーンのメトリクスが別々の行に分かれているのはなぜですか?

キャンペーンのすべてのメトリクスが1行に表示されるのではなく、アドネットワークのメトリクス(コストなど)が1行に表示され、アトリビューショントラッカーのメトリクス(インストール数など)が2行に表示されることがあります。

なぜこのようなことが起こるのかについては、ネットワークとトラッカーのデータを結合する(ガイドの一部、単一レポートデータを理解する)を参照してください。

Invalid Filter Value(無効なフィルター値)」エラーが発生するのはなぜですか?

このエラーは、クエリに存在しないフィルタが含まれている場合に発生します。例えば、Appsページに存在しないアプリや、全く存在しないOSでフィルタリングしようとした可能性があります。返されたフィルター値を調べ、クエリを適切に修正してください。

フィルタリングできるすべてのフィールドと、各フィールドの有効な値のリストを取得するには、 filtersエンドポイントを使用してください。

リクエストに無効なディメンションが含まれています。

クエリにカスタム・ディメンションを含めている場合は、カスタム・ディメンション・エンドポイントを使用して、そのディメンションがまだ使用可能であることを再確認してください。このエラーは、クエリが記述された後に、あなたまたはあなたのチームがカスタム・ディメンション設定ページで変更を行った場合に発生する可能性があります。

さらに、カスタム・ディメンションでは、"表示名" ではなくディメンジョン ID を使用するようにしてください。

詳細は、カスタム・ディメンション FAQ を参照してください。

The request containsinvalid metrics(リクエストには無効なメトリクスが含まれています)」または「The request contains invalidcohort periods(リクエストには無効なコホート期間が含まれています)」という 400 エラーが発生するのはなぜですか?

クエリにコホート・メトリクスまたはイベントが含まれている場合は、Cohort Metrics エンドポイントを使用して、使用したメトリクスと期間が使用可能であることを再確認してください。表示名」ではなく「メトリック名」を使用していることを確認してください。

レポートを再実行すると、一部のメトリクスで数値が低くなるのはなぜですか?

データが時間とともに変化する理由のひとつは、Singularがネットワークやトラッカーから報告されたデータを表示しているためです。これらのパートナーの中には、最終データを入手する前に推定データを報告する場合があります。例えば、Twitterは「Twitterのレポートはインプレッションが配信されてから24~48時間以内に確定されます。それ以前は、リアルタイムのフィードバックを提供するためにデータを推定していますが、データは変更される可能性があります」と述べています(出典)。

クリエイティブ名」ディメンションに「クリエイティブアライメント」が表示されるのはなぜですか?クリエイティブ・メトリクスにマイナスの値が含まれるのはなぜですか?

これは、データを取得する一部の広告ネットワークに関する技術的な問題を回避するために発生します。

キャンペーン内のクリエイティブに対する広告ネットワークのメトリックが、キャンペーンの広告ネットワークのメトリックと正確に一致しないことがあります。

例えば、クリエイティブレベルで取得したデータは50クリックですが、キャンペーンレベルで取得したデータは同じキャンペーンで45クリックです:

Screen_Shot_2019-12-03_at_18.19.18.png

このような場合、データを整合させるために、Singularはデータベースにダミーのクリエイティブ行を追加し、クリエイティブのメトリックがキャンペーン全体のメトリックに加算されるように必要な値を与えます。この値はマイナスになることもあります。このダミー行のクリエイティブ名は、"Missing Creative Data "として与えられます。

Screen_Shot_2019-12-03_at_18.19.32.png

これらのダミー行は通常API結果にのみ表示されます(Singularウェブプラットフォームで実行するレポートには表示されません)。クエリにdisplay_alignment=Falseを追加することで非表示にすることができます。

詳しくはクリエイティブレポートのFAQとトラブルシューティングをご覧ください。

CPEやCPIなどで意味のない値が表示されるのはなぜですか?

Singularには、行内の他の指標に基づいて計算される指標があります。例えば、CPI(インストールあたりのコスト)は、コストをインストール数で割ったものです。APIレポートではこれらのメトリクスの使用を避けることをお勧めします 。集計されたクエリ(メトリクスの合計が「+」操作で行われる)では、意味のない結果が得られるからです。

例えば

Screen_Shot_2020-07-01_at_0.21.18.png

国別データがあるはずのキャンペーンで、国別ディメンションに「N/A」が表示されるのはなぜですか?

クエリにクリエイティブディメンジョン(creative_idcreative_nameasset_idasset_nameなど)が含まれているか確認してください。Google Adsのような一部のネットワークでは、キャンペーンごとの国データは提供されますが、クリエイティブごとの国データは提供されません。

Google Adsの機能と制限の詳細については、AdWords (Google Ads) Data Connectorを参照してください。

Singular APIレポートと Singularユーザーインターフェースの間に矛盾があるのはなぜですか?

Singular APIとSingularユーザーインターフェース(app.singular.net)は同じコードを使ってSingularデータベースからデータを取り出します。もし一致しない場合は、全く同じクエリを実行していない可能性があります。

Singularユーザーインターフェースのクエリ設定とAPIクエリを比較し、特に以下の違いに注意してください:

開発者ツールを使用して、UI使用時に実行されるget_new_dataAPIコールを確認することもできます。

429エラーが発生するのはなぜですか?

非同期レポートは同時に100件しか実行できません。すでに100件のレポートを提出している場合は、レポートが終了するまで待ってから次のレポートを提出してください。

500エラー("Internal server error")が発生したらどうすればいいですか?

様々な理由で発生する可能性があります。しばらく待ってからAPIコールを再試行してください.毎日同じコードを実行してレポートを取得している場合は、500エラーが発生した場合に備えてコードに再試行を追加してください。

問題が解決しない場合は、Singularサポートに連絡してください。

よくある質問

どのくらいの頻度でレポートを実行すればいいですか?

ほとんどのネットワークでは、Singularは毎日データを更新しますので、毎日レポートを実行することは良い習慣です。それ以上の頻度でデータを照会する理由はありません。詳しくはデイリーレポートの実行をご覧ください。