How can we help?

Data Locker — マーケティング担当者向け プレミアム機能

  • 更新

概要:Data Lockerを使用することで、レポートデータをクラウドストレージに送信し、自社の分析基盤(BIシステム)に読み込むことができます。AppsFlyerでは、多様なデータ保存先を提供しています:AppsFlyerが所有するAWS S3バケット、または広告主保有のAWS、GCS、Yandex、BigQuery、Snowflakeのお客様が所有するストレージ。なお、Data Lockerは、複数の接続をサポートしています。つまり、すべてのデータを複数の宛先に送信したり、宛先ごとにデータを分離したり、またはその両方の組み合わせを行ったりすることができます。

概要

6133DataLockerForAdvertisers.png

Data Locker設定画面で、クラウドストレージに格納するAppsFlyerから配信するデータに含めたいアプリ、メディアソース、イベント、レポートを柔軟に選択することができます。その後、ストレージから自社システムへプログラムで読み込ませる形で自社データなどと連携します。 

Data Locker—機能

機能 説明
ストレージオプション(クラウド)

Data Lockerは、次のクラウドサービスプロバイダーへデータを送信できます:

Data Lockerでは複数のストレージを設定できます。つまり、全てまたは一部のデータを複数のストレージに送信することができます。

  • レポートタイプ別にデータを分割:ローデータをGCSへ、集約データをSnowflakeへ送信できます。
  • アプリごとにデータを分離:アプリグループごとにデータを異なるバケットに送信できます。 
複数アプリ   アカウント内の1つ、複数、または全てのアプリのデータを送信連携します。アカウントにアプリを追加したときに、それらを自動的に含めることができます。 
利用可能なデータ期間 14日間
データの分離 利用可能なデータ分離オプション(バケットクラウドストレージに関連):
  • [デフォルト] 統合:すべてのアプリを合わせたデータ。データファイル内のアプリを特定するために、行レベルでアプリID項目が使用されます。
  • アプリごとに分離:各アプリのデータは別々のフォルダに格納されます。フォルダ名はアプリIDで構成されます。 
データ形式のオプション
  • バケットクラウドストレージの場合:
  • データウェアハウス
データ更新頻度 更新頻度はレポートタイプによって異なります。 
  • 毎時:データは継続的に生成されます。例えば、インストールとアプリ内イベントデータは、イベントがAppsFlyerに到着してから数時間以内に書き込まれます。
  • 毎日:アンインストールなどのレポートは毎日生成され、翌日に利用できます。
  • バージョン管理済み: 同じレポートが同じ期間に複数回生成される場合、バージョン管理の仕組みが適用されます。 

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

Data Lockerのレポート設定

データロッカーを設定するには、クラウドサービスに接続し、エクスポート設定を定義し、レポート内容をカスタマイズするために、次の手順に従ってください:

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

1つ以上のクラウドサービスプロバイダーに接続できます。Data Lockerと連携するための設定方法については、以下を参照してください:

注意!Data Lockerのご契約がなく、コホート分析または SKANデータを取得する場合でも、広告主様が所有するクラウドストレージサービスの手順を完了する必要があります。

 

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

データロッカーで動作するようにクラウドサービスアカウントを設定した後(上記の「クラウドサービスの設定」を参照)、アカウントの資格情報を使用してデータロッカーで接続を作成します。最大2つの接続を作成できます。

