Utilizza le mappature nelle tabelle per mappare un
conversions.batchinsert nell'API Campaign Manager 360 al suo
equivalente IngestEventsRequest 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 includono l'ambito dell'API Data Manager.
Campi di richiesta
conversions.batchinsert (API Campaign Manager 360) |
IngestEventsRequest (API Data Manager) |
Note |
|---|---|---|
profileId parametro di percorso dell'URL |
Nessun equivalente | |
kind |
Nessun equivalente | Campo dei metadati; non utilizzato dall'API Data Manager. |
conversions |
events |
Obbligatorio. L'elenco delle conversioni o degli 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 contiene le informazioni di crittografia per gli identificatori dell'utente UserData criptati. Per maggiori dettagli, consulta Crittografia. |
| Nessun equivalente | destinations |
Obbligatorio. Un elenco di oggetti Destination che definiscono l'account di destinazione e l'attività Floodlight per gli eventi. Per maggiori 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 invii identificatori utente: imposta il valore su Encoding utilizzato per i valori UserIdentifier. Se non utilizzi gli identificatori dell'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 maggiori dettagli, consulta Consent. |
nonPersonalizedAd |
consent.adPersonalization |
Per maggiori 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 |
Per maggiori dettagli, consulta Formato del 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 deduplicare gli eventi inviati allo stesso ID attività Floodlight.
Nell'API Campaign Manager 360, puoi assicurarti che gli eventi vengano deduplicati impostando ordinal su un valore fisso e costante, 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 Converti i dati in oggetti Event.
|
customVariables |
customVariables |
Un elenco di oggetti CustomVariable. L'API Data Manager utilizza stringhe come chiavi anziché enum. Utilizza chiavi come U1, U2 per il campo variable. |
limitAdTracking |
consent.adPersonalization |
Per maggiori dettagli, consulta Consent. |
childDirectedTreatment |
consent.adPersonalization |
Per maggiori dettagli, consulta Consent. |
treatmentForUnderage |
consent.adPersonalization |
Per maggiori dettagli, consulta Consent. |
gclid |
adIdentifiers.gclid |
Per maggiori dettagli, consulta AdIdentifiers. |
dclid |
adIdentifiers.dclid |
Per maggiori dettagli, consulta AdIdentifiers. |
matchId |
adIdentifiers.matchId |
Per maggiori dettagli, consulta AdIdentifiers. |
mobileDeviceId |
adIdentifiers.mobileId |
Per maggiori dettagli, consulta AdIdentifiers. |
impressionId |
adIdentifiers.impressionId |
Per maggiori dettagli, consulta AdIdentifiers. |
encryptedUserId |
adIdentifiers.encryptedUserIds |
L'API Data Manager supporta più ID utente criptati. Per maggiori 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, queste vengono specificate per ID utente criptato. |
encryptionInfo.encryptionEntityId |
adIdentifiers.encryptedUserIds[].entityId |
Anziché specificare le informazioni di crittografia una volta per richiesta, queste vengono specificate per ogni ID utente criptato. |
encryptionInfo.encryptionSource |
adIdentifiers.encryptedUserIds[].source |
Anziché specificare le informazioni di crittografia una volta per richiesta, queste vengono specificate per ID utente criptato. |
sessionAttributesEncoded |
adIdentifiers.sessionAttributes |
Per maggiori dettagli, consulta AdIdentifiers. |
cartData |
cartData |
Per maggiori dettagli, consulta Campi dei dati del carrello. |
userIdentifiers |
userData.userIdentifiers |
Per maggiori dettagli, consulta Campi identificatore dell'utente. |
Campi identificatore dell'utente
Nell'API Data Manager, gli identificatori degli utenti sono raggruppati all'interno di un oggetto UserData nel campo userData di Event. Questo approccio è diverso da quello dell'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 |
Imposta il 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 con hash 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 maggiori dettagli, consulta Campi degli elementi. |
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 dell'elemento. |
itemId |
merchantProductId |
Obbligatorio. Imposta l'ID prodotto di Merchant Center per l'articolo. |
quantity |
quantity |
Obbligatorio. |
unitPrice |
unitPrice |
Obbligatorio. |