広告主様向けData Locker

概要:Data Lockerはレポートデータをクラウドストレージに書き込み、広告主のBIシステムに読み込むことができます。さまざまなストレージオプションを提供しているため、AppsFlyer所有のAWSバケットか、広告主が所有するAWSもしくはGCSのバケットを選択できます。データはParquetまたはCSVのいずれかの形式で提供されます。

6133DataLockerForAdvertisers.png

Data Lockerの新機能

  • Parquet: 2021年9月3日より、データ形式をCSVとParquetから選択できるようになりました。現在、CSV形式でデータを取得しており、Parquet形式を試してみたいという方は、CSMまたは hello@AppsFlyer.com にご連絡ください。限られたテスト期間中に、お客様のデータを両方の形式でお届けします。
  • 保存期間:2021年11月1日以降、AppsFlyerが所有するバケット内のデータは14日後に削除されます(従来は30日間でした)。注:これはお客様が所有するバケットには適用されません

関連記事:適切なデータ配信ツールの選択

Data Locker

Data Locker にて、クラウドストレージに格納するデータに含めたいアプリ、メディアソース、イベント、レポートを選択してください。データは、ストレージから独自のBIシステムにプログラムで読み込んでください。

Data Locker—機能

機能 説明
ストレージオプション(クラウド)

いくつかのストレージオプションが利用できます。いつでもオプションを変更できます。オプションの違いは、クラウドサービスプロバイダーとバケットの所有者です。利用できるオプションは次のとおりです。

複数アプリ 

アカウント内の1つ、複数、または全てのアプリのデータを送信します。アカウントにアプリを追加したときに、それらを自動的に含めることができます。

データの分離

 

利用可能なデータ分離オプション

  • [デフォルト] 統合:全てのアプリのデータが統合されます。データファイル内のアプリを特定するために、行レベルでアプリID項目が使用されます。
  • アプリごとの分離:各アプリのデータが別々のフォルダに格納されます。フォルダ名はアプリIDで構成されます。
データ形式のオプション
  • CSV
  • Parquet
最後のデータ更新

更新頻度はレポートタイプによって異なります

  • 毎時:データは継続的に生成されます。例えば、インストールとアプリ内イベントデータは、イベントがAppsFlyerに到着してから数時間以内に書き込まれます。
  • 毎日:アンインストールなどの一部のレポートは毎日生成され、翌日に利用できます。
Data Locker固有のレポート
  • 未変換データ:ユーザー獲得とリターゲティングキャンペーンのクリックとインプレッションデータ。クリックとインプレッションについて
  • SKANローデータは、Data Lockerをサブスクライブしなくても、独自ストレージにて利用できます。
データファイルの例

クリックインストールアプリ内イベント 

Big queryとGoogle Data Studio

GCSストレージにデータを書き込んだ場合、Big Queryは中間処理なしでData Lockerファイルを直接読み込むことができます。Google Data Studioなど、Big Query以外の他のツールを使って、データを視覚化することができます。

レポート—ユーザージャーニー

レポートタイプの説明については、ユーザー経路のレポートを参照してください。

 
カテゴリ レポートの種類 (topic) データの更新頻度* オーガニック/非オーガニック Data Locker固有
ユーザー獲得 クリック 6時間遅れ N/A
リターゲティング クリック 6時間遅れ N/A
ユーザー獲得 インプレッション 6時間遅れ N/A
リターゲティング インプレッション 6時間遅れ N/A
ユーザー獲得 インストール 6時間遅れ どちらも  
ユーザー獲得 アプリ内イベント  6時間遅れ どちらも  
ユーザー獲得 非オーガニックインストールに紐づくアプリ内広告収入 毎日+2 非オーガニック  
ユーザー獲得 オーガニックインストールに紐づくアプリ内広告収入 毎日+2 オーガニック  
リターゲティング リターゲティング広告に紐づくアプリ内広告収入 毎日+2 非オーガニック  
リターゲティング コンバージョン 6時間遅れ 非オーガニック  
リターゲティング In-app events 6時間遅れ 非オーガニック  
リターゲティング Sessions 6時間遅れ どちらも
ユーザー獲得 Sessions 6時間遅れ どちらも
ユーザー獲得 アンインストール 毎日-アンインストール 非オーガニック  
ユーザー獲得 オーガニックアンインストール 毎日-アンインストール オーガニック  
リインストール リインストール 6時間遅れ 非オーガニック  
リインストール オーガニック再インストール 6時間遅れ オーガニック  

