どのようにお手伝いできますか?

マーケター向けData Locker プレミアム機能

  • 更新

概要:Data Lockerは、BIシステムへの取り込みに使用するレポートデータをクラウドストレージに送信します。送信先には、AppsFlyer所有のAWSバケット、または自社所有のAWS、GCS、Yandex、BigQuery、Snowflakeのストレージを選択できます。 Data Lockerは、複数の送信先に対応しています。すべてのデータを複数の送信先に送信することも、送信先ごとにデータを分けることも、両方を組み合わせることも可能です。

概要

6133DataLockerForAdvertisers.png

Data Lockerで、AppsFlyerから選択したクラウドストレージに配信するデータに含めるアプリ、メディアソース、イベント、レポートを選択します。その後、プログラムを使用してストレージから自社システムにデータを取り込みます。 

Data Lockerの機能

機能 説明
ストレージの選択肢(クラウド)

Data Lockerは、以下のクラウドサービスにデータを送信できます。

  • AWS上のAppsFlyer所有のストレージ
  • 以下のサービスの自社所有のストレージ:
    • AWS
    • GCS
    • Azure Blob
    • [Beta機能]Yandex
    • BigQuery
    • Snowflake

Data Lockerには、複数の送信先を設定できます。すべて、または一部のデータを複数の送信先に送信できます。

例

  • レポートの種類ごとにデータを分ける。ローデータをGCSに、集計データをSnowflakeに送信する。
  • アプリごとにデータを分け、アプリグループ別に異なるバケットに送信する。 
複数アプリへの対応  アカウント内の1つ、複数、またはすべてのアプリのデータを送信できます。アカウントに追加したアプリを、自動で対象に含めることもできます。 
データ取得可能期間 14日間
データの分割方法

バケット型のクラウドストレージでは、以下の分割方法を選択できます。

  • [デフォルト]統合:すべてのアプリのデータをまとめます。データファイル内の各行にあるアプリIDフィールドで、アプリを識別します。
  • アプリ別に分割:アプリごとに別のフォルダーにデータを格納します。フォルダー名はアプリIDです。 
データ形式の選択肢
  • バケット型のクラウドストレージの場合:
  • データウェアハウス
データの更新頻度・反映時間

更新頻度・反映時間は、レポートの種類によって異なります。 

  • 時間単位:データが継続的に生成されます。例えば、インストールやアプリ内イベントのデータは、AppsFlyerがイベントを受信してから数時間以内に書き込まれます。
  • 日次:アンインストールなどのレポートは日次で生成され、翌日に取得できます。
  • バージョン管理対応:同じ期間のレポートが複数回生成される場合に、バージョンを管理します。 

Data Lockerで取得できるレポート

Data Lockerのレポート設定

Data Lockerを設定するには、以下の手順でクラウドサービスに接続し、出力設定とレポートの内容を指定します。

1. クラウドサービスの設定

Data Lockerは、1つ以上のクラウドサービスに接続できます。 Data Lockerで使用するための設定手順は、以下を参照してください。

注意 Data Lockerを契約せずにコホート分析やSKANのデータを取得する場合も、マーケター所有のクラウドストレージの設定手順を完了する必要があります。

 

2. クラウドサービスへの接続の追加

クラウドサービスのアカウントをData Lockerで使用できるよう設定したら(上記の「クラウドサービスの設定」を参照)、そのアカウントの認証情報でData Lockerに接続を作成します。接続は最大2つまで作成できます。

注意

デフォルトでは、アカウントごとにData Lockerの接続を最大2つ作成できます。さらに接続が必要な場合は、担当のカスタマーサクセスマネージャー(CSM)にお問い合わせください。

