• レポートは、コストETLに含まれる全てのアプリを対象に、1日あたり、バッチごとに配信されます。
• データがバケットに書き込まれるたびに（1日4回）、過去6日間および、14日目、29日目、88日目の履歴、更新、修正を含む、すべての利用可能なデータが記入されます。データ格納プロセスでは、この点を考慮してください。
• レポート構造の詳細については、ファイル項目の表をご確認ください。構造は次のとおりです。
  • サマリーレポートは、より簡単かつ迅速に取り込めるよう粒度が低くなっています。
  • ディメンションレポートには、常に含まれているプライマリーディメンションが含まれています。つまり全てのメディアソースで利用できるディメンションがこのレポートに含まれています。一方、メディアソースが主要なディメンションデータを提供していない場合、そのデータは特定のディメンションレポートには含まれません。セカンダリーディメンションが利用可能な場合は、これらも含まれていますが、これらは常に含まれているものではありません。
  • 利用可能なプライマリー（保証）は次のとおりです：
    
    • 地域：国別にグループ化されたデータ
    • チャネル：メディアソースのチャネル。例えば、Googleでいう「YouTube」、Facebookでいう「Instagram」等
  • ビジネスニーズに最も適したディメンションを使用してください。メディアソースにより可用性が異なる場合があります。

• Bucketに書き込まれたデータは、ディレクトリとファイル構造が記述されています。サンプルファイルを見る
  注意： 提供されたサンプルはExcelファイルです。Cost ETLファイルはparquetファイルとしてあなたのバケットに送信されます。
• Cost ETL がディレクトリへの書き込みを完了すると、 success ファイルが作成され、フラグが設定されます。これは、常にディレクトリ内の最新のタイムスタンプとなります。
• データが書き込まれるたびに、当日と過去6日間（記事内では7日間分のデータと記載されています）、および14日間、29日間、88日間のデータが含まれます。
• フォルダ／ファイル数は、次のとおりです。
  
  • サマリー：1日あたり4つのバッチフォルダ。
    • 各バッチフォルダには、7日間のデータを含むParquetファイルが含まれています。
  • ディメンション：常に含まれる各ディメンションには、1日あたり4つのバッチフォルダが含まれています。
    • 各バッチフォルダには、番号付けが1から始まるデータを含むParquetファイルが含まれています。

ディレクトリ構造の例

ディレクトリ構造

/<advertiser bucket name>/cost_etl/version/dt=<yyyy-mm-dd>/b=<n>/
<dimension>/<file name>

ディレクトリ構造

ファイル名の構造 

part-<number>

ファイル／ディメンション

指標

この設定手順は、アドミン（管理者）ユーザが行う必要があります。

はじめる前に

• コストETLの設定には、独自のAWSバケットの設定（そしてそれにAppsFlyerがデータを書き込む権限の付与）、およびAppsFlyerでのコストETL設定が必要です。
• コストETLの設定を完了するには、AWSアドミン権限とAppsFlyer管理画面へのアクセス権限の両方が必要です。
• セットアップ中は、AWSとAppsFlyerの両方にタブを開いたままにしておいてください。
• 注：KMSバケット暗号化はAppsFlyerではサポートされていません。 

AWSバケットとコストETLの設定方法：

1. AWSコンソールにサインインします。
2. S3サービスへ進みます。
3. バケットの作成方法：
   1. Create bucketをクリックしてください。
   2. バケット名を次の通り入力してください：必須のpredix af-xpend-cost-etl-<af-account-id>- で始め、この後にフリーテキストのサフィックスを追加してください。
      • 御社の af-account-id は次の手順7-9に示すように、AppsFlyer管理画面で見つけることができます。
      • Amazon S3バケットの命名要件を参照してください。
   3. Create bucketをクリックしてください。
4. AppsFlyerにて、インテグレーション > コストETLへ進みます。
5. コストETLを有効にしてください。
6. レポートスケジュールにて、最初のレポートを受信するタイミングを選択してください。その後のレポートは、その後約6時間間隔で到着します。
7. Amazon S3の設定に進みます。
   

   

8. ドロップダウンメニューから、S3バケットの地域を選択してください。対象の地域が表示されない場合は、CSMまでお問合せください。
9. Amazon S3バケット名を入力してください。
10. 次へ をクリックします。
    バケットポシリーのコードスニペットが表示されます。
    

    

11. バケットポリシーのコードスニペットをコピーし、AWSの設定画面に貼り付けてください。
    1. AWSにて、コストETL用に作成したバケットを選択してください。
    2. 権限タブへ進んでください。
    3. Bucket policy セクションにて、Edit（編集）をクリックしてください。
    4. バケットポリシー画面が開きます。
    5. バケットポリシースニペットを画面に貼り付けてください。
12. AppsFlyerのコストETL設定にて、次へをクリックしてください。
    バケットの検証ステップが表示されます。
    
13. 検証をクリックしてください。
    検証が成功しましたというメッセージが表示されることを確認してください。
14. [次へ] をクリックします。
15. 1つ以上または全てのアプリを選択してください。  全て を選択すると、今後追加したアプリが自動的に含まれるようになります。
16. 適用をクリックしてください。 
17. 少なくとも常に含まれるディメンションを一つ選択してください：チャネルおよび／または地域。
18. 少なくとも追加のディメンションを1つ選択してください。
    

    

19. レポートに含まれる指標を少なくとも1つ選択してください。
    

    