6時間のタイムラグ:

  • データは到着時間別にフォルダに分離されます。
  • これは、イベントがData Lockerで利用できるようになった時間です。
  • ラグタイムは、アプリ固有のタイムゾーンとは関係ありません。

毎日 - アンインストール:

  • アンインストールデータは毎日処理されます。
  • 通常 10:00-12:00 UTC までに利用可能になります。
  • ほとんどの場合、h=2 フォルダーに書き込まれます。つまり、h=2 フォルダには、前日に報告されたアンインストールが含まれています。ただし、データはその後のフォルダに書き込まれる場合もあります。よってインポート処理では、アンインストールフォルダの全てのフォルダのデータを読み込んでください。つまり、これには h=1–24 と h=late フォルダが含まれます。例えば、月曜日に生成されたデータのレポートは、火曜日の h=2 フォルダにあります。データは、火曜日の10:00 UTC 以降に利用できるようになります。

毎日+2:広告収益データは、2日後に利用できるようになります。つまり、月曜日に生成されたデータは、水曜日の 06:00 UTC以降に、月曜日の h=23 フォルダにて利用可能になります。

レポート—アプリケーション

Protect360レポート
レポートの種類 (topic) データの更新頻度*
ブロック済みインストール 6時間遅れ
ブロックされたアプリ内イベント 6時間遅れ
ブロック済みクリック 6時間遅れ
[AG*] アトリビューション後のインストール 毎日
SKAN [自社のバケットにデータを送信する場合、Data Lockerのサブスクリプションは必要ありません]
データ更新頻度:毎日
レポートの種類 (topic)
[FF*] ポストバック
[FF*] ポストバックのコピー(iOSからAppsFlyerに直接送信される)
[FF*] インストール
[FF*] 再ダウンロード
[FF*] アプリ内イベント
ピープルベースドアトリビューションレポート
データ更新頻度:毎日
レポートの種類 (topic)
[FF*] Webサイト訪問
[FF*] webサイトイベント
[FF*] Webサイトアシストインストール
[FF*] コンバージョン経路
 * 略語の意味

[FF] レポート項目はAppsFlyerによって固定されています。これらは、レポートに含めるように選択した項目とは関係ありません。

[AG] 代理店の運用媒体データはサポートされていません。

6時間のタイムラグ:

  • データは到着時間別にフォルダに分離されます。
  • これは、イベントがData Lockerで利用できるようになった時間です。
  • ラグタイムは、アプリ固有のタイムゾーンとは関係ありません。

毎日

  • レポートは h=23 フォルダに書き込まれます。
  • これらのレポートは、通常翌日の h=23フォルダ内にて10:00-12:00 UTC までに利用できるようになります。
  • 例えば、月曜日に生成されたデータのレポ―トは、月曜日の h=23 フォルダにあります。データは、火曜日の10:00 UTC 以降に利用できるようになります。

データストレージのアーキテクチャ

概要

各種データは、選択したストレージオプションに書き込まれます。ストレージは、AppsFlyerが所有するAWSか、広告主が所有するAWSまたはGCSです。ストレージオプションは、いつでも別のオプションに変更できます。変更は数時間以内に完了します。

ストレージ内のデータは、レポートのタイプ、日付、および時刻に従って、階層的なフォルダ構造で編成されます。次の図は、この構造の例を示しています。

