使用表格中的映射，将 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 |
在事件级定义。Campaign Manager 360 加密信息现在在每个加密的用户 ID 中指定。请参阅转化字段部分。 |
| 无对应报告 | 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 |
无对应报告 |
Data Manager API 中没有 Campaign Manager 360 API 中的 ordinal 字段。
不过，您可以使用 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 中，用户标识符在
UserData 对象下的 userData 字段中分组。Event这与
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 |
无对应报告 | Data Manager API 的当前版本不支持此字段。 |
addressInfo.state |
无对应报告 | Data Manager API 的当前版本不支持此字段。 |
addressInfo.hashedStreetAddress |
无对应报告 | Data Manager 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 |
必需。 |