クラウドサービスへの接続を作成するには、以下の手順を実行します。

  1. AppsFlyerのサイドメニューから、出力 > Data Lockerに移動します。
  2. 右側にあるNew connectionをクリックします。
  3. Connection nameに接続名を入力します。半角英小文字、数字、ハイフンのみを使用してください。
  4. 接続するクラウドサービスのアイコンをクリックします。
  5. 選択したサービスに応じて、以下の接続情報を入力します。

    AWSクラウドバケットへの接続

    AWSの接続を設定する前に、AWSバケットを作成します。手順はこちらを参照してください。

    接続の設定手順:

    1. AWS S3のバケット名を入力します。 af-プレフィックスは必須です。手動で入力してください。
    2. Test connectionをクリックします。
    3. バケットのパスが無効であることを示すエラーメッセージが表示されていないことを確認します。
    4. Make this connection compatible with Adobe Experience Platformを選択するかどうかを指定します。選択した場合は、保存をクリックして、全体に適用するフィルターの選択に進みます。
    5. 保存をクリックします。

    GCSクラウドバケットへの接続

    GCSの接続を設定する前に、GCSでバケットを作成します。手順はこちらを参照してください。

    接続の設定手順:

    1. GCS bucket nameにGCSのバケット名を入力します。
    2. Test connectionをクリックします。
    3. バケットのパスが無効であることを示すエラーメッセージが表示されていないことを確認します。
    4. Make this connection compatible with Adobe Experience Platformを選択するかどうかを指定します。 選択した場合は、保存をクリックして、全体に適用するフィルターの選択に進みます。
    5. 保存をクリックします。

    Azureクラウドバケットへの接続

    Azureの接続を設定する前に、Azureでストレージアカウントを作成します。手順はこちらを参照してください。

    接続の設定手順:

    1. Connection name、Storage account name、Keyを入力します。
    2. バケットのパスが無効であることを示すエラーメッセージが表示されていないことを確認します。
    3. Make this connection compatible with Adobe Experience Platformを選択するかどうかを指定します。 選択した場合は、保存をクリックして、全体に適用するフィルターの選択に進みます。
    4. 保存をクリックします。

    Yandex Cloudバケットへの接続

    AWSの接続を設定する前に、Yandexでサービスアカウントを作成します。手順はこちらを参照してください。

    接続の設定手順:

    1. Bucket name、Access key、Secret keyを入力します。
    2. バケットのパスが無効であることを示すエラーメッセージが表示されていないことを確認します。
    3. Make this connection compatible with Adobe Experience Platformを選択するかどうかを指定します。 選択した場合は、保存をクリックして、全体に適用するフィルターの選択に進みます。
    4. 保存をクリックします。

    BigQueryデータウェアハウスへの接続

    BigQueryの接続を設定する前に、BigQueryでデータセットを作成します。手順はこちらを参照してください。

    接続の設定手順:

    1. BigQueryのプロジェクトIDとデータセット名を入力します。
    2. Test connectionをクリックします。
    3. バケットのパスが無効であることを示すエラーメッセージが表示されていないことを確認します。
    4. 保存をクリックして、全体に適用するフィルターの選択に進みます。

    Snowflakeデータウェアハウスへの接続

    Snowflakeの接続を設定する前に、Snowflakeでアカウントを作成します。手順はこちらを参照してください。

    接続の設定手順:

    1. SnowflakeのリージョンとアカウントIDを入力します。
    2. Test connectionをクリックします。
    3. バケットのパスが無効であることを示すエラーメッセージが表示されていないことを確認します。
    4. 保存をクリックして、全体に適用するフィルターの選択に進みます。
  6. 保存をクリックします。 Report output settingsセクションが表示されます。

注意

接続の作成・更新・削除の有無と変更を行ったユーザーは、監査ログで確認できます。

3. レポート出力の設定

クラウドサービスへの接続を設定したら、Data Lockerのレポート出力の全般設定を行います。クラウドサービスがBigQueryまたはSnowflakeの場合、この手順は省略できます。

  1. Report output settingsセクションで、フォルダー構造(データの分割方法)を選択します。
    • Unified(デフォルト):すべてのアプリのレコードをレポートファイルに含めます。
    • Segregated by app:アプリごとに専用のレポートファイルを作成します。
  2. レポートのファイル形式を、Parquet(デフォルト)またはCSVから選択します。
  3. レポートファイルの圧縮方式を選択します。
    • Snappy(Parquetファイルのみで利用可能)
    • GZIP
  4. ファイルの最大行数を、1万、2万5千、5万、10万、20万、50万から選択します。 行数を多くするとファイル数は減りますが、ファイルサイズは大きくなります。 

    注意

    Expected pathで、レポートのパスのパターンを確認します。注意:実際のパスは、表示と異なる場合があります。

4. 全体に適用するフィルターの選択

全体に適用するフィルターでは、アプリ、地域、メディアソースでレポートを絞り込めます。これらのフィルターは、Data Lockerアカウント内のほとんどのレポートに適用されますが、レポート単位でも設定できます(後述のレポート単位のフィルターの選択を参照)。同じフィルターを両方に設定した場合は、レポート単位のフィルターが優先されます。

フィルターを適用するには、以下の手順を実行します。

  1. レポートセクションでフィルターをクリックし、レポートに含める項目を選択します。 例えば、Untitled.pngAppsフィルターをクリックし、レポートに含めるアプリを選択します。
  2. 次に、Enter(⏎)ボタンをクリックします。

5. レポートグループの選択

クラウドサービスで取得するレポートを選択します。レポートはグループごとに一覧表示されます。レポートグループ名をクリックすると、グループを展開・折りたたみできます。

  • レポートを選択するには、 down.png をクリックしてレポートグループを展開します。グループ内の各レポートについて、以下の情報が表示されます。
    • Report Name:レポートのタイトル。
    • Dataset Name:レポートのレコードが含まれるデータセットの名前。
    • Data Freshness:新しいレコードによるレポートの更新頻度(時間単位、日次、バージョン管理方式など)。
    • Fields:選択可能なフィールドの総数に対して、レポートに選択したフィールド(列)の数。

