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

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

概述

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

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

Naming Conventions for Data Files

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

语法:

事件类型_yyyymmdd

在文件名中:

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

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

  • 印象数据:
    impressions_yyymmd.gz
  • 单击数据:
    clicks_yyymmdd.gz
  • 转换数据:
    conversions_yyymmdd.gz

Content Format for Data Files

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

语法:

标题标签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。

Delivery Methods for Data Files

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

重要

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

投放路径语法和示例

数据存储在目录中每个客户的单独命名空间 Amazon S3 中。 文件路径遵循下面显示的语法。 Note, italics indicates a variable placeholder. 其他元素是常量或键,不会更改。

语法:

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

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

文件参数 描述

.../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时间来定义日间隔。

后续步骤

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

在此页面上