入站数据文件内容:语法、无效字符、变量和示例 inbound-data-file-contents-syntax-invalid-characters-variables-and-examples

格式化集客特征数据文件时应遵循的必填字段、语法和规则。

文件内容语法 file-content-syntax

集客数据文件中的字段必须按下面显示的顺序显示。 在此示例中,已添加< >符号以帮助直观地分隔每个元素。 您无需在数据文件中包含这些字段。

<user ID><TAB><trait ID>,<trait ID>,<trait ID>,...

有关其他接受的文件内容格式,请参阅自定义合作伙伴集成

NOTE
对于在入站数据文件中发送的每个用户ID,我们最多可以处理200行。 例如,如果您为用户ID发送了300行,则保留前200行,并丢弃其他100行。 在下面的示例中,您没有发现问题,因为您为用户ID 1和用户ID 2各发送了3行。 我们不限制您在行中包含的特征或键值对的数量。
code language-none
<user ID1><TAB><trait ID>,<trait ID>,<trait ID>
<user ID1><TAB><trait ID>,<trait ID>,<trait ID>
<user ID1><TAB><trait ID>,<trait ID>,<trait ID>
<user ID2><TAB><trait ID>,<trait ID>,<trait ID>
<user ID2><TAB><trait ID>,<trait ID>,<trait ID>
<user ID2><TAB><trait ID>,<trait ID>,<trait ID>

定义的文件变量 file-variables-defined

该表列出并定义在格式正确的入站数据文件中使用的变量。 斜体 ​表示变量占位符。

变量
描述
User ID

用户ID可以是:

  • 用户分配的唯一Audience ManagerID (Audience ManagerUUID)。
  • 在您的CRMAudience Manager中分配的唯一用户ID ( DPUUID,位于中)。
  • 移动Android或iOS设备ID,采用其由移动操作系统公开的原始未修改形式。

对于移动ID:

  • IDFA格式: ID必须为大写并且不带哈希处理。 例如, 6D92078A-8246-4BA4-AE5B-76104861E7DC
  • Android格式: ID必须小写并且不带哈希处理。 例如, 97987bca-ae59-4c7d-94ba-ee4f19ab8c21
TAB
使用单个选项卡分隔符将用户ID和特征ID分隔开。
trait ID

Audience Manager特征ID。 我们要求您在入站数据文件中仅包含 已载入的特征。 在集客数据传输中,我们不处理任何其他特征类型。

注意:可以使用返回所有特征详细信息的GET方法找到特征ID。 有关详细信息,请参阅特征API方法

正在格式化Trait IDs formatting-trait-ids

下表描述了在入站数据文件中标识trait名称或ID的前缀。 有关示例,请参阅示例文件

前缀
描述
d_sid=
d_sid 前缀告知我们的系统,ID是Audience Manager特征ID。 此ID与用户界面中显示的相同。 您还可以使用API GET 方法返回特征ID。 请参阅特征API方法
d_unsid=

前缀为 d_unsid 的数据会从该特征中删除用户。 overwrite 文件中忽略了 d_unsid 前缀。

d_unsid= 前缀告知我们的系统,ID是Audience Manager特征ID。 此ID与用户界面中显示的相同。 您还可以使用API GET 方法返回特征ID。 请参阅特征API方法

ic=

特征规则允许您设置特征资格条件。 如果将特征规则的格式设置为 ic == trait ID ,则可以通过简单的逗号格式列表来发送特征。

例如,假设您创建了以下3个特征规则:

  • ic == "123"
  • ic == "456"
  • ic == "789"

这些特征与 ic 键关联。 这样,您即可在数据文件中创建一个更简单的特征列表。 并且,您无需包含 ic 前缀。 因此,数据文件的内容可能如下所示:

                 user ID <TAB> 123,456,789

键值对

可以使用字母数字字符串将特征数据格式化为键值对。 有几种设置键值对格式的方法,如下所示:

  • key = value
  • "key" = value
  • key = "value"
  • "key" = "value"

"age"="32" "gender"=m model = "pickup truck" product = tablet 都是格式正确的键值对的示例。

Trait IDs、User IDs和键值对中的字符无效 invalid-chars

Trait IDs

Trait IDs只包含数字字符。 我们要求您在入站数据文件中仅包含​ 个onboarded traits。 我们未在入站数据传输中处理任何其他trait类型。

User IDs

ID 类型
要求
DPUUID
不要 在DPUUID中使用编码冒号( %3A )或未编码冒号( : )符号。
Mobile iOS (IDFA)或Android设备ID

移动设备ID必须严格按照以下所示格式设置:

  • IDFA格式: ID必须为大写并且不带哈希处理。 例如, 6D92078A-8246-4BA4-AE5B-76104861E7DC
  • Android格式: ID必须小写并且不带哈希处理。 例如, 97987bca-ae59-4c7d-94ba-ee4f19ab8c21

键值对

键值对中的值名称格式不正确也会导致问题。 在键值对中创建值或命名值时,请遵循以下规则:

字符
要求
引号字符(“)

您可以在键值对的键和值部分中使用引号字符,如下所示:

  • d_city = "New York", d_city = "San Francisco"

  • "d_city" = "New York", "d_city" = "San Francisco"

