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

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

文件内容语法

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

<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 Audience Manager ( Audience ManagerUUID )。
  • 在您的CRM系统中分配的唯一用户ID( DPUUID,Audience Manager )。
  • 移动设备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。 我们要求您在 仅已载入的特征 入站数据文件中。 在集客数据传输中,我们不会处理任何其他特征类型。

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

格式 Trait IDs

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

前缀 描述

d_sid=

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

d_unsid=

数据以前缀 d_unsid 从该特征中删除用户。 的 d_unsid overwrite 文件。

d_unsid= 前缀用于告知我们的系统ID是 Audience Manager 特征ID。 此ID与用户界面中显示的ID相同。 您还可以通过API返回特征ID GET 方法。 请参阅 特征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 )或未编码的冒号(:)符号。

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

不要 use TAB 而不是键值对中的空值。 仅使用 TAB 来分隔集客数据文件中的变量。

\n, \t

请勿使用新的行或制表符( \n, \t )。

数据文件示例

数据文件格式 描述和示例

使用 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 文件扩展名。 您可以使用简单的文本编辑器将其打开。

示例矩阵

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

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

Audience ManagerUUID

示例1

示例2

示例3

示例4

Google Advertising ID for Android Devices

示例5

示例6

示例7

示例8

Apple用于iOS设备的IDFA

示例9

示例10

示例11

示例12

您自己的CRM ID(DPUUID)

示例13

示例14

示例15

示例16

示例 1

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

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

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

59767559181262060060278870901087098252 <TAB> product = tablet, product = phone

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

示例4

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

在此页面上