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

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

文件内容语法

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

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

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

注意

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

<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(在Audience Manager中为 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。 我们要求在入站数据文件中仅包含已载入的特征。 在入站数据传输中,我们不处理任何其他特征类型。

注意: 特征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 或未编码冒号(:)符号。

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

数据文件示例

数据文件格式 说明和示例

具有 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"

示例4

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

发送键值对,以添加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发送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

发送键值对,以添加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

On this page

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now