Adobe Target Single Profile Update API
Il Adobe Target API di aggiornamento a profilo singolo consente di inviare un aggiornamento del profilo per un singolo utente. Il API di aggiornamento a profilo singolo è quasi identico al API di aggiornamento del profilo bulk, ma un profilo visitatore viene aggiornato alla volta, in linea con la chiamata API invece che con un file .cvs.
Il API di aggiornamento a profilo singolo ed è generalmente utilizzato quando si deve verificare un aggiornamento in relazione a una transazione che si verifica in un canale che non è stato implementato Target. Ad esempio, desideri aggiornare il profilo di un singolo visitatore che esegue un’azione offline. Le azioni possono includere il raggiungimento di un call center, il finanziamento di un prestito, l’utilizzo di una carta fedeltà in negozio, l’accesso a un chiosco e così via.
Vantaggi della API di aggiornamento a profilo singolo include:
- 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
-
Il API di aggiornamento a profilo singolo è limitato all’esecuzione di 1 milione di aggiornamenti in qualsiasi periodo continuo di 24 ore.
-
Gli aggiornamenti in genere si verificano in meno di un’ora, ma la visualizzazione potrebbe richiedere fino a 24 ore.
Se devi inviare più aggiornamenti o richiedere l’elaborazione degli aggiornamenti in tempi più brevi, puoi inviare gli aggiornamenti del profilo transazionale tramite aggiornamento lato client (opzione preferita) o tramite Adobe Target lato server API di consegna.
-
Il API di aggiornamento a profilo singolo è un’API server-to-server e non è progettata per funzionare all’interno di una pagina web. Per aggiornare un profilo visitatore dall'interno della pagina Web, puoi utilizzare trackEvent() funzione o API di consegna.
Formato
Specificare i parametri del profilo nel formato profile.paramName=value.
Per aggiornare il profilo per un pcId, utilizza:
\ https\://\<your-client-code>.tt.omtrdc.net/m2/client/profile/update?mboxPC=1368007744041-575948.01\_00\&profile.attr=0\&profile.attr2=1…\
Per aggiornare il profilo per un mbox3rdPartyId, utilizza:
\ shell http\://\<your-client-code>.tt.omtrdc.net/m2/client/profile/update?mbox3rdPartyId=123456\&profile.attr=0\&profile.attr2=1…\
Il API di aggiornamento a profilo singolo è solo per aggiornamenti. Se non viene trovato nulla, non viene creato alcun profilo.
Note
- I parametri e i valori devono essere codificati in URL utilizzando UTF-8.
- Il formato del parametro è
profile.paramName. - Non tutti i valori dei parametri devono esistere per tutti i pcIds e mbox3rdPartyIds.
- I parametri e i valori fanno distinzione tra maiuscole e minuscole.
- Sono supportati sia GET che POST.
- Le attuali limitazioni di dimensione per il limite sono di 8 KB per GET e 60 KB per POST.
Risposta
Un esempio di risposta per le richieste di cui sopra è simile al seguente:
trueRequest successfully submitted
Questa risposta indica che è stata inviata e verrà elaborata a breve.