6. レポートのカスタマイズまたは複製

レポートグループから1つ以上のレポートを選択したら、元のレポートをカスタマイズするか、複製して別のカスタマイズ用コピーを作成できます。これにより、元のバージョンに影響を与えずに、用途に応じたフィールドとフィルターを設定できます。

方法A:元のレポートをカスタマイズ

  1. レポート名の横にあるcustomize.pngCustomizeボタンをクリックします。
  2. レポートエディターが開き、フィールドの選択とフィルターの適用を行えます。
  3. 変更内容は、元のレポートの設定に保存されます。

注意:この操作により、クラウドストレージへのレポートの配信内容が変更されます。

方法B:レポートを複製

  • レポート名の横にあるUntitled 2.pngをクリックします。
  • ドロップダウンメニューからduplicate2.pngDuplicateを選択します。
  • レポートのコピーが作成され、名前の先頭にcopy_of_が付加されます。
  • 複製したレポートは編集モードで開き、さらにカスタマイズできます。

ヒント:用途に応じてレポートのバリエーションを作成する場合は、複製が便利です。

カスタマイズまたは複製を選択したら、次の手順に従ってレポートのフィールドを設定します。

7. レポートのフィールドの選択

レポートをカスタマイズまたは複製した後は、含めるデータフィールドを指定します。各レポートには、利用可能なフィールドがすべて用意されています。分析や連携に必要なフィールドだけを選択できます。デフォルトではすべてのフィールドが選択されていますが、手動で必要なフィールドに絞り込めます。

レポートに含めるフィールドを選択するには:

  1. 選択したレポートのダイアログで、Fieldsタブの各フィールドにカーソルを合わせると、説明を確認できます。

    HQ1_2024-08-26_15.44.23.png

  2. 含めるフィールドにチェックを入れ、除外するフィールドのチェックを外します。
  3. 適用をクリックして、設定を保存します。

別のレポートからのフィールド選択のコピー

別のレポートのフィールド選択をコピーし、それを基にフィールドを選択・解除して調整できます。

  1. Fieldsタブで、任意のフィールドの選択を解除します。
  2. Pull schema from reportをクリックします。
  3. フィールド選択のコピー元のレポートを選択します。
  4. 引き続き、フィールドの選択・解除を行います。
  5. レポートの元のフィールド選択に戻すには、Untitled 4.pngRefreshをクリックします。

8. レポート単位のフィルターの選択

レポート単位のフィルターでは、アプリ、メディアソース、その他の項目で、個々のレポートを絞り込めます。アカウント内のすべてのレポートに適用するフィルターも設定できます。全体に適用するフィルターの選択を参照してください。レポート単位のフィルターは、デフォルトでは全体のフィルター設定に従いますが、選択したレポートにのみ適用する個別の設定に変更できます。

特定のレポートに適用するフィルターを選択するには:

  1. カスタマイズするレポートにカーソルを合わせます。
  2. Untitled 2.pngをクリックして操作メニューを開き、Untitled 3.pngEdit reportを選択します。
  3. Filtersタブを開きます。全体のフィルター設定が反映されています。
  4. フィルターをクリックし、レポートに含める項目を選択します。例えば、Untitled.pngAppsフィルターをクリックし、レポートに含めるアプリを選択します。
  5. Enter(⏎)ボタンをクリックします。選択内容は、全体の設定より優先されます。
  6. (任意)Inappsレポートでは、In-app eventフィルターを設定できます。選択するイベント名を正確に入力します。
  7. 適用をクリックして、設定を保存します。

9. 旧フィールドの削除

旧フィールドとは、以前はレポートのスキーマに含まれていたものの、現在は除外されているフィールドです。レポートに必要な情報だけを含めるため、これらのフィールドの削除を推奨します。変更する前に、既存の処理や連携がそれらのフィールドに依存していないことを確認してください。

特定の旧フィールドを削除するには:

  1. Legacy fieldsタブを開きます。
  2. Include legacy fields in the reportをオンにします。
  3. 除外するフィールドの選択を解除します。
  4. 適用をクリックします。
  5. 接続設定を保存します。

すべての旧フィールドを削除するには:

  1. 旧フィールドのタブを開きます。
  2. Include legacy fields in the reportをオフにします。

注意

旧フィールドを含めたいのに、一覧がグレーアウトしてロックされている場合は、担当のカスタマーサクセスマネージャーにお問い合わせください。

値が入っている旧フィールド

旧フィールドのほとんどは、空欄またはnullです。ただし、一部には値が入っていても、以下のいずれかの理由で旧フィールドとして扱われるものがあります。

  • 名前が変更され、別の名前でレポートに含まれている。
  • 廃止され、レポートのスキーマから除外されている。

値が入っている旧フィールドの一覧をダウンロード(CSV)。 

10. 接続の保存

保存をクリックすると、3時間以内にクラウドサービスへ初回のデータが書き込まれます。その後のデータ更新スケジュールは、レポートによって異なります。

 

