ログとユーザーレベル・データのエクスポート FAQ

ドキュメント

ユーザーレベルデータは、Singularのアトリビューショントラッカー、詐欺防止エンジン、SKAdNetworkの統合によって記録される生のデータです。ユーザーレベルのログは、ログのエクスポートページ (Attribution > Export Logs)からダウンロードできます。

各ログのフィールドの説明については、ログのエクスポートを参照してください:サポートされているフィールド」を参照してください。

この記事では、Singularのお客様が利用できるログのエクスポート機能について説明します。Singularのパートナーの方は、パートナーポータルの利用をご覧ください。

ログのトラブルシューティング

コンバージョン/イベントログがSingularの集計レポートと一致しないのはなぜですか?

コンバージョンや イベントのログ(ログのエクスポートページ)をダウンロードしても、Singularのレポート(レポートページまたはAPIレポート)に表示されるカウントと一致しない場合は、以下を確認してください:

レポートがコホート分析を使用している可能性があります。

つまり、レポートでは、日付範囲内のすべての日について、その日にアプリをインストールしたユーザーによって作成されたイベントをカウントしています(「コホート・メトリクスとコホート期間とは」を参照してください)。一方、エクスポートされたログのイベントは、常に実際に発生した日付と時刻に関連付けられています。

レポート設定を確認して、コホート期間が実際の日付に発生したイベントを表示するように設定されていることを確認してください。

サーバー時間と調整時間

Singularデータベースには各イベントに関連する2つの異なる時間値があります:

  • サーバータイムスタンプはイベントがSingularサーバーで受信された時刻を反映します。これは、イベントデータの送信に技術的な遅延があった場合、イベントが発生した元の時刻と大きく異なることがあります。
  • 調整されたタイムスタンプは、イベントが発生した元の時刻を反映します。

ログのエクスポート」ページの日付範囲は、サーバーのタイムスタンプに基づいています。

レポート ページやその他のSingularレポートツール(Singular APIなど)の日付範囲は、調整されたタイムスタンプに基づいています。

このため、例えば6月1日に発生したイベントが遅れて6月2日にSingularサーバーに到着した場合、イベントカウントに矛盾が生じる可能性があります。

"トラブルシューティングのヒントについては、「レポートのトラブルシューティング」セクションを参照してください。

ログにネットワークやキャンペーン名ではなく、"Organic"、"Suppressed"、または "Unattributed "が表示されるのはなぜですか?

ダウンロードしたログにこれらの値が表示される理由はいくつか考えられます。

1.実際のオーガニックコンバージョン

コンバージョンが有料ソースでないと判断された場合、それはオーガニックとマークされ、ユーザーレベルのログにこのように表示されます:

  • ネットワーク"オーガニック"
  • キャンペーン"無属性"

2.Facebookキャンペーン

エンドユーザーのプライバシーに関する懸念のため、Facebookは、Facebookの自己帰属APIに基づく帰属のユーザーレベルのデータを表示することを許可していません。これらの属性は次のように表示されます:

  • ネットワーク:"無属性"
  • キャンペーン"無属性"

自己アトリビューションAPIに加えて、FacebookにはAndroidInstall Referrerに基づく別のアトリビューションメソッドもあることに注意してください。このメソッドに基づくアトリビューションは、ユーザーレベルのレポートにおいて、すべての通常の詳細とともに表示されます。

"詳細については、Facebook Ads Attribution Integrationを参照してください。

3.TikTokビュースルーキャンペーン

2022年3月22日現在、TikTokは、ユーザーのプライバシーに関する懸念のため、ビュースルーキャンペーンのユーザーレベルのデータをマスクすることをMMPに要求しています。そのため、コンバージョンがTikTokのビュースルー(インプレッションベース)キャンペーンに起因する場合、ポストバックとログの両方で以下のように表示されます:

  • ネットワーク"TikTok制限"
  • キャンペーン"TikTok制限"

"詳細については TikTok For Business Attribution Integrationを参照してください。

4.データ保持期間が過ぎました

一部のパートナーは、ユーザーのプライバシーに関する懸念から、一定期間経過後にユーザーレベルのデータをマスクするようSingularに要求します。

インストールまたはリエンゲージメントが以下のいずれかに起因し、データ保持期間が過ぎた後にアプリ内イベントがトリガーされた場合、ユーザーレベルのイベントログに以下の詳細が表示されます:

  • ネットワーク"オーガニック"
  • キャンペーン"抑制"
パートナー 最大データ保持期間
フェイスブック 6ヶ月
TikTok 6ヶ月
ツイッター 6ヶ月
グーグル広告 6ヶ月
スナップチャット 2ヶ月

ヒント:コンバージョンやイベントを含むポストバックを社内のBIプラットフォームで受信している場合は、社内で詳細を調べて、特定のデバイスIDの元の獲得ソースを理解することができます。

なぜログにはSingularの集計レポートよりも少ないFacebookイベント/インストールがあるのですか?

