使用表中的映射关系，将 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” |
在事件级定义。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。 |
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 不同，后者会将标识符直接附加到 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 |
无对应报告 | Campaign Manager 360 目标位置不支持此功能。 |
addressInfo.state |
无对应报告 | Campaign Manager 360 目标位置不支持此功能。 |
addressInfo.hashedStreetAddress |
无对应报告 | Campaign Manager 360 目标位置不支持此功能。 |
购物车数据字段
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 |
必填。 |