Audience Optimization 报表的数据文件以及可操作的日志文件

数据文件包含印象、单击或转换数据。 格式正确后,您可以将此数据导入Audience Manager以在Audience Optimization报告中视图它,并通过可操作日志文件使用数据创建特征。 根据本节中的这些规范设置数据文件的格式。

概述

使用命名正确且格式正确的Audience Optimization文件,可以将印象、单击或转换数据到报告中。 当与未与Audience Manager集成并且您希望使用该报表包中的数据的合作伙伴合作时,此功能非常有用。 此过程需要单独的文件来获得印象、单击和转换数据。 不要将这些事件混合到单个文件中。

数据文件必须附带元数据文件。 元数据文件内容将数据文件信息与报表菜单中相关的、可读标签相匹配。 有关详细信息,请参阅元数据文件的概述和映射

数据文件的命名约定

以下语法定义格式良好的数据文件名的结构。 注意,斜体​表示变量占位符,该占位符会根据文件内容而发生变化。

语法:

事件类型_yyyymmdd

在文件名中:

  • 事件类型指示文件包含展示次数、点击次数或转换次数。 为每个事件类型创建单独的文件。
  • 下划线将事件类型和年月日期时间戳分隔开。
  • 上传之前,请使用gzip压缩文件,并用.gz文件扩展名保存它们。

根据这些要求,根据数据文件的内容命名它们,如下所示:

  • 印象数据:
    印象_yyyymmddgz
  • 单击数据:
    clicks_yyyymmddgz
  • 转换数据:
    conversions_yyyymmddgz

数据文件的内容格式

以下语法定义格式良好的数据文件中的内容结构。 注意,斜体​表示变量占位符,并替换为实际数据文件中的标签。

语法:

标题标签 1| 标题标签2 …标 题标签n |版 

在文件内容中:

  • 标题标签必须按如下表所示的顺序显示。 展示次数和点击次数使用相同的标签。 转换文件包含额外的标题。

  • 如果没有特定列的数据,请用-1填充该字段。

  • 文件​必须以版本号结尾。​当前版本为1.1。

  • 用非打印ASCII 001字符分隔文件头和内容。 如果不能使用ASCII 001,则使用制表符分隔符分隔标题和数据。 由于这些字符是非打印字符,因此上面的语法示例仅显示用于显示目的的管道"|"

字段标签

下表列表了您的数据文件的列标题。 标题区分大小写,且必须按表中的顺序显示。 除非另有说明,否则所有数据类型都是整数(INT)。

标签 描述

时间戳

UTC印象、单击或转换事件的日期和时间。 使用 yyyy-MM-dd HH:mm:ss格式。

用户ID

站点访客的ID,也称为数据提供程序唯一用户ID或DPUUID。

广告商ID

广告商的数据源ID或集成代码。

BU-ID

业务单位ID。

活动ID

促销活动 ID.

Creative-ID

创作 ID.

站点ID

网站 ID.

放置ID

广告服务器中的数字放置ID。

插入顺序ID

插入顺序ID。

策略ID

策略ID。

垂直ID

行业垂直或类别的ID。

数量

转换事件中售出的物料数。

仅适用于转换数据文件。

收入

购买或其他转换金额。 数据类型:浮动。

仅适用于转换数据文件。

其他数据

转换登陆页的URL。 数据类型:字符串.

仅适用于转换数据文件。

事件类型

转换类型。 指示转换是否匹配。 选项包括:

  • 0: 展示次数
  • 1: 单击
  • -1:未归属或未知

仅适用于转换数据文件。

版本

印象中每行末尾显示的所需版本号,单击或转换数据文件。 当前版本为1.1。

投放数据文件的方法

将您的印象、单击或转换数据文件上传到您的Audience Manager帐户的AmazonS3目录。 有关投放/目录路径、文件处理时间和更新的信息,请参阅本节。

重要

请与Audience Manager顾问或客户服务部门联系,开始为数据文件设置Amazon S3目录。

投放路径语法和示例

数据存储在Amazon S3目录中每个客户的单独命名空间中。 文件路径遵循下面显示的语法。 注意,斜体​表示变量占位符。 其他元素是常量或键,不会更改。

语法:

…/log_ingestion/pid= AAM ID/dpid= d_src/logs/ 文件类型_yyymmdd

下表定义了文件投放路径中的每个元素。

文件参数 描述

.../log_ingestion/

这是目录存储路径的开始。 设置完毕后,您将获得完整路径。

pid=AAM ID

此键值对包含您的Audience Manager客户ID。

dpid=d_src

此键值对包含在事件调用中传入的数据源ID。 它标识数据来源的机构,并将数据绑定到支持的元数据文件。

logs

数据文件的更高级别目录。

file type_yyyymmdd

一种文件类型名称,指示它包含的数据类型和投放时间戳。

上传路径和文件名示例

上传文件时,路径的外观将类似于:

.../log_ingestion/pid=1234/dpid=567/logs/impressions_20150902

文件处理时间和更新

每天以定期时间间隔处理四次数据文件。

要更新数据,请发送包含特定日期的所有展示次数、点击次数或转换次数的文件。 在这种情况下,一天是从午夜到下一个午夜的24小时。 作为最佳实践,您可能希望使用UTC时间来定义日间隔。

后续步骤

查看命名和创建元数据文件的要求。 要开始,请参阅元数据文件的概述和映射

在此页面上