重要

Data Lockerの設定変更が反映されるまで、最大3時間かかります。

ユーザー権限の設定

適切な権限を持つ管理者とチームメンバーの両方が、Data Lockerにアクセスできます。

  • 管理者は、Data Lockerページへのアクセス、すべての接続の作成・管理、編集者の追加、既存の接続の所有者の割り当てを行えます。
  • チームメンバーは、Data Lockerページにアクセスし、自分が所有する既存の接続を編集したり、新しい接続を作成したりできます。アカウント所有者であっても、所有者や編集者の設定といった所有権の管理はできません。

Data Lockerへのアクセスと所有権の管理(管理者)

Data Lockerへのアクセス権限の付与

  • チームメンバーにData Lockerへのアクセス権限を付与するには、Data LockerがManageに設定されたロールを割り当てます。

所有者と編集者の管理

既存の接続の所有権を移譲するか、チームメンバーを編集者として追加するには:

  1. 接続内の3点メニュー3 dots icon.pngをクリックします。
  2. Manage ownershipを選択します。
  3. 接続の所有者を変更するか、編集者を追加します。

所有者変更後のフィルターの確認

Data Lockerの接続の所有者を、データアクセスに制限のあるユーザー(アプリ、メディアソース、代理店、国などの制限)に変更すると、既存の全体のフィルターまたはレポート単位のフィルターが、新しい所有者の権限に合わせてリセットされる場合があります。

所有権を移譲した後は、フィルターを確認し、接続のデータ範囲が意図したとおりになっていることを確認してください。

データアクセスの制限については、ユーザー管理 > データアクセスを参照してください。

注意

AF AWSの接続には、管理者であってもManage ownershipの選択肢がありません。AF AWSの接続を編集、削除、新規作成できるのは管理者のみであるためです。これは、バケットの認証情報の漏えいを防ぐための措置です。

 

データの保存構造

概要

保存先がクラウドストレージかデータウェアハウスかによって、データの構造が異なります。ここで説明するフォルダー構造は、ストレージ(バケット)に適用されます。データウェアハウスでは、フォルダーへの言及はビューを指すものとしてお読みください。 

データは、選択したストレージに書き込まれます。クラウドストレージの場合、AWS上のAppsFlyer所有のストレージ、またはAWS、GCS、Yandex上の自社所有のストレージを使用します。保存先はいつでも変更でき、すべて、または一部のデータを複数の保存先に送信することもできます。 

クラウドバケット内のデータは、レポートの種類、日付、時刻に基づく階層的なフォルダー構造で整理されます。以下の図に、この構造の例を示します。

DLFolderOVerview.png

各レポートのデータは、そのレポートに対応する時間別のhフォルダーに格納されます。

  • 時間別フォルダーの数は、レポートの更新・反映方式(時間単位、日次、バージョン管理方式)によって異なります。
  • データは、ParquetまたはCSV形式のファイルで提供され、Snappy圧縮、GZIP圧縮、非圧縮のいずれかとなります。
  • データファイルは、列(フィールド)で構成されます。
  • ユーザージャーニーレポートのスキーマ(フィールド構成)は共通で、選択したフィールドによって決まります。その他のレポートにはそれぞれ固有のフィールドがあり、スキーマレスレポートとも呼ばれます。利用可能なレポートと各レポートの仕様へのリンクは、Data Lockerのマーケター向けレポートを参照してください。 

フォルダー構造

フォルダー 説明 
サブスクリプションID

DataLockerFolders.png

  • バケットの最上位フォルダーは、ストレージの所有者とクラウドサービスによって異なります。通常はサブスクリプションIDですが、Cyberduckなどを使用する場合は、IDがブックマークに設定され、フォルダー構造に表示されないことがあります。
  • data-locker-hourlyフォルダーに、レポートのトピックが格納されます。この階層より上のフォルダーは、バケットの所有者とクラウドサービスによって異なります。

 バケットの所有者とクラウドサービス別のフォルダー構造の例

  • AppsFlyerのバケット:<af-ext-reports>/<unique_identifier>/<data-locker-hourly>
  • 自社のAWSバケット:<af-datalocker-your bucket prefix>/<generated-home-folder><subscription-id>
  • 自社のGCSバケット:<your bucket name>/<generated-home-folder>/<subscription-id>
トピック(t) レポートの対象に応じた種類。 
日付(dt) 対象データの日付。ローデータでは、イベントが発生した日付を意味します。集計データでは、レポートの対象日を意味します。 
時刻(hまたはversion)

日付フォルダーは、レポートの種類に応じて時間別(h)またはversionフォルダーに分かれます。 

時間別フォルダー

hフォルダーは、AppsFlyerがデータを受信した時刻に対応します。例えば、14:00~15:00 UTCに受信したインストールイベントは、h=14のファイルに書き込まれます。注意 AppsFlyerがデータを受信してからData Lockerにhフォルダーが書き込まれるまで、約1~3時間の遅延があります。例えば、h=14フォルダーは1時間後の15:00 UTCに書き込まれます。 

