使用表格中的映射关系，将 Campaign Manager 360 API 中的 conversions.batchinsert 映射到 Data Manager API 中对应的 IngestEventsRequest。
身份验证
Data Manager API 需要的凭据范围与 Campaign Manager 360 API 不同。按照设置 API 访问权限中的步骤生成包含 Data Manager API 范围的新凭据。
请求字段
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。 |
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 中不存在。相反，Data Manager API 会使用 transactionId 来对发送到同一 Floodlight 活动 ID 的事件进行去重。
在 Campaign Manager 360 API 中，您可以通过将 ordinal 设置为固定常量值（例如 1）来确保事件会进行去重。在 Data Manager API 中，transactionId 必须设置为每个事件的唯一标识符。
|
| 无对应报告 | transactionId |
Data Manager API 会结合使用 Floodlight 活动 ID 和 transactionId 来对事件进行去重。transactionId 字段必须设置为每个活动的唯一标识符。如果发送的是多来源转化事件，则此属性为必需属性。 如需了解详情，请参阅将数据转换为 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 |
必填。 |