格式化入站特征数据文件时应遵循的必填字段、语法和规则。
入站数据文件中的字段必须按以下顺序显示。 在此示例中,已添加<
>
符号,以帮助以可视方式分离每个元素。 您无需在数据文件中包含这些内容。
<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>
表列表并定义格式正确的入站数据文件中使用的变量。 斜体表示变量占位符。
变量 | 描述 |
---|---|
|
用户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必须严格格式化,如下所示:
|
键值对中的值名称格式不正确也会导致问题。 创建或命名键值对中的值时,请遵循以下规则:
字符 | 要求 |
---|---|
引号字符(") |
您可以在键和键值对的值部分中使用引号字符,如:
|
虚线字符(-) |
我们不理钥匙开始的破折号。 例如, |
|
不 要 |
|
请勿在键或值中使用新行或制表符字符( |
数据文件格式 | 说明和示例 |
---|---|
具有 |
此数据文件显示符合特征24、26、27的用户,已从特征28和29中删除。
注释: 您还可以使用以下语法从用户用户档案中删除特征,而不是使用d_unsid:
|
通过 |
这些特征已添加到具有 数字ID
字符串ID
|
带键值对 |
此文件数据使用键值对将数据传递到Audience Manager。
|
[如果] (assets/ftp_dpm_1234_1445374061.overwrite) 您需要其他示例,请下载示例数据文件。下载文件具有.overwrite
文件扩展名。 您可以使用简单的文本编辑器打开它。
下图显示了格式化入站文件的正确方法示例,具体取决于类型的ID以及向用户档案添加traits的方法。
ID类型/操作 | 使用d_sid向用户用户档案添加特征 | 使用d_unsid从用户用户档案中删除特征 | 发送键值对以向用户用户档案添加特征 | 使用ic前缀向用户用户档案添加特征 |
---|---|---|---|---|
Audience ManagerUUID |
||||
适用于Android设备的Google广告ID |
||||
适用于iOS设备的Apple IDFA |
||||
您自己的CRM ID(DPUUID) |
使用trait IDs发送Audience Manager UUIDs的trait资格信息。
59767559181262060060278870901087098252 <TAB> d_sid=24, d_sid=26, d_sid=27
使用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
发送键值对,以添加Audience Manager UUIDs的trait资格信息。
59767559181262060060278870901087098252 <TAB> product = tablet, product = phone
或
59767559181262060060278870901087098252 <TAB> "product" = "tablet", "product" = "phone"
使用ic
前缀可发送Audience Manager UUIDs的trait资格信息。
59767559181262060060278870901087098252 <TAB> 30608,50354,50338,50352,30626
或
59767559181262060060278870901087098252 <TAB> ic=52,ic=55
使用trait IDs发送Android设备的trait资格信息。
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> d_sid=24, d_sid=25, d_sid=26
使用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
发送键值对,以添加Android设备的trait资格信息。
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> product = tablet, product = phone
或
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> "product" = "tablet", "product" = "phone"
使用ic
前缀可发送Android设备的trait资格信息。
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> 30608,50354,50338,50352,30626
或
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> ic=52,ic=55
使用trait IDs发送iOS设备的trait资格信息。
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> d_sid=24, d_sid=25, d_sid=26
使用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
发送键值对,以添加iOS设备的trait资格信息。
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> product = tablet, product = phone
或
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> "product" = "tablet", "product" = "phone"
使用ic
前缀可发送iOS设备的trait资格信息。
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> 30608,50354,50338,50352,30626
或
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> ic=52,ic=55
使用trait IDs发送DPUUIDs的trait资格信息。
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> d_sid=24, d_sid=25, d_sid=26
使用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
发送键值对,以添加DPUUIDs的trait资格信息。
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> product = tablet, product = phone
或
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> "product" = "tablet", "product" = "phone"
使用ic
前缀可发送DPUUIDs的trait资格信息。
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> 30608,50354,50338,50352,30626
或
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> ic=52,ic=55