DLFolderOVerview.png

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

  • 時間フォルダの数は、レポートデータの更新頻度 (毎時または毎日) によって異なります。
  • データはGZ圧縮ファイルで、ParquetまたはCSV形式で提供されます。
  • データファイルは列(項目)で構成されています。
  • 主要な計測レポートの列構成は同じです。つまり、異なるレポートタイプに対して同様のデータ読み込み手順を実行できます。提供されるデータに含まれる実際の項目 (列) は、広告主側で選択します。 
  • FFで指定されたレポート は、独自の列構造を持っており、お客様が設定することはできません。

フォルダの構成

フォルダ 説明
data-locker-hourly

DLHourly.png

  • バケットの上階層のフォルダはストレージ所有者とプロバイダーによって異なります。
  • data-locker-hourly フォルダにはレポートトピックが含まれています。これより上層部のフォルダ階層は、バケット所有者とクラウドサービスプロバイダによって異なります。

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

  • AppsFlyerバケット: <af-ext-reports>/<unique_identifier>/<data-locker-hourly>
  • 独自のAWSバケット: <af-datalocker-your folder name>/<data-locker-hourly>
  • 独自のGCSバケット: <data-locker-hourly>
t (topic) レポートタイプはレポートの主題に関連します。
dt (date)

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

h (hour)

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

フォルダの特性

  • 0–23の番号が付いた24のhフォルダがあります。例えば、h=0、h=1 などです。 
  • h=late という遅延フォルダには、深夜以降に到着した前日のイベントが含まれています。つまり翌日の 00:00–02:00 UTC に到着したイベントを指します。例えば、ユーザーが月曜の08:00 UTC にアプリをインストールし、イベントが火曜日の 01:00 UTCに到着した場合、このイベントは月曜の遅延フォルダに書き込まれます。
  • UTCの02:00以降に到着したデータは、実際の到着日時のフォルダに書き込まれます。
  • h=late フォルダ内のデータが取り込まれていることを確認してください。これらのデータは他のフォルダには含まれていません。
  • _temporary フォルダ場合によっては、hフォルダ内に一時的なフォルダを生成する場合があります。一時フォルダとサブフォルダは無視してください。例: /t=impressions/dt=2021-04-11/h=18/_temporary

UTCタイムゾーンを使用しないアプリでの毎時レポートに関する検討事項

その日の全てのデータを確実に取得するには、次に説明するとおり、アプリのタイムゾーンで定義された日に合わせてフォルダを消費する必要があります。

  • 東半球のタイムゾーン:その日付のデータをすべて取得するには、UTCの日時に合わせてフォルダを消費する必要があります。例:アプリのタイムゾーンはUTC+10(オーストラリアのシドニー)です。火曜(シドニー現地時刻)に関連する全ての時間ごとのデータを取得するには、以下のフォルダを消費する必要があります:月曜日 h=14–23 と late、火曜日 h=0–13 と 14-15。火曜日の h=14-15 を消費しなければならない理由は、一部のデータが遅延して到着することがあるためです。そのため、h=14-15のフォルダには、遅延のあったイベントが含まれることがあります。event_time でフィルタをかけ、UTCを基準としたアプリのカレンダーの日に合わせる必要があります。
  • 西半球のタイムゾーン:その日付のデータをすべて取得するには、UTCの日時に合わせてフォルダを消費する必要があります。例:アプリのタイムゾーンはUTC-7(ロサンゼルス)です。火曜(ロサンゼルス現地時刻)に関連する全ての時間ごとのデータを取得するには、以下のフォルダを消費する必要があります:火曜日 h=7–23、水曜日 h=0–6 と 7-8。水曜日の h=7-8 を消費しなければならない理由、一部のデータが遅延して到着することがあるためです。そのため、h=7-8のフォルダには、遅延のあったイベントが含まれることがあります。event_time でフィルタをかけ、UTCを基準としたアプリのカレンダーの日に合わせる必要があります。

アプリの分離

