Data Locker—広告主様向け

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

クラウドストレージにデータを送るか、データウェアハウスにデータを送るかによって、利用できるデータの構造が異なります。ここで説明するフォルダの構成は、ストレージ（バケット）に適用されるものです。データウェアハウスストレージ（Snowflake）の場合、フォルダはビューに適用されると考えてください。詳細は、Snowflakeを参照してください。

各種データは、選択したストレージオプションに書き込まれます。クラウドストレージの場合、ストレージはAppsFlyerが所有するAWS、または独自に所有するAWSまたはGCSです。ストレージオプションは、いつでも別のオプションに変更できます。

ストレージ内のデータは、レポートのタイプ、日付、および時刻に従って、階層的なフォルダ構造で編成されます。次の図は、この構造の例を示しています。

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

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

• データは、選択したストレージ所有者に次のように書き込まれます。
  • AppsFlyerストレージ
  • 顧客のストレージ—AWSまたはGCS
• ストレージの選択はいつでも変更できます。
• ストレージを変更すると、次のことが起こります。
  • 新しく選択したストレージへの書き込みは1時間以内に開始します。
  • 7日間の移行期間中、既存のストレージへの書き込みを続行します。移行期間の有効期限がユーザーインターフェイスに表示されます。移行期間を使用して、データ読み込みプロセスを更新してください。必要に応じて移行期間を再開したり、AppsFlyerのバケットに戻したりすることができます。
  • バケットの変更：ストレージを変更した場合、7日間の移行期間中はデータは両方のバケットに送信され、データ取り込みプロセスを調整できます。

セキュリティご担当者への連絡事項（お客様が管理するストレージの場合）

注意事項：

• バケットは、AppsFlyer専用のものです。他の部門からそのバケットへのデータ書き込みは行わないでください。
• データを書き込まれた後25時間後に、バケット内のデータを削除できます。
• バケットに書き込まれるデータは、当社のサーバーに既に存在しているデータのコピーです。データは、当社の保持ポリシーに従って引き続き当社のサーバーに格納されます。
• 技術的な理由から、データを削除して再格納することがあります。このため、削除権限とリスト権限が必要です。どちらの権限もセキュリティリスクではありません。リストの場合、バケットに書き込むする唯一のエンティティです。削除の場合、データを再生成することができます。
• 詳細については、hello@appsflyer.com 経由でセキュリティチーム、またはCSMにご連絡ください。

この手順に従って、Data Lockerを設定してください。Data Locker設定への変更が有効になるには、最大3時間かかります。

前提条件

広告主所有のストレージを設置する方法：

広告主所有のストレージ、つまりユーザーが所有するバケットを使用して Data Locker を設定する場合は、次のいずれかの手順を実行してください。

• 御社のAWSのバケット
• 御社のGCSのバケット

注！Data Locker のサブスクリプションをお持ちでなく、コホート分析またはSKANデータにアクセスする場合は、広告主所有のストレージ手順を完了する必要があります。

Data Lockerの設定方法：

1. 管理者が設定を実行する必要があります。
2. AppsFlyerにて、インテグレーション > Data Locker へ進みます。 
3. クラウドサービスのデータ保存先の選択してください。次のいずれかを実行してください：
   
   • AppsFlyer AWSバケットを選択してください（Data Lockerをご契約の方のみご利用いただけるオプションです）。ステップ4に進んでください。
   • 独自のAWSバケットを選択してください。
     1. AWSバケット名を入力してください。接頭辞 af-datalocker- は入力しないでください。
     2. [Test] をクリックします。
     3. バケットパスが無効であることを示すエラーメッセージなどが表示されないことを確認します。
   • 独自のGCSバケットを選択し、GCSバケット名を入力し、最後にテストをクリックしてください。
4. フォルダ構成（データ分離）を選択してください。
   • [デフォルト] 統合。
   • アプリごとに分離。
5. ファイル形式を選択してください：
   • [デフォルト] Parquet。
   • CSV。 
