請使用表格中的對應，將 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 使用者 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。 |
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，針對傳送至相同 Floodlight 活動 ID 的事件進行重複資料刪除。在 Campaign Manager 360 API 中，您可以將 ordinal 設為固定常數值 (例如 1)，確保系統會將重複事件排除。在 Data Manager API 中，
transactionId 必須設為每個事件的專屬 ID。
|
| 無對應報告 | transactionId |
Data Manager API 會結合 Floodlight 活動 ID 和 transactionId，藉此排除重複事件。transactionId 欄位必須設為每個事件的專屬 ID。如要傳送多來源轉換的事件，此為必填屬性。 詳情請參閱「將資料轉換為 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 |
必要。 |