Mapowanie pól

Użyj mapowań w tabelach, aby zmapować conversions.batchinsert w interfejsie Campaign Manager 360 API na jego IngestEventsRequest odpowiednik w interfejsie Data Manager API.

Pola żądania

conversions.batchinsert (interfejs Campaign Manager 360 API) IngestEventsRequest (interfejs Data Manager API) Uwagi
profileId – parametr ścieżki adresu URL Brak odpowiednika
kind Brak odpowiednika Pole metadanych; nie jest używane przez interfejs Data Manager API.
conversions events Wymagane. Lista konwersji lub zdarzeń. Szczegółowe informacje znajdziesz w sekcji Pola konwersji.
encryptionInfo Przeniesiono do events.adIdentifiers.encryptedUserIds Zdefiniowane na poziomie zdarzenia. Informacje o szyfrowaniu w Campaign Managerze 360 są teraz podawane w każdym zaszyfrowanym identyfikatorze użytkownika. Patrz sekcja Pola konwersji.
Brak odpowiednika encryptionInfo `encryptionInfo` na poziomie żądania to informacje o szyfrowaniu zaszyfrowanych identyfikatorów użytkowników `UserData`. Więcej informacji znajdziesz w sekcji Szyfrowanie.
Brak odpowiednika destinations Wymagane. Lista obiektów Destination określających konto docelowe i aktywność Floodlight dla zdarzeń. Szczegółowe informacje znajdziesz w przewodniku po miejscach docelowych. Zmapuj poszczególne pola zgodnie z opisem w sekcji Pola konwersji.
Brak odpowiednika consent Opcjonalne domyślne ustawienia zgody na potrzeby zdarzeń w żądaniu. Tę wartość możesz zastąpić w przypadku pojedynczego zdarzenia, ustawiając pole consent w Event.
Brak odpowiednika encoding Wymagane, jeśli wysyłasz identyfikatory użytkowników: ustaw na Encoding używane w przypadku wartości UserIdentifier. Jeśli nie używasz identyfikatorów użytkowników, to pole jest ignorowane.
Brak odpowiednika validateOnly Jeśli wartość to prawda, żądanie jest weryfikowane, ale nie wykonywane.

Pola konwersji

Conversion (interfejs Campaign Manager 360 API) Event (interfejs Data Manager API) Uwagi
floodlightConfigurationId destinations[].operatingAccount.accountId Zdefiniowane na poziomie żądania. Ustaw na identyfikator konfiguracji Floodlight.
Brak odpowiednika destinations[].operatingAccount.accountType Zdefiniowane na poziomie żądania. Ustaw na FLOODLIGHT_CONFIG.
floodlightActivityId destinations[].productDestinationId Zdefiniowane na poziomie żądania. Ustaw na identyfikator aktywności Floodlight (wcześniej znany jako identyfikator aktywności Floodlight).
kind Brak odpowiednika Pole metadanych; nie jest używane przez interfejs Data Manager API.
Brak odpowiednika destinations[].reference Zdefiniowane na poziomie żądania. Zdefiniowany przez użytkownika identyfikator miejsca docelowego. Ustaw to pole, jeśli wysyłasz zdarzenia do wielu miejsc docelowych w jednym żądaniu.
adUserDataConsent consent.adUserData Więcej informacji znajdziesz w sekcji Consent.
nonPersonalizedAd consent.adPersonalization Więcej informacji znajdziesz w sekcji Consent.
Brak odpowiednika destinationReferences Jeśli wysyłasz zdarzenia do wielu miejsc docelowych w jednym żądaniu, ustaw to pole na odpowiednią reference miejsca docelowego.
timestampMicros eventTimestamp
  • Jeśli używasz formatu JSON, ustaw wartość w formacie RFC 3339, który nieznacznie różni się od formatu interfejsu Campaign Manager 360 API, który oczekiwał timestampMicros w mikrosekundach od epoki uniksowej.
  • Jeśli używasz buforów protokołu, użyj Timestamp i ustaw pola seconds oraz (opcjonalnie) nanoseconds.

Więcej informacji znajdziesz w sekcji Format sygnatury czasowej.
value conversionValue
quantity conversionCount
ordinal Brak odpowiednika Pole ordinal z interfejsu Campaign Manager 360 API nie występuje w interfejsie Data Manager API. Zamiast tego możesz użyć transactionId, aby kontrolować sposób deduplikacji konwersji od tego samego użytkownika i z tego samego dnia.

W interfejsie Campaign Manager 360 API można było zapewnić deduplikację zdarzeń, ustawiając ordinal na stałą wartość, np. 1. W interfejsie Data Manager API pole transactionId musi być ustawione na unikalny identyfikator każdego zdarzenia.
Brak odpowiednika transactionId W interfejsie Data Manager API pole transactionId służy do kontrolowania sposobu deduplikacji konwersji od tego samego użytkownika i z tego samego dnia. To pole musi być ustawione na unikalny identyfikator każdego zdarzenia.