クラウドプロバイダーとの接続を作成するには、次の手順を実行してください:

  1. AppsFlyer管理画面 左メニュー エクスポート > Data Lockerへ進みます。
  2. 画面右上の、新しい接続をクリックします。
  3. 接続名に接続の名前を入力してください。英字の小文字と数字、ハイフンのみを使用してください。
  4. 接続したいクラウドサービスのアイコンをクリックしてください。
  5. 選択したサービスに応じて、以下の接続情報を入力してください。

    AWSクラウドバケット接続

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

    接続を設定するには:

    1. AWS S3バケット名を入力します。プレフィックス af- は必須であり、手動で入力する必要があります。
    2. 接続テストをクリックしてください。
    3. バケットパスが無効であることを示すエラーメッセージなどが表示されないことを確認します。
    4. この接続をAdobe Experience Platformと互換性を持たせるかどうかを選択します。選択した場合は、保存をクリックして、グローバルレベルのフィルターを選択へ続きます。
    5. 保存をクリックします。

    AWSクラウドバケット接続

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

    接続を設定するには:

    1. GCSバケット名を入力します。
    2. 接続テストをクリックしてください。
    3. バケットパスが無効であることを示すエラーメッセージなどが表示されないことを確認します。
    4. この接続をAdobe Experience Platformと互換性を持たせるかどうかを選択します。 選択した場合は、保存をクリックして、グローバルレベルのフィルターを選択へ続きます。
    5. 保存をクリックします。

    Azureクラウドバケット接続

    Azure接続を設定する前に、Azureでストレージアカウントを開いてください。詳細はこちらを参照してください。

    接続を設定するには:

    1. 接続名ストレージアカウント名キーを入力します。
    2. バケットパスが無効であることを示すエラーメッセージなどが表示されないことを確認します。
    3. この接続をAdobe Experience Platformと互換性を持たせるかどうかを選択します。 選択した場合は、保存をクリックして、グローバルレベルのフィルターを選択へ続きます。
    4. 保存をクリックします。

    Yandexクラウドバケット接続

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

    接続を設定するには:

    1. バケット名アクセスキーシークレットキーを入力します。
    2. バケットパスが無効であることを示すエラーメッセージなどが表示されないことを確認します。
    3. この接続をAdobe Experience Platformと互換性を持たせるかどうかを選択します。 選択した場合は、保存をクリックして、グローバルレベルのフィルターを選択へ続きます。
    4. 保存をクリックします。

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

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

    接続を設定するには:

    1. BigQuery プロジェクト ID とデータセット名を入力します。
    2. 接続テストをクリックしてください。
    3. バケットパスが無効であることを示すエラーメッセージなどが表示されないことを確認します。
    4. 選択した場合は、保存をクリックして、グローバルレベルのフィルターを選択へ続きます。

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

    Snowflake接続を設定する前に、Snowflakeでアカウントを開設してください。詳細はこちらを参照してください。

    接続を設定するには:

    1. Snowflake地域とアカウントIDを入力します。
    2. 接続テストをクリックしてください。
    3. バケットパスが無効であることを示すエラーメッセージなどが表示されないことを確認します。
    4. 選択した場合は、保存をクリックして、グローバルレベルのフィルターを選択へ続きます。
  6. 保存をクリックします。レポート出力設定セクションが表示されます。

注記

接続が作成、更新、または削除されたかどうか、そして誰が変更を行ったかを確認するには、監査ログを使用できます。

3. レポート出力の設定

クラウドサービスとの接続を設定した後、データロッカーのレポート出力の一般設定を続けることができます。クラウドサービスがBigQueryまたはSnowflakeである場合、このステップはスキップします

  1. レポート出力設定 セクションで、フォルダ構造 (データ分離) を選択します。
    • 統一(デフォルト):レポートファイルには、すべてのアプリからの記録が含まれています。
    • アプリごとに分離:各レポートファイルは1つのアプリの専用ファイルです。
  2. レポートのファイル形式を選択します:パーケット(デフォルト)またはCSV。
  3. レポートのファイル圧縮タイプを選択してください:
    • Snappy(Parquetファイルでのみ使用可能)
    • GZIP
  4. ファイルに希望する最大行数を選択してください:1万、2万5千、5万、10万、20万、50万のいずれか。 ファイル内の行数が多いほど、ファイルは少なくなりますが、各ファイルサイズは大きくなります。 

    注記

    期待されるパスの下で、レポートのパスパターンを表示します。注記:表示されているものとは異なる実際のパスがあるかもしれません。

4. グローバルレベルのフィルターを選択

グローバルレベルのフィルターを使用すると、アプリやメディアソースでレポートをフィルターできます。これらのフィルターは、あなたのデータロッカーアカウント内のほとんどのレポートに適用されますが、レポートレベルでも設定できます(下記 7. レポートレベルのフィルター選択を参照してください)。両方のレベルに同じフィルターが適用される場合、レポートレベルのフィルターが優先されます。

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

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

5. レポートの選択

