概要：パートナー（アドネットワーク / 代理店）向けのData Lockerは、アプリのデータを AWS、GCSまたはBig Queryのパートナーのストレージへ配信します。
Data Locker：連携済みパートナー向け
連携済みパートナー向けのData Lockerでは、アプリの計測データをパートナーがお持ちのクラウドストレージへ共有します。(広告主は対象のパートナーに対して、どのデータの共有を行うか権限を付与する必要があります。)
Data Lockerの主な機能
| 機能 | 説明 |
|---|---|
| 利用可能なクラウドストレージ |
自社で保持している以下のストレージ(バケット)：
|
| 複数アプリ対応 |
計測連携しているアプリのデータを取得可能です。ただし、データを取得するには広告主がレポート毎に権限を付与する必要があります。 |
| データ形式のオプション |
|
| データ更新頻度 |
レポートタイプ毎に更新頻度が異なります：
|
連携済みパートナーが利用可能なレポート
利用できるレポートやそのレポートを取得するために必要な権限は、パートナータイプによって異なりますが、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 ファイルにストリーミングされます。 フォルダの特性：
|
| 統合データ |
全アプリに関するデータは、統合したデータファイルで提供されます。データを取り込む際には、行単位でapp_idの項目を使用してアプリを区別してください。 データファイルの例は、h=2 フォルダをご覧ください
|
| 完了フラグ |
最終ファイル（完了）フラグは、対象の h フォルダの全てのデータが書き込まれたあとに設定されます。
|
| データ圧縮 |
ファイルはgzを使って圧縮されます。
|
| 列シーケンス |
レポート項目の順序は常に同じです。新しい項目が追加される場合には、常に既存項目の右端に追加されます。 カラム(フィールド)の定義は、レポート毎に異なります。各内容については、関連するレポートのヘルプページを参照してください。 |
| 項目入力に関する考慮事項 |
空白または空のフィールド： タイムゾーンと通貨設定： アプリ毎に管理画面上で設定されているタイムゾーンと通過設定は、Data Lockerに書き込まれるデータでは無視されます。代わりに、以下仕様が適用されます：
カンマを含む値：これらのカンマは、二重引用符「"」の間に含まれます。例： |
データファイル
データファイルはセグメンテーションタイプにより異なります。
| コンテンツ | 詳細 | |
|---|---|---|
| 完了フラグ |
最終ファイル（完了）フラグは、対象の h フォルダの全てのデータが書き込まれたあとに設定されます。
|
|
| ファイルの種類 |
|
|
| 列の並び（CSVファイル） |
CSVファイルの場合、レポート項目の順序は常に同じです。新しい項目が追加される場合は、既存項目の右側に追加されます。 この点に関して：
|
|
| 項目入力に関する考慮事項 |
空白または空の項目：一部の項目には null が入力されるか、空白になります。これは、特定のレポートのコンテキストでは、レポートするデータがないことを意味します。通常、null は、特定のレポートおよびアプリタイプのコンテキストでこの項目に値が入力されないことを意味します。空白（""）は、この項目がこのコンテキストに関連しているものの、入力するデータが見つからなかったことを意味します。 制限付きメディアソースの場合、制限された項目の内容は null になります。 一般的に、nullとブランクは同じものであり、利用可能なデータはありません。 タイムゾーンと通貨 アプリ固有のタイムゾーンと通貨設定は、Data Locker に書き込まれるデータには影響しません。次のことが当てはまります。
カンマを含む値：これらのカンマは、二重引用符「"」の間に含まれます。例： |
|
ストレージオプション
- データは、AWS、GCS、BigQuery のように、選択したストレージ所有者に書き込まれます。
- ストレージの選択はいつでも変更できます。
- ストレージを変更すると、次のことが起こります。
- 新しく選択したストレージへの書き込みは1時間以内に開始します。
- 7日間の移行期間中、既存のストレージへの書き込みを続行します。移行期間の有効期限がユーザーインターフェイスに表示されます。移行期間を使用して、データ読み込みプロセスを更新してください。
- バケットの変更：ストレージを変更した場合、7日間の移行期間中はデータは両方のバケットに送信され、データ取り込みプロセスを調整できます。
| パートナー所有のストレージ(GCS、AWS、BigQuery) | |
|---|---|
| バケット名 |
例： |
| ストレージの所有者 | パートナー |
| ストレージプラットフォーム | 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のパートナーアカウントでログインしてください。
- 以下に移動します：
-
広告主：レポート > Data Locker
- マーケティングパートナー： アカウントメニュー > Data Lockerをクリックします。
-
広告主：レポート > Data Locker
- DataLockerのセットアップ手順のステップ3〜16に従ってください。
追加情報
特性と制限
| 特性 | 備考 |
|---|---|
| アプリ固有のタイムゾーン | 不適用 |
| アプリ固有の通貨 | サポートされていません |
| サイズ制限 | 不適用 |
| データ更新頻度 | データは、この記事内に記載されている個々のレポートデータの更新頻度に従って更新されます。 |
| 過去データ |
サポートされていません |
| チームメンバーアクセス | チームメンバーは、管理画面上で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.