使用表格中的對應，將 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 使用者 ID 的加密資訊。詳情請參閱「加密」一文。 |
| 無對應報告 | destinations |
必要。Destination 物件清單，用於定義事件的目標帳戶和 Floodlight 活動。詳情請參閱目的地指南。如「轉換欄位」部分所示，對應個別欄位。 |
| 無對應報告 | consent |
要求的事件可選用預設同意聲明設定。如要覆寫個別活動的這項值，請設定 Event 的 consent 欄位。 |
| 無對應報告 | encoding |
如果傳送使用者 ID，則為必填：設為用於 UserIdentifier 值的 Encoding。如未使用使用者 ID，系統會忽略這個欄位。 |
| 無對應報告 | 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 |
在要求層級定義。目的地的使用者定義 ID。如果您在單一要求中將事件傳送至多個目的地，請設定這個欄位。 |
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 必須設為每個事件的專屬 ID。 |
| 無對應報告 | transactionId |
在 Data Manager API 中，transactionId 用於控管如何避免重複計算同日中來自相同使用者的轉換。這個欄位必須設為每個事件的專屬 ID。傳送 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 |
詳情請參閱使用者 ID 欄位。 |
使用者 ID 欄位
在 Data Manager API 中，使用者 ID 會歸類在 Event 的 userData 欄位下，屬於 UserData 物件。這與 Campaign Manager 360 API 不同，後者會直接將 ID 附加至 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 |
(選用步驟) 作品的專屬 ID。 |
itemId |
merchantProductId |
必要。設為項目的 Merchant Center 產品 ID。 |
quantity |
quantity |
必要。 |
unitPrice |
unitPrice |
必要。 |