クラウドサービスで取得したいレポートを選択してください。レポートはグループごとにリストされています。レポートグループ名をクリックすると、グループが展開または折りたたまれます。

  • レポートを選択するには、down.pngをクリックしてレポートグループを展開します。グループ内の各レポートには、以下の情報が提示されます:
  •  
    • Report Name:レポートのタイトル
    • Dataset Name:レポートの記録を含むデータセットの名前。
    • Data Freshness:レポートが新しいレコードでどのくらいの頻度で更新されるか(例:毎時、毎日、またはバージョン管理)。
    • Fields: レポートのために選択したフィールド(または列)の数と、選択可能なフィールドの総数を比較します。

6. レポート項目の選択

各レポートは、含めたいフィールドのみを選択できる完全なフィールドセットを提供しています。デフォルトでは、すべてのレポートフィールドが選択されています。

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

  1. 特定のレポートをカスタマイズしたい場合は、レポート選択の上にカーソルを合わせます。
  2. アクションメニューを開くには、Untitled 2.png をクリックし、Untitled 3.png レポートの編集 を選択します。
  3. 選択したレポートダイアログのフィールドタブの下で、任意のフィールドにカーソルを合わせると、その説明が表示されます。HQ1_2024-08-26_15.44.23.png
  4. レポートに含めたいフィールドをチェックするか、レポートから除外したいフィールドのチェックを外してください。
  5. 適用をクリックして設定を保存します。

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

他のレポートからフィールドの選択をコピーして出発点とし、その後、レポートを微調整するためにフィールドを選択または選択解除し続けることができます。

  1. フィールド タブで、任意のランダムフィールドの選択を解除します。
  2. レポートからスキーマを取得クリックします。
  3. フィールド選択をコピーしたいレポートを選択してください。
  4. フィールドの選択または選択解除を続けてください。
  5. レポートの元のフィールド選択を復元するには、 無題 4.png 更新をクリックしてください。

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

レポートレベルのフィルターを使用すると、アプリ、メディアソース、またはその他のディメンションによって単一のレポートをフィルターできます。アカウント内のすべてのレポートに適用されるフィルターを設定することもできます。参照:グローバルレベルのフィルターを選択デフォルトでは、レポートレベルのフィルターはグローバルレベルのフィルター設定に設定されていますが、選択したレポートにのみ適用されるカスタム設定に更新することができます。

指定されたレポートに適用するフィルターを選択するには:

  1. 特定のレポートにカーソルを合わせてカスタマイズします。
  2. アクションメニューを開くには、Untitled 2.png をクリックし、Untitled 3.png レポートの編集 を選択します。
  3. フィルタータブを開きます。フィルターはグローバルレベルのフィルター設定に設定されています。
  4. フィルターをクリックして、レポートに含めるアイテムを選択します。例: Untitled.png アプリフィルターをクリックして、レポートに含めるアプリを選択します。
  5. Enter (⏎) ボタンをクリックします。この選択はグローバルレベルの設定を上書きします。
  6. (オプション) アプリ内イベントレポートについては、アプリ内イベントフィルターを設定できます。名前を正確に入力して選択してください。
  7. 適用をクリックして設定を保存します。

8. 未使用フィールドの削除

未使用のフィールドとは、以前はレポートスキーマに含まれていたが、現在は除外されているフィールドのことです。これらのフィールドを削除して、レポートに関連する情報のみが含まれるようにすることをお勧めします。変更を加える前に、ワークフローや統合がそれに依存していないことを確認してください。

特定の未使用フィールドを削除する

  1. 未使用フィールドタブを開きます。
  2. オンに設定する:レポートに未使用のフィールドを含める
  3. 除外したいフィールドの選択を解除します。
  4. 適用をクリックしてください。
  5. 接続設定を保存します。

すべての未使用フィールドを削除する:

  1. 未使用フィールドタブを開きます。
  2. オフに設定する:レポートに未使用のフィールドを含める

注記

未使用のフィールドをレポートに含めたいが、未使用フィールドのリストがグレーアウトしてロックされているためできない場合は、カスタマーサクセスマネージャーにお問い合わせください。

空でない未使用フィールド