To pole jest opcjonalne, gdy wysyłasz konwersje offline Floodlight. Więcej informacji znajdziesz w sekcji Konwertowanie danych na obiekty Event.
customVariables customVariables Lista obiektów CustomVariable. Interfejs Data Manager API używa ciągów znaków jako kluczy zamiast wyliczeń. W polu variable używaj kluczy takich jak U1, U2.
limitAdTracking consent.adPersonalization Więcej informacji znajdziesz w sekcji Consent.
childDirectedTreatment consent.adPersonalization Więcej informacji znajdziesz w sekcji Consent.
treatmentForUnderage consent.adPersonalization Więcej informacji znajdziesz w sekcji Consent.
gclid adIdentifiers.gclid Więcej informacji znajdziesz w sekcji AdIdentifiers.
dclid adIdentifiers.dclid Więcej informacji znajdziesz w sekcji AdIdentifiers.
matchId adIdentifiers.matchId Więcej informacji znajdziesz w sekcji AdIdentifiers.
mobileDeviceId adIdentifiers.mobileId Więcej informacji znajdziesz w sekcji AdIdentifiers.
impressionId adIdentifiers.impressionId Więcej informacji znajdziesz w sekcji AdIdentifiers.
encryptedUserId adIdentifiers.encryptedUserIds Interfejs Data Manager API obsługuje wiele zaszyfrowanych identyfikatorów użytkowników. Więcej informacji znajdziesz w sekcji AdIdentifiers.
encryptedUserIdCandidates adIdentifiers.encryptedUserIds Każdy identyfikator kandydata jest mapowany na obiekt EncryptedUserId na liście.
encryptionInfo.kind Brak odpowiednika Pole metadanych; nie jest używane przez interfejs Data Manager API.
encryptionInfo.encryptionEntityType adIdentifiers.encryptedUserIds[].entityType Zamiast określać informacje o szyfrowaniu raz na żądanie, są one określane dla każdego zaszyfrowanego identyfikatora użytkownika.
encryptionInfo.encryptionEntityId adIdentifiers.encryptedUserIds[].entityId Zamiast określać informacje o szyfrowaniu raz na żądanie, są one określane dla każdego zaszyfrowanego identyfikatora użytkownika.
encryptionInfo.encryptionSource adIdentifiers.encryptedUserIds[].source Zamiast określać informacje o szyfrowaniu raz na żądanie, są one określane dla każdego zaszyfrowanego identyfikatora użytkownika.
sessionAttributesEncoded adIdentifiers.sessionAttributes Więcej informacji znajdziesz w sekcji AdIdentifiers.
cartData cartData Więcej informacji znajdziesz w sekcji Pola danych koszyka.
userIdentifiers userData.userIdentifiers Więcej informacji znajdziesz w sekcji Pola identyfikatorów użytkownika.

Pola identyfikatorów użytkownika

W interfejsie Data Manager API identyfikatory użytkowników są grupowane w UserData obiekcie w polu userData obiektu Event. Różni się to od interfejsu Campaign Manager 360 API, w którym identyfikatory są bezpośrednio dołączane do obiektu Conversion.

UserIdentifier (interfejs Campaign Manager 360 API) UserIdentifier (interfejs Data Manager API) Uwagi
hashedEmail emailAddress Ustaw na sformatowany i zaszyfrowany adres e-mail. Możesz też zaszyfrować zaszyfrowany adres e-mail.
hashedPhoneNumber phoneNumber Ustaw na sformatowany i zaszyfrowany numer telefonu. Możesz też zaszyfrować zaszyfrowany numer telefonu.
addressInfo address Ustaw na obiekt AddressInfo. Postępuj zgodnie z wytycznymi dotyczącymi formatowania i szyfrowania. Możesz też zaszyfrować zaszyfrowane atrybuty adresu.
addressInfo.hashedFirstName address.givenName
addressInfo.hashedLastName address.familyName
addressInfo.countryCode address.regionCode
addressInfo.postalCode address.postalCode
addressInfo.city Brak odpowiednika Nie jest obsługiwane w bieżącej wersji interfejsu Data Manager API.
addressInfo.state Brak odpowiednika Nie jest obsługiwane w bieżącej wersji interfejsu Data Manager API.
addressInfo.hashedStreetAddress Brak odpowiednika Nie jest obsługiwane w bieżącej wersji interfejsu Data Manager API.

Pola danych koszyka

CartData (interfejs Campaign Manager 360 API) CartData (interfejs Data Manager API) Uwagi
kind Brak odpowiednika Pole metadanych; nie jest używane przez interfejs Data Manager API.
merchantId merchantId
merchantFeedLabel merchantFeedLabel
merchantFeedLanguage merchantFeedLanguageCode
items items Lista obiektów Item. Więcej informacji znajdziesz w sekcji Pola produktu.

Pola produktu w danych koszyka

Item (interfejs Campaign Manager 360 API) Item (interfejs Data Manager API) Uwagi
kind Brak odpowiednika Pole metadanych; nie jest używane przez interfejs Data Manager API.
Brak odpowiednika itemId Opcjonalnie. Unikalny identyfikator produktu.
itemId merchantProductId Wymagane. Ustaw na identyfikator produktu w Merchant Center.
quantity quantity Wymagane.
unitPrice unitPrice Wymagane.
Wstecz
Przejście na nową wersję