Show Menu
主题×

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

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

文件内容语法

入站数据文件中的字段必须按以下顺序显示。 在此示例中,已添 <``> 加符号以帮助以可视方式分隔每个元素。 您无需在数据文件中包含这些组件。
<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可以是:
对于移动ID:
  • IDFA格式:ID必须是大写的,而不是哈希的。 For example, 6D92078A-8246-4BA4-AE5B-76104861E7DC
  • Android格式:ID必须小写,而不是散列。 For example, 97987bca-ae59-4c7d-94ba-ee4f19ab8c21
TAB
使用单个制表符分隔符分隔用户ID和特征ID。
trait ID
Audience Manager特 征ID。 我们要求您在入站数 据文件中仅包含已载入 的特征。 在入站数据传输中,我们不会处理任何其他特征类型。
注意: 可以使用GET方法找到特征ID,该方法返回有关您所有特征的详细信息。 有关详细信息,请参阅 特征API方法

格式化特征ID

下表描述了标识入站数据文件中的特征名称或ID的前缀。 有关示例 ,请参阅 示例文件。
前缀 描述
d_sid=
d_sid 缀告诉我们的系统该ID是 Audience Manager特 征ID。 这是用户界面中显示的同一ID。 您还可以使用API方法返回特征 GET ID。 请参 阅特征API方法
d_unsid=
前缀为的数 d_unsid 据会从该特征中删除用户。 在文 d_unsid 件中忽略前缀 overwrite
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 都是格式正确的键值对的示例。

特征ID、用户ID和键值对中的字符无效

特征ID

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

用户 ID

ID 类型 要求
DPUUID
请勿使用已编码的冒号 ()或未编码的冒号 %3A (:)符号。
移动iOS(IDFA)或Android设备ID
移动设备ID必须严格格式化,如下所示:
  • IDFA格式:ID必须是大写的,而不是哈希的。 For example, 6D92078A-8246-4BA4-AE5B-76104861E7DC
  • Android格式:ID必须小写,而不是散列。 For example, 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”
如果需要 ,请下载示例数据文件。 下载文件具有文 .overwrite 件扩展名。 您可以使用简单的文本编辑器打开它。

示例矩阵

下图显示了如何正确设置入站文件格式的示例,具体取决于ID的类 ,以及向配置文件添加特征的方法。
ID类型/操作 使用d_sid向用户配置文件添加特征 使用d_unsid从用户配置文件中删除特征 发送键值对以向用户配置文件添加特征 使用ic前缀向用户配置文件添加特征
Audience Manager UUID
适用于Android设备的Google Advertising ID
适用于iOS设备的Apple IDFA
您自己的CRM ID(DPUUID)

Example 1

使用特征ID发送Audience Manager UUID的特征资格信息。
59767559181262060060278870901087098252 <TAB> d_sid=24, d_sid=26, d_sid=27

Example 2

使用特征ID发送Audience Manager UUID的特征取消资格信息。
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

Example 3

发送键值对以添加Audience Manager UUID的特征资格信息。
59767559181262060060278870901087098252 <TAB> product = tablet, product = phone

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

Example 4

使用ic前缀发送Audience Manager UUID的特征资格信息。
59767559181262060060278870901087098252 <TAB> 30608,50354,50338,50352,30626

59767559181262060060278870901087098252 <TAB> ic=52,ic=55

Example 5

使用特征ID发送Android设备的特征资格信息。
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> d_sid=24, d_sid=25, d_sid=26

Example 6

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

Example 7

发送键值对以添加Android设备的特征资格信息。
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> product = tablet, product = phone

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

Example 8

使用ic前缀发送Android设备的特征资格信息。
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> 30608,50354,50338,50352,30626

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

Example 9

使用特征ID发送iOS设备的特征资格信息。
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> d_sid=24, d_sid=25, d_sid=26

Example 10

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

Example 11

发送键值对以添加iOS设备的特征资格信息。
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> product = tablet, product = phone

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

Example 12

使用ic前缀发送iOS设备的特征资格信息。
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> 30608,50354,50338,50352,30626

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

Example 13

使用特征ID发送DPUUID的特征资格信息。
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> d_sid=24, d_sid=25, d_sid=26

Example 14

使用特征ID发送DPUUID的特征取消资格信息。
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

Example 15

发送键值对以添加DPUUID的特征资格信息。
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> product = tablet, product = phone

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

Example 16

使用ic前缀发送DPUUID的特征资格信息。
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> 30608,50354,50338,50352,30626

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> ic=52,ic=55