ほとんどの未使用のフィールドは空であるか、nullです。しかし、それらのいくつかは値を含んでいますが、次の理由から未使用と見なされます:

  • 別の名前(改名された)でレポートに表示されます。
  • レポートスキーマから除外(非推奨)されました。

ダウンロード:空でない未使用フィールドのリスト(CSV)

9. 接続の保存

保存をクリックすると、最初のダンプデータが3時間以内に接続されたクラウドサービスに書き込まれます。次のデータ更新スケジュールは、各レポートに特有のものです。

 

重要!

Data Locker設定への変更が有効になるには、最大3時間かかります。

ユーザー権限

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

管理者

管理者はData Lockerページへのアクセス、すべての接続の作成と管理、編集者の追加、既存の接続への所有者の割り当てを行うことができます。

チームメンバー

チームメンバーは、Data Lockerページへのアクセス、所有する既存の接続の編集、新規接続の作成を行うことができます。

権限の付与

  • チームメンバーにData Lockerへのアクセス権を付与するには、管理に設定されたData Locker役割を割り当てます。
  • 既存の接続で所有権を譲渡したり、チームメンバーを編集者として追加するには、既存の接続内の3ドットオプションメニュー 3 dots icon.png をクリックし、所有権の管理から接続の所有者の変更や編集者の追加を行います。

データストレージのアーキテクチャ

概要

ストレージ内のデータ構造は、データが送信されるクラウドストレージまたはデータウェアハウスによって異なります。ここで説明するフォルダの構成は、ストレージ(バケット)に適用されるものです。データウェアハウスストレージの場合は、フォルダーへの参照がビューに適用されることを考慮してください。 

各種データは、選択したストレージオプションに書き込まれます。クラウドストレージの場合、ストレージはAppsFlyerが所有しているAWSか、お客様が保有しているAWS、GCS、またはYandexのいずれかもしくは複数を選択できます。ストレージオプションはいつでも切り替えたり、データの一部またはすべてを複数のストレージオプションに送信したりできます。 

クラウドバケットストレージ内のデータは、レポートタイプ、日付、時刻に従って階層フォルダ構造に編成されます。次の図は、この構造の例を示しています:

DLFolderOVerview.png

特定のレポートのデータは、そのレポートに紐付けられた時間 (h) フォルダに格納されます。

  • 時間フォルダの数は、レポートデータの更新頻度(毎時、毎日、またはバージョン別)によって異なります。
  • データは、Snappy または GZIP圧縮ファイル、もしくはParquet 形式またはCSV形式の非圧縮ファイルで提供されます。
  • データファイルは列(項目)で構成されています。
  • ユーザージャーニーレポートのスキーマ(フィールド)構造は互いに同一であり、選択した項目によって異なります。その他のレポートは、それぞれ独自の明示的な項目を持つ、別名スキーマレスレポートです。利用できるレポートとレポートの仕様へのリンクについては、マーケター向けのData Lockerレポートを参照してください。 

フォルダの構成

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

DataLockerFolders.png

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

 バケット所有者とクラウドプロバイダーに基づくフォルダの構成の例

  • AppsFlyer保有のAWS S3バケット: <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>
Topic (t) レポートタイプはレポートの主題に関連します。 
Date (dt) これはデータの日付に関連します。ローデータの場合、これはイベントが発生した日を意味します。集計データの場合、レポート日が入ります。 
Time (h or version)

日付フォルダは、レポートの種類によって、hourly (h) または version フォルダに分かれています。 

Hourly(時間別)フォルダ

h フォルダは、AppsFlyerがデータを受信した時刻に関連します。例えば、インストールイベントを 14:00-15:00 UTC に受信した場合、h=14 ファイルに書き込まれます。注!AppsFlyerにデータが到着してから、h フォルダがData Lockerに書き込まれるまで、約1-3時間のタイムラグがあります。例えば、h=14 フォルダは1時間後の15:00 UTC に書き込まれます。 