時間別フォルダーの特徴:

  • 0~23の番号が付いた、24個のhフォルダーがあります。例えば、h=0、h=1などです。
  • 遅延データ用のh=lateフォルダーには、午前0時を過ぎて到着した前日のイベントが含まれます。翌日の00:00~02:00 UTCに到着したイベントが対象です。例えば、月曜日の08:00 UTCにアプリがインストールされ、そのイベントが火曜日の01:00 UTCに到着した場合、月曜日のlateフォルダーに書き込まれます。
  • 02:00 UTCを過ぎて到着したデータは、実際の到着日時に対応するフォルダーに書き込まれます。
  • h=lateフォルダーのデータも、必ず取り込んでください。このデータは、他のフォルダーには含まれません。
  • _temporaryフォルダー:hフォルダー内に、一時フォルダーが生成される場合があります。一時フォルダーとそのサブフォルダーは無視してください。例:/t=impressions/dt=2021-04-11/h=18/_temporary。

日次レポート

  • 日次更新のローデータレポートは、h=23フォルダーに保存されます。アンインストールレポートは通常h=2フォルダーに入りますが、他のフォルダーに入る場合もあります。
  • コホートとIncrementalityのレポートは、dtフォルダー直下に保存されます。
  • バージョン管理対応のレポートには、このセクションで説明する別の規則が適用されます。 

UTC以外のタイムゾーンを使用するアプリの、時間別レポートに関する留意点。

特定の暦日のデータをすべて取得するには、以下のようにアプリのタイムゾーンでの1日に対応するフォルダーを取り込む必要があります。 

  • 東半球のタイムゾーン:特定の暦日のデータをすべて取得するには、UTCの日時に対応するフォルダーを取り込みます。例:アプリのタイムゾーンがUTC+10(オーストラリアのシドニー)の場合。火曜日(シドニー)の時間別データをすべて取得するには、月曜日のh=14~23とlate、火曜日のh=0~13および14~15を取り込みます。火曜日のh=14~15も必要なのは、なぜでしょうか?一部のデータは遅れて到着する場合があります。そのため、h=14~15フォルダーには、遅れて到着したイベントが含まれる可能性があります。アプリのタイムゾーンでの暦日に合うように、UTCのevent_timeを絞り込む必要があります。
  • 西半球のタイムゾーン:特定の暦日のデータをすべて取得するには、UTCの日時に対応するフォルダーを取り込みます。例:アプリのタイムゾーンがUTC-7(ロサンゼルス)の場合。火曜日(ロサンゼルス)の時間別データをすべて取得するには、火曜日のh=7~23とlate、水曜日のh=0~6および7~8を取り込みます。水曜日のh=7~8も必要なのは、なぜでしょうか?一部のデータは遅れて到着する場合があります。そのため、h=7~8フォルダーには、遅れて到着したイベントが含まれる可能性があります。アプリのタイムゾーンでの暦日に合うように、UTCのevent_timeを絞り込む必要があります。

バージョンフォルダー

一部のレポートでは、バージョン管理に対応しています。同じ日付について、更新されたデータが複数回提供されます。遅れて到着するデータや、より正確なデータによって更新が続くことがあるため、同じレポートに複数のバージョンが存在し、最新のものが最も正確です。 

各日付のレポートは、その日付のバージョンフォルダーに格納されます。各バージョンは個別のフォルダーに入り、レポートを一意に識別するエポックタイムスタンプがフォルダー名に使用されます。 

データの取り込み処理では、過去の日付にデータが書き込まれる可能性を考慮する必要があります。例えば、1月14日に1月1日のフォルダーへデータが書き込まれる場合があります。自社所有のバケットを使用する場合は、クラウドサービスの通知を使って取り込み処理を開始することを検討してください(AWS | GCS)。

アプリ別の分割

バケット型のクラウドストレージでは、選択したすべてのアプリを含む統合データファイル、またはアプリごとに分かれたフォルダーでデータが提供されます。以下の表のように、hフォルダー内で分割されます。

分割方法 説明 
[デフォルト]統合

すべてのアプリのデータを、統合されたデータファイルで提供します。取り込み時には、各行のapp_idフィールドでアプリを区別します。

h=2フォルダー内のデータファイルの例

UnifiedByApp.png

データファイルの命名規則はunique_id.gzです。

  • データの取り込み処理では、以下を守ってください。
    • _SUCCESSフラグが設定された後に、データを取り込む。
    • フォルダー内の.gz拡張子を持つすべてのファイルを取り込む。パート番号に基づくロジックで取り込み処理を構築しない。 
アプリ別に分割

