Show Menu
主题×

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

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

概述

通过命名正确且格式正确的受众文件,您可以将印象、单击或转换数据到优 化报告中 。 当您与未集成的合作伙伴合作,并且希望 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

将您的印象、单击或转换数据文件上传到Amazon S3目录中,以便您的帐 Audience Manager 户。 有关投放/目录路径、文件处理时间和更新的信息,请参阅本节。
请与Audience Manager顾问或客户关怀部门联系,开始为 Amazon S3 文件设置目录。
投放路径语法和示例
数据存储在目录中每个客户的单独命名空间 Amazon S3 中。 文件路径遵循下面显示的语法。 Note, italics indicates a variable placeholder. 其他元素是常量或键,不会更改。
语法:

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

后续步骤

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