Hourly フォルダの特性

  • 0–23の番号が付いた24のhフォルダがあります。例えば、h=0, h=1などです。 
  • h=late という遅延フォルダには、深夜以降に到着した前日のイベントが含まれています。つまり翌日の 00:00–02:00 UTC に到着したイベントを指します。例えば、ユーザーが月曜の朝 08:00 UTC にアプリをインストールし、イベントが火曜日の深夜 01:00 UTCに到着した場合、このイベントは月曜の遅延フォルダに書き込まれます。
  • UTCの深夜 02:00以降に到着したデータは、実際の到着日時のフォルダに書き込まれます。
  • h=late フォルダ内のデータが取り込まれていることを確認してください。これらのデータは他の h フォルダには含まれていません。
  • _temporary フォルダ場合によっては、hフォルダ内に一時的なフォルダを生成する場合があります。一時フォルダとサブフォルダは無視してください。例: /t=impressions/dt=2021-04-11/h=18/_temporary
  • 注意:
    • h=23フォルダには、毎日更新されるローデータレポートが保存されています。アンインストールレポートは、通常 h=2 フォルダに格納されますが、それ以外のフォルダに入るケースもあります。 
    • コホートとIncrementalityのレポートは、直接 dt フォルダに保存されます。 
    • バージョン管理されたレポートは、このセクションで説明する別の慣例に従い保存されます。

UTCタイムゾーンを使用しないアプリでの毎時レポートに関する検討事項

その日の全てのデータを確実に取得するには、次に説明するとおり、アプリのタイムゾーンで定義された日に合わせてフォルダを消費する必要があります:

  • 東半球のタイムゾーン(日本):指定されたカレンダーの日付のすべてのデータを取得するには、UTC時間と日付に従ってフォルダを消費する必要があります。例:アプリのタイムゾーンがUTC+9(日本時間)の場合、日本時間の火曜に関連する全ての時間ごとのデータを取得するには、以下のフォルダを確認する必要があります:月曜日 h=15–23 と late、火曜日 h=0–14 と h=15-16(なぜ火曜日の h=14-15 を消費する必要があるのか? -火曜日の h=15-16 も確認した方がよい理由は、一部のデータは遅れて到着する場合があるためです。そのため、h=14-15のフォルダには、遅延のあったイベントが含まれることがあります。)そのため、データ取得後にevent_time でフィルタをかけ、UTCでの時間表記を考慮しながら火曜のデータを拾う必要があります。
  • 西半球のタイムゾーン:指定されたカレンダーの日付のすべてのデータを取得するには、UTC時間と日付に従ってフォルダを消費する必要があります。例:アプリのタイムゾーンはUTC- 7(ロサンゼルス)です。ロサンゼルスでの火曜に関連する全ての時間ごとのデータを取得するには、以下のフォルダを確認する必要があります:火曜h=7-23と後半、水曜h=0-6と7-8。(水曜日の h=7-8 も確認した方がよい理由は、火曜日の h=15-16 も確認した方がよい理由は、一部のデータは遅れて到着する場合があるためです。そのため、h=7-8のフォルダには、遅延のあったイベントが含まれることがあります。)そのため、データ取得後にevent_time でフィルタをかけ、UTCでの時間表記を考慮しながら火曜のデータを拾う必要があります。

Versionフォルダ

一部のレポートにはバージョン指定のオプションがあります。つまり、ある日の最新データが複数回提供されます。データは、到着が遅れたり、より正確なデータによって更新され続けることがあるため、同じレポートには複数のバージョンがあり、最新のバージョンが最も正確なものとなります。 

ある日のレポートは、その日のバージョンフォルダーに含まれています。各バージョンは、レポートを一意に識別するEpochタイムスタンプを使用して名前が設定されている別のフォルダに格納されています。 

データのインポート処理では、データが過去にさかのぼって書き込まれる可能性があることを考慮する必要があります。例えば、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拡張子が付いた状態でデータを取り込んでください。パート番号のロジックを使用したインポートプロセスは構築しないでください。 

制限事項:このオプションはPeople-Based Attributionレポートでは利用できません。

データファイル

データファイルはセグメンテーションタイプにより異なります。

コンテンツ 詳細
完了フラグ 最終ファイル(完了)フラグは、対象の h フォルダの全てのデータが書き込まれたあとに設定されます。 
  • _SUCCESS フラグが存在していることを確認してから、h フォルダ内のデータを読み込んでください。
  • _SUCCESS フラグは、特定のフォルダに書き込むデータがなく、フォルダが空である場合にも設定されます。
  • 注!アプリごとの分離オプションでは、フラグは各アプリフォルダごとではなく、h フォルダ内で設定されます。前のセクションの図を参照してください。 