データは、選択した全てのアプリのデータを含む統合データファイル、またはアプリごとに分かれたファイルで提供されます。アプリごとの分離は、次の表で示すとおり、hフォルダ内で行われます。
分離タイプ 説明
[デフォルト] 統合

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

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

UnifiedByApp.png

データファイルの命名規則は次の通りです:part-nnnnn.gz。

  • nnnnn はパート番号です。例えば、part-00000、part-00001、part-00002などです。この命名構造は、今後変更される可能性があります。
  • 数値は必ずしも連続しているとは限りません。
  • データの取り込みプロセスでは、以下のことに注意してください:
    • _SUCCESS フラグが設定された後にデータを取り込んでください。
    • フォルダ内の .gz 拡張子の付いた全てのファイルを読み込んでください。パート番号のロジックを使用したインポートプロセスは構築しないでください。
アプリごとに分離

フォルダにはアプリごとのサブフォルダが含まれています。特定のアプリのデータファイルは、アプリフォルダ内に含まれています。次の図では、h=19 フォルダにアプリフォルダが含まれています。各アプリフォルダには関連するデータファイルが含まれています。

DLSegregateByApp.png

各アプリのフォルダでの命名規則:part-nnnnn-string.csv.gz

  • nnnnn はパート番号です。例えば、part-00000、part-00001、part-00002などです。この命名構造は、今後変更される可能性があります。
  • 数値は必ずしも連続しているとは限りません。
  • データの取り込みプロセスでは、以下のことに注意してください:
    • _SUCCESS フラグが設定された後にデータを取り込んでください。
    • フォルダ内の .gz 拡張子の付いた全てのファイルを読み込んでください。パート番号のロジックを使用したインポートプロセスは構築しないでください。

制限事項:このオプションはピープルベースドアトリビューションレポートでは利用できません。

データファイル

コンテンツ 詳細
完了フラグ

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

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

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

  • 注!アプリごとの分離オプションでは、フラグは各アプリフォルダごとではなく、h フォルダ内で設定されます。前のセクションの図を参照してください。
ファイルの種類
  • 解凍後、パーツファイルは GZ を使用して
  • 解凍後のデータファイルは、設定に応じてParquet形式またはCSV形式で出力されます。
列の並び(CSVファイル)

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

この点に関して:

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

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

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

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

タイムゾーンと通貨

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

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

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

データファイルは分離タイプにより異なります。

ストレージオプション

 警告!

広告主が所有するストレージオプションを使用する場合:

  • GDPR等のデータプライバシー規制とアドネットワーク/SRNのデータ保持ポリシーに準拠していることをご確認ください。
  • 広告主所有のストレージソリューションを使用して第三者にデータを送信しないでください。
  • データは、選択したストレージ所有者に次のように書き込まれます。
    • AppsFlyerストレージ
    • 顧客のストレージ—AWSまたはGCS
  • ストレージの選択はいつでも変更できます。
  • ストレージを変更すると、次のことが起こります。
    • 新しく選択したストレージへの書き込みは1時間以内に開始します。
    • 7日間の移行期間中、既存のストレージへの書き込みを続行します。移行期間の有効期限がユーザーインターフェイスに表示されます。移行期間を使用して、データ読み込みプロセスを更新してください。必要に応じて移行期間を再開したり、AppsFlyerのバケットに戻したりすることができます。
    • バケットの変更:ストレージを変更した場合、7日間の移行期間中はデータは両方のバケットに送信され、データ取り込みプロセスを調整できます。
  AppsFlyer所有ストレージ (AWS)  広告主所有ストレージ (GCSまたはAWS)
バケット名 AppsFlyerが設定します
  • GCS:制限なし
  • AWS:広告主が設定します。「af-datalocker-」という接頭辞が必要です。

例:af-datalocker-your-bucket-name

ストレージの所有権 AppsFlyer 広告主
ストレージプラットフォーム AWS AWS または GCS
データへアクセスするための認証情報 アカウント管理者がData Locker画面から確認できます AppsFlyerには開示されません。ストレージプロバイダーから提供される認証情報を使用してください。
データ保持 データは14日後に削除されます。 広告主の責任
データ削除リクエスト AppsFlyerの責任です 広告主の責任
セキュリティ AppsFlyerがストレージを管理します。顧客は読み込み専用アクセスがあります。