2021年10月現在、FacebookはSingularのようなMMPがFacebookの自己帰属APIを通して帰属されたインストールやイベントに関する ユーザーレベルの情報を表示することを許可していませんそのため、これらのインストールやイベントは、エクスポートログや社内BIに送信されるポストバックでFacebookのものとしてマークされません。この制限は集計データには適用されないため、Singularは集計レポート(レポートページ、Singular APIなど)にこれらのインストールやイベントに関する情報を表示します。

自己アトリビューション API に加えて、Facebook には Android Install Referrer に基づく別のアトリビューションソリューションがあります。インストールリファラーを通して帰属されたインストールやイベントは、エクスポートログに表示されます。

Facebookキャンペーンに関するインストールリファラーベースの情報を提供できるように、アプリのインストールリファラー復号化キーをSingularに渡すことをお勧めします。

"詳しくは、Facebook Ads Attribution Integrationをご覧ください。

よくある質問

ユーザーレベルのデータとは何ですか?

ユーザーレベルデータとは、Singularのアトリビューションメカニズムと不正防止エンジンによって記録される生のデータです。

クリック、コンバージョン、リエンゲージメント、アプリ内ユーザーイベント、ポストバック、不正判定など、ユーザーアクティビティの詳細やアトリビューション関連レコードが含まれます。

Singularはこのデータを使用して、レポート(レポートページなど)で表示される集計データを計算します。

Singularのアトリビューションサービスのお客様であれば、未加工のユーザーレベルデータにアクセスし、様々な方法で使用することができます。例えば、問題があると思われる場合に集計レポートのデータを照合することができます。

例ユーザレベルのイベント・データを示すログ

Screen_Shot_2020-12-30_at_19.46.06.png

ユーザレベルのデータにはどのようにアクセスできますか?

ユーザーレベルのデータにアクセスするには3つの方法があります:

1.ログのエクスポートページ(属性 > ログのエクスポート)

Singularプラットフォームの「ログのエクスポート」ページでは、クリック、インストール、リエンゲージメント、アプリ内イベント、ポストバック、不正関連のユーザーレベルデータを手動でダウンロードすることができます。このページはCSVファイルを生成します。

お客様としては、前月の初めからデータをダウンロードすることができます。例えば、2月中旬であれば、1月1日以降のデータをダウンロードできます。

Singular パートナーが利用できるオプションについては、パートナーポータルの利用を参照してください:ログのエクスポート」を参照してください。

2.データ送信先

Singularのデータ送信先(ETL)は、Singularのデータをお客様の社内のBIプラットフォーム、データウェアハウス、またはストレージサービスに直接プッシュします。この方法でエクスポートできるデータの種類の一つは、ユーザーレベルの変換とイベントです。

"詳細はSingularデータ送信先FAQをご覧ください。

3.内部 BIポストバックの設定

社内BIプラットフォームにポストバックを送信するようにSingularを設定すると、インストール、リエンゲージメント、アプリ内イベント、不正判定に関するデータをリアルタイムで受け取ることができます。

"詳しくは社内BIポストバックFAQをご覧ください。

ログのエクスポートページからユーザーレベルのデータをダウンロードするには?

ログをエクスポートするには

  1. 属性]>[ログのエクスポート]に進みます。
  2. 関連する日付範囲を選択します。ログのエクスポートは先月の初めまで可能です。ダウンロードごとのレコード制限を超えないよう、日付範囲はできるだけ狭くすることをお勧めします。
  3. アプリアプリサイト、およびエクスポートするログの種類(クリック、インストール、イベント、またはポストバック)を選択します。
  4. 選択したフィールド]ボックスにドラッグして、含めたいフィールドを選択します。

    Screen_Shot_2020-12-30_at_19.52.07.png

    正確なユーザーレベルのデータを取得するために、ログをエクスポートする際にデバイスIDフィールドを選択していることを確認してください。

  5. オプションで、属性パートナー、国、デバイスID、デバイスタイプでログをフィルタリングできます。イベントログについては、特定のイベントでフィルタリングすることもでき、コンバージョンログについては、コンバージョンタイプでフィルタリングすることもできます。レコードの制限を超えないように、できるだけログをフィルタリングすることをお勧めします。Screen_Shot_2020-12-30_at_19.19.49.png
  6. ログのエクスポートを選択します。

制限事項

  • Facebookは、Facebookの自己属性APIに基づくユーザーレベルのデータへのアクセスを許可していません。通常、自己属性の Facebook インストールを識別するフィールドはすべて "Unattributed" とマークされます。Facebook には、Android Install リファラーに基づく別のアトリビューションソリューションもあり、このソリューションに基づいてアトリビューションされたインストールはユーザーレベルのエクスポートに表示されます。詳細については、Facebook Ads Attribution Integrationのドキュメントを参照してください。
  • 日付の範囲は、Singularのお客様は先月の初めまでに制限されています。Singularパートナーが利用できるオプションについては、パートナーポータルの利用を参照してください:ログのエクスポートを参照してください。
  • エクスポートは、1回のリクエストにつき5Mレコードまでに制限されています。
  • ログは現在の日の最後の60分までのデータを提供します。過去60分のデータについては、リアルタイムデータチェックボックスを選択してください。
  • Singularデータベースには、ログの各レコードに関連する2つの異なる時間値があります:サーバータイムスタンプ(イベントがSingularサーバーに受信された時間を反映)と調整済みタイムスタンプ(イベントが発生した元の時間を反映)。このため、ユーザーレベルのデータと集計されたレポートの間に不一致が生じることがあります(詳しくはこちら)。