短划线字符(-)
我们不理会钥匙开头的破折号。 例如, -product = camera 被解释为 product = camera
TAB
不要 在键值对中使用 TAB 而不是空值。 仅使用 TAB 分隔入站数据文件中的变量。
\n, \t
请勿在键或值中使用新行或制表符字符( \n, \t )。

数据文件示例 data-file-examples

数据文件格式
说明和示例
d_sid d_unsid

此数据文件显示一个符合特征24、26、27条件的用户,该用户已从特征28和29中删除。

59767559181262060060278870901087098252  d_sid=24,d_sid=26,d_sid=27,d_unsid=28,d_unsid=29

注意:

您还可以使用以下语法从用户配置文件中删除特征,而不是使用d_unsid:

59767559181262060060278870901087098252 28:0, 29:0

59767559181262060060278870901087098252 28:-1, 29:-1

ic==

这些特征已添加到前缀为 ic 的特征规则中。 因此,您可以将其添加到数据文件中,数据文件需用逗号分隔,如下所示。 UUID和特征ID使用制表符分隔。 文件中不需要 ic 前缀。

数值ID

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1  30608,50354,50338,50352,30626

字符串ID

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1  ic=52,ic=55

使用键值对

此文件数据使用键值对将数据传递到Audience Manager。

59767559181262060060278870901087098252 “gender”=”female”,“luxury_shopper”=”yes”

如果需要其他示例,请下载示例数据文件。 下载文件的文件扩展名为.overwrite。 您可以使用简单的文本编辑器将其打开。

示例矩阵 examples-matrix

下图显示了正确格式化入站文件的示例,具体取决于ID类型以及要将traits添加到配置文件的方法。

ID类型/操作
使用d_sid将特征添加到用户配置文件
使用d_unsid从用户配置文件中删除特征
发送键值对以将特征添加到用户配置文件
使用ic前缀将特征添加到用户配置文件
AUDIENCE MANAGERUUID
示例1
示例2
示例3
示例4
适用于Android设备的Google Advertising ID
示例5
示例6
示例7
示例8
适用于iOS设备的Apple IDFA
示例9
示例10
示例11
示例12
您自己的CRM ID (DPUUID)
示例13
示例14
示例15
示例16

示例 1 example-1

使用trait IDs发送Audience Manager UUIDs的trait资格信息。

59767559181262060060278870901087098252 <TAB> d_sid=24, d_sid=26, d_sid=27

示例 2 example-2

使用trait IDs发送Audience Manager UUIDs的trait取消资格信息。

59767559181262060060278870901087098252 <TAB> d_unsid=24, d_unsid=26, d_unsid=27

59767559181262060060278870901087098252 <TAB> 24:0, 26:0, 27:0

59767559181262060060278870901087098252 <TAB> 24:-1, 26:-1, 27:-1

示例 3 example-3

发送键值对以添加Audience Manager UUIDs的trait资格信息。

59767559181262060060278870901087098252 <TAB> product = tablet, product = phone

59767559181262060060278870901087098252 <TAB> "product" = "tablet", "product" = "phone"

示例4 example-4

使用ic前缀发送Audience Manager UUIDs的trait资格信息。

59767559181262060060278870901087098252 <TAB> 30608,50354,50338,50352,30626

59767559181262060060278870901087098252 <TAB> ic=52,ic=55

示例5 example-5

使用trait IDs发送Android设备的trait资格信息。

e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> d_sid=24, d_sid=25, d_sid=26

示例6 example-6

使用trait IDs发送Android设备的trait取消资格信息。

e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> d_unsid=24, d_unsid=25, d_unsid=26

e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> 24:0, 26:0, 27:0

e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> 24:-1, 26:-1, 27:-1

示例7 example-7

发送键值对以添加Android设备的trait资格信息。

e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> product = tablet, product = phone

e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> "product" = "tablet", "product" = "phone"

示例8 example-8

使用ic前缀发送Android设备的trait资格信息。

e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> 30608,50354,50338,50352,30626

e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> ic=52,ic=55

示例9 example-9

使用trait IDs发送iOS设备的trait资格信息。

6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> d_sid=24, d_sid=25, d_sid=26

示例10 example-10

使用trait IDs发送iOS设备的trait取消资格信息。

6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> d_unsid=24, d_unsid=25, d_unsid=26

6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> 24:0, 26:0, 27:0

6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> 24:-1, 26:-1, 27:-1

示例11 example-11

发送键值对以添加iOS设备的trait资格信息。

6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> product = tablet, product = phone

6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> "product" = "tablet", "product" = "phone"

示例12 example-12

使用ic前缀发送iOS设备的trait资格信息。

6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> 30608,50354,50338,50352,30626

6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> ic=52,ic=55

示例13 example-13

使用trait IDs发送DPUUIDs的trait资格信息。

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> d_sid=24, d_sid=25, d_sid=26

示例14 example-14

使用trait IDs发送DPUUIDs的trait取消资格信息。

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> d_unsid=24, d_unsid=25, d_unsid=26

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> 24:0, 26:0, 27:0

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> 24:-1, 26:-1, 27:-1

示例15 example-15

发送键值对以添加DPUUIDs的trait资格信息。

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> product = tablet, product = phone

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> "product" = "tablet", "product" = "phone"

示例16 example-16

使用ic前缀发送DPUUIDs的trait资格信息。

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> 30608,50354,50338,50352,30626

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> ic=52,ic=55
recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695