広告主がストレージを管理します。

  • AWS:AppsFlyerは、バケットへのGetObject、ListBucket、DeleteObject、PutObject の権限が必要です。バケットはAppsFlyer専用にする必要があります。他の用途には使用しないでください。
  • GCSGCS設定に関する記事をご覧ください。
ストレージ容量 AppsFlyerが管理します 広告主が管理
バケットポリシーでVPCエンドポイントを使用したアクセスコントロール 不適用 [オプション] AWSで、バケット単位でVPCエンドポイントセキュリティを実装している場合、AppsFlyerサーバーを許可リストに追加する必要があります。
SKANレポート Data Lockerのサブスクリプションが必要 ローデータをサブスクリプションしている場合に利用できます。つまり、Data Lockerをサブスクリプションする必要はありません。

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

注意事項:

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

手順

Data Lockerの設定

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

広告主が所有するストレージ設定の前提条件:

広告主所有のストレージ、つまりユーザーが所有するバケットを使用して Data Locker を設定する場合は、次のいずれかの手順を実行してください。

  • 御社のAWSのバケット
  • 御社のGCSのバケット

注!Data Locker のサブスクリプションをお持ちでなく、SKAdNetworkデータにのみアクセスする場合は、広告主所有のストレージ手順を完了する必要があります。

AppsFlyerAdmin_us-en.png Data Lockerの設定方法:

  1. アドミンが設定を実行する必要があります。
  2. AppsFlyerにて、インテグレーション > Data Locker へ進みます。 
  3. クラウドサービスのデータ保存先の選択してください。次のいずれかを実行してください:
    • AppsFlyer AWSバケットを選択してください。ステップ4に進みます。
    • 独自のAWSバケットを選択してください。
      1. AWSバケット名を入力してください。接頭辞 af-datalocker- は入力しないでください。
      2. [Test] をクリックします。
      3. バケットパスが無効であることを示すエラーメッセージなどが表示されないことを確認します。
    • 独自のGCSバケットを選択し、GCSバケット名を入力し、最後にテストをクリックしてください。
  4. フォルダ構成(データ分離)を選択してください。
    • [デフォルト] 統合
    • アプリごとに分離。
  5. ファイル形式を選択してください:
    • [デフォルト] Parquet
    • CSV。 
  6. 必要なアプリを選択してください。全てを選択すると、将来追加されるアプリも自動的に含まれます。
  7. [Apply] をクリックします。
  8. [オプション] メディアソース:レポートに含めたい1つまたは複数のメディアソースを選択します。
    • デフォルト=すべて。今後新たに追加されるメディアソースも自動的に追加されます。
  9. 必要なレポートタイプを選択してください。少なくとも1つ選択する必要があります。
  10. [オプション] アプリ内イベント:含めたいアプリ内イベントを選択します。アプリ内イベントの種類が100個を超えている場合には、検索することはできませんので、名前を正確に入力して選択してください。
    • デフォルト=すべて。今後新たに追加されるアプリ内イベントも自動的に追加されます。
  11. [Apply] をクリックします。
  12. [オプション] Field(項目):レポートに含める項目を選択します。:場合によっては追加項目が利用できる場合があります。データインポートプロセスでこのことを考慮してください。
  13. Save Configuration(設定を保存)をクリックします。次のうちいずれかが発生します:
    • AppsFlyer AWSバケットを選択した場合:
      • 専用のAWSバケットが作成されます。バケットの認証情報が表示されます。
      • バケットはこの認証情報を使用してアクセスできます。認証情報は、バケットへの読み取り専用アクセスを提供します。
    • カスタマーバケットを選択した場合:データは独自のバケットに3時間以内に書き込まれます。

認証情報のリセット

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