6. 必要なアプリを選択してください。全てを選択すると、将来追加されるアプリも自動的に含まれます。
7. [Apply] をクリックします。
8. [オプション] メディアソース：レポートに含めたい1つまたは複数のメディアソースを選択します。
   • デフォルト=すべて。今後新たに追加されるメディアソースも自動的に追加されます。
9. 必要なレポートタイプを選択してください。少なくとも1つ選択する必要があります。
10. [オプション] アプリ内イベント：含めたいアプリ内イベントを選択します。アプリ内イベントの種類が100個を超えている場合には、検索することはできませんので、名前を正確に入力して選択してください。
    • デフォルト=すべて。今後新たに追加されるアプリ内イベントも自動的に追加されます。
11. [Apply] をクリックします。
12. [オプション] Field（項目）：レポートに含める項目を選択します。注：場合によっては追加項目が利用できる場合があります。データインポートプロセスでこのことを考慮してください。
13. Save Configuration（設定を保存）をクリックします。次のうちいずれかが発生します：
    
    • AppsFlyer AWSバケットを選択した場合：
      • 専用のAWSバケットが作成されます。バケットの認証情報が表示されます。
      • バケットはこの認証情報を使用してアクセスできます。認証情報は、バケットへの読み取り専用アクセスを提供します。
    • カスタマーバケットを選択した場合：データは独自のバケットに3時間以内に書き込まれます。

管理者（アドミン）は、AppsFlyerバケットの認証情報をいつでもリセットできます。注！認証情報をリセットする場合、新しい認証情報を使用してデータインポートスクリプトを更新する必要があります。

認証情報をリセットする方法：

1. AppsFlyerにて、インテグレーション > Data Locker へ進みます。 
2. 認証情報セクションにて、Reset credentials.をクリックします。
   確認画面が表示されます。
3. Reset(リセット）をクリックします。
4. Credentials successfully reset（認証情報が正常にリセットされました）とメッセージが表示されるまで待ちます（約20秒間）。更新された認証情報が利用できます。

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

はじめに：

• コンピューターに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クライアントをインストールしてください。
• AppsFlyerで、Data Lockerに移動し、資格情報パネルに含まれる情報を取得します。

Cyberduckの設定方法：

1. Cyberduckで、[Action]をクリックしてください。
2. New Bookmark を選択します。以下の画面が表示されます：
3. 最初のフィールド（次のスクリーンショットでは [1] とマークされています）で、[Amazon S3] を選択します。

   

4. 次のように各フィールドを入力します。
   • Nickname: フリーテキスト
   • Server: s3.amazonaws.com
   • Access Key ID: AppFlyerの認証情報パネルに表示されるAWSアクセスキーをコピーしてください
   • Secret Access Key: AppsFlyerの認証情報パネルに表示される Bucket Secretキーをコピーします。
   • Path: {Bucket Name}/{Home Folder} 例：af-ext-reports/1234-abc-ffffffff
5. ウィンドウを閉じるには、ウィンドウの右上隅にあるXを使用します。
6. 接続を選択します。
   データディレクトリが表示されます。

はじめに：

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

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

1. S3 ブラウザにて、Accounts > Add New Account をクリックします。
   新しいアカウントの追加ウィンドウが開きます。

   

2. 次のように各フィールドを入力します。
   • Account Name ：フリーテキスト
   • Access Key ID ：認証情報パネルに表示されるAWS Access Keyをコピーします。
   • Secret Access Key：資格情報パネルに表示される Bucket Secret Key をコピーします。
   • パスワードで [Encrypt Access Keys] を選択し、パスワードを入力します。このパスワードを覚えておいてください。
   • [Use secure transfer] を選択します。
3. [Save changes] をクリックします。
4. [Buckets] > [Add External Bucket] をクリックします。
   外部バケットの追加ウィンドウが開きます。
   

   

5. バケット名を入力します。バケット名の形式は {Bucket Name} / {Home Folder} です。バケット名とホームフォルダに必要な値は認証情報ウィンドウに表示されます。
6. [Add External bucket] をクリックします。
   バケットが作成され、ウィンドウの左側のパネルに表示されます。
   これで、Data Lockerファイルにアクセスできます。