Mappature di campi

Utilizza i mapping nelle tabelle per mappare un conversions.batchinsert nell'API Campaign Manager 360 al suo IngestEventsRequest equivalente nell'API Data Manager.

Autenticazione

L'API Data Manager richiede credenziali con un ambito diverso rispetto all'API Campaign Manager 360. Segui i passaggi descritti in Configura l'accesso API per generare nuove credenziali che includano l'ambito dell'API Data Manager.

Campi di richiesta

conversions.batchinsert (API Campaign Manager 360) IngestEventsRequest (API Data Manager) Note
profileId Parametro del percorso URL Nessun equivalente
kind Nessun equivalente Campo dei metadati; non utilizzato dall'API Data Manager.
conversions events Obbligatorio. L'elenco di conversioni o eventi. Per maggiori dettagli, consulta la sezione Campi di conversione.
encryptionInfo Spostato in events.adIdentifiers.encryptedUserIds Definito a livello di evento. Le informazioni sulla crittografia di Campaign Manager 360 sono ora specificate in ogni ID utente criptato. Consulta la sezione Campi di conversione.
Nessun equivalente encryptionInfo encryptionInfo a livello di richiesta sono le informazioni di crittografia per gli identificatori utente UserData criptati. Per maggiori dettagli, vedi Crittografia.
Nessun equivalente destinations Obbligatorio. Un elenco di oggetti Destination che definiscono l'account di destinazione e l'attività Floodlight per gli eventi. Per ulteriori dettagli, consulta la guida alle destinazioni. Mappa i singoli campi come mostrato nella sezione Campi di conversione.
Nessun equivalente consent Impostazioni predefinite facoltative per il consenso per gli eventi nella richiesta. Puoi eseguire l'override di questo valore per un singolo evento impostando il campo consent di Event.
Nessun equivalente encoding Obbligatorio se vengono inviati identificatori utente:impostato su Encoding utilizzato per i valori di UserIdentifier. Se non utilizzi gli identificatori utente, questo campo viene ignorato.
Nessun equivalente validateOnly Se impostato su true, la richiesta viene convalidata, ma non eseguita.

Campi di conversione

Conversion (API Campaign Manager 360) Event (API Data Manager) Note
floodlightConfigurationId destinations[].operatingAccount.accountId Definito a livello di richiesta. Impostato sull'ID configurazione Floodlight.
Nessun equivalente destinations[].operatingAccount.accountType Definito a livello di richiesta. Da impostare su FLOODLIGHT_CONFIG.
floodlightActivityId destinations[].productDestinationId Definito a livello di richiesta. Impostato sull'ID attività Floodlight.
kind Nessun equivalente Campo dei metadati; non utilizzato dall'API Data Manager.
Nessun equivalente destinations[].reference Definito a livello di richiesta. Un identificatore definito dall'utente per la destinazione. Imposta questo campo se invii eventi a più destinazioni in un'unica richiesta.
adUserDataConsent consent.adUserData Per ulteriori dettagli, consulta Consent.
nonPersonalizedAd consent.adPersonalization Per ulteriori dettagli, consulta Consent.
Nessun equivalente destinationReferences Se invii eventi a più destinazioni in un'unica richiesta, imposta questo campo sul reference corrispondente della destinazione.
timestampMicros eventTimestamp
  • Se utilizzi il formato JSON, imposta un valore nel formato RFC 3339, che differisce leggermente dall'API Campaign Manager 360, che prevedeva timestampMicros in microsecondi dall'epoca Unix.
  • Se utilizzi i buffer di protocollo, usa un Timestamp e imposta i campi seconds e (facoltativamente) nanoseconds.

Per maggiori dettagli, vedi Formato per il timestamp.
value conversionValue
quantity conversionCount
ordinal Nessun equivalente Il campo ordinal dell'API Campaign Manager 360 non è presente nell'API Data Manager. L'API Data Manager utilizza invece transactionId per eliminare i duplicati degli eventi inviati allo stesso ID attività Floodlight.

Nell'API Campaign Manager 360, puoi assicurarti che gli eventi vengano deduplicati impostando ordinal su un valore costante fisso, ad esempio 1. Nell'API Data Manager, transactionId deve essere impostato su un identificatore univoco per ogni evento.
Nessun equivalente transactionId L'API Data Manager utilizza una combinazione di ID attività Floodlight e transactionId per deduplicare l'evento. Il campo transactionId deve essere impostato su un identificatore univoco per ogni evento.

