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

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

文件内容语法

入站数据文件中的字段必须按照以下顺序显示。 在此示例中,已添加< >符号以帮助以可视方式分离每个元素。 您无需在数据文件中包含这些内容。

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

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

注意

对于入站数据文件中发送的每个用户ID,我们最多可处理200行。 例如,如果您为用户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可以是:

  • Audience Manager(Audience ManagerUUID )分配的唯一用户ID。
  • 在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。 还可以使用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和键值对中的字符无效

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

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

59767559181262060060278870901087098252 <TAB> product = tablet, product = phone

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

示例5

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

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

59767559181262060060278870901087098252 <TAB> ic=52,ic=55

示例5

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> product = tablet, product = phone

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

示例16

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

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

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> ic=52,ic=55

在此页面上