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 Platform 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 API's en u weet hoe u deze kunt verifiëren. Als niet, herzie dit leerprogramma.
- U hebt toegang tot een Experience Platform-ontwikkelingssandbox.
- Je kent je Experience Platform huurder-id. U kunt het verkrijgen door een voor authentiek verklaard API verzoekte maken
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
.
Postman gebruiken postman
Omgevingsvariabelen instellen
Alvorens u de stappen volgt, zorg ervoor dat u de toepassing van Postmanhebt gedownload. Laten we beginnen!
-
Download het { dossier 0} platform-utils-main.zip, dat alle dossiers bevat die voor dit leerprogramma worden vereist.
note note NOTE De gegevens van de gebruiker in het { dossier 0} platform-utils-main.zip zijn fictief en moeten slechts voor demonstratiedoeleinden worden gebruikt. -
Verplaats het
platform-utils-main.zip
-bestand vanuit de downloadmap naar de gewenste locatie op de computer en decomprimeer het bestand. -
Open in de map
luma-data
allejson
-bestanden in een teksteditor en vervang alle instanties van_yourTenantId
door uw eigen huurder-id, voorafgegaan door een onderstrepingsteken. -
Open
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 (zoek bijvoorbeeld naar"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 omgevingsvariabele
FILE_PATH
Postman :note note NOTE Om dossierweg op uw Mac te verkrijgen, navigeer aan de platform-utils-main
omslag, klik op de omslag met de rechtermuisknop aan en selecteer krijgt Info 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. -
Open Postman en creeer een werkruimte van het 2} dropdown menu van de Werkruimten {:
-
Ga a Naam en facultatieve Samenvatting voor uw werkruimte in en klik creeer Workspace. Postman schakelt over naar de nieuwe werkruimte wanneer u deze maakt.
-
Pas nu enkele instellingen aan om de Postman -verzamelingen in deze werkruimte uit te voeren. In de kopbal van Postman, klik het tandwielpictogram en selecteer Montages om de montages modaal te openen. U kunt ook de sneltoets (CMD/CTRL + ,) gebruiken om het modaal te openen.
-
Werk onder het tabblad
General
de time-out van de aanvraag in ms bij naar5000 ms
en schakelallow reading file outside this directory
in
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
niet hetzelfde is als het pad naar de werkmap van Postman , moet deze optie zijn ingeschakeld. -
Sluit het paneel van Montages.
-
Selecteer de Milieu's en selecteer dan Invoer:
-
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. Leren hoe te om de waarde van de milieuvariabelen te verkrijgen, controleer voor authentiek verklaart aan Experience Platform APIsleerprogramma voor geleidelijke 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
- Zorg dat u met een onderstrepingsteken gaat werken, bijvoorbeeld_techmarketingdemos
CONTAINER_ID
platform_end_point
FILE_PATH
- gebruik het lokale mappad waar u hetplatform-utils-main.zip
-bestand hebt uitgepakt. Zorg ervoor dat de map de mapnaam bevat, bijvoorbeeld/Users/dwright/Desktop/platform-utils-main
-
sparen het bijgewerkte milieu
Postman-verzamelingen importeren
Vervolgens moet u de verzamelingen importeren in Postman.
-
Selecteer Verzamelingen en kies dan de de invoeroptie:
-
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 externe host en bij Extern ondertekenen wordt de persoonlijke sleutel naar een door Adobe beheerde webservice verzonden. Hoewel Adobe deze persoonlijke sleutel niet opslaat, mogen productietoetsen nooit met iemand worden gedeeld.
-
Open de
0-Authentication
-verzameling, selecteer deOAuth: Request Access Token
-aanvraag en klik opSEND
om de toegangstoken te verifiëren en te verkrijgen. -
Bekijk de omgevingsvariabelen en merk op dat de
ACCESS_TOKEN
nu is 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
inzameling en klik Looppas op het overzichtslusje om een Runner van de Inzameling te beginnen. -
In het venster van de inzamelings runner, zorg ervoor om het milieu van dropdown te selecteren, werk de Vertraging aan
4000ms
bij, controleer sparen reacties optie, en zorg ervoor dat de looppasorde correct is. Klik de knoop van de Gegevens van de Loyalty van de Loyalty van de Loyalty van de Loyalty van de Loyalty van de Loyalty van de Loyalty van de Loyalty van de Loyalty van de Lumanote note NOTE 1-Luma-Loyalty-Gegevens 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, moeten alle aanvragen in de
Luma-Loyalty-Data
-verzameling worden doorgegeven. -
Nu login aan interface van Adobe Experience Platformen navigeer aan datasets.
-
Open de
Luma Loyalty Dataset
dataset, en onder het venster van de datasetactiviteit, kunt u een succesvolle partijlooppas bekijken die 1000 verslagen opnam. 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 er 1000 New Profile Fragments is 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 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
maakt een schema en een gevulde gegevensset voor offlineaankoopgebeurtenisgegevens van klanten. Het schema is gebaseerd op de klasse XDM ExperienceEvent en bestaat uit een aangepaste identiteit en Commerce Details-veldgroepen.5-Luma-Product-Inventory-Events.postman_collection.json
maakt een schema en een gevulde dataset voor gebeurtenissen die betrekking hebben op producten die in- en uitkomen. Het schema is gebaseerd op een aangepaste bedrijfsgebeurtenisklasse en een aangepaste veldgroep.6-Luma-Test-Profiles.postman_collection.json
maakt een schema en een gevulde gegevensset met testprofielen voor gebruik in Adobe Journey Optimizer7-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 interface van Adobe Experience Platform:
- Ga naar Profiles > Browse
- Selecteer
Luma Loyalty Id
als de Identity namespace - Zoeken naar
5625458
als de Identity value - Het profiel
Daniel Wright
openen
Door de gegevens op de tabbladen Attributes en Events te doorbladeren, ziet u dat het profiel gegevens uit de verschillende gegevensbestanden bevat:
Volgende stappen
Als u over Adobe Journey Optimizer zou willen leren, bevat deze zandbak alles u de uitdagingen van Journey Optimizermoet nemen
Als u over samenvoegingsbeleid, gegevensbeheer, vraagdienst, en de segmentbouwer zou willen leren, over aan les 11 in het Begonnen krijgen voor de Architecten van Gegevens en het leerprogramma van de Ingenieurs van Gegevensspringen. 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 voorbeeld van een SDK-implementatie voor het web wilt maken om een koppeling naar deze sandbox te maken, doorloopt u de
voert Adobe Experience Cloud met het leerprogramma van SDK van het Web uit. Nadat u de lessen "Eerste configuratie", "Configuratie tags" en "Experience Platform instellen" van de zelfstudie van Web SDK hebt ingesteld, meldt u zich aan bij de Luma-website met behulp van de eerste tien e-mailadressen in het luma-crm.json
-bestand met behulp van het wachtwoord test
om te zien hoe de profielfragmenten worden samengevoegd met gegevens die in deze zelfstudie zijn geüpload.
Als u een voorbeeld wilt maken van een mobiele SDK-implementatie voor koppeling naar deze sandbox, doorloopt u de
voert Adobe Experience Cloud in mobiele apps leerprogramma uit. Nadat u de lesbestanden "Eerste configuratie", "App-implementatie" en "Experience Platform" van de zelfstudie voor Web SDK hebt ingesteld, meldt u zich aan bij de Luma-website met de eerste e-mailadressen in het 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.
Volg de stappen hierom een zandbakmilieu terug te stellen.