Obbligatorio se invii eventi per conversioni multisorgente. Per ulteriori dettagli, consulta Convertire i dati in oggetti Event.
customVariables customVariables Un elenco di oggetti CustomVariable. L'API Data Manager utilizza stringhe come chiavi anziché enumerazioni. Utilizza tasti come U1, U2 per il campo variable.
limitAdTracking consent.adPersonalization Per ulteriori dettagli, consulta Consent.
childDirectedTreatment consent.adPersonalization Per ulteriori dettagli, consulta Consent.
treatmentForUnderage consent.adPersonalization Per ulteriori dettagli, consulta Consent.
gclid adIdentifiers.gclid Per ulteriori dettagli, consulta AdIdentifiers.
dclid adIdentifiers.dclid Per ulteriori dettagli, consulta AdIdentifiers.
matchId adIdentifiers.matchId Per ulteriori dettagli, consulta AdIdentifiers.
mobileDeviceId adIdentifiers.mobileId Per ulteriori dettagli, consulta AdIdentifiers.
impressionId adIdentifiers.impressionId Per ulteriori dettagli, consulta AdIdentifiers.
encryptedUserId adIdentifiers.encryptedUserIds L'API Data Manager supporta più ID utente criptati. Per ulteriori dettagli, consulta AdIdentifiers.
encryptedUserIdCandidates adIdentifiers.encryptedUserIds Ogni ID candidato viene mappato a un oggetto EncryptedUserId nell'elenco.
encryptionInfo.kind Nessun equivalente Campo dei metadati; non utilizzato dall'API Data Manager.
encryptionInfo.encryptionEntityType adIdentifiers.encryptedUserIds[].entityType Anziché specificare le informazioni di crittografia una volta per richiesta, vengono specificate per ID utente criptato.
encryptionInfo.encryptionEntityId adIdentifiers.encryptedUserIds[].entityId Anziché specificare le informazioni di crittografia una volta per richiesta, vengono specificate per ID utente criptato.
encryptionInfo.encryptionSource adIdentifiers.encryptedUserIds[].source Anziché specificare le informazioni di crittografia una volta per richiesta, vengono specificate per ID utente criptato.
sessionAttributesEncoded adIdentifiers.sessionAttributes Per ulteriori dettagli, consulta AdIdentifiers.
cartData cartData Per maggiori dettagli, vedi Campi dei dati del carrello.
userIdentifiers userData.userIdentifiers Per maggiori dettagli, vedi Campi identificatore dell'utente.

Campi identificatore dell'utente

Nell'API Data Manager, gli identificatori utente sono raggruppati all'interno di un oggetto UserData nel campo userData di Event. Ciò è diverso dall'API Campaign Manager 360, in cui gli identificatori sono collegati direttamente all'oggetto Conversion.

UserIdentifier (API Campaign Manager 360) UserIdentifier (API Data Manager) Note
hashedEmail emailAddress Imposta l'indirizzo email formattato e sottoposto ad hashing. Puoi anche criptare l'indirizzo email sottoposto ad hashing.
hashedPhoneNumber phoneNumber Impostato sul numero di telefono formattato e sottoposto ad hashing. Puoi anche criptare il numero di telefono sottoposto ad hashing.
addressInfo address Impostato su un oggetto AddressInfo. Segui le linee guida sulla formattazione e sull'hashing. Puoi anche criptare gli attributi sottoposti ad hashing di un indirizzo.
addressInfo.hashedFirstName address.givenName
addressInfo.hashedLastName address.familyName
addressInfo.countryCode address.regionCode
addressInfo.postalCode address.postalCode
addressInfo.city Nessun equivalente Non supportato per le destinazioni Campaign Manager 360.
addressInfo.state Nessun equivalente Non supportato per le destinazioni Campaign Manager 360.
addressInfo.hashedStreetAddress Nessun equivalente Non supportato per le destinazioni Campaign Manager 360.

Campi dei dati del carrello

CartData (API Campaign Manager 360) CartData (API Data Manager) Note
kind Nessun equivalente Campo dei metadati; non utilizzato dall'API Data Manager.
merchantId merchantId
merchantFeedLabel merchantFeedLabel
merchantFeedLanguage merchantFeedLanguageCode
items items Un elenco di oggetti Item. Per ulteriori dettagli, consulta Campi elemento.

Campi degli articoli per i dati del carrello

Item (API Campaign Manager 360) Item (API Data Manager) Note
kind Nessun equivalente Campo dei metadati; non utilizzato dall'API Data Manager.
Nessun equivalente itemId Facoltativo. Un identificatore univoco per l'elemento.
itemId merchantProductId Obbligatorio. Imposta l'ID prodotto di Merchant Center per l'articolo.
quantity quantity Obbligatorio.
unitPrice unitPrice Obbligatorio.
Indietro
Procedura per l'upgrade