Profielkenmerken aan de rand in real-time opzoeken
Adobe Experience Platform gebruikt het Real-Time Profiel van de Klantals enige bron van waarheid voor alle profielgegevens. Voor snelle, real time gegevensherwinning, gebruikt het randprofielen, die lichtgewichtprofielen zijn die door Edge Networkworden verdeeld. Dit maakt het mogelijk snel en realtime gebruik te maken van personalisatie.
Gebruiksscenario’s use-cases
Hieronder vindt u twee gebruiksgevallen waarbij het opzoeken van het randprofiel kan helpen.
- Echte - tijd Personalization: wint snel profielinformatie van het randprofiel terug om de ervaring van een gebruiker op uw website te personaliseren.
- de Steun van de Klant: Haal profielinformatie in real time terug wanneer een klant een agent van het steuncentrum roept.
Deze pagina beschrijft de stappen die u moet volgen om de gegevens van het randprofiel in real time op te zoeken, verpersoonlijkingservaringen te leveren of besluitvormingsregels door stroomafwaartse toepassingen te informeren.
Terminologie en voorwaarden prerequisites
Wanneer het vormen van het gebruiksgeval in deze pagina wordt beschreven, zult u de volgende componenten van het Platform gebruiken:
- Datastreams: Een gegevensstroom ontvangt inkomende gebeurtenisgegevens van het Web SDK en antwoordt met de gegevens van het randprofiel.
- het Beleid van de Fusie: U zult een Active-On-Edge fusiebeleid creëren om ervoor te zorgen dat de randprofielen de correcte profielgegevens gebruiken.
- de verbinding van Personalization van de Douane: U zult een nieuwe verbinding van de douaneverpersoonlijking vormen die de profielattributen naar Edge Network zal verzenden.
- Edge Network API: U zult de Edge Network API interactieve functionaliteit van de gegevensinzamelinggebruiken om profielattributen van de randprofielen snel terug te winnen.
Prestatiegerichten guardrails
Voor het opzoeken van Edge-profielen gelden de specifieke prestatieaanwijzingen die in de onderstaande tabel worden beschreven. Voor meer details betreffende de handleidingen van Edge Network API, zie de guardrails documentatiepagina.
Stap 1: Een gegevensstroom maken en configureren create-datastream
Volg de stappen in de 🔗 documentatie van de 0} gegevensstroomconfiguratie {om een nieuwe gegevensstroom met de volgende Service montages tot stand te brengen:
-
Service: Adobe Experience Platform
-
Personalization Destinations: Enabled
-
Edge Segmentation: Schakel deze optie in als u segmentatie van de randen nodig hebt. Als u alleen geïnteresseerd bent in het opzoeken van profielkenmerken aan de rand, maar geen segmentatie wilt uitvoeren op basis van de randprofielen, laat u deze optie uitgeschakeld.
Stap 2: Vorm uw publiek voor randevaluatie audience-edge-evaluation
Wanneer u profielkenmerken op de rand wilt opzoeken, moet uw publiek zijn geconfigureerd voor randevaluatie.
Zorg ervoor het publiek dat u van plan bent te activeren heeft het actief-op-Edge Beleid van de Fusiegeplaatst als gebrek. Het Active-On-Edge fusiebeleid zorgt ervoor dat het publiek constant op de randwordt geëvalueerd en beschikbaar voor de gevallen van het verpersoonlijkingsgebruik in real time is.
Volg de instructies op creërend een fusiebeleid, en zorg ervoor om Active-On-Edge Merge Policy knevel toe te laten.
Stap 3: gegevens van profielkenmerken naar de Edge Network verzenden configure-custom-personalization-connection
Als u Edge-profielen, waaronder kenmerken en lidmaatschapsgegevens voor het publiek, in real-time wilt opzoeken, moeten de gegevens op de Edge Network beschikbaar worden gesteld. Hiertoe moet u een verbinding met een Custom Personalization With Attributes -doel maken en het publiek activeren, inclusief de kenmerken die u wilt opzoeken in de randprofielen.
Volg het leerprogramma van de de schepping van de bestemmingsverbindingvoor gedetailleerde instructies op hoe te om een nieuwe bestemmingsverbinding tot stand te brengen.
Wanneer het vormen van de nieuwe bestemming, selecteer de gegevensstroom die u in stap 1op het Datastream ID gebied creeerde. Voor Integration alias kunt u elke waarde gebruiken die u helpt deze doelverbinding in de toekomst te identificeren, zoals de doelnaam.
Nadat u een Custom Personalization With Attributes -verbinding hebt gemaakt, kunt u nu profielgegevens naar de Edge Network verzenden.
| note important |
|---|
| IMPORTANT |
|
| Lees het overzicht van de toegangscontroleof contacteer uw productbeheerder om de vereiste toestemmingen te verkrijgen. |
-
Ga naar Connections > Destinations en selecteer de tab Catalog .
-
Zoek de Custom Personalization With Attributes doelkaart en selecteer vervolgens Activate audiences , zoals in de onderstaande afbeelding wordt getoond.
-
Selecteer de doelverbinding die u eerder hebt geconfigureerd en selecteer vervolgens Next .
-
Selecteer uw publiek. Gebruik de selectievakjes links van de publieksnamen om het publiek te selecteren dat u wilt activeren naar het doel en selecteer vervolgens Next .
U kunt kiezen uit meerdere soorten publiek, afhankelijk van de oorsprong:
-
Segmentation Service: publiek dat in Experience Platform wordt gegenereerd door de Segmentation Service. Zie de segmentatiedocumentatievoor meer details.
-
Custom upload: buiten Experience Platform gegenereerde soorten publiek die als CSV-bestanden in Platform worden geüpload. Meer over extern publiek leren, zie de documentatie bij het invoeren van een publiek.
-
Andere soorten publiek, afkomstig van andere Adobe-oplossingen, zoals Audience Manager .
-
-
Selecteer de profielkenmerken die u beschikbaar wilt maken voor de randprofielen.
-
Uitgezochte bronattributen. Als u bronkenmerken wilt toevoegen, selecteert u het besturingselement Add new field in de kolom Source field en zoekt of navigeert u naar het gewenste veld voor XDM-kenmerken, zoals hieronder wordt weergegeven.
-
Uitgezochte doelattributen. Als u doelkenmerken wilt toevoegen, selecteert u het besturingselement Add new field in de kolom Target field en typt u de naam van het aangepaste kenmerk waaraan u het bronkenmerk wilt toewijzen.
-
Selecteer Next wanneer u de kenmerken van het toewijzingsprofiel hebt voltooid.
Op de pagina Review ziet u een overzicht van uw selectie. Selecteer Cancel om de stroom te verbreken, Back om uw instellingen te wijzigen of Finish om uw selectie te bevestigen en profielgegevens naar de Edge Network te verzenden.
Als uw organisatie het Schild van de Gezondheidszorg van Adobe of de Privacy & het Schild van de Veiligheid van Adobe kocht, selecteer View applicable consent policies om te zien welk toestemmingsbeleid wordt toegepast en hoeveel profielen in de activering als resultaat van hen inbegrepen zijn. Lees over evaluatie van het toestemmingsbeleidvoor meer informatie.
de controles van het het gebruiksbeleid van Gegevens
In de stap Review controleert Experience Platform ook op overtredingen van het gegevensgebruiksbeleid. Hieronder ziet u een voorbeeld waarin een beleid wordt overtreden. U kunt de workflow voor publieksactivering pas voltooien nadat u de schending hebt opgelost. Voor informatie over hoe te om beleidsschendingen op te lossen, lees over schendingen van het beleid van het gegevensgebruikin de de documentatiesectie van het gegevensbeheer.
In de stap Review kunt u de beschikbare filters op de pagina gebruiken om alleen het publiek weer te geven waarvan het schema of de toewijzing is bijgewerkt als onderdeel van deze workflow. U kunt ook schakelen welke tabelkolommen u wilt zien.
Als u tevreden bent met de selectie en er zijn geen beleidsovertredingen gevonden, selecteert u Finish om uw selectie te bevestigen.
Stap 4: De profielkenmerken van de rand opzoeken configure-edge-profile-lookup
Tegen nu zou u het vormen van uw datastreammoeten gebeëindigd hebben, hebt u een nieuwe Personalization van de Douane met de bestemmingsverbinding van Attributengecreeerd, en u hebt deze verbinding gebruikt de profielattributente verzenden die u aan Edge Network zult kunnen opzoeken.
De volgende stap bestaat uit het configureren van uw personalisatieoplossing om profielkenmerken op te halen uit de randprofielen.
Als u de bovenstaande vereisten niet opvolgt, wordt de personalisatie alleen gebaseerd op het lidmaatschap van het publiek en zijn de profielkenmerken niet beschikbaar voor u.
De gegevensstroom die u in stap 1vormde is nu klaar om inkomende gebeurtenisgegevens goed te keuren en met de informatie van het randprofiel te antwoorden.
Configureer uw integratie om de gegevens van het randprofiel op te halen, zoals in de onderstaande voorbeelden wordt getoond.
Verzoek request
Als u de gegevens van het randprofiel wilt ophalen, verzendt u een lege POST -aanroep naar het /interact -eindpunt, met de primaire identiteit waarvoor u de profielkenmerken in de gebeurtenis opzoekt, zoals hieronder wordt weergegeven.
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
}
]
}
}
}
}'
dataStreamIdStringAntwoord response
Een geslaagde reactie retourneert de HTTP-status 200 OK , met een Handle -object dat soortgelijke informatie bevat als de voorbeelden in de onderstaande tabbladen, afhankelijk van het feit of het profiel aan de rand wordt gevonden of niet.
handle -object kan meerdere payload -objecten van verschillende typen bevatten. De informatie over het opzoeken van het randprofiel wordt gegroepeerd onder het object payload met "type": "activation:pull" ,Als het profiel aan de rand bestaat, kunt u, afhankelijk van de profielkenmerken en het publiek dat aan de rand wordt geactiveerd, een reactie verwachten met kenmerken en publieksleden die vergelijkbaar zijn met de onderstaande kenmerken.
| code language-json |
|---|
|
Het handle -object biedt de informatie die in de onderstaande tabel wordt beschreven.
| 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 | Beschrijving |
payload |
Het payload -object dat de opzoekgegevens voor de randen bevat. De reactie kan meerdere aanvullende payload -objecten bevatten, die geen verband houden met het opzoeken van randen. |
type |
De ladingen worden gegroepeerd in de reactie door hun type. Het ladingstype voor de raadpleging van het randprofiel wordt altijd geplaatst aan profileLookup. |
destinationId |
Identiteitskaart van de Custom Personalization verbindingsinstantie die u in stap 3creeerde. |
alias |
De alias van de bestemmingsverbinding, die door de gebruiker wordt gevormd wanneer zij de de bestemmingsverbinding van de Personalization van de Douanecreëren. |
attributes |
Deze serie omvat de attributen van het randprofiel van het publiek dat u in stap 3activeerde. |
segments |
Deze serie omvat het publiek dat u in stap 3activeerde. |
type |
handle -objecten worden gegroepeerd op type. Voor het opzoeken van randprofielen is het type van het handle -object altijd activation:pull . |
eventIndex |
De Edge Network ontvangt gebeurtenissen van de client in de vorm van arrays. De volgorde van de gebeurtenissen in de array blijft behouden tijdens de verwerking en wordt door deze index weerspiegeld. De indexering van gebeurtenissen begint met 0 . |
Als het profiel niet aan de rand bestaat, is het antwoord vergelijkbaar met het onderstaande.
| code language-json |
|---|
|
Het handle -object biedt de informatie die in de onderstaande tabel wordt beschreven.
| table 0-row-2 1-row-2 2-row-2 3-row-2 | |
|---|---|
| Parameter | Beschrijving |
payload |
Wanneer het profiel niet aanwezig is op de rand, is het object payload leeg. |
type |
payload -objecten worden gegroepeerd op type. Voor het opzoeken van randprofielen is het type van het payload -object altijd activation:pull . |
eventIndex |
De Edge Network ontvangt gebeurtenissen van de client in de vorm van arrays. De volgorde van de gebeurtenissen in de array blijft behouden tijdens de verwerking en wordt door deze index weerspiegeld. De indexering van gebeurtenissen begint met 0 . |
Conclusie conclusion
Door de bovenstaande stappen te volgen, kunt u de attributen van het randprofiel in real time efficiënt opzoeken, toelatend gepersonaliseerde ervaringen en geïnformeerde besluitvorming door stroomafwaartse toepassingen.