Skorzystaj z mapowań w tabelach, aby przypisać element conversions.batchinsert w interfejsie Campaign Manager 360 API do jego odpowiednika IngestEventsRequest w interfejsie Data Manager API.
Uwierzytelnianie
Interfejs Data Manager API wymaga danych logowania o zakresie innym niż interfejs Campaign Manager 360 API. Aby wygenerować nowe dane logowania, które obejmują zakres interfejsu Data Manager API, wykonaj czynności opisane w sekcji Konfigurowanie dostępu do interfejsu API.
Pola żądania
conversions.batchinsert (interfejs API Campaign Managera 360) |
IngestEventsRequest (interfejs Data Manager API) |
Uwagi |
|---|---|---|
profileId Parametr ścieżki adresu URL |
Brak odpowiednika | |
kind |
Brak odpowiednika | Pole metadanych, które nie jest używane przez interfejs Data Manager API. |
conversions |
events |
Parametr wymagany. Lista konwersji lub zdarzeń. Szczegółowe informacje znajdziesz w sekcji dotyczącej pól konwersji. |
encryptionInfo |
Przeniesiono do: events.adIdentifiers.encryptedUserIds |
Określony 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 |
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 |
Parametr wymagany. Lista obiektów Destination, które określają konto docelowe i aktywność Floodlight dla zdarzeń. Szczegółowe informacje znajdziesz w przewodniku po miejscach docelowych. Zmapuj poszczególne pola zgodnie z instrukcjami w sekcji dotyczącej pól konwersji. |
| Brak odpowiednika | consent |
Opcjonalne domyślne ustawienia dotyczące zgody na zdarzenia w żądaniu. Możesz zastąpić tę wartość w przypadku poszczególnych zdarzeń, ustawiając pole consent w Event. |
| Brak odpowiednika | encoding |
Wymagany, jeśli wysyłane są identyfikatory użytkowników: ustaw na Encoding używany 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 API Campaign Managera 360) |
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 jako: FLOODLIGHT_CONFIG. |
floodlightActivityId |
destinations[].productDestinationId |
Zdefiniowane na poziomie żądania. Ustaw na identyfikator aktywności Floodlight. |
kind |
Brak odpowiednika | Pole metadanych, które 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 reference miejsca docelowego. |
timestampMicros |
eventTimestamp |
Szczegółowe informacje znajdziesz w sekcji Format sygnatury czasowej. |
value |
conversionValue |
|
quantity |
conversionCount |
|
ordinal |
Brak odpowiednika |
Pola ordinal z interfejsu Campaign Manager 360 API nie ma w interfejsie Data Manager API.
Zamiast tego interfejs Data Manager API używa transactionId do usuwania duplikatów zdarzeń wysyłanych do tego samego identyfikatora aktywności Floodlight.
W interfejsie Campaign Managera 360 API możesz zapewnić deduplikację zdarzeń, ustawiając wartość 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 wydarzenia.
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 wyliczeń. Użyj klawiszy takich jak U1, U2 w polu variable. |
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, które nie jest używane przez interfejs Data Manager API. |
encryptionInfo.encryptionEntityType |
adIdentifiers.encryptedUserIds[].entityType |
Zamiast określać informacje o szyfrowaniu raz na żądanie, określa się je dla każdego zaszyfrowanego identyfikatora użytkownika. |
encryptionInfo.encryptionEntityId |
adIdentifiers.encryptedUserIds[].entityId |
Zamiast określać informacje o szyfrowaniu raz na żądanie, określa się je dla każdego zaszyfrowanego identyfikatora użytkownika. |
encryptionInfo.encryptionSource |
adIdentifiers.encryptedUserIds[].source |
Zamiast określać informacje o szyfrowaniu raz na żądanie, określa się je 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 obiekcie UserData w polu userData obiektu Event. Różni się to od interfejsu Campaign Managera 360 API, w którym identyfikatory są bezpośrednio dołączane do obiektu Conversion.
UserIdentifier (interfejs API Campaign Managera 360) |
UserIdentifier (interfejs Data Manager API) |
Uwagi |
|---|---|---|
hashedEmail |
emailAddress |
Ustaw na sformatowany i zahaszowany adres e-mail. Możesz też zaszyfrować zahaszowany adres e-mail. |
hashedPhoneNumber |
phoneNumber |
Ustaw na 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ć zahaszowane 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 API Campaign Managera 360) |
CartData (interfejs Data Manager API) |
Uwagi |
|---|---|---|
kind |
Brak odpowiednika | Pole metadanych, które 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 produktów. |
Pola produktów w danych koszyka
Item (interfejs API Campaign Managera 360) |
Item (interfejs Data Manager API) |
Uwagi |
|---|---|---|
kind |
Brak odpowiednika | Pole metadanych, które 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 dla danego produktu. |
quantity |
quantity |
Parametr wymagany. |
unitPrice |
unitPrice |
Parametr wymagany. |