Adobe Target Bulk Profile Update API
Il Adobe Target Bulk Profile Update API consente di aggiornare in blocco i profili utente di più visitatori a un sito web utilizzando un file batch.
Utilizzo di Bulk Profile Update API, puoi inviare in modo comodo dati dettagliati del profilo del visitatore sotto forma di parametri di profilo per molti utenti a Target da qualsiasi origine esterna. Le fonti esterne possono includere sistemi CRM (Customer Relationship Management) o POS (Point of Sale), che di solito non sono disponibili su una pagina web.
http://CLIENTCODE.tt.omtrdc.net/m2/CLIENTCODE/profile/batchUpdate
http://CLIENTCODE.tt.omtrdc.net/m2/CLIENTCODE/v2/profile/batchUpdate
- Crea profilo se non trovato.
- Aggiornamento dello stato per riga.
Vantaggi dell’API di aggiornamento del profilo in blocco
- Nessun limite al numero di attributi del profilo.
- Gli attributi del profilo inviati tramite il sito possono essere aggiornati tramite l’API e in modo opposto.
Avvertenze
- La dimensione del file batch deve essere inferiore a 50 MB. Inoltre, il numero totale di righe non deve superare 500000 righe per upload.
- Gli aggiornamenti in genere si verificano in meno di un’ora, ma la visualizzazione potrebbe richiedere fino a 24 ore.
- Non esiste alcun limite al numero o alle righe che è possibile caricare in un periodo di 24 ore nei batch successivi. Tuttavia, il processo di ingestione potrebbe essere limitato durante l'orario di ufficio per garantire che altri processi vengano eseguiti in modo efficiente.
- Le chiamate all’aggiornamento collettivo v2 senza chiamate mbox tra gli stessi thirdPartyIds sovrascrivono le proprietà aggiornate nella prima chiamata di aggiornamento collettivo.
- Adobe non garantisce che il 100% dei dati del profilo batch sia integrato e mantenuto in Target e sia quindi disponibile per l’utilizzo nel targeting. Nella progettazione corrente, esiste la possibilità che una piccola percentuale di dati (fino allo 0,1% dei batch di produzione di grandi dimensioni) non venga caricata o conservata.
File batch
Per aggiornare i dati del profilo in blocco, crea un file batch. Il file batch è un file di testo con valori separati da virgole simili al seguente file di esempio.
\ batch=pcId,param1,param2,param3,param4\ 123,value1\ 124,value1,value4\ 125,value2\ 126,value1,value2,value3,value4\
batch=
Il parametro è obbligatorio e deve essere specificato all'inizio del file.Fai riferimento a questo file nella chiamata POST a Target server per elaborare il file. Durante la creazione del file batch, tenere presente quanto segue:
- Nella prima riga del file devono essere specificate le intestazioni di colonna.
- La prima intestazione deve essere
pcId
othirdPartyId
. Il Marketing Cloud visitor ID non è supportato. pcId è un TargetID visitatore generato da.thirdPartyId
è un ID specificato dall’applicazione client e trasmesso a Target tramite una chiamata mbox comembox3rdPartyId
. Deve essere qui indicato comethirdPartyId
. - I parametri e i valori specificati nel file batch devono essere codificati tramite URL utilizzando UTF-8 per motivi di sicurezza. I parametri e i valori possono essere inoltrati ad altri nodi edge per l’elaborazione tramite richieste HTTP.
- I parametri devono essere nel formato
paramName
solo. I parametri vengono visualizzati in Target asprofile.paramName
. - Se sta usando Bulk Profile Update API v2, non è necessario specificare tutti i valori dei parametri per ciascuno
pcId
. I profili vengono creati per qualsiasipcId
ombox3rdPartyId
che non si trova in Target. Se utilizzi v1, i profili non vengono creati per pcIds o mbox3rdPartyIds mancanti. - La dimensione del file batch deve essere inferiore a 50 MB. Inoltre, il numero totale di righe non deve superare 500,000. Questo limite assicura che i server non vengano inondati da troppe richieste.
- Puoi inviare più file. Tuttavia, la somma totale delle righe di tutti i file inviati in un giorno non deve superare un milione per ogni client.
- Non esiste alcun limite al numero di attributi caricati. Tuttavia, la dimensione complessiva di un profilo, inclusi i dati di sistema, non deve superare i 2000 KB. Adobe consiglia di utilizzare meno di 1000 KB di spazio di archiviazione per gli attributi del profilo.
- I parametri e i valori fanno distinzione tra maiuscole e minuscole.
richiesta HTTP POST
Effettuare una richiesta HTTP POST a Target server perimetrali per elaborare il file. Di seguito è riportato un esempio di richiesta HTTP POST per il file batch.txt utilizzando il comando curl:
\ curl -X POST --data-binary @BATCH.TXT http\://CLIENTCODE.tt.omtrdc.net/m2/CLIENTCODE/v2/profile/batchUpdate\
Dove:
BATCH.TXT è il nome del file. CLIENTCODE è il codice Target codice client.
Se non conosci il tuo codice cliente, nel Target clic interfaccia utente Administration > Implementation. Il codice client viene visualizzato nel Account Details sezione.
Inspect la risposta
L’API Profiles restituisce lo stato di invio del batch per l’elaborazione insieme a un collegamento in "batchStatus" a un URL diverso che mostra lo stato generale di un particolare processo batch.
Esempio di risposta API
Il seguente codice acquisito è un esempio di risposta API Profiles:
<response>
<success>true</success>
<batchStatus>http://mboxedge45.tt.omtrdc.net/m2/demo/profile/batchStatus?batchId=demo-1701473848678-13029383</batchStatus>
<message>Batch submitted for processing</message>
</response>
In caso di errore, la risposta contiene success=false
e un messaggio dettagliato dell’errore.
Risposta di stato batch predefinita
Risposta predefinita corretta quando batchStatus
Il collegamento URL selezionato si presenta come segue:
<response><batchId>demo4-1701473848678-13029383</batchId><status>complete</status><batchSize>1</batchSize></response>
I valori previsti per i campi di stato sono:
Risposta URL dettagliata sullo stato del batch
È possibile ottenere una risposta più dettagliata passando un parametro showDetails=true
al batchStatus
URL in alto.
Ad esempio:
http://mboxedge45.tt.omtrdc.net/m2/demo/profile/batchStatus?batchId=demo-1701473848678-13029383&showDetails=true
Risposta dettagliata
<response>
<batchId>demo4-1701473848678-13029383</batchId>
<status>complete</status>
<batchSize>1</batchSize>
<consumedCount>1</consumedCount>
<successfulUpdates>1</successfulUpdates>
<profilesNotFound>0</profilesNotFound>
<failedUpdates>0</failedUpdates>
</response>