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.

Uwierzytelnianie

Interfejs Data Manager API wymaga danych logowania o innym zakresie niż interfejs Campaign Manager 360 API. Aby wygenerować nowe dane logowania, które obejmują zakres interfejsu Data Manager API, wykonaj czynności opisane w artykule Konfigurowanie dostępu do interfejsu API.

Pola żądania

conversions.batchinsert (interfejs Campaign Manager 360 API) IngestEventsRequest (interfejs Data Manager API) Uwagi
Parametr ścieżki adresu URL profileId Brak odpowiednika
kind Brak odpowiednika Pole metadanych; nie jest używane przez interfejs Data Manager API.
conversions events Parametr wymagany. 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 usłudze Campaign Manager 360 są teraz podawane w każdym zaszyfrowanym identyfikatorze użytkownika. Więcej informacji znajdziesz w sekcji Pola konwersji.
Brak odpowiednika encryptionInfo `encryptionInfo`encryptionInfo na poziomie żądania to informacje o szyfrowaniu zaszyfrowanych UserData identyfikatorów użytkownika. Więcej informacji znajdziesz w artykule Szyfrowanie.
Brak odpowiednika destinations Parametr wymagany. 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 Parametr wymagany, jeśli wysyłasz identyfikatory użytkownika: ustaw wartość Encoding używaną w przypadku wartości UserIdentifier. Jeśli nie używasz identyfikatorów użytkownika, 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 identyfikator konfiguracji Floodlight.
Brak odpowiednika destinations[].operatingAccount.accountType Zdefiniowane na poziomie żądania. Ustaw wartość FLOODLIGHT_CONFIG.
floodlightActivityId destinations[].productDestinationId Zdefiniowane na poziomie żądania. Ustaw 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. Identyfikator miejsca docelowego zdefiniowany przez użytkownika. 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ą wartość reference miejsca docelowego.
timestampMicros eventTimestamp
  • Jeśli używasz formatu JSON, ustaw wartość w formacie RFC 3339, który nieznacznie różni się od interfejsu Campaign Manager 360 API, w którym oczekiwano wartości timestampMicros w mikrosekundach od początku epoki systemu Unix.
  • 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 interfejs Data Manager API używa pola transactionId do deduplikacji zdarzeń wysyłanych do tego samego identyfikatora aktywności Floodlight.

W interfejsie Campaign Manager 360 API można było zapewnić deduplikację zdarzeń, ustawiając pole 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 Interfejs Data Manager API używa kombinacji identyfikatora aktywności Floodlight i pola transactionId do deduplikacji zdarzenia. Pole transactionId musi być ustawione na unikalny identyfikator każdego zdarzenia.

Parametr wymagany , jeśli wysyłasz zdarzenia dotyczące konwersji z wieloma źródłami. Więcej informacji znajdziesz w artykule Konwertowanie danych na obiektyEventwięcej szczegółów.
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żytkownika. 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żytkownika 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 sformatowany i zaszyfrowany adres e-mail. Możesz też zaszyfrować zaszyfrowany adres e-mail.
hashedPhoneNumber phoneNumber Ustaw sformatowany i zaszyfrowany numer telefonu. Możesz też zaszyfrować zaszyfrowany numer telefonu.
addressInfo address Ustaw 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 przypadku miejsc docelowych w usłudze Campaign Manager 360.
addressInfo.state Brak odpowiednika Nie jest obsługiwane w przypadku miejsc docelowych w usłudze Campaign Manager 360.
addressInfo.hashedStreetAddress Brak odpowiednika Nie jest obsługiwane w przypadku miejsc docelowych w usłudze Campaign Manager 360.

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 Parametr wymagany. Ustaw identyfikator produktu w Merchant Center.
quantity quantity Parametr wymagany.
unitPrice unitPrice Parametr wymagany.
Wstecz
Przejście na nową wersję