使用表格中的映射，将 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 |
无对应报告 |
Data Manager API 中没有 Campaign Manager 360 API 中的 ordinal 字段。
相反，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 中，用户标识符在
UserData 对象中分组，该对象位于
Event 的 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 |
必需。 |