使用表格中的映射关系，将 Campaign Manager 360 API 中的 conversions.batchinsert 映射到 Data Manager API 中对应的 IngestEventsRequest。
请求字段
conversions.batchinsert (Campaign Manager 360 API) |
IngestEventsRequest (Data Manager API) |
备注 |
|---|---|---|
profileId 网址路径参数 |
无对应报告 | |
kind |
无对应报告 | 元数据字段；Data Manager API 不使用。 |
conversions |
events |
必需。转化或事件列表。如需了解详情，请参阅“转化”字段部分。 |
encryptionInfo |
已移至“events.adIdentifiers.encryptedUserIds” |
在事件级定义。现在，每个加密的用户 ID 中都指定了 Campaign Manager 360 加密信息。请参阅“转化”字段部分。 |
| 无对应报告 | encryptionInfo |
请求级 encryptionInfo 是加密后的 UserData 用户标识符的加密信息。如需了解详情，请参阅加密。 |
| 无对应报告 | destinations |
必需。一个 Destination 对象列表，用于定义事件的目标账号和 Floodlight 活动。如需了解详情，请参阅目标平台指南。按“转化”字段部分所示映射各个字段。 |
| 无对应报告 | consent |
请求中活动的可选默认同意情况设置。您可以通过设置 Event 的 consent 字段来替换单个事件的此值。 |
| 无对应报告 | encoding |
如果发送用户标识符，则为必需属性：设置为用于 UserIdentifier 值的 Encoding。如果不使用用户标识符，则系统会忽略此字段。 |
| 无对应报告 | validateOnly |
如果为 true，则系统会验证请求，但不会执行请求。 |
转化字段
Conversion (Campaign Manager 360 API) |
Event (Data Manager API) |
备注 |
|---|---|---|
floodlightConfigurationId |
destinations[].operatingAccount.accountId |
在请求级别定义。设置为 Floodlight 配置 ID。 |
| 无对应报告 | destinations[].operatingAccount.accountType |
在请求级别定义。设置为 FLOODLIGHT_CONFIG。 |
floodlightActivityId |
destinations[].productDestinationId |
在请求级别定义。设置为 Floodlight 活动 ID（之前称为 Floodlight 活动 ID）。 |
kind |
无对应报告 | 元数据字段；Data Manager API 不使用。 |
| 无对应报告 | destinations[].reference |
在请求级别定义。目的地的用户定义标识符。如果您在一个请求中将事件发送到多个目的地，请设置此字段。 |
adUserDataConsent |
consent.adUserData |
如需了解详情，请参阅 Consent。 |
nonPersonalizedAd |
consent.adPersonalization |
如需了解详情，请参阅 Consent。 |
| 无对应报告 | destinationReferences |
如果在单个请求中将事件发送到多个目的地，请将此字段设置为相应目的地的 reference。 |
timestampMicros |
eventTimestamp |
如需了解详情，请参阅时间戳格式。 |
value |
conversionValue |
|
quantity |
conversionCount |
|
ordinal |
无对应报告 |
Campaign Manager 360 API 中的 ordinal 字段在 Data Manager API 中不存在。不过，您可以使用 transactionId 来控制如何对同一用户在同一天完成的多次转化进行去重。
在 Campaign Manager 360 API 中，您可以通过将 ordinal 设置为固定常量值（例如 1）来确保事件会进行去重。在 Data Manager API 中，transactionId 必须设置为每个事件的唯一标识符。
|
| 无对应报告 | transactionId |
在 Data Manager API 中，transactionId 用于控制如何对同一用户在同一天完成的多次转化进行去重。此字段必须设置为每个事件的唯一标识符。
发送 Floodlight 线下转化时，此字段为可选字段。如需了解详情，请参阅将数据转换为 Event 对象。
|
customVariables |
customVariables |
CustomVariable 对象的列表。Data Manager API 使用字符串作为键，而不是枚举。为 variable 字段使用 U1、U2 等键。 |
limitAdTracking |
consent.adPersonalization |
如需了解详情，请参阅 Consent。 |
childDirectedTreatment |
consent.adPersonalization |
如需了解详情，请参阅 Consent。 |
treatmentForUnderage |
consent.adPersonalization |
如需了解详情，请参阅 Consent。 |
gclid |
adIdentifiers.gclid |
如需了解详情，请参阅 AdIdentifiers。 |
dclid |
adIdentifiers.dclid |
如需了解详情，请参阅 AdIdentifiers。 |
matchId |
adIdentifiers.matchId |
如需了解详情，请参阅 AdIdentifiers。 |
mobileDeviceId |
adIdentifiers.mobileId |
如需了解详情，请参阅 AdIdentifiers。 |
impressionId |
adIdentifiers.impressionId |
如需了解详情，请参阅 AdIdentifiers。 |
encryptedUserId |
adIdentifiers.encryptedUserIds |
Data Manager API 支持多个加密的用户 ID。如需了解详情，请参阅 AdIdentifiers。 |
encryptedUserIdCandidates |
adIdentifiers.encryptedUserIds |
每个候选 ID 都会映射到列表中的一个 EncryptedUserId 对象。 |
encryptionInfo.kind |
无对应报告 | 元数据字段；Data Manager API 不使用。 |
encryptionInfo.encryptionEntityType |
adIdentifiers.encryptedUserIds[].entityType |
加密信息不再是针对每个请求指定一次，而是针对每个加密的用户 ID 指定一次。 |
encryptionInfo.encryptionEntityId |
adIdentifiers.encryptedUserIds[].entityId |
加密信息不再是针对每个请求指定一次，而是针对每个加密的用户 ID 指定一次。 |
encryptionInfo.encryptionSource |
adIdentifiers.encryptedUserIds[].source |
加密信息不再是针对每个请求指定一次，而是针对每个加密的用户 ID 指定一次。 |
sessionAttributesEncoded |
adIdentifiers.sessionAttributes |
如需了解详情，请参阅 AdIdentifiers。 |
cartData |
cartData |
如需了解详情，请参阅购物车数据字段。 |
userIdentifiers |
userData.userIdentifiers |
如需了解详情，请参阅用户标识符字段。 |
用户标识符字段
在 Data Manager API 中，用户标识符分组在 Event 的 userData 字段下的 UserData 对象中。这与 Campaign Manager 360 API 不同，在 Campaign Manager 360 API 中，标识符直接附加到 Conversion 对象。
UserIdentifier (Campaign Manager 360 API) |
UserIdentifier (Data Manager API) |
备注 |
|---|---|---|
hashedEmail |
emailAddress |
设置为经过格式化和哈希处理的电子邮件地址。您还可以加密哈希处理后的电子邮件地址。 |
hashedPhoneNumber |
phoneNumber |
设置为已格式化和哈希处理的电话号码。您还可以对哈希处理后的电话号码进行加密。 |
addressInfo |
address |
设置为 AddressInfo 对象。遵循格式设置和哈希处理指南。您还可以加密地址的哈希属性。 |
addressInfo.hashedFirstName |
address.givenName |
|
addressInfo.hashedLastName |
address.familyName |
|
addressInfo.countryCode |
address.regionCode |
|
addressInfo.postalCode |
address.postalCode |
|
addressInfo.city |
无对应报告 | 当前版本的数据管理器 API 不支持此功能。 |
addressInfo.state |
无对应报告 | 当前版本的数据管理器 API 不支持此功能。 |
addressInfo.hashedStreetAddress |
无对应报告 | 当前版本的数据管理器 API 不支持此功能。 |
购物车数据字段
CartData (Campaign Manager 360 API) |
CartData (Data Manager API) |
备注 |
|---|---|---|
kind |
无对应报告 | 元数据字段；Data Manager API 不使用。 |
merchantId |
merchantId |
|
merchantFeedLabel |
merchantFeedLabel |
|
merchantFeedLanguage |
merchantFeedLanguageCode |
|
items |
items |
Item 对象的列表。如需了解详情，请参阅商品字段。 |
购物车数据的商品字段
Item (Campaign Manager 360 API) |
Item (Data Manager API) |
备注 |
|---|---|---|
kind |
无对应报告 | 元数据字段；Data Manager API 不使用。 |
| 无对应报告 | itemId |
可选。商品的唯一标识符。 |
itemId |
merchantProductId |
必需。设置为相应商品的 Merchant Center 商品 ID。 |
quantity |
quantity |
必填。 |
unitPrice |
unitPrice |
必填。 |