入站数据文件内容:语法、无效字符、变量和示例

设置入站特征数据文件格式时,应遵循的必填字段、语法和规则。

文件内容语法

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

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

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

注意

对于在入站数据文件中发送的每个用户ID,我们最多可以处理200行用户ID。 例如,如果您为用户ID发送300行,则前200行将保留,另外100行将被丢弃。 在以下示例中,您做得不错,因为您要为用户ID 1和用户ID 2分别发送3行。 我们不对行中包含的特征或键值对的数量设置限制。

<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>

定义的文件变量

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

变量 描述

User ID

用户ID可以是:

对于移动ID:

  • IDFA格式:ID必须大写,且不得进行哈希处理。 例如, 6D92078A-8246-4BA4-AE5B-76104861E7DC
  • Android格式:ID必须小写,而不是经过哈希处理。 例如, 97987bca-ae59-4c7d-94ba-ee4f19ab8c21

TAB

使用单个选项卡分隔符分隔用户ID和特征ID。

trait ID

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

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

格式化Trait IDs

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

前缀 描述

d_sid=

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

d_unsid=

带有 d_unsid 前缀的数据会从该特征中删除用户。 在 overwrite 文件中,将忽略 d_unsid 前缀。

d_unsid= 前缀用于告知我们的系统ID是Audience Manager特征ID。 此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和键值对中的字符无效

Trait IDs

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

User IDs

ID 类型 要求

DPUUID

勿使用编码的冒号( %3A )或未编码的冒号(:)符号。

移动设备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 )。

数据文件示例

数据文件格式 描述和示例

具有 d_sid d_unsid

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

59767559181262060060278870901087098252&nbsp;&nbsp;d_sid=24,d_sid=26,d_sid=27,d_unsid=28,d_unsid=29

注释:

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

59767559181262060060278870901087098252&nbsp;28:0,&nbsp;29:0

59767559181262060060278870901087098252&nbsp;28:-1,&nbsp;29:-1

通过 ic==

这些特征已添加到具有 ic 前缀的特征规则中。 因此,您可以将它们添加到以逗号分隔的数据文件中,如所示。 使用选项卡可分隔UUID和特征ID。 文件中不需要 ic 前缀。

数字ID

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1&nbsp;&nbsp;30608,50354,50338,50352,30626

字符串ID

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1&nbsp;&nbsp;ic=52,ic=55

具有键值对

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

59767559181262060060278870901087098252&nbsp;“gender”=”female”,“luxury_shopper”=”yes”

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

示例矩阵

下图显示了正确格式入站文件方式的示例,具体取决于ID类型和要向用户档案添加traits的方法。

ID类型/操作 使用d_sid向用户配置文件添加特征 使用d_unsid从用户配置文件中删除特征 发送键值对,以向用户配置文件添加特征 使用ic前缀向用户配置文件添加特征

Audience ManagerUUID

示例1

示例2

示例3

示例4

适用于Android设备的Google广告ID

示例5

示例6

示例7

示例8

适用于iOS设备的Apple IDFA

示例9

示例10

示例11

示例12

您自己的CRM ID(DPUUID)

示例13

示例14

示例15

示例16

示例1

使用trait IDs发送Audience Manager UUIDs的trait鉴别信息。

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

示例2

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

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

发送键值对,以添加Audience Manager UUIDs的trait鉴别信息。

59767559181262060060278870901087098252 <TAB> product = tablet, product = phone

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

示例5

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

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

59767559181262060060278870901087098252 <TAB> ic=52,ic=55

示例5

使用trait IDs发送trait设备的Android鉴别信息。

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

示例6

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

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

发送键值对,以添加trait设备的Android鉴别信息。

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

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

示例8

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

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

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

示例9

使用trait IDs发送trait设备的iOS鉴别信息。

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

示例10

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

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

发送键值对,以添加trait设备的iOS鉴别信息。

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

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

示例12

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

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

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

示例13

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

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

示例14

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

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

发送键值对,以添加trait的DPUUIDs鉴别信息。

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> product = tablet, product = phone

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

示例16

使用ic前缀发送trait的DPUUIDs鉴别信息。

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

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> ic=52,ic=55

在此页面上