請使用表格中的對應關係，將 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 使用者 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 |
無對應報告 |
Data Manager API 沒有 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 |
無對應報告 | 不支援 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 |
(選用步驟) 項目的專屬 ID。 |
itemId |
merchantProductId |
必填項目。設為項目的 Merchant Center 產品 ID。 |
quantity |
quantity |
必要。 |
unitPrice |
unitPrice |
必要。 |