Adobe Target Bulk Profile Update API
Adobe Target Bulk Profile Update API consente di aggiornare i profili utente per più visitatori a un sito Web in blocco utilizzando un file batch.
Utilizzando Bulk Profile Update API, puoi inviare in modo comodo dati dettagliati del profilo 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/batchUpdatehttp://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= è obbligatorio e deve essere specificato all'inizio del file.Si fa riferimento a questo file nella chiamata POST ai server Target 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
pcIdothirdPartyId. Marketing Cloud visitor ID non è supportato. pcId è un visitorID generato da Target.thirdPartyIdè un ID specificato dall'applicazione client, passato a Target tramite una chiamata mbox comembox3rdPartyId. Deve essere indicato qui 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 solo nel formato
paramName. I parametri vengono visualizzati in Target comeprofile.paramName. - Se si utilizza Bulk Profile Update API v2, non è necessario specificare tutti i valori dei parametri per ogni
pcId. I profili creati per qualsiasipcIdombox3rdPartyIdnon trovato 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 alcuna restrizione sul numero di attributi che è possibile caricare. Tuttavia, la dimensione totale dei dati del profilo esterno, che include Attributi del cliente, API del profilo, parametri del profilo In-Mbox e output degli script di profilo, non deve superare i 64 KB.
- I parametri e i valori fanno distinzione tra maiuscole e minuscole.
richiesta HTTP POST
Effettuare una richiesta HTTP POST ai server perimetrali Target 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 client Target.
Se non conosci il tuo codice client, nell'interfaccia utente di Target fai clic su Administration > Implementation. Il codice client è visualizzato nella sezione Account Details.
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>
Se si verifica un errore, la risposta contiene success=false e un messaggio dettagliato per l'errore.
Risposta di stato batch predefinita
Una risposta predefinita corretta quando si fa clic sul collegamento URL batchStatus sopra riportato è simile alla seguente:
<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 all'URL batchStatus precedente.
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>