Cercare in tempo reale gli attributi del profilo sul bordo
Adobe Experience Platform utilizza Real-Time Customer Profile come unica origine di verità per tutti i dati del profilo. Per un recupero rapido dei dati in tempo reale, utilizza profili edge, che sono profili leggeri distribuiti in Edge Network. Questo consente casi d’uso di personalizzazione rapidi e in tempo reale.
Casi d’uso use-cases
Di seguito sono riportati due casi di utilizzo in cui la ricerca dei profili edge può essere utile.
- Real-Time Personalization: recupera rapidamente le informazioni sul profilo dal profilo Edge per personalizzare l'esperienza di un utente sul sito Web.
- Assistenza clienti: recupera le informazioni sul profilo in tempo reale quando un cliente chiama un agente del centro di assistenza.
Questa pagina descrive i passaggi da seguire per cercare i dati del profilo edge in tempo reale, per fornire esperienze di personalizzazione o per informare le regole decisionali tramite le applicazioni a valle.
Terminologia e prerequisiti prerequisites
Quando configuri il caso d’uso descritto in questa pagina, utilizzerai i seguenti componenti di Experience Platform:
- Datastream: un datastream riceve i dati evento in arrivo da Web SDK e risponde con i dati del profilo Edge.
- Criteri di unione: creerai un criterio di unione Active-On-Edge per garantire che i profili edge utilizzino i dati di profilo corretti.
- Connessione Personalization personalizzata: verrà configurata una nuova connessione di personalizzazione personalizzata che invierà gli attributi del profilo a Edge Network.
- API Edge Network: utilizzerai la funzionalità dell'API Edge Network raccolta dati interattiva per recuperare rapidamente gli attributi del profilo dai profili edge.
Guardrail prestazioni guardrails
I casi di utilizzo della ricerca di profili Edge sono soggetti ai guardrail di prestazioni specifici descritti nella tabella seguente. Per ulteriori dettagli sui guardrail API di Edge Network, consulta la pagina della documentazione relativa ai guardrail.
Passaggio 1: creare e configurare un flusso di dati create-datastream
Segui i passaggi descritti nella documentazione relativa alla configurazione dello stream di dati per creare un nuovo stream di dati con le seguenti impostazioni Service:
- Service: Adobe Experience Platform
- Personalization Destinations: abilitato
- Edge Segmentation: se è necessaria la segmentazione Edge, abilitare questa opzione. Se ti interessa cercare solo gli attributi del profilo sul server Edge di, ma non desideri eseguire alcuna segmentazione in base ai profili Edge di, lascia questa opzione disabilitata.
Passaggio 2: configurare i tipi di pubblico per la valutazione Edge audience-edge-evaluation
La ricerca degli attributi del profilo sul server Edge richiede la configurazione dei tipi di pubblico per la valutazione Edge.
Assicurarsi che il criterio di unione Attivo su Edge sia impostato come predefinito per i tipi di pubblico che si intende attivare. Il criterio di unione Active-On-Edge garantisce che i tipi di pubblico vengano valutati costantemente sul server Edge e siano disponibili per casi di utilizzo di personalizzazione in tempo reale.
Segui le istruzioni relative alla creazione di un criterio di unione e assicurati di attivare/disattivare Active-On-Edge Merge Policy.
Passaggio 3: inviare i dati degli attributi del profilo ad Edge Network configure-custom-personalization-connection
Per cercare in tempo reale i profili edge, inclusi gli attributi e i dati di iscrizione al pubblico, è necessario rendere disponibili i dati in Edge Network. A questo scopo, devi creare una connessione a una destinazione Custom Personalization With Attributes e attivare i tipi di pubblico, inclusi gli attributi che desideri cercare nei profili edge.
Segui l'esercitazione creazione connessione di destinazione per istruzioni dettagliate su come creare una nuova connessione di destinazione.
Durante la configurazione della nuova destinazione, seleziona lo stream di dati creato nel passaggio 1 nel campo Datastream ID. Per Integration alias è possibile utilizzare qualsiasi valore che ti consenta di identificare questa connessione di destinazione in futuro, come il nome della destinazione.
Dopo aver creato una connessione Custom Personalization With Attributes, puoi inviare i dati del profilo ad Edge Network.
| note important |
|---|
| IMPORTANT |
|
| Leggi la panoramica sul controllo degli accessi o contatta l'amministratore del prodotto per ottenere le autorizzazioni necessarie. |
-
Passare a Connections > Destinations e selezionare la scheda Catalog.
-
Trova la scheda di destinazione Custom Personalization With Attributes, quindi seleziona Activate audiences, come illustrato nell'immagine seguente.
-
Selezionare la connessione di destinazione configurata in precedenza, quindi selezionare Next.
-
Seleziona i tipi di pubblico. Utilizza le caselle di controllo a sinistra dei nomi del pubblico per selezionare i tipi di pubblico che desideri attivare nella destinazione, quindi seleziona Next.
Puoi scegliere tra più tipi di pubblico, a seconda della loro origine:
-
Segmentation Service: pubblico generato in Experience Platform dal servizio di segmentazione. Per ulteriori dettagli, consulta la documentazione sulla segmentazione.
-
Custom upload: pubblico generato al di fuori di Experience Platform e caricato in Experience Platform come file CSV. Per ulteriori informazioni sui tipi di pubblico esterni, consulta la documentazione su importazione di un pubblico.
-
Altri tipi di pubblico, provenienti da altre soluzioni Adobe, ad esempio Audience Manager.
-
-
Selezionare gli attributi di profilo che si desidera rendere disponibili per i profili di spigolo.
-
Selezionare gli attributi di origine. Per aggiungere attributi di origine, selezionare il controllo Add new field nella colonna Source field e cercare o passare al campo attributo XDM desiderato, come illustrato di seguito.
-
Selezionare gli attributi di destinazione. Per aggiungere attributi di destinazione, selezionare il controllo Add new field nella colonna Target field e digitare il nome dell'attributo personalizzato a cui si desidera mappare l'attributo di origine.
-
Al termine della mappatura degli attributi del profilo, selezionare Next.
Nella pagina Review è disponibile un riepilogo della selezione. Seleziona Cancel per interrompere il flusso, Back per modificare le impostazioni o Finish per confermare la selezione e iniziare a inviare i dati del profilo ad Edge Network.
Se la tua organizzazione ha acquistato Adobe Healthcare Shield o Adobe Privacy & Security Shield, seleziona View applicable consent policies per vedere quali criteri di consenso sono applicati e quanti profili sono inclusi nell'attivazione come risultato di tali criteri. Leggi informazioni sulla valutazione dei criteri di consenso per ulteriori informazioni.
Controlli dei criteri di utilizzo dati
Nel passaggio Review, Experience Platform controlla anche eventuali violazioni dei criteri di utilizzo dei dati. Di seguito è riportato un esempio di violazione di una policy. Non puoi completare il flusso di lavoro di attivazione del pubblico finché non hai risolto la violazione. Per informazioni su come risolvere le violazioni dei criteri, leggere le violazioni dei criteri di utilizzo dei dati nella sezione relativa alla governance dei dati.
Nel passaggio Review è possibile utilizzare i filtri disponibili nella pagina per visualizzare solo i tipi di pubblico la cui pianificazione o mappatura è stata aggiornata come parte di questo flusso di lavoro. Puoi anche scegliere quali colonne della tabella visualizzare.
Se si è soddisfatti della selezione e non sono state rilevate violazioni dei criteri, selezionare Finish per confermare la selezione.
Passaggio 4: Cercare gli attributi del profilo sullo spigolo configure-edge-profile-lookup
A questo punto dovresti aver completato la configurazione dello stream di dati, hai creato una nuova connessione di destinazione Personalization con attributi personalizzati e hai utilizzato questa connessione per inviare gli attributi del profilo che potrai cercare in Edge Network.
Il passaggio successivo consiste nel configurare la soluzione di personalizzazione per recuperare gli attributi del profilo dai profili edge.
Lo stream di dati configurato nel passaggio 1 è ora pronto per accettare i dati dell'evento in arrivo e rispondere con le informazioni del profilo Edge.
Configura l’integrazione per recuperare le informazioni del profilo edge, come illustrato negli esempi seguenti.
Richiesta request
Per recuperare i dati del profilo Edge, invia una chiamata POST vuota all'endpoint /interact, con l'identità primaria per la quale stai cercando gli attributi di profilo inclusi nell'evento, come mostrato di seguito.
curl -X POST "https://server.adobedc.net/ee/v2/interact?dataStreamId={DATASTREAM_ID}"
-H "Authorization: Bearer {TOKEN}"
-H "x-gw-ims-org-id: {ORG_ID}"
-H "x-api-key: {API_KEY}"
-H "Content-Type: application/json"
-d '{
"event":
{
"xdm": {
"identityMap": {
"Email": [
{
"id":"test123@adobetest.com",
"primary":true
}
]
}
}
}
}'
Risposta response
In caso di esito positivo, la risposta restituisce lo stato HTTP 200 OK, con un oggetto Handle che include informazioni simili a quelle riportate nelle schede seguenti, a seconda che il profilo si trovi o meno sul server Edge di.
handle può includere più oggetti payload di vari tipi. Le informazioni relative alla ricerca del profilo perimetrale sono raggruppate nell'oggetto payload con "type": "activation:pull",Se il profilo esiste sul server Edge di, a seconda degli attributi del profilo e dei tipi di pubblico attivati sul server Edge di, puoi aspettarti una risposta con attributi e appartenenze a tipi di pubblico simili a quelli riportati di seguito.
| code language-json |
|---|
|
L'oggetto handle fornisce le informazioni descritte nella tabella seguente.
| table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 | |
|---|---|
| Parametro | Descrizione |
payload |
L'oggetto payload che include le informazioni di ricerca edge. La risposta può contenere più oggetti payload aggiuntivi, non correlati alla ricerca Edge. |
type |
I payload sono raggruppati nella risposta per tipo. Il tipo di payload per la ricerca del profilo edge è sempre impostato su profileLookup. |
destinationId |
ID dell'istanza di connessione Custom Personalization creata in passaggio 3. |
alias |
Alias della connessione di destinazione, configurato dall'utente quando crea la connessione di destinazione Personalization personalizzata. |
attributes |
Questo array include gli attributi del profilo edge dei tipi di pubblico attivati nel passaggio 3. |
segments |
Questo array include i tipi di pubblico attivati in passaggio 3. |
type |
handle oggetti sono raggruppati per tipo. Per i casi di utilizzo di ricerca di profili edge, il tipo dell'oggetto handle è sempre activation:pull. |
eventIndex |
Edge Network riceve gli eventi dal client sotto forma di array. L’ordine degli eventi nell’array viene mantenuto durante l’elaborazione e rispecchiato da questo indice. L'indicizzazione degli eventi inizia con 0. |
Se il profilo non esiste sul server Edge di, la risposta sarà simile a quella riportata di seguito.
| code language-json |
|---|
|
L'oggetto handle fornisce le informazioni descritte nella tabella seguente.
| table 0-row-2 1-row-2 2-row-2 3-row-2 | |
|---|---|
| Parametro | Descrizione |
payload |
Quando il profilo non è presente nel perimetro, l'oggetto payload è vuoto. |
type |
payload oggetti sono raggruppati per tipo. Per i casi di utilizzo di ricerca di profili edge, il tipo dell'oggetto payload è sempre activation:pull. |
eventIndex |
Edge Network riceve eventi dal client sotto forma di array. L’ordine degli eventi nell’array viene mantenuto durante l’elaborazione e rispecchiato da questo indice. L'indicizzazione degli eventi inizia con 0. |
Conclusione conclusion
Seguendo i passaggi precedenti, puoi cercare in modo efficiente gli attributi del profilo edge in tempo reale, abilitando esperienze personalizzate e processi decisionali informati tramite le applicazioni a valle.