フォルダー内に、アプリごとのサブフォルダーがあります。各アプリのデータファイルは、そのアプリのフォルダー内に格納されます。以下の図では、h=19フォルダー内にアプリごとのフォルダーがあります。各アプリフォルダーには、そのアプリのデータファイルが入っています。注意データファイルにはapp_idが含まれないため、フォルダーからapp_idを特定する必要があります。 

DLSegregateByApp.png

各アプリフォルダー内の命名規則はunique_id.gzです。 

  • データの取り込み処理では、以下を守ってください。
    • _SUCCESSフラグが設定された後に、データを取り込む。
    • フォルダー内の.gz拡張子を持つすべてのファイルを取り込む。パート番号に基づくロジックで取り込み処理を構築しない。 

制限事項:この方法は、ユーザーベースのアトリビューションのレポートでは利用できません。

データファイル

データファイルの構成は、分割方法によって異なります。

内容 詳細
完了フラグ

特定のhフォルダーへのデータの書き込みがすべて完了すると、最終ファイル(完了)フラグが設定されます。 

  • _SUCCESSフラグの存在を確認するまで、フォルダー内のデータを読み込まないでください。
  • 書き込むデータがなく、フォルダーが空の場合も、_SUCCESSフラグは設定されます。
  • 注意アプリ別に分割する場合、フラグは個々のアプリフォルダーではなく、hフォルダーに設定されます。前のセクションの図を参照してください。 
ファイルの種類
  • データは、ParquetまたはCSV形式のファイルで提供され、Snappy圧縮、GZIP圧縮、非圧縮のいずれかとなります。
  • 解凍後のデータファイルは、設定に応じてParquetまたはCSV形式になります。
列の順序(CSVファイル) 

CSVファイルでは、レポート内のフィールドの順序は常に同じです。新しいフィールドは、既存のフィールドの右側に追加されます。 

関連する留意点: 

  • ユーザージャーニーレポートの列構成は共通です。そのため、異なる種類のレポートにも同様のデータ取り込み処理を使用できます。レポートに含めるフィールドは選択できます。各フィールドの意味は、ローデータのフィールド一覧に記載されています。
  • レポートの提供状況のセクションでFFと記載されたレポートは、共通の列構成には従いません。 
フィールドへの値の入力に関する留意点

空欄または空のフィールド:一部のフィールドはnullまたは空欄になります。そのレポートの文脈では、表示するデータがないことを意味します。通常、nullは、レポートとアプリの種類に照らして、そのフィールドに値が入力されないことを意味します。空欄「""」は、その文脈で該当するフィールドではあるものの、入力するデータが見つからなかったことを意味します。 

メディアソースがrestrictedの場合、制限対象のフィールドはnullになります。 

全体として、nullと空欄は、どちらも利用できるデータがないという意味で同じように扱ってください。 

タイムゾーンと通貨

アプリ固有のタイムゾーンと通貨の設定は、Data Lockerに書き込まれるデータには影響しません。以下が適用されます。 

  • タイムゾーン:日付と時刻はUTCです。
  • 通貨:event_revenue_usdフィールドはUSDです。

カンマを含む値:カンマを含む値は、`"iPhone6,1"`のように二重引用符`"`で囲まれます。

ストレージの選択肢

注意

マーケター所有のストレージを使用する場合: 

  • GDPRなどのデータプライバシー規制、およびアドネットワーク / SRNのデータ保持ポリシーに準拠していることを確認してください。
  • マーケター所有のストレージを使用して、第三者にデータを送信しないでください。 
  • データは、以下のいずれかの所有者のストレージに書き込まれます。
    • AppsFlyerのストレージ
    • 顧客のストレージ(AWS、GCS、Azure、Yandex、BigQuery、Snowflake)
  • ストレージの選択は、いつでも変更できます。
  • ストレージを変更すると、以下の処理が行われます。
    • 1時間以内に、新たに選択したストレージへの書き込みが開始されます。
    • 7日間の移行期間中は、既存のストレージへの書き込みも継続します。移行期間の終了時刻は、管理画面に表示されます。移行期間中に、データの取り込み処理を更新してください。必要に応じて、移行期間を再開したり、AppsFlyerのバケットに戻したりできます。
    • ストレージの変更:複数ストレージの機能で複数の送信先に同時配信することで、ストレージ間の移行を行えます。移行とテストが完了したら、不要になった保存先を削除します。 
  AppsFlyer所有のストレージ(AWS)  マーケター所有のストレージ(GCS、AWS、Azure、Yandex、BigQuery、Snowflake)
バケット名 AppsFlyerが設定
  • GCS:制限なし
  • AWS:自社で設定。先頭にaf-が必要です。

例:af-datalocker-your-bucket-name

ストレージの所有者 AppsFlyer マーケター
ストレージのプラットフォーム AWS AWS、GCS、Azure、Yandex、BigQuery、Snowflake
データにアクセスするための認証情報 AppsFlyerアカウントの管理者が、Data Lockerの管理画面で確認可能 AppsFlyerは保持しません。クラウドサービスから提供された認証情報を使用してください。
データ保持期間 14日後にデータを削除 マーケターの責任
データ削除要求への対応 AppsFlyerの責任 マーケターの責任
セキュリティ AppsFlyerがストレージを管理します。顧客は読み取り権限を持ちます。