その他の注意事項

  • タイムゾーンフィールドには、Singularアカウントに設定されているタイムゾーンが表示されます。
  • タイムスタンプフィールド(touchpoint__timestampなど)は設定したタイムゾーンでエクスポートされます。Unix時間に基づくタイムスタンプ(例:touchpoint__unix_timestamp)はUTCタイムゾーンになります。
  • デフォルトでエクスポートされるフィールドのリストを変更したい場合、またはエクスポートする新しいフィールドのリクエストを追加したい場合は、カスタマーサクセスマネージャーにご連絡ください。
  • ネットワークがユーザーレベルの不正データを要求し、Partner Configurationを通じて不正のポストバックを受信できるようになっていない場合、不正ログをダウンロードしてネットワークと共有することができます。Singularは、同意なしにサポートチケットを介してこのデータをネットワークと共有することはありません。
ダウンロードできるログの種類は

クリック

インストールまたは再エンゲージメントのアトリビューションを決定するために調査されたすべてのクリックが含まれます。

コンバージョン

インストールやリエンゲージメントイベントに関する情報、帰属先、帰属に関するその他の詳細(決定論的か 確率論的かなど)が含まれます。

注: コンバージョンイベントに提供される場所は、アプリ内部で検出された場所やユーザーが提供した情報ではなく、トリガーされた場所からのIPに基づいています。イベントの位置情報の他のソースがある場合は、アプリからSingularに送信されるパススルーパラメータを読み取ることで確認できます。

イベント

セッション、登録、購入、その他Singular SDK/S2Sを統合する際にアプリ内で定義されたイベントなど、アプリ内イベントに関するデータが含まれます。
イベントログデータとレポートでのイベントカウントを比較する場合、レポートでは1d,7d,14dなどのコホート期間ではなく、必ずACTUALを使用してください。レポートでは、ACTUAL期間のユニークイベントに対するデータは表示されません。

ポストバック

Singularから送信されたポストバックに関するデータが含まれます(アトリビューション決定に関するポストバックだけではありません)。ログには、社内BI(設定している場合)やサードパーティの分析ツールへのポストバックが含まれます。

ヒント:ポストバックログをダウンロードするときは、[レスポンスHTTPコード]フィールドと[レスポンスHTTPボディ]フィールドを必ず選択してください。Response HTTP Codeは、ポストバックが正常に配信されたかどうかを示します。200 は成功、それ以外はエラーを意味します。送信にエラーがあった場合、Singularは1分、5分、15分、30分、60分の間隔で5回ポストバックを再試行します。レスポンスHTTPボディには 、エラーの詳細が含まれる場合があります。

SKAN(SKAdNetwork)のポストバック

Singularが広告ネットワークパートナーから受け取ったSKAdNetworkポストバックのログです。これらのポストバックは、SKAdNetworkのトラッキングを使用しているiOSアプリと、ポストバックの転送を伴うSKAdNetworkの統合をSingularと行っているパートナーでのみご利用いただけます。SingularのSKAdNetworkソリューションの詳細はこちら

不正

Singular不正防止システムの生の出力です。

このログには、インストールイベントに関連するすべてのタッチポイント(クリック、インプレッションなど)の行が含まれていることに注意してください。そのため、1つのインストールに対して複数のタッチポイントが不正行為として拒否される場合があります。

異なるフィールドの意味は?

"各ログのフィールドの説明については、 ログのエクスポートを参照してください :サポートされているフィールド」をご覧ください。

集計レポートのインストールをクロスチェックするためにログを使うには?
  1. レポートページ(またはレポートAPI)で、ソースとキャンペーンごとのインストールを表示するレポートを実行します。
  2. ログのエクスポートページでコンバージョンのログタイプを選択し、同じ日付範囲の以下のフィールドを取り出します:

crosscheck.png

Singularはユーザーレベルのデータをどのくらいの期間保持しますか?

当社の統合パートナーおよびグローバルなユーザープライバシー基準に準拠するため、Singularは特定のケースにおいてユーザーレベルのデータ保持を最大30日間に制限することがあります。特に指定がない限り、ユーザーレベルデータのデフォルトの保存期間は以下の通りです:

  • インプレッションデータ:インプレッションデータ:収集日から14日間保持されます。
  • クリックデータ:クリックデータ:収集日から30日間保持。
  • ポストバックデータ:収集日から30日間保持。
  • イベントデータ:前月の月初から保持(最大60日間)。
  • アトリビューションデータ:前月の月初から保持(最大60日間)。
  • 不正データ:前月の月初から保持(最長60日間)。

これらの保存期間は、分析およびレポート作成に不可欠なデータへのアクセスを提供しながら、プライバシー規制へのコンプライアンスを保証します。これらの期間を超えてすべてのログレベルデータを保存するには、自動エクスポートを設定して、これらの情報を社内システムに取り込み、保存することを強くお勧めします。