Voorbeeldgegevens importeren naar Adobe Experience Platform
Leer hoe u een Experience Platform-sandboxomgeving instelt met voorbeeldgegevens. Met behulp van een Postman-verzameling kunt u veldgroepen, schema's, gegevenssets maken en vervolgens voorbeeldgegevens importeren in Experience Platform.
Voorbeeld van gebruik van gegevens
Zakelijke gebruikers van Experience Platforms moeten vaak een reeks stappen doorlopen die het identificeren van veldgroepen, het creëren van schema's, het voorbereiden van gegevens, het creëren van datasets, en dan het opnemen van gegevens omvatten alvorens zij de marketing mogelijkheden kunnen onderzoeken die door Experience Platform worden aangeboden. In deze zelfstudie worden enkele stappen geautomatiseerd, zodat u gegevens zo snel mogelijk in een platformsandbox kunt plaatsen.
Deze zelfstudie richt zich op een fictief, handelsmerk genaamd Luma. Zij investeren in Adobe Experience Platform om loyaliteit, CRM, productcatalogus, en off-line aankoopgegevens in klantenprofielen in real time te combineren en deze profielen te activeren om hun marketing aan het volgende niveau te brengen. We hebben voorbeeldgegevens gegenereerd voor Luma en in de rest van deze zelfstudie importeert u deze gegevens in een van uw Experience Platform-sandboxomgevingen.
Vereisten
- U hebt toegang tot Experience Platform APIs en weet hoe te voor authentiek te verklaren. Zo niet, bekijk dit zelfstudie.
- U hebt toegang tot een sandbox voor het ontwikkelen van Experience Platforms.
- Je kent je Experience Platform huurder-id. U kunt het verkrijgen door voor authentiek te maken API-verzoek
of door deze uit de URL te halen wanneer u zich aanmeldt bij uw Platform-account. In de volgende URL is de huurder bijvoorbeeld "techmarketingdemos
"https://experience.adobe.com/#/@techmarketingdemos/sname:prod/platform/home
.
Gebruiken Postman postman
Omgevingsvariabelen instellen
Voordat u de stappen uitvoert, moet u controleren of u de Postman toepassing. Laten we beginnen!
-
Download de platform-utils-main.zip bestand, dat alle bestanden bevat die voor deze zelfstudie zijn vereist.
note note NOTE Gebruikersgegevens in de platform-utils-main.zip het bestand is fictief en mag alleen voor demonstratiedoeleinden worden gebruikt. -
Verplaats vanuit de map met downloads de
platform-utils-main.zip
naar de gewenste locatie op de computer en decomprimeer het bestand. -
In de
luma-data
map, allejson
bestanden in een teksteditor en vervang alle instanties van_yourTenantId
met je eigen huurder-id, voorafgegaan door een onderstrepingsteken. -
Openen
luma-offline-purchases.json
,luma-inventory-events.json
, enluma-web-events.json
in een teksteditor en werk alle tijdstempels bij, zodat de gebeurtenissen in de laatste maand plaatsvinden (bijvoorbeeld om"timestamp":"2022-11
en vervang het jaar en de maand) -
Noteer de locatie van de uitgevouwen map, zoals u deze later nodig hebt bij het instellen van de
FILE_PATH
Postman omgevingsvariabele:note note NOTE Als u een bestandspad op uw Mac wilt verkrijgen, navigeert u naar de platform-utils-main
map, klikt u met de rechtermuisknop op de map en selecteert u Info opvragen -optie.note note NOTE U verkrijgt dossierweg op uw vensters, klik om de plaats van de gewenste omslag te openen, en dan met de rechtermuisknop aan het recht van de weg in de adresbar te klikken. Kopieer het adres om het bestandspad te verkrijgen. -
Openen Postman en maakt u een werkruimte op basis van de Werkruimten vervolgkeuzelijst:
-
Voer een Naam en optioneel Samenvatting voor uw werkruimte en klik op Werkruimte maken. Postman schakelt u over naar de nieuwe werkruimte wanneer u deze maakt.
-
Pas nu enkele instellingen aan om het dialoogvenster Postman in deze werkruimte. In de koptekst van Postman, klikt u op het tandwielpictogram en selecteert u Instellingen om de instellingen modaal te openen. U kunt ook de sneltoets (CMD/CTRL + ,) gebruiken om het modaal te openen.
-
Onder de
General
tabblad, de time-out van de aanvraag in ms bijwerken naar5000 ms
enallow reading file outside this directory
note note NOTE Als bestanden vanuit de werkmap worden geladen, worden ze op alle apparaten probleemloos uitgevoerd als dezelfde bestanden op de andere apparaten worden opgeslagen. Als u echter bestanden van buiten de werkmap wilt uitvoeren, moet een instelling worden ingeschakeld om dezelfde intentie aan te geven. Als uw FILE_PATH
is niet gelijk aan PostmanHet pad naar de werkmap moet nu zijn ingeschakeld. -
Sluit het dialoogvenster Instellingen deelvenster.
-
Selecteer de Omgevingen en selecteer vervolgens Importeren:
-
Importeer het gedownloade JSON-omgevingsbestand.
DataInExperiencePlatform.postman_environment
-
Selecteer in Postman de omgeving in het vervolgkeuzemenu rechtsboven en klik op het oogpictogram om de omgevingsvariabelen weer te geven:
-
Controleer of de volgende omgevingsvariabelen zijn gevuld. Als u wilt weten hoe u de waarde van de omgevingsvariabelen ophaalt, raadpleegt u de Verifiëren voor Experience Platform-API's zelfstudie voor stapsgewijze instructies.
CLIENT_SECRET
API_KEY
—Client ID
in Adobe Developer ConsoleSCOPES
TECHNICAL_ACCOUNT_ID
IMS
IMS_ORG
—Organization ID
in Adobe Developer ConsoleSANDBOX_NAME
TENANT_ID
—moet met een onderstrepingsteken bijvoorbeeld beginnen_techmarketingdemos
CONTAINER_ID
platform_end_point
FILE_PATH
—gebruik het lokale omslagweg waar u uitgepaktplatform-utils-main.zip
bestand. Zorg ervoor dat de map bijvoorbeeld de mapnaam bevat/Users/dwright/Desktop/platform-utils-main
-
Opslaan de bijgewerkte omgeving
Postman-verzamelingen importeren
Vervolgens moet u de verzamelingen importeren in Postman.
-
Selecteren Verzamelingen en kies vervolgens de importoptie:
-
Importeer de volgende verzamelingen:
0-Authentication.postman_collection.json
1-Luma-Loyalty-Data.postman_collection.json
2-Luma-CRM-Data.postman_collection.json
3-Luma-Product-Catalog.postman_collection.json
4-Luma-Offline-Purchase-Events.postman_collection.json
5-Luma-Product-Inventory-Events.postman_collection.json
6-Luma-Test-Profiles.postman_collection.json
7-Luma-Web-Events.postman_collection.json
Verifiëren
Vervolgens moet u een gebruikerstoken verifiëren en genereren. Houd er rekening mee dat de methoden voor het genereren van tokens die in deze zelfstudie worden gebruikt, alleen geschikt zijn voor niet-productiedoeleinden. Bij Lokaal ondertekenen wordt een JavaScript-bibliotheek geladen van een host van een andere fabrikant en bij Extern ondertekenen wordt de persoonlijke sleutel verzonden naar een Adobe die eigendom is van en wordt beheerd met de webservice. Hoewel deze persoonlijke sleutel niet wordt opgeslagen in de Adobe, mogen productietoetsen nooit met iemand worden gedeeld.
-
Open de
0-Authentication
verzameling, selecteer deOAuth: Request Access Token
verzoek, en klikSEND
om het toegangstoken voor authentiek te verklaren en te verkrijgen. -
Controleer de omgevingsvariabelen en merk op dat de
ACCESS_TOKEN
is nu gevuld.
Gegevens importeren
Nu kunt u de gegevens voorbereiden en importeren in uw platformsandbox. De Postman-verzamelingen die u hebt geïmporteerd, maken het hele heft!
-
Open de
1-Luma-Loyalty-Data
verzameling en klik op Uitvoeren op het overzichtslusje om een Runner van de Inzameling te beginnen. -
Zorg ervoor dat in het venster van de verzamelingsrunner de omgeving in het vervolgkeuzemenu is geselecteerd en werk de Vertraging tot
4000ms
, controleert u de Reacties opslaan en zorgt u ervoor dat de uitvoervolgorde correct is. Klik op de knop Loyaliteitsgegevens uitvoeren knopnote note NOTE 1-Luma-Loyalty-Data leidt tot een schema voor de gegevens van de klantenloyaliteit. Het schema is gebaseerd op de individuele klasse van het Profiel XDM, standaardgebiedsgroep, en een groep en een gegevenstype van het douanegebied. De inzameling leidt tot een dataset gebruikend het schema en uploadt de gegevens van de steekproefklantenloyaliteit aan Adobe Experience Platform. note note NOTE Als om het even welke inzamelingsverzoeken tijdens de de inzamelingsloopler van Postman ontbreken, houd de uitvoering tegen en stel de inzamelingsverzoeken één voor één in werking. -
Als alles goed gaat, alle verzoeken in de
Luma-Loyalty-Data
de verzameling moet slagen . -
Nu aanmelden bij Adobe Experience Platform-interface en navigeer naar gegevenssets.
-
Open de
Luma Loyalty Dataset
dataset, en onder het venster van de gegevenssetactiviteit, kunt u een succesvolle partijlooppas bekijken die 1000 verslagen ingebed. U kunt ook op de optie van de voorproefdataset klikken om de opgenomen verslagen te verifiëren. Mogelijk moet u enkele minuten wachten om te bevestigen dat 1000 New Profile Fragments zijn gemaakt.
-
Herhaal stap 1-3 om de andere verzamelingen uit te voeren:
2-Luma-CRM-Data.postman_collection.json
leidt tot een schema en bevolkte dataset voor de gegevens van CRM van klanten. Het schema is gebaseerd op de klasse van het Profiel van Individuele XDM die Demografische Details, Persoonlijke Details van het Contact, de Details van de Voorkeur en een groep van het het gebiedsveld van de douaneidentiteit omvat.3-Luma-Product-Catalog.postman_collection.json
leidt tot een schema en een bevolkte dataset voor de informatie van de productcatalogus. Het schema is gebaseerd op een aangepaste productcatalogusklasse en gebruikt een aangepaste productcatalogusveldgroep.4-Luma-Offline-Purchase-Events.postman_collection.json
leidt tot een schema en een bevolkte dataset voor off-line gegevens van de koopgebeurtenis van klanten. Het schema is gebaseerd op de klasse XDM ExperienceEvent en omvat een aangepaste identiteit en de de gebiedsgroepen van de Details van de Handel.5-Luma-Product-Inventory-Events.postman_collection.json
leidt tot een schema en bevolkte dataset voor gebeurtenissen met betrekking tot producten die in en uit voorraad gaan. Het schema is gebaseerd op een aangepaste bedrijfsgebeurtenisklasse en een aangepaste veldgroep.6-Luma-Test-Profiles.postman_collection.json
leidt tot een schema en bevolkte dataset met testprofielen in Adobe Journey Optimizer te gebruiken7-Luma-Web-Events.postman_collection.json
leidt tot een schema en bevolkte dataset met eenvoudige historische Webgegevens.
Validatie
De voorbeeldgegevens zijn zodanig ontworpen dat, wanneer de verzamelingen zijn uitgevoerd, realtime profielen van klanten worden gemaakt waarin gegevens van meerdere systemen worden gecombineerd. Een goed voorbeeld hiervan is de eerste record van de gegevens over loyaliteit, CRM en offline aankopen. Zoek dat profiel op om te bevestigen dat de gegevens zijn opgenomen. In de Adobe Experience Platform-interface:
- Ga naar Profiles > Browse
- Selecteren
Luma Loyalty Id
als de Identity namespace - Zoeken naar
5625458
als de Identity value - Open de
Daniel Wright
profiel
Door de gegevens in het dialoogvenster Attributes en Events tabbladen, ziet u dat het profiel gegevens bevat uit de verschillende gegevensbestanden:
Volgende stappen
Als u meer wilt weten over Adobe Journey Optimizer, bevat deze sandbox alles wat u nodig hebt om de Journey Optimizer-uitdagingen
Als u over samenvoegingsbeleid, gegevensbeheer, vraagdienst, en de segmentbouwer zou willen leren, over aan les 11 in het Getting Started for Data Architects and Data Engineers lesbestand. De vroegere lessen van dit andere leerprogramma hebben u manueel alles bouwen dat enkel door deze inzameling van Postman bevolkt was—geniet van het hoofdbegin!
Als u een voorbeeldimplementatie van SDK van het Web aan verbinding aan deze zandbak wilt bouwen, ga door
Zelfstudie Adobe Experience Cloud implementeren met Web SDK. Nadat u de lessen "Eerste configuratie", "Configuratie van tags" en "Experience Platform instellen" van de zelfstudie van de SDK van Web hebt ingesteld, meldt u zich aan bij de Luma-website met de eerste tien e-mailadressen in het dialoogvenster luma-crm.json
bestand met het wachtwoord test
om te zien hoe de profielfragmenten worden samengevoegd met gegevens die in deze zelfstudie zijn geüpload.
Als u een voorbeeld van een mobiele SDK-implementatie wilt maken om een koppeling naar deze sandbox te maken, doorloopt u de
Zelfstudie Adobe Experience Cloud implementeren in mobiele apps. Nadat u de lessen "Eerste configuratie", "App-implementatie" en "Experience Platform" van de zelfstudie van de Web SDK hebt ingesteld, meldt u zich aan bij de Luma-website met de eerste e-mailadressen in het dialoogvenster luma-crm.json
bestand om een profielfragment samen te voegen met gegevens die in deze zelfstudie zijn geüpload.
Sandbox-omgeving opnieuw instellen reset-sandbox
Als u een niet-productiesandbox opnieuw instelt, worden alle bronnen verwijderd die aan die sandbox zijn gekoppeld (schema's, gegevenssets, enzovoort), terwijl de naam van de sandbox en de bijbehorende machtigingen behouden blijven. Deze 'schone' sandbox blijft onder dezelfde naam beschikbaar voor gebruikers die er toegang toe hebben.
Voer de stappen uit hier om een sandboxomgeving opnieuw in te stellen.