マーケターがストレージを管理します。

  • AWS:AppsFlyerには、バケットのGetObject、ListBucket、DeleteObject、PutObject権限が必要です。バケットはAppsFlyer専用にしてください。他の用途には使用しないでください。
  • GCS:GCSの設定記事を参照してください。
ストレージ容量 AppsFlyerが管理 マーケターが管理
バケットポリシーによるVPCエンドポイントのアクセス制御 該当なし [任意]AWSでバケット単位のVPCエンドポイントセキュリティを設定する場合は、AppsFlyerのサーバーを許可リストに追加する必要があります。 

顧客が管理するストレージについての、セキュリティ担当者向けの説明

留意点:

  • バケットまたは送信先は、AppsFlyer専用です。同じ送信先に、他のサービスなどからデータを書き込まないでください。
  • データは、AppsFlyerによる書き込みから25時間後に、送信先から削除できます。
  • 送信先に書き込まれるデータは、AppsFlyerのサーバーにすでに存在するデータのコピーです。元のデータは、AppsFlyerの保持ポリシーに従ってサーバーに保持されます。
  • 技術的な理由で、データを削除して再度書き込む場合があります。そのため、削除権限と一覧表示権限が必要です。どちらの権限も、お客様にとってセキュリティ上のリスクとはなりません。一覧表示については、このバケットに書き込むのはAppsFlyerのみです。削除については、AppsFlyerでデータを再生成できます。
  • 詳しくは、hello@appsflyer.comからセキュリティチーム、または担当のCSMにお問い合わせください。  

複数接続(複数の送信先)の基本的な仕組み

Data Lockerでは、すべて、または一部のデータを2つの送信先(接続設定で指定)に送信できます。例えば、アプリAのデータをAWSに、アプリBのデータをGCSに送信できます。

各接続は、送信先を含むData Locker設定一式で構成されます。各接続の設定は、互いに独立しています。

接続の管理に関する留意点:

  • Data Lockerの設定では、接続はタブで表示されます。各接続には専用の設定タブがあり、そこから接続を管理できます。各タブのアイコンは、ストレージの種類を表します。
  • 接続の詳細の表示、複製、削除を行うには、⋮(オプション)をクリックします。

補足情報

監査ログでの接続変更の確認

Data Lockerの接続変更は、AppsFlyer管理画面のセキュリティセンターにある監査ログで確認できます。変更の有無、変更日時、変更を行ったユーザーを確認できます。データの欠落や意図しない接続変更などを、サポートに問い合わせずに調査・解決する際に役立ちます。

以下の接続のライフサイクルイベントが記録されます。

  • 新しい接続の作成
  • 接続の更新
  • 接続の無効化
  • 接続の削除

監査ログにアクセスするには:

  1. 上部のナビゲーションバーで、HQ1 2025-05-05 10.48.04.pngアカウントメニューを開きます。
  2. セキュリティセンターを選択します。
  3. 監査ログセクションで、View audit logをクリックします。
  4. ServiceをDatalockerで絞り込み、関連する記録を表示します。

詳しくは、監査ログを参照してください。 

特徴と制限事項

項目 備考 
アドネットワーク アドネットワークは利用できません。
代理店 代理店は利用できません。
アプリ固有のタイムゾーン 該当なし。 Data Lockerのフォルダーは、UTCで時間ごとに分かれます。実際のイベント時刻もUTCです。必要に応じて、他のタイムゾーンに変換してください。アプリのタイムゾーンにかかわらず、イベントの発生からData Lockerに記録されるまでの遅延は同じです。
アプリ固有の通貨  非対応
サイズ制限 該当なし
データの更新頻度・反映時間 データは、こちらの記事に記載されている各レポートの更新・反映タイミングに従って更新されます。 
過去のデータ 非対応。過去のデータが必要な場合、一部のレポートはPull APIで取得できますが、すべてではありません。
制限されるデータ プライバシー上の制限により、一部のレポートではフィールドの取得が制限されます。詳細
ユーザーアクセス Data Lockerを設定できるのは、必要な権限を持つアカウントユーザーのみです。 
単一アプリ / 複数アプリ 複数アプリに対応。 Data Lockerはアカウント単位の機能です。
接続数の上限 デフォルトでは、アカウントごとにData Lockerの接続を最大2つ作成できます。追加の接続が必要な場合は、担当のCSMにお問い合わせください。

