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 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 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 di 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. |
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.
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.
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 esegue il mapping 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 dell'articolo. |
Campi dell'articolo 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. |