ファイルの種類
  • データは、Snappy または GZIP圧縮ファイル、もしくはParquet 形式またはCSV形式の非圧縮ファイルで提供されます。
  • 解凍後のデータファイルは、設定に応じてParquetまたはCSV形式で出力されます。
列の並び(CSVファイル) 

CSVファイルの場合、レポート項目の順序は常に同じです。新しい項目が追加される場合は、既存項目の右側に追加されます。 

この点に関して: 

  • ユーザー経路レポートの列の構成は同じです。つまり、異なるレポートタイプに対して同様のデータ読み込み手順を実行できます。レポートに含める項目を選択してください。各項目の詳細・定義:ローデータ項目の手引き
  • レポート可用性セクションで、FFと表示されているレポートは、共通の列構造ではありません。 
項目入力に関する考慮事項

空白または空のフィールド: 一部の項目は null または空白になります。これは、特定のレポートのコンテキストでは、レポートするデータがないことを意味します。通常、null は、特定のレポートおよびアプリタイプのコンテキストでこの項目に値が入力されないことを意味します。空白("")は、この項目がこのコンテキストに関連しているものの、入力するデータが見つからなかったことを意味します。 

制限付きメディアソースの場合、制限された項目の内容は null になります。  

一般的に、nullとブランクは同じものであり、利用可能なデータはありません。  

タイムゾーンと通貨

アプリ固有のタイムゾーンと通貨設定は、Data Locker に書き込まれるデータには影響しません。次のことが当てはまります。 

  • time_zone日付と時間のデータはUTCです。
  • 通貨:event_revenue_usd フィールドは USD です。

カンマで区切られた値:これらのカンマは二重引用符 `"` の間に含まれます。例:`"iPhone6,1"`

ストレージオプション

警告!

広告主所有のストレージオプションを使用する場合: 

  • GDPR等のデータプライバシー規制とアドネットワーク/SRNのデータ保持ポリシーに準拠していることをご確認ください。
  • 広告主所有のストレージソリューションを使用して第三者にデータを送信しないでください。 
  • データは、選択したストレージ所有者に次のように書き込まれます。
    • AppsFlyer所有のAWS S3ストレージ
    • 広告主所有のストレージ — 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専用です。この宛先には他のシステムからのデータを送らないでください。
  • データを書き込まれた後25時間後に、ストレージ内のデータを削除できます。
  • ストレージに書き込まれるデータは、当社のサーバーに既に存在しているデータのコピーです。データは、当社の保持ポリシーに従って引き続き当社のサーバーに格納されます。
  • 技術的な理由により、データを削除したり書き換えたりすることがあります。このため、削除とリストのパーミッションが必要です。どちらのパーミッションも、広告主にとってセキュリティリスクにはなりません。リストの場合、我々はバケットに書き込む唯一の存在です。削除された場合は、データを再生成することができます。
  • 詳細については、hello@appsflyer.com 経由でセキュリティチーム、またはCSMにご連絡ください。  

複数連携の原則(2つ以上の接続先設定)

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

各連携に対して、ディスティネーションを含むData Lockerの設定を全て実行する必要があります。連携設定は互いに独立しています。

連携管理について、以下の点を考慮してください。

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

追加情報

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

データロッカーの接続変更を監査ログで表示できるようになりました。これは、AppsFlyerダッシュボードのセキュリティセンターから利用可能です。変更が行われたかどうか、いつ行われたか、誰が行ったかを確認するには、監査ログを使用してください。これにより、サポートに連絡することなく、データの欠落や予期しない接続の変更などの問題を解決するのに役立ちます。

次の接続ライフサイクルイベントがモニターされます:

  • 新しい接続の作成
  • 既存の接続内容の更新
  • 接続の解除
  • 接続の削除

監査ログへアクセスする方法:

  1. 上部のナビゲーションバーで、アカウントメニュー HQ1 2025-05-05 10.48.04.png を開きます。
  2. セキュリティセンターを選択します。
  3. 監査ログセクションで、監査ログの確認をクリックします。
  4. サービスでフィルター:Datalockerの関連エントリを表示します。

