Adobe Target Single Profile Update API
L’API Adobe Target Aggiornamento profilo singolo consente di inviare un aggiornamento profilo per un singolo utente. L’API Aggiornamento profilo singolo è quasi identica all’API Aggiornamento profilo bulk, ma un profilo visitatore viene aggiornato alla volta, in linea con la chiamata API invece che con un file .cvs.
L’API Aggiornamento profilo singolo e viene generalmente utilizzata quando deve verificarsi un aggiornamento in relazione a una transazione che si verifica in un canale che non ha 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.
I vantaggi dell’API di aggiornamento a profilo singolo includono:
- 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
-
L’API Single Profile Update è limitata 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 altri aggiornamenti o richiedere l’elaborazione degli aggiornamenti in tempi più brevi, puoi inviare gli aggiornamenti del profilo transazionale tramite l’aggiornamento lato client (preferito) o tramite l’Adobe Target API di consegna lato server.
-
L’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 dalla pagina Web, puoi utilizzare la funzione trackEvent() o l’API di consegna.
Formato
Specificare i parametri del profilo nel formato profile.paramName=value.
Per aggiornare il profilo per un pcId, utilizzare:
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, utilizzare:
shell http://<your-client-code>.tt.omtrdc.net/m2/client/profile/update?mbox3rdPartyId=123456&profile.attr=0&profile.attr2=1...
L’API Aggiornamento 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.