Söka efter profilattribut i kanten i realtid
Adobe Experience Platform använder Real-Time Customer Profile som enda källa till sanning för alla profildata. För snabb datahämtning i realtid används edge-profiler, som är enkla profiler som distribueras i hela Edge Network. Detta möjliggör snabb personalisering i realtid.
Användningsfall use-cases
Nedan visas två användningsområden där sökningar efter kantprofiler kan vara till hjälp.
- Real-Time Personalization: Hämta snabbt profilinformation från edge-profilen för att anpassa en användares upplevelse på webbplatsen.
- Kundsupport: Hämta profilinformation i realtid när en kund ringer en supportcenteragent.
På den här sidan beskrivs de steg som du måste följa för att söka efter edge-profildata i realtid, för att leverera personaliseringsupplevelser eller för att informera beslutsregler via program längre fram i kedjan.
Terminologi och förutsättningar prerequisites
När du konfigurerar det användningsfall som beskrivs på den här sidan använder du följande Experience Platform-komponenter:
- Datastreams: En datastream tar emot inkommande händelsedata från Web SDK och svarar med edge-profildata.
- Sammanslagningsprinciper: Du skapar en Active-On-Edge sammanfogningsprincip för att se till att kantprofilerna använder rätt profildata.
- Anpassad Personalization-anslutning: Du konfigurerar en ny anpassad personaliseringsanslutning som skickar profilattributen till Edge Network.
- Edge Network API: Du använder Edge Network API-funktionen interaktiv datainsamling för att snabbt hämta profilattribut från kantprofilerna.
Prestandaskydd guardrails
Användningsexempel för Edge-profilsökning beror på de specifika säkerhetsbeskrivningar som beskrivs i tabellen nedan. Mer information om Edge Network API-skyddsutkast finns i dokumentationssidan.
Steg 1: Skapa och konfigurera ett datastream create-datastream
Följ stegen i dokumentationen för datastream-konfigurationen för att skapa ett nytt datastream med följande Service-inställningar:
- Service: Adobe Experience Platform
- Personalization Destinations: Aktiverad
- Edge Segmentation: Aktivera det här alternativet om du behöver kantsegmentering. Om du bara är intresserad av att leta upp profilattribut på kanten, men inte vill segmentera baserat på kantprofilerna, låter du det här alternativet vara inaktiverat.
Steg 2: Konfigurera era målgrupper för edge-utvärdering audience-edge-evaluation
Om du vill söka efter profilattribut i kanten måste målgrupperna konfigureras för kantutvärdering.
Kontrollera att Active-on-Edge Merge Policy har angetts som standard för de målgrupper som du tänker aktivera. Sammanslagningsprincipen Active-On-Edge säkerställer att målgrupperna hela tiden utvärderas vid sidan om och är tillgängliga för personalisering i realtid.
Följ instruktionerna på skapa en sammanfogningsprincip och se till att aktivera alternativet Active-On-Edge Merge Policy.
Steg 3: Skicka profilattributsdata till Edge Network configure-custom-personalization-connection
För att kunna slå upp edge-profiler, inklusive attribut och data om målgruppsmedlemskap i realtid, måste data göras tillgängliga på Edge Network. Därför måste du skapa en anslutning till ett Custom Personalization With Attributes-mål och aktivera målgrupperna, inklusive de attribut som du vill söka efter kantprofilerna.
Följ självstudiekursen för att skapa en målanslutning om du vill ha mer information om hur du skapar en ny målanslutning.
När du konfigurerar det nya målet markerar du datastream som du skapade i steg 1 i fältet Datastream ID. För Integration alias kan du använda vilket värde som helst som hjälper dig att identifiera den här målanslutningen i framtiden, till exempel målnamnet.
När du har skapat en Custom Personalization With Attributes-anslutning kan du nu skicka profildata till Edge Network.
| note important |
|---|
| IMPORTANT |
|
| Läs åtkomstkontrollsöversikten eller kontakta produktadministratören för att få den behörighet som krävs. |
-
Gå till Connections > Destinations och välj fliken Catalog.
-
Hitta målkortet Custom Personalization With Attributes och välj sedan Activate audiences, så som visas i bilden nedan.
-
Markera målanslutningen som du tidigare konfigurerade och välj sedan Next.
-
Välj målgrupper. Använd kryssrutorna till vänster om målgruppsnamnen för att markera de målgrupper som du vill aktivera för målet och välj sedan Next.
Du kan välja mellan flera typer av målgrupper, beroende på deras ursprung:
-
Segmentation Service: Publiker som genererats inom Experience Platform av segmenteringstjänsten. Mer information finns i segmenteringsdokumentationen.
-
Custom upload: Publiker som genererats utanför Experience Platform och överförts till Experience Platform som CSV-filer. Mer information om externa målgrupper finns i dokumentationen om att importera en målgrupp.
-
Andra typer av målgrupper som kommer från andra Adobe-lösningar, till exempel Audience Manager.
-
-
Välj de profilattribut som du vill ska vara tillgängliga för kantprofilerna.
-
Välj källattribut. Om du vill lägga till källattribut väljer du kontrollen Add new field i kolumnen Source field och söker efter eller navigerar till det önskade XDM-attributfältet, vilket visas nedan.
-
Välj målattribut. Om du vill lägga till målattribut markerar du kontrollen Add new field i kolumnen Target field och skriver in det anpassade attributnamnet som du vill mappa källattributet till.
-
När du är klar med mappningen av profilattribut väljer du Next.
På sidan Review kan du se en sammanfattning av ditt val. Välj Cancel om du vill dela upp flödet, Back om du vill ändra inställningarna eller Finish om du vill bekräfta ditt val och börja skicka profildata till Edge Network.
Om din organisation har köpt Adobe Healthcare Shield eller Adobe Privacy & Security Shield väljer du View applicable consent policies för att se vilka medgivandepolicyer som tillämpas och hur många profiler som inkluderas i aktiveringen som ett resultat av dem. Läs mer om utvärdering av medgivandeprincip.
Principkontroller av dataanvändning
I steget Review söker Experience Platform även efter överträdelser av dataanvändningsprinciper. Nedan visas ett exempel där en princip överträds. Du kan inte slutföra arbetsflödet för målgruppsaktivering förrän du har löst överträdelsen. Mer information om hur du löser policyöverträdelser finns i brott mot dataanvändningsprinciper i dokumentationsavsnittet för datastyrning.
I steget Review kan du använda de tillgängliga filtren på sidan för att endast visa de målgrupper vars schema eller mappning har uppdaterats som en del av det här arbetsflödet. Du kan också växla vilka tabellkolumner som du vill se.
Om du är nöjd med ditt val och inga principöverträdelser har identifierats, kan du bekräfta ditt val genom att välja Finish.
Steg 4: Slå upp profilattributen på kanten configure-edge-profile-lookup
Nu bör du ha konfigurerat din datastream, skapat en ny anpassad Personalization med attributmålanslutning och du har använt den här anslutningen för att skicka profilattributen som du kommer att kunna söka efter i Edge Network.
Nästa steg är att konfigurera din personaliseringslösning för att hämta profilattribut från edge-profilerna.
Datastream som du konfigurerade i steg 1 är nu klar att acceptera inkommande händelsedata och svara med edge-profilinformation.
Konfigurera integreringen för att hämta kantprofilinformation enligt exemplen nedan.
Begäran request
Om du vill hämta kantprofildata skickar du ett tomt POST-anrop till /interact-slutpunkten, med den primära identiteten som du söker efter profilattribut för i händelsen, vilket visas nedan.
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
}
]
}
}
}
}'
Svar response
Ett lyckat svar returnerar HTTP-statusen 200 OK, med ett Handle-objekt som innehåller information som liknar exemplen på flikarna nedan, beroende på om profilen hittas på kanten eller inte.
handle kan innehålla flera payload-objekt av olika typer. Informationen som är relaterad till sökningen efter kantprofiler grupperas under objektet payload med "type": "activation:pull",Om profilen finns på kanten, beroende på vilka profilattribut och målgrupper som är aktiverade på kanten, kan du förvänta dig ett svar med attribut och målgruppsmedlemskap som liknar dem som anges nedan.
| code language-json |
|---|
|
Objektet handle innehåller den information som beskrivs i tabellen nedan.
| 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 | |
|---|---|
| Parameter | Beskrivning |
payload |
Objektet payload som innehåller kantsökningsinformation. Svaret kan innehålla flera ytterligare payload objekt, som inte hör till kantsökningen. |
type |
Nyttolaster grupperas i svaret efter typ. Nyttolasttypen för edge-profilsökningen är alltid inställd på profileLookup. |
destinationId |
ID:t för Custom Personalization-anslutningsinstansen som du skapade i steg 3. |
alias |
Aliaset för målanslutningen, som konfigureras av användaren när de skapar målanslutningen Anpassad Personalization. |
attributes |
Den här arrayen innehåller kantprofilattributen för de målgrupper som du aktiverade i steg 3. |
segments |
Den här arrayen innehåller de målgrupper som du har aktiverat i steg 3. |
type |
handle objekt grupperas efter typ. Vid användning av sökningar efter kantprofil är typen för handle-objektet alltid activation:pull. |
eventIndex |
Edge Network får evenemang från klienten i form av matriser. Ordningen på händelserna i arrayen bevaras under bearbetningen och återspeglas av detta index. Händelseindexeringen börjar med 0. |
Om profilen inte finns på kanten kan du förvänta dig ett svar som liknar det nedan.
| code language-json |
|---|
|
Objektet handle innehåller den information som beskrivs i tabellen nedan.
| table 0-row-2 1-row-2 2-row-2 3-row-2 | |
|---|---|
| Parameter | Beskrivning |
payload |
När profilen inte finns på kanten är objektet payload tomt. |
type |
payload objekt grupperas efter typ. Vid användning av sökningar efter kantprofil är typen för payload-objektet alltid activation:pull. |
eventIndex |
Edge Network tar emot händelser från klienten i form av arrayer. Ordningen på händelserna i arrayen bevaras under bearbetningen och återspeglas av detta index. Händelseindexeringen börjar med 0. |
Slutsats conclusion
Genom att följa stegen ovan kan ni effektivt slå upp edge-profilattribut i realtid, vilket möjliggör personaliserade upplevelser och välgrundat beslutsfattande via program i senare led.