Mapowanie pól

Użyj mapowań w tabelach, aby zmapować conversions.batchinsert w interfejsie Campaign Manager 360 API na odpowiednik IngestEventsRequest 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
profileId parametr ścieżki adresu URL 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. Zapoznaj się z sekcją Pola konwersji.
Brak odpowiednika encryptionInfo Parametr encryptionInfo na poziomie żądania to informacje o szyfrowaniu zaszyfrowanych identyfikatorów użytkowników UserData. Szczegółowe informacje znajdziesz w artykule Szyfrowanie.
Brak odpowiednika destinations Parametr wymagany. Lista obiektów Destination, które definiują konto docelowe i aktywność Floodlight dla zdarzeń. Szczegółowe informacje znajdziesz w przewodniku po miejscach docelowych. Zmapuj poszczególne pola, jak pokazano w sekcji Pola konwersji.
Brak odpowiednika consent Opcjonalne domyślne ustawienia zgody na zdarzenia w żądaniu. Możesz zastąpić tę wartość w przypadku pojedynczego zdarzenia, ustawiając pole consent w Event.
Brak odpowiednika encoding Wymagane, jeśli wysyłasz identyfikatory użytkowników: ustaw wartość Encoding używaną 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 sprawdzane, ale nie jest 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 jako: 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. 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 na stronie Consent.
nonPersonalizedAd consent.adPersonalization Więcej informacji znajdziesz na stronie Consent.
Brak odpowiednika destinationReferences Jeśli wysyłasz zdarzenia do wielu miejsc docelowych w jednym żądaniu, ustaw w tym polu odpowiedni parametr reference miejsca docelowego.
timestampMicros eventTimestamp
  • Jeśli używasz formatu JSON, ustaw wartość w formacie RFC 3339, który różni się nieco od interfejsu Campaign Manager 360 API, który oczekiwał wartości timestampMicros w mikrosekundach od epoki uniksowej.
  • Jeśli używasz buforów protokołu, użyj Timestamp i ustaw pola seconds oraz (opcjonalnie) nanoseconds.

Szczegółowe informacje znajdziesz w sekcji Formaty 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 parametru transactionId do usuwania duplikatów zdarzeń wysyłanych do tego samego identyfikatora aktywności Floodlight.

W interfejsie Campaign Manager 360 API możesz zapewnić deduplikację zdarzeń, ustawiając parametr ordinal na stałą wartość, np. 1. W interfejsie Data Manager API parametr transactionId musi być ustawiony na unikalny identyfikator każdego zdarzenia.
Brak odpowiednika transactionId Interfejs Data Manager API używa kombinacji identyfikatora aktywności Floodlight i transactionId do usuwania duplikatów zdarzeń. Pole transactionId musi być ustawione na unikalny identyfikator każdego zdarzenia.

Wymagany w przypadku wysyłania zdarzeń na potrzeby konwersji z wieloma źródłami. Więcej informacji znajdziesz w artykule 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 typów wyliczeniowych. W polu variable użyj kluczy takich jak U1, U2.
limitAdTracking consent.adPersonalization Więcej informacji znajdziesz na stronie Consent.
childDirectedTreatment consent.adPersonalization Więcej informacji znajdziesz na stronie Consent.
treatmentForUnderage consent.adPersonalization Więcej informacji znajdziesz na stronie Consent.
gclid adIdentifiers.gclid Więcej informacji znajdziesz na stronie AdIdentifiers.
dclid adIdentifiers.dclid Więcej informacji znajdziesz na stronie AdIdentifiers.
matchId adIdentifiers.matchId Więcej informacji znajdziesz na stronie AdIdentifiers.
mobileDeviceId adIdentifiers.mobileId Więcej informacji znajdziesz na stronie AdIdentifiers.
impressionId adIdentifiers.impressionId Więcej informacji znajdziesz na stronie AdIdentifiers.
encryptedUserId adIdentifiers.encryptedUserIds Interfejs Data Manager API obsługuje wiele zaszyfrowanych identyfikatorów użytkowników. Więcej informacji znajdziesz na stronie 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 podawać informacje o szyfrowaniu raz na żądanie, podaje się je dla każdego zaszyfrowanego identyfikatora użytkownika.
encryptionInfo.encryptionEntityId adIdentifiers.encryptedUserIds[].entityId Zamiast podawać informacje o szyfrowaniu raz na żądanie, podaje się je dla każdego zaszyfrowanego identyfikatora użytkownika.
encryptionInfo.encryptionSource adIdentifiers.encryptedUserIds[].source Zamiast podawać informacje o szyfrowaniu raz na żądanie, podaje się je dla każdego zaszyfrowanego identyfikatora użytkownika.
sessionAttributesEncoded adIdentifiers.sessionAttributes Więcej informacji znajdziesz na stronie AdIdentifiers.
cartData cartData Więcej informacji znajdziesz w artykule 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ą pogrupowane w obiekcie UserData w polu userData obiektu Event. Różni się to od interfejsu Campaign Manager 360 API, w którym identyfikatory są bezpośrednio dołączone 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 zahaszowany numer telefonu. Możesz też zaszyfrować zahaszowany 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 Nieobsługiwane w przypadku miejsc docelowych Campaign Managera 360.
addressInfo.state Brak odpowiednika Nieobsługiwane w przypadku miejsc docelowych Campaign Managera 360.
addressInfo.hashedStreetAddress Brak odpowiednika Nieobsługiwane w przypadku miejsc docelowych Campaign Managera 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 elementów.

Pola produktów w przypadku 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 elementu.
itemId merchantProductId Parametr wymagany. Ustaw identyfikator produktu w Merchant Center dla danego produktu.
quantity quantity Parametr wymagany.
unitPrice unitPrice Parametr wymagany.
Wstecz
Przejście na nową wersję