Audience Optimization レポートおよびアクションにつながるログファイル用のデータファイル data-files-for-audience-optimization-reports
データファイルにはインプレッション、クリックまたはコンバージョンのデータが含まれます。形式が正しい場合は、このデータを Audience Manager に読み込み、Audience Optimization レポートで表示し、アクションにつながるログファイルからデータを使用して特性を作成できます。データファイルの形式を、この節で説明した仕様に合わせてください。
概要 overview
適切な名前と形式のデータファイルを使用すると、インプレッション、クリック、コンバージョンのいずれかのデータを Audience Optimization レポートにインポートできます。これは、Audience Manager と統合されていないパートナーのデータを同レポートスイートで扱う場合に役に立ちます。このプロセスには、インプレッション、クリック、コンバージョンのデータごとに別個のファイルが必要です。これらのイベントを単一のファイルに混在させないでください。
データファイルには、メタデータファイルが付いている必要があります。メタデータファイルには、データファイルの情報に対応するレポートメニューラベルが人間に判読できる形で記載されています。詳しくは、 概要とメタデータファイルのマッピングを参照してください。
データファイルの命名規則 naming-conventions
適格なデータファイル名の構造を次の構文で定義します。なお、斜体 の部分にはファイルコンテンツの実際の情報が入ります。
構文：
event type_yyyymmdd
ファイル名の場合：
- イベントタイプは、ファイルにインプレッション、クリック、コンバージョンのどれが格納されているかを示します。イベントタイプごとに別個のファイルを作成します。
- アンダースコアは、イベントタイプと年月日タイムスタンプの区切りになります。
- アップロードする前に、gzip を使用してファイルを圧縮し、
.gzファイル拡張子を付けて保存します。
これらの要件を前提として、コンテンツに応じてデータファイルに次のように名前を付けます。
-
インプレッションデータ：
code language-none impressions_yyyymmdd.gz -
クリックデータ：
code language-none clicks_yyyymmdd.gz -
コンバージョンデータ：
code language-none conversions_yyyymmdd.gz
データファイルのコンテンツ形式 content-format
適格なデータファイルのコンテンツ構造を次の構文で定義します。なお、斜体 の部分には実際のデータファイル内のラベルが入ります。
構文：
header label 1 | header label 2 … header label n | version
ファイルコンテンツの場合：
-
ヘッダーラベルは、以下の表に示す順序で出現する必要があります。インプレッションとクリックは、同じラベルを使用します。コンバージョンファイルには追加のヘッダーが含まれています。
-
特定の列のデータがない場合は、そのフィールドに
-1を入力します。 -
ファイルの末尾はバージョン番号である 必要があり ます。現在のバージョンは 1.1 です。
-
ファイルヘッダーとコンテンツを非印字 ASCII 文字 001 で区切ります。ASCII 001 を使用できない場合は、ヘッダーとデータをタブ文字で区切ります。これらは非印字文字なので、上記の構文例では、表示のためだけにパイプ「
"|"」を使用しています。
フィールドラベル
次の表では、データファイルの列ヘッダーを列挙し説明します。ヘッダーは大文字と小文字の区別があり、この表での順序どおりに出現する必要があります。他に指示がない限り、すべてのデータタイプは整数（INT）です。
yyyy-MM-dd HH:mm:ss形式を使用します。コンバージョンイベントで販売された商品の数。
コンバージョンデータファイルの場合のみ。
獲得やその他のコンバージョン量。データタイプは浮動小数。
コンバージョンデータファイルの場合のみ。
コンバージョンランディングページの URL。データタイプは文字列。
コンバージョンデータファイルの場合のみ。
コンバージョンタイプ。コンバージョンが対応しているかどうかを示します。オプションは次のとおりです。
0：インプレッション1：クリック-1：原因不明
コンバージョンデータファイルの場合のみ。
データファイルの配信方法 delivery-methods
インプレッション、クリック、コンバージョンのデータファイルは、Audience Manager アカウントの Amazon S3 ディレクトリにアップロードします。配信／ディレクトリパス、ファイル処理回数、データ更新については、この節を参照してください。
配信パスの構文と例
データはユーザーごとに Amazon S3 ディレクトリ内の個別の名前空間に保存されます。ファイルパスは以下の構文に従います。なお、斜体 の部分には実際の情報が入ります。他の要素は定数またはキーで、変わりません。
構文：
…/log_ingestion/pid= AAM ID/dpid= d_src/logs/ file type_yyyymmdd
ファイル配信パスのこれらの各要素を次の表で定義します。
.../log_ingestion/pid=AAM IDdpid=d_srclogsfile type_yyyymmddアップロードパスとファイル名のサンプル
ファイルをアップロードすると、パスは次のようになります。
.../log_ingestion/pid=1234/dpid=567/logs/impressions_20150902
ファイル処理の回数と更新
データファイルは 1 日 4 回定期的に処理されます。
データを更新するには、当日のインプレッション、クリック、コンバージョンをすべて格納したファイルを送信します。この場合、1 日は当日の午前 0 時から翌日の午前 0 時までの 24 時間になります。ベストプラクティスとして、世界標準時（UTC）で時刻を定義するとよいでしょう。
次の手順 next-steps
メタデータファイルの命名と作成の要件を確認します。開始するには、 概要とメタデータファイルのマッピングを参照してください。