概要:Data Lockerは、BIシステムへの取り込みに使用するレポートデータをクラウドストレージに送信します。送信先には、AppsFlyer所有のAWSバケット、または自社所有のAWS、GCS、Yandex、BigQuery、Snowflakeのストレージを選択できます。 Data Lockerは、複数の送信先に対応しています。すべてのデータを複数の送信先に送信することも、送信先ごとにデータを分けることも、両方を組み合わせることも可能です。
概要
Data Lockerで、AppsFlyerから選択したクラウドストレージに配信するデータに含めるアプリ、メディアソース、イベント、レポートを選択します。その後、プログラムを使用してストレージから自社システムにデータを取り込みます。
Data Lockerの機能
| 機能 | 説明 |
|---|---|
| ストレージの選択肢(クラウド) |
Data Lockerは、以下のクラウドサービスにデータを送信できます。
Data Lockerには、複数の送信先を設定できます。すべて、または一部のデータを複数の送信先に送信できます。 例
|
| 複数アプリへの対応 | アカウント内の1つ、複数、またはすべてのアプリのデータを送信できます。アカウントに追加したアプリを、自動で対象に含めることもできます。 |
| データ取得可能期間 | 14日間 |
| データの分割方法 |
バケット型のクラウドストレージでは、以下の分割方法を選択できます。
|
| データ形式の選択肢 |
|
| データの更新頻度・反映時間 |
更新頻度・反映時間は、レポートの種類によって異なります。
|
Data Lockerで取得できるレポート
Data Lockerのレポート設定
Data Lockerを設定するには、以下の手順でクラウドサービスに接続し、出力設定とレポートの内容を指定します。
1. クラウドサービスの設定
2. クラウドサービスへの接続の追加
クラウドサービスのアカウントをData Lockerで使用できるよう設定したら(上記の「クラウドサービスの設定」を参照)、そのアカウントの認証情報でData Lockerに接続を作成します。接続は最大2つまで作成できます。
注意
デフォルトでは、アカウントごとにData Lockerの接続を最大2つ作成できます。さらに接続が必要な場合は、担当のカスタマーサクセスマネージャー(CSM)にお問い合わせください。
クラウドサービスへの接続を作成するには、以下の手順を実行します。
- AppsFlyerのサイドメニューから、出力 > Data Lockerに移動します。
- 右側にあるNew connectionをクリックします。
- Connection nameに接続名を入力します。半角英小文字、数字、ハイフンのみを使用してください。
- 接続するクラウドサービスのアイコンをクリックします。
-
選択したサービスに応じて、以下の接続情報を入力します。
AWSクラウドバケットへの接続
AWSの接続を設定する前に、AWSバケットを作成します。手順はこちらを参照してください。
接続の設定手順:
- AWS S3のバケット名を入力します。
af-プレフィックスは必須です。手動で入力してください。 - Test connectionをクリックします。
- バケットのパスが無効であることを示すエラーメッセージが表示されていないことを確認します。
- Make this connection compatible with Adobe Experience Platformを選択するかどうかを指定します。選択した場合は、保存をクリックして、全体に適用するフィルターの選択に進みます。
- 保存をクリックします。
GCSクラウドバケットへの接続
GCSの接続を設定する前に、GCSでバケットを作成します。手順はこちらを参照してください。
接続の設定手順:
- GCS bucket nameにGCSのバケット名を入力します。
- Test connectionをクリックします。
- バケットのパスが無効であることを示すエラーメッセージが表示されていないことを確認します。
- Make this connection compatible with Adobe Experience Platformを選択するかどうかを指定します。 選択した場合は、保存をクリックして、全体に適用するフィルターの選択に進みます。
- 保存をクリックします。
Azureクラウドバケットへの接続
Azureの接続を設定する前に、Azureでストレージアカウントを作成します。手順はこちらを参照してください。
接続の設定手順:
- Connection name、Storage account name、Keyを入力します。
- バケットのパスが無効であることを示すエラーメッセージが表示されていないことを確認します。
- Make this connection compatible with Adobe Experience Platformを選択するかどうかを指定します。 選択した場合は、保存をクリックして、全体に適用するフィルターの選択に進みます。
- 保存をクリックします。
Yandex Cloudバケットへの接続
AWSの接続を設定する前に、Yandexでサービスアカウントを作成します。手順はこちらを参照してください。
接続の設定手順:
- Bucket name、Access key、Secret keyを入力します。
- バケットのパスが無効であることを示すエラーメッセージが表示されていないことを確認します。
- Make this connection compatible with Adobe Experience Platformを選択するかどうかを指定します。 選択した場合は、保存をクリックして、全体に適用するフィルターの選択に進みます。
- 保存をクリックします。
BigQueryデータウェアハウスへの接続
BigQueryの接続を設定する前に、BigQueryでデータセットを作成します。手順はこちらを参照してください。
接続の設定手順:
- BigQueryのプロジェクトIDとデータセット名を入力します。
- Test connectionをクリックします。
- バケットのパスが無効であることを示すエラーメッセージが表示されていないことを確認します。
- 保存をクリックして、全体に適用するフィルターの選択に進みます。
Snowflakeデータウェアハウスへの接続
Snowflakeの接続を設定する前に、Snowflakeでアカウントを作成します。手順はこちらを参照してください。
接続の設定手順:
- SnowflakeのリージョンとアカウントIDを入力します。
- Test connectionをクリックします。
- バケットのパスが無効であることを示すエラーメッセージが表示されていないことを確認します。
- 保存をクリックして、全体に適用するフィルターの選択に進みます。
- AWS S3のバケット名を入力します。
- 保存をクリックします。 Report output settingsセクションが表示されます。
注意
接続の作成・更新・削除の有無と変更を行ったユーザーは、監査ログで確認できます。
3. レポート出力の設定
クラウドサービスへの接続を設定したら、Data Lockerのレポート出力の全般設定を行います。クラウドサービスがBigQueryまたはSnowflakeの場合、この手順は省略できます。
-
Report output settingsセクションで、フォルダー構造(データの分割方法)を選択します。
- Unified(デフォルト):すべてのアプリのレコードをレポートファイルに含めます。
- Segregated by app:アプリごとに専用のレポートファイルを作成します。
- レポートのファイル形式を、Parquet(デフォルト)またはCSVから選択します。
- レポートファイルの圧縮方式を選択します。
- Snappy(Parquetファイルのみで利用可能)
- GZIP
-
ファイルの最大行数を、1万、2万5千、5万、10万、20万、50万から選択します。 行数を多くするとファイル数は減りますが、ファイルサイズは大きくなります。
注意
Expected pathで、レポートのパスのパターンを確認します。注意:実際のパスは、表示と異なる場合があります。
4. 全体に適用するフィルターの選択
全体に適用するフィルターでは、アプリ、地域、メディアソースでレポートを絞り込めます。これらのフィルターは、Data Lockerアカウント内のほとんどのレポートに適用されますが、レポート単位でも設定できます(後述のレポート単位のフィルターの選択を参照)。同じフィルターを両方に設定した場合は、レポート単位のフィルターが優先されます。
フィルターを適用するには、以下の手順を実行します。
-
レポートセクションでフィルターをクリックし、レポートに含める項目を選択します。 例えば、
Appsフィルターをクリックし、レポートに含めるアプリを選択します。
- 次に、Enter(⏎)ボタンをクリックします。
5. レポートグループの選択
クラウドサービスで取得するレポートを選択します。レポートはグループごとに一覧表示されます。レポートグループ名をクリックすると、グループを展開・折りたたみできます。
- レポートを選択するには、
をクリックしてレポートグループを展開します。グループ内の各レポートについて、以下の情報が表示されます。
- Report Name:レポートのタイトル。
- Dataset Name:レポートのレコードが含まれるデータセットの名前。
- Data Freshness:新しいレコードによるレポートの更新頻度(時間単位、日次、バージョン管理方式など)。
- Fields:選択可能なフィールドの総数に対して、レポートに選択したフィールド(列)の数。
6. レポートのカスタマイズまたは複製
レポートグループから1つ以上のレポートを選択したら、元のレポートをカスタマイズするか、複製して別のカスタマイズ用コピーを作成できます。これにより、元のバージョンに影響を与えずに、用途に応じたフィールドとフィルターを設定できます。
方法A:元のレポートをカスタマイズ
- レポート名の横にある
Customizeボタンをクリックします。
- レポートエディターが開き、フィールドの選択とフィルターの適用を行えます。
- 変更内容は、元のレポートの設定に保存されます。
注意:この操作により、クラウドストレージへのレポートの配信内容が変更されます。
方法B:レポートを複製
- レポート名の横にある
をクリックします。
- ドロップダウンメニューから
Duplicateを選択します。
- レポートのコピーが作成され、名前の先頭に
copy_of_が付加されます。 - 複製したレポートは編集モードで開き、さらにカスタマイズできます。
ヒント:用途に応じてレポートのバリエーションを作成する場合は、複製が便利です。
カスタマイズまたは複製を選択したら、次の手順に従ってレポートのフィールドを設定します。
7. レポートのフィールドの選択
レポートをカスタマイズまたは複製した後は、含めるデータフィールドを指定します。各レポートには、利用可能なフィールドがすべて用意されています。分析や連携に必要なフィールドだけを選択できます。デフォルトではすべてのフィールドが選択されていますが、手動で必要なフィールドに絞り込めます。
レポートに含めるフィールドを選択するには:
-
選択したレポートのダイアログで、Fieldsタブの各フィールドにカーソルを合わせると、説明を確認できます。
- 含めるフィールドにチェックを入れ、除外するフィールドのチェックを外します。
- 適用をクリックして、設定を保存します。
別のレポートからのフィールド選択のコピー
別のレポートのフィールド選択をコピーし、それを基にフィールドを選択・解除して調整できます。
- Fieldsタブで、任意のフィールドの選択を解除します。
- Pull schema from reportをクリックします。
- フィールド選択のコピー元のレポートを選択します。
- 引き続き、フィールドの選択・解除を行います。
- レポートの元のフィールド選択に戻すには、
Refreshをクリックします。
8. レポート単位のフィルターの選択
レポート単位のフィルターでは、アプリ、メディアソース、その他の項目で、個々のレポートを絞り込めます。アカウント内のすべてのレポートに適用するフィルターも設定できます。全体に適用するフィルターの選択を参照してください。レポート単位のフィルターは、デフォルトでは全体のフィルター設定に従いますが、選択したレポートにのみ適用する個別の設定に変更できます。
特定のレポートに適用するフィルターを選択するには:
- カスタマイズするレポートにカーソルを合わせます。
-
をクリックして操作メニューを開き、
Edit reportを選択します。
- Filtersタブを開きます。全体のフィルター設定が反映されています。
- フィルターをクリックし、レポートに含める項目を選択します。例えば、
Appsフィルターをクリックし、レポートに含めるアプリを選択します。
- Enter(⏎)ボタンをクリックします。選択内容は、全体の設定より優先されます。
- (任意)Inappsレポートでは、In-app eventフィルターを設定できます。選択するイベント名を正確に入力します。
-
適用をクリックして、設定を保存します。
9. 旧フィールドの削除
旧フィールドとは、以前はレポートのスキーマに含まれていたものの、現在は除外されているフィールドです。レポートに必要な情報だけを含めるため、これらのフィールドの削除を推奨します。変更する前に、既存の処理や連携がそれらのフィールドに依存していないことを確認してください。
特定の旧フィールドを削除するには:
- Legacy fieldsタブを開きます。
- Include legacy fields in the reportをオンにします。
- 除外するフィールドの選択を解除します。
- 適用をクリックします。
- 接続設定を保存します。
すべての旧フィールドを削除するには:
- 旧フィールドのタブを開きます。
- Include legacy fields in the reportをオフにします。
注意
旧フィールドを含めたいのに、一覧がグレーアウトしてロックされている場合は、担当のカスタマーサクセスマネージャーにお問い合わせください。
値が入っている旧フィールド
旧フィールドのほとんどは、空欄またはnullです。ただし、一部には値が入っていても、以下のいずれかの理由で旧フィールドとして扱われるものがあります。
- 名前が変更され、別の名前でレポートに含まれている。
- 廃止され、レポートのスキーマから除外されている。
10. 接続の保存
保存をクリックすると、3時間以内にクラウドサービスへ初回のデータが書き込まれます。その後のデータ更新スケジュールは、レポートによって異なります。
重要
Data Lockerの設定変更が反映されるまで、最大3時間かかります。
ユーザー権限の設定
適切な権限を持つ管理者とチームメンバーの両方が、Data Lockerにアクセスできます。
- 管理者は、Data Lockerページへのアクセス、すべての接続の作成・管理、編集者の追加、既存の接続の所有者の割り当てを行えます。
- チームメンバーは、Data Lockerページにアクセスし、自分が所有する既存の接続を編集したり、新しい接続を作成したりできます。アカウント所有者であっても、所有者や編集者の設定といった所有権の管理はできません。
Data Lockerへのアクセスと所有権の管理(管理者)
Data Lockerへのアクセス権限の付与
- チームメンバーにData Lockerへのアクセス権限を付与するには、Data LockerがManageに設定されたロールを割り当てます。
所有者と編集者の管理
既存の接続の所有権を移譲するか、チームメンバーを編集者として追加するには:
- 接続内の3点メニュー
をクリックします。
- Manage ownershipを選択します。
- 接続の所有者を変更するか、編集者を追加します。
所有者変更後のフィルターの確認
Data Lockerの接続の所有者を、データアクセスに制限のあるユーザー(アプリ、メディアソース、代理店、国などの制限)に変更すると、既存の全体のフィルターまたはレポート単位のフィルターが、新しい所有者の権限に合わせてリセットされる場合があります。
所有権を移譲した後は、フィルターを確認し、接続のデータ範囲が意図したとおりになっていることを確認してください。
データアクセスの制限については、ユーザー管理 > データアクセスを参照してください。
注意
AF AWSの接続には、管理者であってもManage ownershipの選択肢がありません。AF AWSの接続を編集、削除、新規作成できるのは管理者のみであるためです。これは、バケットの認証情報の漏えいを防ぐための措置です。
データの保存構造
概要
保存先がクラウドストレージかデータウェアハウスかによって、データの構造が異なります。ここで説明するフォルダー構造は、ストレージ(バケット)に適用されます。データウェアハウスでは、フォルダーへの言及はビューを指すものとしてお読みください。
データは、選択したストレージに書き込まれます。クラウドストレージの場合、AWS上のAppsFlyer所有のストレージ、またはAWS、GCS、Yandex上の自社所有のストレージを使用します。保存先はいつでも変更でき、すべて、または一部のデータを複数の保存先に送信することもできます。
クラウドバケット内のデータは、レポートの種類、日付、時刻に基づく階層的なフォルダー構造で整理されます。以下の図に、この構造の例を示します。
各レポートのデータは、そのレポートに対応する時間別のhフォルダーに格納されます。
- 時間別フォルダーの数は、レポートの更新・反映方式(時間単位、日次、バージョン管理方式)によって異なります。
- データは、ParquetまたはCSV形式のファイルで提供され、Snappy圧縮、GZIP圧縮、非圧縮のいずれかとなります。
- データファイルは、列(フィールド)で構成されます。
- ユーザージャーニーレポートのスキーマ(フィールド構成)は共通で、選択したフィールドによって決まります。その他のレポートにはそれぞれ固有のフィールドがあり、スキーマレスレポートとも呼ばれます。利用可能なレポートと各レポートの仕様へのリンクは、Data Lockerのマーケター向けレポートを参照してください。
フォルダー構造
| フォルダー | 説明 |
|---|---|
| サブスクリプション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に書き込まれます。 時間別フォルダーの特徴:
バージョンフォルダー一部のレポートでは、バージョン管理に対応しています。同じ日付について、更新されたデータが複数回提供されます。遅れて到着するデータや、より正確なデータによって更新が続くことがあるため、同じレポートに複数のバージョンが存在し、最新のものが最も正確です。 各日付のレポートは、その日付のバージョンフォルダーに格納されます。各バージョンは個別のフォルダーに入り、レポートを一意に識別するエポックタイムスタンプがフォルダー名に使用されます。 データの取り込み処理では、過去の日付にデータが書き込まれる可能性を考慮する必要があります。例えば、1月14日に1月1日のフォルダーへデータが書き込まれる場合があります。自社所有のバケットを使用する場合は、クラウドサービスの通知を使って取り込み処理を開始することを検討してください(AWS | GCS)。 |
アプリ別の分割
バケット型のクラウドストレージでは、選択したすべてのアプリを含む統合データファイル、またはアプリごとに分かれたフォルダーでデータが提供されます。以下の表のように、hフォルダー内で分割されます。
| 分割方法 | 説明 |
|---|---|
| [デフォルト]統合 |
すべてのアプリのデータを、統合されたデータファイルで提供します。取り込み時には、各行のapp_idフィールドでアプリを区別します。 h=2フォルダー内のデータファイルの例 データファイルの命名規則はunique_id.gzです。
|
| アプリ別に分割 |
フォルダー内に、アプリごとのサブフォルダーがあります。各アプリのデータファイルは、そのアプリのフォルダー内に格納されます。以下の図では、h=19フォルダー内にアプリごとのフォルダーがあります。各アプリフォルダーには、そのアプリのデータファイルが入っています。注意データファイルにはapp_idが含まれないため、フォルダーからapp_idを特定する必要があります。 各アプリフォルダー内の命名規則はunique_id.gzです。
制限事項:この方法は、ユーザーベースのアトリビューションのレポートでは利用できません。 |
データファイル
データファイルの構成は、分割方法によって異なります。
| 内容 | 詳細 | |
|---|---|---|
| 完了フラグ |
特定のhフォルダーへのデータの書き込みがすべて完了すると、最終ファイル(完了)フラグが設定されます。
|
|
| ファイルの種類 |
|
|
| 列の順序(CSVファイル) |
CSVファイルでは、レポート内のフィールドの順序は常に同じです。新しいフィールドは、既存のフィールドの右側に追加されます。 関連する留意点:
|
|
| フィールドへの値の入力に関する留意点 |
空欄または空のフィールド:一部のフィールドはnullまたは空欄になります。そのレポートの文脈では、表示するデータがないことを意味します。通常、nullは、レポートとアプリの種類に照らして、そのフィールドに値が入力されないことを意味します。空欄「""」は、その文脈で該当するフィールドではあるものの、入力するデータが見つからなかったことを意味します。 メディアソースがrestrictedの場合、制限対象のフィールドはnullになります。 全体として、nullと空欄は、どちらも利用できるデータがないという意味で同じように扱ってください。 タイムゾーンと通貨 アプリ固有のタイムゾーンと通貨の設定は、Data Lockerに書き込まれるデータには影響しません。以下が適用されます。
カンマを含む値:カンマを含む値は、 |
|
ストレージの選択肢
注意
マーケター所有のストレージを使用する場合:
- GDPRなどのデータプライバシー規制、およびアドネットワーク / SRNのデータ保持ポリシーに準拠していることを確認してください。
- マーケター所有のストレージを使用して、第三者にデータを送信しないでください。
- データは、以下のいずれかの所有者のストレージに書き込まれます。
- AppsFlyerのストレージ
- 顧客のストレージ(AWS、GCS、Azure、Yandex、BigQuery、Snowflake)
- ストレージの選択は、いつでも変更できます。
- ストレージを変更すると、以下の処理が行われます。
- 1時間以内に、新たに選択したストレージへの書き込みが開始されます。
- 7日間の移行期間中は、既存のストレージへの書き込みも継続します。移行期間の終了時刻は、管理画面に表示されます。移行期間中に、データの取り込み処理を更新してください。必要に応じて、移行期間を再開したり、AppsFlyerのバケットに戻したりできます。
- ストレージの変更:複数ストレージの機能で複数の送信先に同時配信することで、ストレージ間の移行を行えます。移行とテストが完了したら、不要になった保存先を削除します。
| AppsFlyer所有のストレージ(AWS) | マーケター所有のストレージ(GCS、AWS、Azure、Yandex、BigQuery、Snowflake) | |
|---|---|---|
| バケット名 | AppsFlyerが設定 |
例: |
| ストレージの所有者 | AppsFlyer | マーケター |
| ストレージのプラットフォーム | AWS | AWS、GCS、Azure、Yandex、BigQuery、Snowflake |
| データにアクセスするための認証情報 | AppsFlyerアカウントの管理者が、Data Lockerの管理画面で確認可能 | AppsFlyerは保持しません。クラウドサービスから提供された認証情報を使用してください。 |
| データ保持期間 | 14日後にデータを削除 | マーケターの責任 |
| データ削除要求への対応 | AppsFlyerの責任 | マーケターの責任 |
| セキュリティ | AppsFlyerがストレージを管理します。顧客は読み取り権限を持ちます。 |
マーケターがストレージを管理します。
|
| ストレージ容量 | 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管理画面のセキュリティセンターにある監査ログで確認できます。変更の有無、変更日時、変更を行ったユーザーを確認できます。データの欠落や意図しない接続変更などを、サポートに問い合わせずに調査・解決する際に役立ちます。
以下の接続のライフサイクルイベントが記録されます。
- 新しい接続の作成
- 接続の更新
- 接続の無効化
- 接続の削除
監査ログにアクセスするには:
- 上部のナビゲーションバーで、
アカウントメニューを開きます。
- セキュリティセンターを選択します。
- 監査ログセクションで、View audit logをクリックします。
- 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のバケット用のものではありません。コンピューターに複数の認証情報や無効な認証情報がある場合に、この問題が発生することがあります。
-
対処方法:
- CLI以外の方法(Cyberduckなど)で、バケットにアクセスしてください。使用している認証情報で接続できるかを確認するための操作です。 Cyberduckで接続できる場合は、認証情報のキャッシュに問題があることを示します。
-
AWSの認証情報のキャッシュを更新してください。
AWSのスクリーンショット
AWSのデータ取得
任意のAWSデータ取得ツール、AWS CLI、または以下のセクションで説明するツールを使用してください。注意以下の具体的な手順は、AppsFlyer所有のバケット向けです。自社のバケットに接続する場合は、必要に応じて手順を調整してください。
AWS CLI
始める前に:
- コンピューターにAWS CLIをインストールします。
- AppsFlyerでData Lockerに移動し、認証情報パネルの情報を確認します。
AWS CLIの使用手順:
- ターミナルを開きます。 Windowsでは、<Windows>+<R>を押して、OKをクリックします。
コマンドラインウィンドウが開きます。 - aws configureを入力します。
- 認証情報パネルに表示されるAWS Access Keyを入力します。
- 認証情報パネルに表示されるAWS Secret Keyを入力します。
- eu-west-1を入力します。
- 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の設定手順:
- CyberduckでActionをクリックします。
- New Bookmarkを選択します。ウィンドウが開きます。
- 最初のフィールド(以下のスクリーンショットの[1])で、Amazon S3を選択します。
- 各フィールドに、以下の内容を入力します。
- 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
- ウィンドウを閉じます。右上のXをクリックしてください。
- 接続を選択します。
データディレクトリが表示されます。
Amazon S3 Browser
始める前に:
- Amazon S3 Browserをインストールします。
- AppsFlyerでData Lockerに移動し、認証情報パネルの情報を確認します。
Amazon S3 Browserの設定手順:
- S3 Browserで、Accounts > Add New Accountをクリックします。
Add New Accountウィンドウが開きます。 - 各フィールドに、以下の内容を入力します。
- Account Name:任意のテキスト。
- Access Key ID:認証情報パネルに表示されるAWS Access Keyをコピーします。
- Secret Access Key:認証情報パネルに表示されるバケットのシークレットキーをコピーします。
- Encrypt Access Keysを選択し、パスワードを入力します。このパスワードを控えておいてください。
- Use secure transferを選択します。
- Save changesをクリックします。
-
Buckets > Add External Bucketをクリックします。
Add External Bucketウィンドウが開きます。 - Bucket nameを入力します。バケット名の形式は{Bucket Name}/{Home Folder}です。バケット名とホームフォルダーに必要な値は、認証情報ウィンドウに表示されています。
-
Add External bucketをクリックします。バケットが作成され、ウィンドウの左側のパネルに表示されます。
これでData Lockerのファイルにアクセスできます。