设置入站特征数据文件格式时,应遵循的必填字段、语法和规则。
集客数据文件中的字段必须按照以下顺序显示。 在本例中, <
>
添加了符号以帮助直观地分隔每个元素。 您无需在数据文件中包含这些内容。
<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>
该表列出并定义了格式正确的入站数据文件中使用的变量。 斜体表示变量占位符。
变量 | 描述 |
---|---|
|
用户ID可以是:
对于移动ID:
|
|
使用单个选项卡分隔符分隔用户ID和特征ID。 |
|
的 Audience Manager 特征ID。 我们要求您在 仅已载入的特征 入站数据文件中。 在集客数据传输中,我们不会处理任何其他特征类型。
注意:特征ID可使用返回所有特征详细信息的GET方法找到。 有关更多信息,请参阅 特征API方法 . |
下表描述了用于标识 trait 入站数据文件中的名称或ID。 请参阅 示例文件 。
前缀 | 描述 |
---|---|
|
的 |
|
数据以前缀 的 |
|
特征规则 允许您设置特征鉴别标准。 如果将特征规则设置为 例如,假设您创建了以下3个特征规则:
这些特征与
|
键值对 |
特征数据可以使用字母数字字符串以键值对的形式进行格式设置。 有多种格式化键值对的方法,如下所示:
"age"="32" , "gender"=m , model = "pickup truck" , product = tablet 都是格式正确的键值对的示例。 |
Trait IDs 只包含数字字符。 我们要求您在 仅onboarded traits 入站数据文件中。 我们不处理任何其他 trait 集客数据传输中的类型。
ID 类型 | 要求 |
---|---|
DPUUID |
不要 使用编码的冒号( |
Mobile iOS(IDFA)或Android设备ID |
移动设备ID必须严格设置格式,如下所示:
|
键值对中格式不正确的值名称也会导致问题。 在键值对中创建或命名值时,请遵循以下规则:
字符 | 要求 |
---|---|
引号字符(") |
您可以在键和键值对的值部分中使用引号字符,如下所示:
|
短划线字符(-) |
我们在键的开头忽略掉的符号。 例如, |
|
不要 use |
|
请勿使用新的行或制表符( |
数据文件格式 | 描述和示例 |
---|---|
使用 |
此数据文件显示符合特征24、26、27的用户,且已从特征28和29中删除。
注释: 您还可以使用以下语法从用户配置文件中删除特征,而不是使用d_unsid:
|
通过 |
这些特征已添加到具有 数字ID
字符串ID
|
具有键值对 |
此文件数据使用键值对将数据传递到 Audience Manager .
|
下载 示例数据文件(如果需要其他示例)。 下载文件具有 .overwrite
文件扩展名。 您可以使用简单的文本编辑器将其打开。
下图显示了正确设置入站文件格式的示例,具体取决于 ID类型 和要添加的方法 traits 到用户档案。
ID类型/操作 | 使用d_sid向用户配置文件添加特征 | 使用d_unsid从用户配置文件中删除特征 | 发送键值对,以向用户配置文件添加特征 | 使用ic前缀向用户配置文件添加特征 |
---|---|---|---|---|
Audience ManagerUUID |
||||
Google Advertising ID for Android Devices |
||||
Apple用于iOS设备的IDFA |
||||
您自己的CRM ID(DPUUID) |
使用 trait IDs 发送 trait 资格信息 Audience Manager UUIDs.
59767559181262060060278870901087098252 <TAB> d_sid=24, d_sid=26, d_sid=27
使用 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
发送键值对以添加 trait 资格信息 Audience Manager UUIDs.
59767559181262060060278870901087098252 <TAB> product = tablet, product = phone
或
59767559181262060060278870901087098252 <TAB> "product" = "tablet", "product" = "phone"
使用 ic
发送前缀 trait 资格信息 Audience Manager UUIDs.
59767559181262060060278870901087098252 <TAB> 30608,50354,50338,50352,30626
或
59767559181262060060278870901087098252 <TAB> ic=52,ic=55
使用 trait IDs 发送 trait 资格信息 Android 设备。
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> d_sid=24, d_sid=25, d_sid=26
使用 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
发送键值对以添加 trait 资格信息 Android 设备。
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> product = tablet, product = phone
或
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> "product" = "tablet", "product" = "phone"
使用 ic
发送前缀 trait 资格信息 Android 设备。
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> 30608,50354,50338,50352,30626
或
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> ic=52,ic=55
使用 trait IDs 发送 trait 资格信息 iOS 设备。
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> d_sid=24, d_sid=25, d_sid=26
使用 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
发送键值对以添加 trait 资格信息 iOS 设备。
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> product = tablet, product = phone
或
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> "product" = "tablet", "product" = "phone"
使用 ic
发送前缀 trait 资格信息 iOS 设备。
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> 30608,50354,50338,50352,30626
或
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> ic=52,ic=55
使用 trait IDs 发送 trait 资格信息 DPUUIDs.
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> d_sid=24, d_sid=25, d_sid=26
使用 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
发送键值对以添加 trait 资格信息 DPUUIDs.
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> product = tablet, product = phone
或
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> "product" = "tablet", "product" = "phone"
使用 ic
发送前缀 trait 资格信息 DPUUIDs.
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> 30608,50354,50338,50352,30626
或
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> ic=52,ic=55