20. 適用をクリックしてください。

この設定手順は、アドミン（管理者）ユーザが行う必要があります。

はじめる前に

• コストETLの設定には、独自のAWSバケットの設定（そしてそれにAppsFlyerがデータを書き込む権限の付与）、およびAppsFlyerでのコストETL設定が必要です。
• コストETLの設定を完了するには、AWSアドミン権限とAppsFlyer管理画面へのアクセス権限の両方が必要です。
• セットアップ中は、AWSとAppsFlyerの両方にタブを開いたままにしておいてください。

GCSバケットとCost ETLをセットアップする：

1. GCSコンソールにサインインします。
2. バケットを作成します。
   バケットに以下のような名前をつけます。
   • 必須のprefix af-xpend-cost-etl-<af-account-id>- で開始し、フリーテキストでサフィックスを追加します。
   • 御社の af-account-idは、次の手順6-8に示すように、AppsFlyer管理画面で見つけることができます。
   • 参照：GCS バケットの命名要件
3. AppsFlyerにて、インテグレーション > コストETLへ進みます。
4. コストETLを有効にしてください。
5. レポートスケジュールにて、最初のレポートを受信するタイミングを選択してください。その後のレポートは、その後約6時間間隔で到着します。
6. データ保存先 (Data destination) にアクセスし、 Google Cloud Storage (GCS) バケット を選択します。
7. GCSバケット名を入力します。
8. 次へ をクリックします。
   GCSの権限設定に使用する、AppsFlyerのサービスアカウントが表示されます。
9. GCS コンソールで、バケットの IAM パーミッション を設定します。

   1. AppsFlyerのサービスアカウントをCost ETLバケットのプリンシパルとして追加します。

   2. Storage Object Admin のロールを割り当てます。
10. AppsFlyerのコストETL設定にて、次へをクリックしてください。
    バケットの検証ステップが表示されます。
    
11. 検証をクリックしてください。
    検証が成功しましたというメッセージが表示されることを確認してください。
12. [次へ] をクリックします。
13. 1つ以上または全てのアプリを選択してください。  全て を選択すると、今後追加したアプリが自動的に含まれるようになります。
14. 適用をクリックしてください。 
15. 少なくとも常に含まれるディメンションを一つ選択してください：チャネルおよび／または地域。
16. 少なくとも追加のディメンションを1つ選択してください。
    

    

17. レポートに含まれる指標を少なくとも1つ選択してください。
    

    

18. 適用をクリックしてください。

AWSでは、デフォルトで、AppsFlyerがオブジェクトをバケットに書き込む場合、そのオブジェクトのオーナーはAppsFlyerです。データ取り込みプロセスによっては、デフォルトの所有権をあなた（バケット所有者）に変更する必要がある場合があります。

自社バケットのオブジェクトの所有権を変更する方法：

1. AWS Management Consoleにサインインし、Amazon S3 console https://console.aws.amazon.com/s3/を開いてください。

2. Bucketsリストにて、S3 Object Ownershipを有効にしたいバケット名を選択してください。

3. 権限タブへ進んでください。

4. Object Ownership で Edit をクリックしてください。

5. Bucket owner preferred を選択してください。

6. 保存 をクリックしてください。

データを取得し分析する際は、特定の日付とバッチのデータを取得するか、全ての過去のデータを現在のバッチのデータで上書きすることをお勧めします。そうしないと、同じデータが繰り返し表示される可能性があります。

例えば、2月20日のバッチ1には2月14~20日のデータが含まれていますしかし、2月19日に書かれたバッチにも、2月14日~2月19日のデータが含まれていました。2月19日に受信した以前のデータを、直近の2月20日のバッチで受信したデータで上書きします。

全てのネットワークが全てのディメンションのデータを一緒に提供しているわけではありません。Facebookの地域とチャネルデータが最も一般的な例です。2つの別々のデータセットが提供されるのは、このためです。地域データセットには地域データが、チャネルデータセットにはチャネルデータが含まれることが保証されています。

多くの場合、大部分のメディアソースでは、地域とチャネルデータは同じになります。そのため、ビジネスニーズに応じて、いずれかのデータセット（地域またはチャネル）を取り込んでください。

メディアソースとの連携に関する契約にチャンネルが含まれておらず、チャンネルが空白の場合、そのデータにチャンネルが含まれているものとして扱います。

コストETLは、アドネットワークから抽出できる最も粒度の細かいフレキシブルなデータを提供します。このような膨大な量のデータから実用的なインサイトを引き出すには、ビジネスニーズに最適な方法でデータを集約することをお勧めします。例えば、キャンペーンおよび国レベルでコストデータを理解する必要がある場合は、これらのディメンションを使用してください。

すべてのネットワークが同じ粒度のデータを提供するわけではありません。例えば、FacebookはサイトID別のコストデータを提供せず、Twitterは地域別のコストデータを提供していません。コストETLデータを集計する場合は、このようなケースに注意し、ネットワークを比較する時に同様のデータを確認します。

コストETLは、お客様のすべてのコストデータに関する情報を提供します。コストETLで提供された一部のキャンペーンは、一部のAppsFlyerダッシュボードに表示されません。例えば、非アクティブなキャンペーンのデータ、つまり、 インストールが記録されていないキャンペーン です。データを比較するためには、オーバービュー管理画面で特定のキャンペーンIDを見つけ、コストETLでのコストデータと比較してください。コストデータの入手方法について詳しくはこちら