Utilizza i mapping nelle tabelle per mappare un
conversions.batchinsert nell'API Campaign Manager 360 al relativo
IngestEventsRequest equivalente nell'API Data Manager.
Campi della richiesta
conversions.batchinsert (API Campaign Manager 360) |
IngestEventsRequest (API Data Manager) |
Note |
|---|---|---|
profileId URL path parameter |
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 ora sono specificate in ogni ID utente criptato. Consulta la sezione Campi di conversione. |
| Nessun equivalente | encryptionInfo |
encryptionInfo a livello di richiesta sono le informazioni sulla crittografia per gli identificatori utente UserData criptati. Per maggiori dettagli, consulta Crittografia. |
| Nessun equivalente | destinations |
Obbligatorio. Un elenco di Destination oggetti che definiscono l'account di destinazione e l'attività Floodlight per gli eventi. Per maggiori dettagli, consulta la guida Destinazioni. Mappa i singoli campi come mostrato nella sezione Campi di conversione. |
| Nessun equivalente | consent |
Impostazioni di consenso predefinite facoltative per gli eventi nella richiesta. Puoi sostituire questo valore per un singolo evento impostando il campo consent di Event. |
| Nessun equivalente | encoding |
Obbligatorio se invii identificatori utente: imposta su Encoding utilizzato per i valori UserIdentifier. Se non utilizzi 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. Imposta sull'ID configurazione Floodlight. |
| Nessun equivalente | destinations[].operatingAccount.accountType |
Definito a livello di richiesta. Imposta su FLOODLIGHT_CONFIG. |
floodlightActivityId |
destinations[].productDestinationId |
Definito a livello di richiesta. Imposta sull'ID attività Floodlight (in precedenza noto come 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 stai inviando 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.
In alternativa, puoi utilizzare transactionId per controllare la deduplicazione delle conversioni dello stesso utente e dello stesso giorno.
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 |
Nell'API Data Manager, transactionId viene utilizzato per controllare la deduplicazione delle conversioni dello stesso utente e dello stesso giorno. Questo campo deve essere impostato su un identificatore univoco per ogni evento.
Questo campo è facoltativo quando invii conversioni offline Floodlight. Per maggiori dettagli, consulta Convertire i dati in oggetti Event per maggiori
dettagli.
|
customVariables |
customVariables |
Un elenco di CustomVariable oggetti. L'API Data Manager utilizza le stringhe come chiavi anziché le enumerazioni. 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 EncryptedUserId oggetto nell'elenco. |
encryptionInfo.kind |
Nessun equivalente | Campo dei metadati; non utilizzato dall'API Data Manager. |
encryptionInfo.encryptionEntityType |
adIdentifiers.encryptedUserIds[].entityType |
Anziché specificare le informazioni sulla crittografia una volta per richiesta, vengono specificate per ogni ID utente criptato. |
encryptionInfo.encryptionEntityId |
adIdentifiers.encryptedUserIds[].entityId |
Anziché specificare le informazioni sulla crittografia una volta per richiesta, vengono specificate per ogni ID utente criptato. |
encryptionInfo.encryptionSource |
adIdentifiers.encryptedUserIds[].source |
Anziché specificare le informazioni sulla crittografia una volta per richiesta, vengono specificate per ogni 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 utente sono raggruppati all'interno di un
UserData oggetto nel campo userData di
Event. Questo è 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 sull'indirizzo email formattato e sottoposto ad hashing. Puoi anche criptare l'indirizzo email sottoposto ad hashing. |
hashedPhoneNumber |
phoneNumber |
Imposta sul numero di telefono formattato e sottoposto ad hashing. Puoi anche criptare il numero di telefono sottoposto ad hashing. |
addressInfo |
address |
Imposta su un AddressInfo oggetto. 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 nella versione attuale dell'API Data Manager. |
addressInfo.state |
Nessun equivalente | Non supportato nella versione attuale dell'API Data Manager. |
addressInfo.hashedStreetAddress |
Nessun equivalente | Non supportato nella versione attuale dell'API Data Manager. |
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 Item oggetti. Per maggiori dettagli, consulta Campi degli articoli. |
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'articolo. |
itemId |
merchantProductId |
Obbligatorio. Imposta sull'ID prodotto di Merchant Center per l'articolo. |
quantity |
quantity |
Obbligatorio. |
unitPrice |
unitPrice |
Obbligatorio. |