トラブルシューティング

  • 症状:AWS CLIでデータを取得できない。
  • エラーメッセージ:An error occurred (AccessDenied) when calling the ListObjectsV2 operation: Access Denied
  • 原因:使用しているAWSの認証情報が、AppsFlyerのバケット用のものではありません。コンピューターに複数の認証情報や無効な認証情報がある場合に、この問題が発生することがあります。
  • 対処方法:
    1. CLI以外の方法(Cyberduckなど)で、バケットにアクセスしてください。使用している認証情報で接続できるかを確認するための操作です。 Cyberduckで接続できる場合は、認証情報のキャッシュに問題があることを示します。
    2. AWSの認証情報のキャッシュを更新してください。
      AWSのスクリーンショット mceclip0.png

AWSのデータ取得

任意のAWSデータ取得ツール、AWS CLI、または以下のセクションで説明するツールを使用してください。注意以下の具体的な手順は、AppsFlyer所有のバケット向けです。自社のバケットに接続する場合は、必要に応じて手順を調整してください。 

AWS CLI

始める前に:

  • コンピューターにAWS CLIをインストールします。
  • AppsFlyerでData Lockerに移動し、認証情報パネルの情報を確認します。

AWS CLIの使用手順:

  1. ターミナルを開きます。 Windowsでは、<Windows>+<R>を押して、OKをクリックします。
    コマンドラインウィンドウが開きます。
  2. aws configureを入力します。
  3. 認証情報パネルに表示されるAWS Access Keyを入力します。
  4. 認証情報パネルに表示されるAWS Secret Keyを入力します。
  5. eu-west-1を入力します。
  6. Enterを押します(None)。

必要に応じて、以下のCLIコマンドを使用してください。

以下のコマンドの{home-folder}の値は、次の場所で確認できます。

バケット内のフォルダーを一覧表示するには:

aws s3 ls s3://af-ext-reports/{home-folder}/data-locker-hourly/

ファイルとフォルダーの一覧表示

Data Lockerのバケットには、3種類のフォルダーがあります。

  • レポートの種類:t=
  • 日付:dt=
  • 時間:h=

特定の種類のレポートをすべて一覧表示するには:

aws s3 ls s3://af-ext-reports/{home-folder}/data-locker-hourly/t=installs/

特定の日付の、特定の種類のレポートをすべて一覧表示するには:

aws s3 ls s3://af-ext-reports/{home-folder}/data-locker-hourly/t=installs/dt=2019-01-17

特定の日付・時間の、特定のレポートをすべて一覧表示するには:

aws s3 ls s3://af-ext-reports/{home-folder}/data-locker-hourly/t=installs/dt=2019-01-17/h=23

特定の日付のファイルをダウンロードするには:


aws s3 cp s3://af-ext-reports/<home-folder>/data-locker-hourly/t=installs/dt=2020-08-01/h=9/part-00000.gz ~/Downloads/

Cyberduck

始める前に:

  • Cyberduckクライアントをインストールします。
  • AppsFlyerでData Lockerに移動し、認証情報パネルの情報を確認します。

Cyberduckの設定手順:

  1. CyberduckでActionをクリックします。
  2. New Bookmarkを選択します。ウィンドウが開きます。
  3. 最初のフィールド(以下のスクリーンショットの[1])で、Amazon S3を選択します。 DataDuckSmall2.png
  4. 各フィールドに、以下の内容を入力します。
    • Nickname:任意のテキスト
    • Server:s3.amazonaws.com
    • Access Key ID:AppsFlyerの認証情報パネルに表示されるAWS Access Keyをコピーします。
    • Secret Access Key:AppsFlyerの認証情報パネルに表示されるバケットのシークレットキーをコピーします。
    • Path:{Bucket Name}/{Home Folder}。例:af-ext-reports/1234-abc-ffffffff
  5. ウィンドウを閉じます。右上のXをクリックしてください。
  6. 接続を選択します。
    データディレクトリが表示されます。

Amazon S3 Browser

始める前に:

  • Amazon S3 Browserをインストールします。
  • AppsFlyerでData Lockerに移動し、認証情報パネルの情報を確認します。

Amazon S3 Browserの設定手順:

  1. S3 Browserで、Accounts > Add New Accountをクリックします。
    Add New Accountウィンドウが開きます。 mceclip0.png
  2. 各フィールドに、以下の内容を入力します。
    • Account Name:任意のテキスト。
    • Access Key ID:認証情報パネルに表示されるAWS Access Keyをコピーします。
    • Secret Access Key:認証情報パネルに表示されるバケットのシークレットキーをコピーします。
    • Encrypt Access Keysを選択し、パスワードを入力します。このパスワードを控えておいてください。
    • Use secure transferを選択します。
  3. Save changesをクリックします。
  4. Buckets > Add External Bucketをクリックします。
    Add External Bucketウィンドウが開きます。
    mceclip2.png
  5. Bucket nameを入力します。バケット名の形式は{Bucket Name}/{Home Folder}です。バケット名とホームフォルダーに必要な値は、認証情報ウィンドウに表示されています。
  6. Add External bucketをクリックします。バケットが作成され、ウィンドウの左側のパネルに表示されます。
    これでData Lockerのファイルにアクセスできます。