Data Locker：連携済みパートナー向け

• バケット内の最上層のフォルダはストレージサービスによって異なります。
• data-locker-hourlyのフォルダには、レポートトピックが含まれています。 

バケット所有者とクラウドプロバイダー毎のフォルダ構成の例：

• 独自のAWSバケット: <af-datalocker-your bucket prefix>/<generated-home-folder><subscription-id>
• 独自のGCSバケット: <your bucket name>/<generated-home-folder>/<subscription-id>

これはデータの日付に関連します。ほとんどの場合、これはイベントが発生した日時を意味します。

h フォルダはAppsFlyerがデータを受信した時刻に紐付けられています。例えば、インストールイベントを 14:00-15:00 UTC に受信した場合、h=14 ファイルにストリーミングされます。
注意！AppsFlyerにデータが到着してから、h フォルダがData Lockerに書き込まれるまで、約6時間のタイムラグがあります。例えば、h=14のフォルダは、6時間の23:00 UTCに書き込まれます。 

フォルダの特性：

• 0〜23の番号が付いた24個の h フォルダがあります。例えば、h=0, h=1などです。 
• また、Lateというフォルダも存在し、こちらには午前0時以降に到着した前日のイベントが含まれます（つまり、翌日 00:00–02:00 UTCの間に到着したものです）。例えば、ユーザーが月曜日の08:00 UTCにアプリをインストールし、イベントが火曜日の01:00 UTCに到着した場合です。このイベントは月曜日のLateフォルダに記録されます。 
• 02:00以降に到着したデータは、実際の到着日時のフォルダに記録されます。 
• lateフォルダのデータも必ず確認し、利用してください。これらのデータは他の h フォルダには含まれていません。
• _temporary フォルダ：場合によっては、hフォルダ内に一時的なフォルダを生成する場合があります。一時フォルダとサブフォルダは無視してください。例： /t=impressions/dt=2021-04-11/h=18/_temporary

全アプリに関するデータは、統合したデータファイルで提供されます。データを取り込む際には、行単位でapp_idの項目を使用してアプリを区別してください。

データファイルの例は、h=2 フォルダをご覧ください

• データの取り込みプロセスでは、以下のことに注意してください：
  • _SUCCESS フラグが設定された後にのみ、データを取り込んでください。
  • フォルダの全てのファイルに.gzの拡張子が付いた状態でデータを取り込んでください。

最終ファイル（完了）フラグは、対象の h フォルダの全てのデータが書き込まれたあとに設定されます。

• _SUCCESS フラグが存在していることを確認してから、h フォルダ内のデータを読み込んでください。

• _SUCCESSのフラグは、対象フォルダ内に書き込むデータが内(=空)の場合にも設定されます。

ファイルはgzを使って圧縮されます。
ファイルの解凍後：

• このファイルには拡張子はありません。
• 各ファイルには列（項目）名を含むヘッダー行があります。

レポート項目の順序は常に同じです。新しい項目が追加される場合には、常に既存項目の右端に追加されます。 

カラム(フィールド)の定義は、レポート毎に異なります。各内容については、関連するレポートのヘルプページを参照してください。

空白または空のフィールド：
一部の項目には nullが入力されるか、空白になることがあります。これは、対象のレポートではレポートするデータがないことを意味します。通常、null は、対象のレポートおよびアプリタイプにおいて、この項目に値が入力されないことを意味します。空白（""）は、この項目が対象レポートには関連しているものの、入力するデータが見つからなかったことを意味します。 

タイムゾーンと通貨設定：

アプリ毎に管理画面上で設定されているタイムゾーンと通過設定は、Data Lockerに書き込まれるデータでは無視されます。代わりに、以下仕様が適用されます：

• タイムゾーン：日付と時間のデータはUTCベースで記録されます。
• 通貨設定：event_revenue_usdの値が常にUSDベースで記録されます。

カンマを含む値：これらのカンマは、二重引用符「"」の間に含まれます。例： `"iPhone6,1"`

最終ファイル（完了）フラグは、対象の h フォルダの全てのデータが書き込まれたあとに設定されます。

• _SUCCESS フラグが存在していることを確認してから、h フォルダ内のデータを読み込んでください。

• _SUCCESS フラグは、特定のフォルダに書き込むデータがなく、フォルダが空である場合にも設定されます。

• 注！アプリごとの分離オプションでは、フラグは各アプリフォルダごとではなく、h フォルダ内で設定されます。前のセクションの図を参照してください。

• データは、Snappy または GZIP圧縮ファイル、もしくはParquet 形式またはCSV形式の非圧縮ファイルで提供されます。
• 解凍後のデータファイルは、設定に応じてParquetまたはCSV形式で出力されます。

CSVファイルの場合、レポート項目の順序は常に同じです。新しい項目が追加される場合は、既存項目の右側に追加されます。

この点に関して：

• ユーザー経路レポートの列の構成は同じです。つまり、異なるレポートタイプに対して同様のデータ読み込み手順を実行できます。レポートに含める項目を選択してください。項目の意味は、ローデータ項目の手引きに詳述されています。
• レポート可用性セクションで、FFと表示されているレポートは、共通の列構造ではありません。

空白または空の項目：一部の項目には null が入力されるか、空白になります。これは、特定のレポートのコンテキストでは、レポートするデータがないことを意味します。通常、null は、特定のレポートおよびアプリタイプのコンテキストでこの項目に値が入力されないことを意味します。空白（""）は、この項目がこのコンテキストに関連しているものの、入力するデータが見つからなかったことを意味します。

制限付きメディアソースの場合、制限された項目の内容は null になります。 

一般的に、nullとブランクは同じものであり、利用可能なデータはありません。 

タイムゾーンと通貨

アプリ固有のタイムゾーンと通貨設定は、Data Locker に書き込まれるデータには影響しません。次のことが当てはまります。

• タイムゾーン：日付と時間はUTCで入力されます。
• 通貨：event_revenue_usd の項目は米ドルです。

カンマを含む値：これらのカンマは、二重引用符「"」の間に含まれます。例： `"iPhone6,1"`

• GCS：制限なし
• AWS：ご自身で設定してください。その際、必ず文頭にaf-を追加してください。

例：af-datalocker-your-bucket-name

御社がストレージを管理します： 

• AWS：AppsFlyerは、バケットへのGetObject、ListBucket、DeleteObject、PutObject の権限が必要です。バケットはAppsFlyer専用にする必要があります。他の用途には使用しないでください。
• GCS