AppsFlyerAdmin_us-en.png 認証情報をリセットする方法:

  1. AppsFlyerにて、インテグレーション > Data Locker へ進みます。 
  2. 認証情報セクションにて、Reset credentials.をクリックします。
    確認画面が表示されます。
  3. Reset(リセット)をクリックします。
  4. Credentials successfully reset(認証情報が正常にリセットされました)とメッセージが表示されるまで待ちます(約20秒間)。更新された認証情報が利用できます。

追加情報

特徴と制限

特徴
特徴 備考
Ad Networks アドネットワークは使用できません
代理店 代理店アカウントでは使用できません。
アプリ固有のタイムゾーン 適用されません。Data Lockerフォルダは、UTCを使用して時間に分割されます。実際のイベントは、UTCで時刻が刻まれます。必要に応じて、他のタイムゾーンに時刻を変換します。アプリのタイムゾーンに関係なく、イベント発生からData Lockerに記録されるまでの遅延は変わらず、6時間です。
アプリ固有の通貨 サポートされていません
サイズ制限 不適用
最後のデータ更新 データは、この記事内に記載されている個々のレポートデータの更新頻度に従って更新されます。
ヒストリカルデータ サポートされていませんイベントデータは、Data Lockerの構成後に送信されます。過去のデータが必要な場合は、Pull APIを使用してください。
チームメンバーアクセス チームメンバーアカウントはData Lockerを構成できません。
単一アプリ / 複数アプリ 複数アプリのサポート。Data Lockerはアカウントレベルでのサービスです。

トラブルシューティング

  • 症状:AWS CLIを使用してデータを取得できない
  • エラーメッセージ:ListObjectsV2 操作を呼び出す時にエラーが発生 (AccessDenied) しました:Access Denied
  • 原因 :使用されているAWS認証情報がAppsFlyerバケットの正しい認証情報ではありません。これは、複数または無効な資格情報が原因の可能性があります。
  • 解決法
    1. Cyberduck などの別の方法、つまりCLI以外を使用してバケットにアクセスしてください。これにより、使用している資格情報が機能していることを確認してください。Cyberduckを使用して接続できる場合は、資格情報キャッシュに問題があることを示しています。
    2. AWS認証情報キャッシュを更新してください
      AWSのスクリーンショット mceclip0.png 

AWS データの取得

AWS CLIや次のセクションで説明するツールのいずれかのAWSデータ取得ツールを使用してください。注!正確な手順は、AppsFlyerが所有するバケットに適しています。独自のバケットに接続する場合は、必要に応じて手順を調節してください。

AWS CLI

はじめに:

  • コンピューターに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

はじめに:

  • Cyberduckクライアントをインストールしてください。
  • AppsFlyerで、Data Lockerに移動し、資格情報パネルに含まれる情報を取得します。

Cyberduckの設定方法

  1. Cyberduckで、[Action]をクリックしてください。
  2. New Bookmark を選択します。以下の画面が表示されます:
  3. 最初のフィールド(次のスクリーンショットでは [1] とマークされています)で、[Amazon S3] を選択します。

    DataDuckSmall2.png

  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ブラウザー

はじめに:

  • Amazon S3ブラウザをインストールします。
  • AppsFlyerで、Data Lockerに移動し、資格情報パネルに含まれる情報を取得します。

Amazon S3ブラウザを設定するには

  1. S3 ブラウザにて、Accounts > Add New Account をクリックします。
    新しいアカウントの追加ウィンドウが開きます。

    mceclip0.png

  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] をクリックします。
    外部バケットの追加ウィンドウが開きます。

    mceclip2.png

  5. バケット名を入力します。バケット名の形式は {Bucket Name} / {Home Folder} です。バケット名とホームフォルダに必要な値は認証情報ウィンドウに表示されます。
  6. [Add External bucket] をクリックします。
    バケットが作成され、ウィンドウの左側のパネルに表示されます。
    これで、Data Lockerファイルにアクセスできます。
この記事は役に立ちましたか?