Show Menu
主题×

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

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

文件内容语法

入站数据文件中的字段必须按照以下顺序显示。 在此示例中,已添 < 加符 > 号以帮助以可视方式分离每个元素。 您无需在数据文件中包含这些内容。
<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可以是:
对于移动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。 See Trait API Methods .
d_unsid=
前缀为的数 d_unsid 据会从该特征中删除用户。 在文 d_unsid 件中忽略前缀 overwrite
d_unsid= 缀告诉我们的系统ID是 Audience Manager 特征ID。 这是用户界面中显示的同一ID。 您还可以使用API方法返回特征 GET ID。 See Trait API Methods .
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”
如果您 需要其他示例,请下载示例数据文件。 下载文件具有文 .overwrite 件扩展名。 您可以使用简单的文本编辑器打开它。

示例矩阵

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

Example 1

使用 trait IDs 发送 trait 资格信息 UUIDs。
59767559181262060060278870901087098252 <TAB> d_sid=24, d_sid=26, d_sid=27

Example 2

使用 trait IDs 发送 trait 取消资格信息 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

Example 3

通过键值对发送,为添加 trait 资格信息 UUIDs。
59767559181262060060278870901087098252 <TAB> product = tablet, product = phone

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

Example 4

使用前 ic 缀发送 trait 资格信息 UUIDs。
59767559181262060060278870901087098252 <TAB> 30608,50354,50338,50352,30626

59767559181262060060278870901087098252 <TAB> ic=52,ic=55

Example 5

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

Example 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

Example 7

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

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

Example 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

Example 9

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

Example 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

Example 11

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

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

Example 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

Example 13

使用 trait IDs 发送 trait 的资格信息 DPUUIDs。
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> d_sid=24, d_sid=25, d_sid=26

Example 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

Example 15

通过键值对发送,为添加 trait 资格信息 DPUUIDs。
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> product = tablet, product = phone

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

Example 16

使用前 ic 缀发送 trait 资格信息 DPUUIDs。
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> 30608,50354,50338,50352,30626

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> ic=52,ic=55