詳細については、以下を参照してください:監査ログ

特徴と制限

特性 備考 
アドネットワーク アドネットワークは使用できません。
代理店 代理店アカウントでは使用できません。
アプリ固有のタイムゾーン 適用されません。Data Lockerフォルダは、UTCを使用して時間に分割されます。実際のイベントは、UTCで時刻が刻まれます。必要に応じて、他のタイムゾーンに時刻を変換します。アプリのタイムゾーンに関係なく、イベント発生からData Lockerに記録されるまでの遅延時間は同じです。
アプリ固有の通貨  サポートされておらず、計測対象外です
サイズ制限 不適用
データ更新頻度 データは、この記事内に記載されている個々のレポートデータの更新頻度に従って更新されます。 
過去データ 対応していません過去のデータが必要な場合、すべてではありませんが、一部のレポートはPull APIを介して利用可能です。
制限付きデータ 一部のレポートの項目は、プライバシーの制限により制限されています。詳細はこちら
ユーザーアクセス Data Lockerを設定できるのは、必要な権限を持つアカウントユーザーのみです。 
単一アプリ / 複数アプリ 複数アプリのサポート。複数のアプリをサポートしています。

トラブルシューティング

  • 症状:AWS CLIを使用してデータを取得できない
  • エラーメッセージ: ListObjectsV2 オペレーションの呼び出し時にエラーが発生しました(AccessDenied):アクセス拒否
  • 要因:使用されているAWS認証情報が、AppsFlyerバケットの正しい認証情報ではありません。これは、複数または無効な資格情報が原因の可能性があります。
  • 解決法:
    1. Cyberduckなどの別の方法、つまりCLI以外を使用してバケットにアクセスしてください。これにより、使用している資格情報が機能していることを確認してください。Cyberduckを使用して接続できる場合は、資格情報キャッシュに問題があることを示しています。
    2. AWS認証情報キャッシュを更新してください。
      Screenshot from AWS mceclip0.png

AWSデータの取得

AWS CLIや次のセクションで説明するツールのいずれかのAWSデータ取得ツールを使用してください。注!正確な手順は、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種類のフォルダがあります。

  • Report Type: t=
  • Date: dt=
  • Hour: 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: AppFlyerの認証情報パネルに表示されるAWSアクセスキーをコピーしてください
    • Secret access key: AppsFlyer の資格情報パネルに表示されているバケットシークレットキーをコピーします。
    • Path: {Bucket Name}/{Home Folder} / 例:af-ext-reports/1234-abc-ffffffff
  5. ウィンドウを閉じます。画面の右上にある X をクリックしてください。
  6. 接続を選択します。
    データディレクトリが表示されます。

Amazon S3ブラウザー

はじめに:

  • Amazon S3ブラウザをインストールします。
  • AppsFlyerで、Data Lockerに移動し、認証情報パネルに含まれる情報を取得します。

Amazon S3ブラウザを設定するには

  1. S3 ブラウザにて、Accounts > Add New Account をクリックします。
    新しいアカウントの追加ウィンドウが開きます。 mceclip0.png
  2. 次のフィールドを入力します:
    • Account Name :フリーテキスト
    • Access Key ID :認証情報パネルに表示されるAWS Access Keyをコピーします。
    • Secret Access Key:資格情報パネルに表示される Bucket Secret Key をコピーします。
    • パスワードで Encrypt Access Keys を選択し、パスワードを入力します。このパスワードを覚えておいてください。
    • Use secure transfer を選択します。
  3. 変更を保存をクリックします。
  4. Buckets > Add External Bucketをクリックします。
    「外部バケットの追加」ウィンドウが開きます。
    mceclip2.png
  5. バケット名を入力します。バケット名は以下の形式です: {Bucket Name}/{Home Folder}.バケット名とホームフォルダに必要な値は認証情報ウィンドウに表示されます。
  6. Add External bucketをクリックします。バケットが作成され、ウィンドウの左側のパネルに表示されます。
    これで、Data Lockerファイルにアクセスできます。 

This article was translated using AI and may contain errors. For the most accurate information, please refer to the English version using the language selector.


Share article: