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

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

概述

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

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

数据文件的命名约定

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

语法:

事件类型_yyyymmdd

在文件名中:

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

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

  • 印象数据:
    印象_yyyymmddgz
  • 单击数据:
    clicks_yyyymmdd.gz
  • 转换数据:
    conversions_yyyymmdd.gz

数据文件的内容格式

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

语法:

标题标签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帐户的Amazon S3目录。 有关投放/目录路径、文件处理时间和更新的信息,请参阅本节。

重要

请与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时间定义天间隔。

后续步骤

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

On this page

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now