分类数据文件(旧版)

WARNING
分类导入器将于 2026 年 8 月 31 日​弃用。 请改用分类集体验,以确保继续使用相关功能。

导入器允许您将文件中的分类数据批量上载至分析报告。 要成功上传数据,导入操作需要特定的文件格式。

为了帮助您创建有效的数据文件,您可以下载一个模板文件,该文件提供了一个可以粘贴分类数据的文件结构。 有关详细信息,请参阅下载分类模板

请参阅通用文件结构,以了解有关分类中字符限制的详细信息。

通用文件结构

下图是一个示例数据文件:

数据文件必须遵循以下结构规则:

  • 分类的值不能为0(零)。

  • Adobe 建议您将导入和导出列的数量限制为 30。

  • 上载的文件应使用不带BOM字符编码的UTF-8。

  • 包含制表符、换行符和引号在内的特殊字符可以嵌入在单元格内,前提是指定了 v2.1 文件格式,并且该单元格已被正确转义。 特殊字符包括:

    code language-text
    \t     tab character
    \r     form feed character
    \n    newline character
    "       double quote
    

    逗号不是特殊字符。

  • 分类名称不能包含脱字符号(^),因为此字符用于表示子分类。

  • 使用连字符时请小心。 例如,如果您在 Social 术语中使用连字符 (-),则 Social 会将连字符识别为 Not 运算符(减号)。 例如,如果您使用导入指定 fragrance-free 作为术语,则 Social 会将该术语识别为 fragrance minus free,并收集提及 fragrance,但未提及 free 的帖子。

  • 在对报告数据进行分类时必须执行字符限制。 例如,如果上载产品名称长度超过 100 个字符(字节)的产品的分类文本文件 (s.products),将不会在报告中显示这些产品。 跟踪代码和所有自定义转化变量(eVar)允许 255 字节。 此策略还扩展到分类和子分类列值,这些值受相同的255字节限制的约束。

  • 以制表符分隔的数据文件(可以使用任一款电子表格应用程序或文本编辑器来创建模板文件)。

  • 使用 .tab.txt 作为文件扩展名。

  • 井号(#)将该行标识为用户注释。 Adobe忽略任何以#开头的行。

  • 双井号后面接SC (## SC)表示该行是报告使用的预处理标题注释。 请勿删除这些行。

  • 由于键中存在换行字符,分类导出可能包含重复的键。 在FTP或浏览器导出中,可以通过为FTP帐户启用报价来解决此问题。 这将在每个键周围加上引号,其中带有换行字符。

  • 导入文件第一行中的单元格C1包含版本标识符,该标识符确定分类如何处理在文件的其余部分使用引号的情况。

    • v2.0忽略引号,并假定它们都是指定键和值的一部分。 例如,请考虑以下值:“这是”“一些值”“。 v2.0会按字面含义将此解析为:“这是"一些值””。
    • v2.1告诉分类,假定引号是Excel文件中使用的文件格式的一部分。 因此,v2.1会将上述示例格式设置为:这是“一些值”。
    • 如果在文件中指定了v2.1,但实际需要的是v2.0,即,当以在Excel格式下非法的方式使用引号时,可能会出现问题。 例如,如果具有以下值:“VP NO REPS” S/l Dress w/ Overlay。 使用v2.1时,格式不正确(值应用开头和结尾引号括起来,属于实际值的引号应用引号转义),超出此范围将无法进行分类。
    • 请确保您执行了以下操作之一:通过更改上载文件中的标题(单元格 C1)将您的文件格式更改为 v2.0,或者在所有文件中正确实施 Excel 引号功能。
  • 数据文件的第一个(非注释)行包含用于标识该列中分类数据的列标题。 导入器要求为列标题使用特定格式。 有关详细信息,请参阅列标题格式

  • 数据文件中的标题行后面紧接着是数据行。 每行数据应包含每个列标题的数据字段。

  • 数据文件支持以下控制代码,Adobe使用这些代码为文件提供结构,并正确导入分类数据:

控制代码
描述
<New Line>
新行字符是数据文件中数据行/记录之间唯一支持的分隔符。 通常,在编写程序以自动生成数据文件时,您只需专门插入这些字符即可。
~autogen~

请求Adobe自动为此元素生成唯一ID。

在营销活动上下文中,此控制值指示Adobe为每个创意元素分配一个标识符。 请参阅密钥

~period~
指定数据列表示与项目关联的日期范围。 请参阅日期
空字段
表示当前字段的NULL值。 如果特定数据列不适用于当前记录,则使用此选项。
PER修饰符
指定此数据列代表 PER 修饰符字段。 请参阅 PER 修饰符标题

列标题格式

NOTE
Adobe 建议您将导入和导出列的数量限制为 30。

分类文件支持以下列标题:

在整个系统中,此值必须唯一。 此字段中的值对应于在您网站的 JavaScript 信标中分配给 Analytics 变量的值。 该列中的数据可能包含 autogen 或任何其他唯一跟踪代码。

分类列标题

NOTE
分类列标题中的值必须完全符合分类的命名规范,否则会导致导入失败。 例如,如果管理员在促销活动设置管理器中将促销活动更改为内部促销活动名称,则文件列标题必须随之更改。 “Key”是保留的分类(标头)值。 不支持名为“Key”的新分类。

此外,数据文件支持以下附加标题约定,以确定子分类和其他专门的数据列:

子分类标题

例如,Campaigns^Owner是包含Campaign Owner值的列的列标题。 同样,Creative Elements^Size是包含Creative Elements分类的Size子分类的列的列标题。

有关分类的疑难解答

  • 常见 上载问题:知识库文章,描述由于文件格式以及文件内容不正确导致的问题。
recommendation-more-help
analytics-help-components