Adobe Target Bulk Profile Update API

Ultimo aggiornamento: 5 maggio 2025

Creato per:

  • Sviluppatore

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.

VersioneEsempio di URLFunzioni
v1http://CLIENTCODE.tt.omtrdc.net/m2/CLIENTCODE/profile/batchUpdateSupporto solo per l’aggiornamento in blocco dei profili.
v2http://CLIENTCODE.tt.omtrdc.net/m2/CLIENTCODE/v2/profile/batchUpdate
  • Crea profilo se non trovato.
  • Aggiornamento dello stato per riga.
NOTA
La versione 2 (v2) di Bulk Profile Update API è la versione corrente. Target supporta comunque la versione 1 (v1).

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\

NOTA
Il parametro 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 pcId o thirdPartyId. 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 come mbox3rdPartyId. Deve essere indicato qui come thirdPartyId.
  • 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 come profile.paramName.
  • Se si utilizza Bulk Profile Update API v2, non è necessario specificare tutti i valori dei parametri per ogni pcId. I profili creati per qualsiasi pcId o mbox3rdPartyId non 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.