Data Locker — マーケティング担当者向け

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

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

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

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

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

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

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

• データは、選択したストレージ所有者に次のように書き込まれます。
  • AppsFlyerストレージ
  • お客様保有のストレージ — AWS, GCS, Yandex, BigQuery, Snowflake
• ストレージの選択はいつでも変更できます。
• ストレージを変更すると、次のことが起こります。
  • 新しく選択したストレージへの書き込みは1時間以内に開始します。
  • 7日間の移行期間中、既存のストレージへの書き込みを続行します。移行期間の有効期限がユーザーインターフェイスに表示されます。移行期間を使用して、データ読み込みプロセスを更新してください。必要に応じて移行期間を再開したり、AppsFlyerのバケットに戻したりすることができます。
  • ストレージの変更：マルチストレージオプションを使用して複数の宛先に同時にデータを送信することで、あるストレージオプションから別のストレージオプションに移行できます。移行とテストが完了したら、不要になったストレージオプションを削除してください。

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

注意事項：

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

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

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

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

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

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

前提条件

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

マーケティング担当者が所有するクラウドストレージサービスを使用して Data Lockerを設定する場合は、ここで次の手順の 1つ以上を完了してください。 

• セットアップ：
  • AWSバケット
  • GCSバケット
  • [Beta] Yandexバケット
  • BigQueryデータウェアハウス
  • Snowflake ウェアハウス

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

Data Lockerの設定方法：

1. 管理者が設定を実行する必要があります。
2. AppsFlyer で、 インテグレーション > Data Lockerに移動します。 
3. [オプション] 有効なData Locker接続先が既に存在し、別の新しい接続先を追加する場合は、接続の追加 をクリックします。接続に名前を付けます。
4. クラウドサービスのデータ保存先の選択してください。次のいずれかを実行してください：
   
   • AppsFlyer AWSバケットを選択してください（Data Lockerをご契約の方のみご利用いただけるオプションです）。
     保存をクリックして、手順 5に進みます。 
   • S3を選択します。
     1. AWS S3バケット名を入力します。af- プレフィックスは必須であり、手動で入力する必要があります。
     2. 接続テストをするをクリックしてください。
        
     3. バケットパスが無効であることを示すエラーメッセージなどが表示されないことを確認します。
     4. この接続をAdobe Experience Platformと互換性を持たせるかどうかを選択します。選択した場合は、保存をクリックしてステップ6 に進みます。
     5. 保存 をクリックしてください。
   • GCSを選択します。
     1. GCSバケット名を入力します。
     2. 接続テストをするをクリックしてください。
        
     3. バケットパスが無効であることを示すエラーメッセージなどが表示されないことを確認します。
     4. この接続をAdobe Experience Platformと互換性を持たせるかどうかを選択します。選択した場合は、保存をクリックしてステップ6 に進みます。
     5. 保存 をクリックしてください。
   • [Beta] Yandexを選択します。
     1. あなたのバケット名、アクセスキー、シークレットキーを入力します。
     2. バケットパスが無効であることを示すエラーメッセージなどが表示されないことを確認します。
     3. この接続をAdobe Experience Platformと互換性を持たせるかどうかを選択します。選択した場合は、保存をクリックしてステップ6 に進みます。
     4. 保存 をクリックしてください。
   • BigQueryを選択します。
     1. BigQuery プロジェクト ID とデータセット名を入力します。
     2. 接続テストをするをクリックしてください。
        
     3. バケットパスが無効であることを示すエラーメッセージなどが表示されないことを確認します。
     4. 保存 をクリックして、ステップ6 に進みます。
   • Snowflakeを選択してください。
     1. Snowflake地域とアカウントIDを入力します。
     2. 接続テストをするをクリックしてください。
        
     3. バケットパスが無効であることを示すエラーメッセージなどが表示されないことを確認します。
     4. 保存 をクリックして、ステップ6 に進みます。
5. データ設定セクションへ進みます：
   1. 目的のファイル形式を選択します：
      • [デフォルト] Parquet
      • CSV
   2. 必要なファイル圧縮タイプを選択します。
      • Snappy（Parquetファイルでのみ使用可能）
      • GZIP
      • 非圧縮
   3. ファイルに含める最大行数を 10,000 / 25,000 / 50,000 / 100,000 / 200,000 / 500,000行から選択します。ファイル内の行数が多いほど、ファイルは少なくなりますが、ファイルサイズは大きくなります。
   4. フォルダ構造で アプリ別に分離を選択してください。
      • [デフォルト] 統合
      • アプリごとに分離
6. Data Lockerコンテンツセクションへ進みます：
7. レポートに含めるアプリを1つ以上選択します。今後追加されるアプリを自動的に含めるには、すべてを選択します。 
8. [Apply] をクリックします。
9. [オプション] レポートに含める メディアソース を1つ以上選択します。
   • デフォルト=すべて。今後新たに追加されるメディアソースも自動的に追加されます。
10. [Apply] をクリックします。
11. [オプション] レポートに含める データ項目を選択します。注：場合によっては追加項目が利用できる場合がありますので、データインポートプロセスでこの点を考慮してください。
12. [Apply] をクリックします。
13. レポートの種類を選択します。少なくとも1つ選択する必要があります。
14. [オプション] アプリ内イベントレポートで、含めるアプリ内イベントを選択します。アプリ内イベントの種類が100個を超えている場合には、検索することはできません。名前を正確に入力して選択してください。
    • デフォルト=すべて。今後新たに追加されるアプリ内イベントも自動的に追加されます。
15. [Apply] をクリックします。
16. 接続を保存をクリックします。次のうちいずれかが発生します：
    
    • AppsFlyer AWSバケットを選択した場合：
      • 専用のAWSバケットが作成されます。バケットの認証情報が表示されます。
      • バケットはこの認証情報を使用してアクセスできます。認証情報は、バケットへの読み取り専用アクセスを提供します。
    • クラウドストレージサービスのいずれかを選択した場合：データは3時間以内にサービスに書き込まれます。 

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

AppsFlyerが所有するストレージの認証情報をリセットする方法：

1. AppsFlyer で、 インテグレーション > Data Lockerに移動します。 
2. AppsFlyerが所有するディスティネーションを選択してください。
3. 認証情報セクションにて、Reset credentials.をクリックします。
   確認画面が表示されます。
4. Reset(リセット）をクリックします。
5. 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ファイルにアクセスできます。