Adobe Experience Platform-gegevens gebruiken voor personalisatie (Beta) aep-data
Journey Optimizer staat u toe om gegevens van hefboomwerking van Adobe Experience Platform in de verpersoonlijkingsredacteur aan te personaliseren uw inhoud. Om dit te doen, moeten de datasets nodig voor raadplegingsverpersoonlijking eerst door een API vraag worden toegelaten zoals hieronder beschreven. Als u klaar bent, kunt u hun gegevens gebruiken om uw inhoud aan te passen aan Journey Optimizer .
Beperkingen en richtlijnen voor Beta guidelines
Controleer voordat u begint de volgende beperkingen en richtlijnen:
Gegevensset inschakelen enablement
- grootte van de Dataset is beperkt tot 5GB voor productiedatasets en 1GB voor dev zandbakdatasets
- A maximum van 50 datasets kan voor raadpleging per organisatie op elk ogenblik worden toegelaten.
- Aantal verslagen is beperkt tot 5M in productiedetecten en 1M in dev zandbakdatasets.
- de Etikettering en de Handhaving van het Gebruik van Gegevens wordt niet afgedwongen op dit ogenblik voor datasets die voor raadpleging worden toegelaten.
- Datasets die voor raadpleging worden toegelaten en in verpersoonlijking worden gebruikt worden niet beschermd tegen schrapping. Het is aan u om spoor te houden van welke datasets voor verpersoonlijking worden gebruikt om ervoor te zorgen zij niet worden geschrapt of worden verwijderd.
Personalization gebruikt Adobe Experience Platform -gegevens perso
- Gesteunde kanalen: Voor nu, is dit vermogen slechts beschikbaar voor gebruik binnen e-mail, SMS, duw en direct-mailkanalen.
- de Etikettering en de Handhaving van het Gebruik van Gegevens wordt niet afgedwongen op dit ogenblik voor datasets die voor raadpleging worden toegelaten.
- de fragmenten van de Uitdrukking: De raadplegingsverpersoonlijking van de Dataset kan niet binnen uitdrukkingsfragmenten op dit ogenblik worden geplaatst.
Een dataset inschakelen voor gegevensopzoekhandeling enable
Om gegevens van uw dataset voor verpersoonlijking te hefboomwerking, moet u een API vraag gebruiken om zijn status terug te winnen en de raadplegingsdienst toe te laten.
Vereisten prerequisites-enable
-
Volg de richtingen die in worden gedetailleerd deze documentatieom uw milieu te vormen om API bevelen te verzenden.
-
De API's van Adobe Journey Optimizer en Adobe Experience Platform moeten aan het project worden toegevoegd.
-
U moet de toestemming van datasets als deel van uw rol leiden.
-
Het schema waarvoor de dataset gebaseerd is moet a primaire identiteit bevatten die als raadplegingssleutel kan dienst doen.
API-oproepstructuur call
curl -s -XPATCH "https://platform.adobe.io/data/core/entity/lookup/dataSets/${DATASET_ID}/${ACTION}" \ -H "Authorization: Bearer ${ACCESS_TOKEN}" \ -H "x-api-key: ${API_KEY}" \ -H "x-gw-ims-org-id: ${IMS_ORG}" \ -H "x-sandbox-name: ${SANDBOX_NAME}"
Waarbij:
- URL is
https://platform.adobe.io/data/core/entity/lookup/dataSets/${DATASET_ID}/${ACTION}
- identiteitskaart van de Dataset is de dataset waarvoor u wenst om toe te laten.
- de Actie laat OF onbruikbaar maakt toe.
- het teken van de Toegang kan van de ontwikkelaarsconsole worden teruggewonnen.
- API sleutel kan van de ontwikkelaarsconsole worden teruggewonnen.
- IMS Org ID is uw ORG van Adobe IMS.
- Naam Sandbox is de zandbaknaam de dataset in (d.w.z. prod, dev enz.) is.
Gebruik een dataset voor verpersoonlijking leverage
Zodra een dataset voor raadplegingsverpersoonlijking gebruikend een API vraag is toegelaten, kunt u zijn gegevens gebruiken om uw inhoud in Journey Optimizer te personaliseren.
-
Open de verpersoonlijkingsredacteur, die in elke context beschikbaar is waar u verpersoonlijking zoals berichten kunt bepalen. Leer hoe te met de verpersoonlijkingsredacteurte werken
-
Navigeer aan de lijst van helperfuncties en voeg datasetLookup hulpfunctie aan de coderuit toe.
-
Deze functie verstrekt een vooraf bepaalde syntaxis om u toe te staan om gebieden van uw datasets van Adobe Experience Platform te roepen. De syntaxis is als volgt:
code language-none {{datasetLookup datasetId="datasetId" id="key" result="store" required=false}}
-
datasetId is identiteitskaart van de dataset u met werkt.
-
identiteitskaart is identiteitskaart van de bronkolom die met de primaire identiteit van de opzoekdataset zou moeten worden aangesloten.
note note NOTE De waarde ingegaan voor dit gebied kan of a gebied identiteitskaart (profile.packages.packageSKU) zijn, een gebied dat in een reisgebeurtenis (context.trip.events.event_ID.productSKU) wordt overgegaan, of een statische waarde (sku007653). In elk geval, zal het systeem de waarde en raadpleging in de dataset gebruiken om te controleren of het een sleutel aanpast. Als u een letterlijke tekenreekswaarde voor de toets gebruikt, moet u de tekst tussen aanhalingstekens plaatsen. Bijvoorbeeld: {{datasetLookup datasetId="datasetId" id="SKU1234" result="store" required=false}}
. Als u een kenmerkwaarde gebruikt als een dynamische sleutel, verwijdert u de aanhalingstekens. Voorbeeld:{{datasetLookup datasetId="datasetId" id=category.product.SKU result="SKU" required=false}}
-
resultaat is een willekeurige naam die u moet verstrekken om alle gebiedswaarden van verwijzingen te voorzien u van de dataset gaat terugwinnen. Deze waarde wordt in de code gebruikt om elk veld aan te roepen.
-
required=false: Als vereist aan WAAR wordt geplaatst, zal het bericht slechts worden geleverd als een passende sleutel wordt gevonden. Indien ingesteld op false, is geen overeenkomende sleutel vereist en kan het bericht nog steeds worden bezorgd. Houd er rekening mee dat als de waarde false is, u in de berichtinhoud een back-up- of standaardwaarde moet opgeven.
accordion Waar om een dataset ID terug te winnen? Dataset-id's kunnen worden opgehaald in de gebruikersinterface van Adobe Experience Platform. Leer hoe te met datasets in de documentatie van Adobe Experience Platformte werken .
-
-
Pas de syntaxis aan uw wensen aan. In dit voorbeeld willen we gegevens ophalen over de vluchten van passagiers. De syntaxis is als volgt:
code language-none {{datasetLookup datasetId="1234567890abcdtId" id=profile.upcomingFlightId result="flight"}}
- We werken in de dataset met als id "1234567890abcdtId",
- Het gebied wij willen gebruiken om zich aan te sluiten bij de blik omhoog dataset is profile.upcomingFlightId,
- We willen alle veldwaarden opnemen onder de "vlucht"-referentie.
-
Zodra de syntaxis om in de dataset van Adobe Experience Platform te roepen is gevormd, kunt u specificeren welke gebieden u wilt terugwinnen. De syntaxis is als volgt:
code language-none {{result.fieldId}}
note note NOTE Wanneer het van verwijzingen voorzien van een datasetgebied, zorg ervoor dat u de volledige die gebiedspad zoals binnen het schema wordt bepaald aanpast. -
resultaat is de waarde die u aan de resultaat parameter in de MultiEntiteit hulpfunctie hebt toegewezen. In dit voorbeeld "vlucht".
-
fieldID is identiteitskaart van het gebied u wilt terugwinnen. Deze id is zichtbaar in de gebruikersinterface van Adobe Experience Platform wanneer het doorbladeren van het recordschema met betrekking tot uw dataset:
accordion Waar moet u een veld-id ophalen? Velden-id's kunnen worden opgehaald wanneer een voorbeeld van een gegevensset in de gebruikersinterface van Adobe Experience Platform wordt weergegeven. Leer hoe te voorproef datasets in de documentatie van Adobe Experience Platform.
In dit voorbeeld willen we informatie gebruiken over de instaptijd en -poort van de passagiers. Daarom voegen wij deze twee lijnen toe:
{{flight._myorg.booking.boardingTime}}
{{flight._myorg.booking.gate}}
-
-
Nu uw code klaar is, kunt u uw inhoud voltooien zoals gewoonlijk, en het testen gebruikend de Simuleer inhoud knoop om de verpersoonlijking te controleren. Leer hoe te om inhoudvoor te vertonen en te testen