概要：概要：パートナー（アドネットワーク / 代理店）向けのData Lockerは、アプリのデータを AWS、GCSまたはBig Queryのパートナーのストレージへ配信します。
Data Locker：連携済みパートナー向け
パートナー向けのデータロッカーは、アプリデータをクラウドストレージに提供します。広告主は、AppsFlyerが特定のパートナーと選択したデータを共有できるようにする権限を設定します。
Data Lockerの主な機能
| 機能 | 説明 |
|---|---|
| ストレージオプション（クラウド） |
自社で保持している以下のストレージ(バケット)：
|
| 複数アプリ対応 |
計測連携しているアプリのデータを取得可能です。ただし、データを取得するには広告主がレポート毎に権限を付与する必要があります。 |
| データ形式のオプション |
|
| データ更新頻度 |
レポートタイプ毎に更新頻度が異なります：
|
連携済みパートナーが利用可能なレポート
利用可能なレポートとレポートを取得するために必要な権限は、パートナーの種類によって異なります。ただし、データロッカーのメカニズム、ストレージオプション、および必要な設定は、パートナーの種類に関係なく同じです。パートナータイプ毎に、以下の記事を参照してください：
データストレージのアーキテクチャ
概要
各種データは、選択したストレージオプションに書き込まれます。ストレージオプションは、いつでも別のオプションに変更できます。変更は数時間以内に完了します。
クラウドバケットストレージ内のデータは、レポートタイプ、日付、時刻に従って階層フォルダ構造に編成されます。次の図は、この構造の例を示しています：
レポートデータは、そのレポートが関連している時間 (h) のフォルダに格納されます。
- 時間 (h) フォルダの数は、レポートデータの更新頻度 (DailyまたはHourly) によって異なります。
- データは、Snappy または GZIP圧縮ファイル、もしくはParquet 形式またはCSV形式の非圧縮ファイルで提供されます。
- データファイルは列（項目）で構成されています。
- カラムの構成はレポート種別毎に定義されています。
フォルダの構成
| フォルダ | 説明 |
|---|---|
| data-locker-hourly |
バケット所有者とクラウドプロバイダー毎のフォルダ構成の例：
|
| t (topic) | レポートタイプはレポートの主題に関連します。 |
| dt (日付) |
これはデータの日付に関連します。ほとんどの場合、これはイベントが発生した日時を意味します。 |
| h (hour) |
h フォルダはAppsFlyerがデータを受信した時刻に紐付けられています。例えば、インストールイベントを 14:00-15:00 UTC に受信した場合、h=14 ファイルにストリーミングされます。ご注意くださいAppsFlyerにデータが到着してから、h フォルダがData Lockerに書き込まれるまで、約6時間のタイムラグがあります。例えば、h=14 フォルダは6時間後の 23:00 UTCにストリーミングされます。 フォルダの特性：
|
| 統合データ |
全アプリに関するデータは、統合したデータファイルで提供されます。データを取り込む際には、行単位でapp_idの項目を使用してアプリを区別してください。 データファイルの例は、h=2 フォルダをご覧ください
|
| 完了フラグ |
最終ファイル（完了）フラグは、対象の h フォルダの全てのデータが書き込まれたあとに設定されます。
|
| データ圧縮 |
ファイルはgzを使って圧縮されます。ファイルの解凍後：
|
| 列シーケンス |
レポート項目の順序は常に同じです。新しい項目が追加される場合には、常に既存項目の右端に追加されます。 カラム(フィールド)の定義は、レポート毎に異なります。各内容については、関連するレポートのヘルプページを参照してください。 |
| 項目入力に関する考慮事項 |
空白または空のフィールド： 一部の項目は null または空白になります。これは、特定のレポートのコンテキストでは、レポートするデータがないことを意味します。通常、null は、特定のレポートおよびアプリタイプのコンテキストでこの項目に値が入力されないことを意味します。空白（""）は、この項目がこのコンテキストに関連しているものの、入力するデータが見つからなかったことを意味します。 タイムゾーンと通貨設定： アプリ毎に管理画面上で設定されているタイムゾーンと通過設定は、Data Lockerに書き込まれるデータでは無視されます。代わりに、以下仕様が適用されます：
カンマで区切られた値：これらのカンマは二重引用符 `"` の間に含まれます。例： |
データファイル
データファイルはセグメンテーションタイプにより異なります。
| コンテンツ | 詳細 | |
|---|---|---|
| 完了フラグ |
最終ファイル（完了）フラグは、対象の h フォルダの全てのデータが書き込まれたあとに設定されます。
|
|
| ファイルの種類 |
|
|
| 列の並び（CSVファイル） |
CSVファイルの場合、レポート項目の順序は常に同じです。新しい項目が追加される場合は、既存項目の右側に追加されます。 この点に関して：
|
|
| 項目入力に関する考慮事項 |
空白または空のフィールド： 一部の項目は null または空白になります。これは、特定のレポートのコンテキストでは、レポートするデータがないことを意味します。通常、null は、特定のレポートおよびアプリタイプのコンテキストでこの項目に値が入力されないことを意味します。空白（""）は、この項目がこのコンテキストに関連しているものの、入力するデータが見つからなかったことを意味します。 制限付きメディアソースの場合、制限された項目の内容は null になります。 一般的に、nullとブランクは同じものであり、利用可能なデータはありません。 タイムゾーンと通貨 アプリ固有のタイムゾーンと通貨設定は、Data Locker に書き込まれるデータには影響しません。次のことが当てはまります。
カンマで区切られた値：これらのカンマは二重引用符 `"` の間に含まれます。例： |
|
ストレージオプション
- データは、選択したストレージ所有者に次のように書き込まれます。AWS、GCS、およびBigQuery。
- ストレージの選択はいつでも変更できます。
- ストレージを変更すると、次のことが起こります：
- 新しく選択したストレージへの書き込みは1時間以内に開始します。
- 7日間の移行期間中、既存のストレージへの書き込みを続行します。移行期間の有効期限がユーザーインターフェイスに表示されます。移行期間を使用して、データ読み込みプロセスを更新してください。
- バケットの変更:バケットの変更：ストレージを変更した場合、7日間の移行期間中はデータは両方のバケットに送信され、データ取り込みプロセスを調整できます。
| パートナー所有のストレージ(GCS、AWS、BigQuery) | |
|---|---|
| バケット名 |
例： |
| ストレージの所有者 | Partner |
| ストレージプラットフォーム | AWS、GCS、Yandex、BigQuery |
| データへアクセスするための認証情報 | AppsFlyerには開示されません。ストレージプロバイダーから提供される認証情報を使用してください。 |
| データ保持期間 | 御社による管理 |
| セキュリティ |
御社がストレージを管理します：
|
セキュリティ担当者へのお知らせ：
次の点を考慮してください：
- バケットまたはストレージ先は、AppsFlyer専用です。他の部門からそのバケットへのデータ書き込みは行わないでください。
- データを書き込まれた後25時間後に、バケット内のデータを削除できます。
- ストレージに書き込まれるデータは、当社のサーバーに既に存在しているデータのコピーです。データは、当社の保持ポリシーに従って引き続き当社のサーバーに格納されます。
- 技術的な理由により、データを削除したり書き換えたりすることがあります。この理由から、削除およびリスト権限が必要です。リストまたは削除は、あなたにとってセキュリティリスクではありません。リストの場合、我々はバケットに書き込む唯一の存在です。削除の場合、データを再生成できます。
複数連携の仕様について（2つ以上の接続先設定）
Data Lockerでは、一部または全てのデータを複数のディスティネーション（連携設定で定義）に送信することができます。例えば、アプリAのデータをAWSへ、アプリBのデータをGCSへ送信できます。
各連携に対して、ディスティネーションを含むData Lockerの設定を全て実行する必要があります。連携設定は互いに独立しています。
連携管理について、以下の点を考慮してください。
- Data Locker設定では、連携はタブに表示されます。各連携には独自の設定タブがあり、そこから連携を管理できます。デフォルトタブは「Data Locker」です。
- 新しい連携を作成する方法：
- 接続の追加をクリックします。
- 連携の名前を入力し、ストレージの種類を選択してください。
-
保存をクリックしてください。
保存したら、連携はデフォルトの「Data Locker」タブの隣に表示されます。各タブのアイコンはストレージの種類を示しています。
- 連携の詳細の確認、連携の複製、連携の削除を行うには、⋮ (オプション) をクリックしてください。
手順
Data Lockerの設定
この手順に従って、Data Lockerを設定します。なお、設定変更を行った後、機能が有効になるまで最大3時間かかる場合があります。
前提条件：
以下のいずれかのストレージの作業手順を完了してください。
Data Lockerの設定：
- AppsFlyerのパートナーアカウントでログインしてください。
- 管理画面内で以下に移動してください：
-
AdvertisersAppsFlyerでは、サイドバーからエクスポート >データロッカー.
- マーケティングパートナーの場合： アカウントメニューをクリックして、 Data Lockerへ進んでください。
-
AdvertisersAppsFlyerでは、サイドバーからエクスポート >データロッカー.
- DataLockerのセットアップ手順のステップ3〜16に従ってください。
追加情報
特徴と制限
| 特性 | 備考 |
|---|---|
| アプリ固有のタイムゾーン | 不適用 |
| App-specific currency | サポートされておらず、計測対象外です |
| サイズ制限 | 不適用 |
| データ更新頻度 | データは、この記事内に記載されている個々のレポートデータの更新頻度に従って更新されます。 |
| 過去データ |
サポートされておらず、計測対象外です |
| チームメンバーアクセス | チームメンバーは、管理画面上でData Lockerの設定を行うことができません。 |
トラブルシューティング
こちらのトラブルシューティングガイドをご確認ください。