DocumentatieExperience PlatformTutorial voor Web SDK

Gegevens streamen naar Experience Platform met Web SDK

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Onderwerpen:

Gemaakt voor:

  • Beginner
  • tussenpersoon
  • Ontwikkelaar

Leer hoe u webgegevens kunt streamen naar Adobe Experience Platform met Platform Web SDK.

Experience Platform is de ruggengraat van alle nieuwe Experience Cloud toepassingen, zoals Adobe Real-time Customer Data Platform, Adobe Customer Journey Analytics en Adobe Journey Optimizer. Deze toepassingen worden ontworpen om het Web SDK van het Platform als hun optimale methode van Webgegevensinzameling te gebruiken.

SDK van het Web en het diagram van Adobe Experience Platform

Experience Platform gebruikt hetzelfde XDM-schema dat u eerder hebt gemaakt om gebeurtenisgegevens van de Luma-website vast te leggen. Wanneer die gegevens naar de Edge Network van het Platform worden verzonden, kan de configuratie van de gegevensstroom het aan Experience Platform door:sturen.

Leerdoelstellingen

Aan het eind van deze les, zult u kunnen:

  • Een gegevensset maken in Adobe Experience Platform
  • Vorm de gegevensstroom om de gegevens van SDK van het Web naar Adobe Experience Platform te verzenden
  • Streaming webgegevens inschakelen voor realtime klantprofiel
  • Bevestig de gegevens zowel in de dataset van het Platform als in het Profiel van de Klant in real time zijn geland
  • De gegevens van het steekproefloyaliteitsprogramma in Platform opnemen
  • Een eenvoudig platformpubliek maken

Vereisten

Om deze les te voltooien, moet u eerst:

  • Toegang hebben tot een Adobe Experience Platform-toepassing zoals Real-time Customer Data Platform, Journey Optimizer of Customer Journey Analytics
  • Voltooi de vroegere lessen in de Aanvankelijke secties van de Configuratie van de Configuratie en van de Markeringen van dit leerprogramma.
NOTE
Als u geen toepassingen van het Platform hebt, kunt u deze les overslaan of lezen.

Een gegevensset maken

Alle gegevens die met succes in Adobe Experience Platform worden opgenomen, blijven binnen het datumpeer als datasets voortbestaan. A datasetis een opslag en beheersconstructie voor een inzameling van gegevens, typisch een lijst die een schema (kolommen) en gebieden (rijen) bevat. Datasets bevatten ook metagegevens die verschillende aspecten van de gegevens beschrijven die ze opslaan.

Stel een gegevensset in voor uw Luma-webgebeurtenisgegevens:

  1. Ga naar het Experience Platformof Journey Optimizerinterface

  2. Bevestig dat u zich in de ontwikkelingssandbox bevindt die u voor deze zelfstudie gebruikt

  3. Data Management > Datasets openen vanuit de linkernavigatie

  4. Selecteren Create dataset

    creeer schema

  5. Selecteer de optie Create dataset from schema

    creeer dataset van schema

  6. Selecteer het Luma Web Event Data die schema in de wordt gecreeerd vroegere lesen selecteer dan Next

    Dataset, uitgezochte schema

  7. Geef een Name en optioneel Description op voor de gegevensset. Gebruik voor deze oefening Luma Web Event Data en selecteer vervolgens Finish

    Naam gegevensset

Een dataset wordt nu gevormd beginnen gegevens van uw implementatie van SDK van het Web van het Platform te verzamelen.

De gegevensstroom configureren

Nu kunt u uw datastream configureren om gegevens naar Adobe Experience Platform te verzenden. De gegevensstroom is het verband tussen uw markeringsbezit, de Edge Network van het Platform, en de dataset van het Experience Platform.

  1. Open de 🔗 {target=“blank”} interface van de Inzameling van 0} Gegevens

  2. Selecteer Datastreams in de linkernavigatie

  3. Open de datastream u in creeerde vormen een datastreamles, Luma Web SDK

    selecteer de datastream van SDK van het Web van Luma

  4. Selecteren Add Service
    voegt de dienst aan de datastream toe

  5. Selecteer Adobe Experience Platform als de Service

  6. Selecteer Luma Web Event Data als de Event Dataset

  7. Selecteer Save.

    DataStream Config

Aangezien u verkeer op de Plaats van de Demo van de Lumaproduceert die aan uw markeringsbezit wordt in kaart gebracht, bevolkt de gegevens de dataset in Experience Platform!

De gegevensset valideren

Deze stap is essentieel om ervoor te zorgen dat de gegevens in de dataset zijn geland. Er zijn twee aspecten van het valideren van gegevens die naar de dataset worden verzonden.

  • Valideren met Experience Platform Debugger
  • Valideren met Preview Dataset
  • Valideren met Query Service

Experience Platform Debugger

Deze stappen zijn meer of minder het zelfde als wat u in de Debugger lesdeed. Aangezien gegevens echter alleen naar Platform worden verzonden nadat u deze in de gegevensstroom hebt ingeschakeld, moet u nog enkele voorbeeldgegevens genereren:

  1. Open de plaats van de Luminagedemoen selecteer het Experience Platform Debugger uitbreidingspictogram

  2. Vorm Debugger om het markeringsbezit aan in kaart te brengen uw milieu van de Ontwikkeling, zoals die in wordt beschreven bevestigt met Debuggerles

    Uw ontwikkelomgeving van de Lancering die in Debugger wordt getoond

  3. Meld u aan bij de Luministensite met de referenties test@adobe.com/test

  4. Terugkeer aan de homepage van Luma

  5. Binnen de het netwerkbakens van SDK van het Web van het Platform die door debugger worden getoond, selecteer de "gebeurtenissen"rij om details in een pop-up uit te breiden

    SDK van het Web in Debugger

  6. Zoek naar "identityMap"binnen pop-up. Hier moet u lumaCrmId zien met drie sleutels van authenticatedState, id en primaire
    SDK van het Web in Debugger

Gegevens moeten nu worden ingevuld in de gegevensset Luma Web Event Data en klaar zijn voor validatie van de gegevensset Voorvertoning.

Een voorvertoning van de gegevensset weergeven

Om te bevestigen dat de gegevens in het gegevensmeer van Platform zijn geland, kunt u de functie Preview dataset snel gebruiken. De gegevens van SDK van het Web zijn micro-gebatcheerd aan het gegevens meer en op periodieke basis verfrist in de interface van het Platform. Het kan 10 tot 15 minuten duren om de gegevens te zien die u hebt gegenereerd.

  1. In de interface van het Experience Platform, selecteer Data Management > Datasets in de linkernavigatie om het Datasets dashboard te openen.

    Het dashboard maakt een lijst van alle beschikbare datasets voor uw organisatie. De details worden getoond voor elke vermelde dataset, met inbegrip van zijn naam, het schema de dataset zich aan, en status van de meest recente versiereeks houdt.

  2. Selecteer uw Luma Web Event Data dataset om zijn Dataset activity scherm te openen.

    Gebeurtenis van het Web van de Luminantie van de Dataset

    Het activiteitenscherm omvat een grafiek die het tarief visualiseert van berichten die worden verbruikt evenals een lijst van succesvolle en ontbroken partijen.

  3. Selecteer in het Dataset activity -scherm Preview dataset in de rechterbovenhoek van het scherm om een voorvertoning van maximaal 100 rijen met gegevens weer te geven. Als de dataset leeg is, wordt de voorproefverbinding gedeactiveerd.

    Voorproef van de Dataset

    In het voorproefvenster, wordt de hiërarchische mening van het schema voor de dataset getoond op het recht.

    Voorproef van de Dataset 1

De gegevens opvragen

  1. In de interface van het Experience Platform, selecteer Data Management > Queroes in de linkernavigatie om het Queries scherm te openen.
  2. Selecteren Create query
  3. Eerst, stel een vraag in werking om alle namen van de lijsten in het gegevensmeer te zien. Voer SHOW TABLES in de query-editor in en klik op het afspeelpictogram om de query uit te voeren.
  4. In de resultaten ziet u hoe de naam van de tabel er ongeveer als volgt uitziet luma_web_event_data
  5. Nu vraag de lijst met een eenvoudige vraag die naar uw lijst van verwijzingen voorziet (merk op dat door gebrek de vraag tot 100 resultaten zal worden beperkt): SELECT * FROM "luma_web_event_data"
  6. Na een paar ogenblikken ziet u voorbeeldrecords van uw webgegevens.
ERROR
Als er een fout optreedt met de instelling "Tabel niet voorzien", controleert u de naam van de tabel nogmaals. Het kan ook zijn dat de micropartij gegevens nog niet in het datumpeer is geland. Probeer het over 10-15 minuten opnieuw.
INFO
Voor meer details over de vraagdienst van Adobe Experience Platform, zie gegevensin de sectie van de Leerprogramma's van het Platform onderzoeken.

De dataset en het schema voor het Profiel van de Klant in real time inschakelen

Voor klanten van Real-time Customer Data Platform en Journey Optimizer, is de volgende stap de dataset en het schema voor het Profiel van de Klant in real time toe te laten. Gegevens die van SDK van het Web stromen zullen één van vele gegevensbronnen zijn die in Platform stromen en u wilt zich bij uw Webgegevens met andere gegevensbronnen aansluiten om klantenprofielen van 360 graads te bouwen. Bekijk deze korte video voor meer informatie over Real-Time Customer Profile:

https://video.tv.adobe.com/v/27251?learn=on&captions=eng

CAUTION
Wanneer we met uw eigen website en gegevens werken, raden we u aan gegevens robuuster te valideren voordat u deze inschakelt voor het realtime-klantprofiel.

om de dataset toe te laten:

  1. Open de gegevensset die u hebt gemaakt, Luma Web Event Data

  2. Selecteer de Profile Toggle om deze in te schakelen

    Wisselen van het Profiel

  3. Bevestig dat u de gegevensset wilt Enable

    Profiel laat Wisselen toe

om het schema toe te laten:

  1. Open het schema dat u hebt gemaakt, Luma Web Event Data

  2. Selecteer de Profile Toggle om deze in te schakelen

    Wisselen van het Profiel

  3. Selecteren Data for this schema will contain a primary identity in the identityMap field.

    note important
    IMPORTANT
    Primaire id's zijn vereist voor elk record dat wordt verzonden naar het Real-Time Klantprofiel. Identiteitsvelden worden doorgaans gelabeld in het schema. Als u identiteitskaarten gebruikt, zijn de identiteitsvelden echter niet zichtbaar binnen het schema. In dit dialoogvenster kunt u bevestigen dat u een primaire identiteit voor ogen hebt en dat u deze in een identiteitsoverzicht opgeeft wanneer u uw gegevens verzendt. Zoals u weet, gebruikt SDK van het Web een identiteitskaart met Experience Cloud identiteitskaart (ECID) als standaard primaire identiteit en voor authentiek verklaarde identiteitskaart als primaire identiteit wanneer beschikbaar.

  4. Selecteren Enable

    Profiel laat Wisselen toe

  5. Selecteer Save om het bijgewerkte schema op te slaan

Het schema is nu ook ingeschakeld voor het profiel.

IMPORTANT
Als een schema eenmaal is ingeschakeld voor Profiel, kan het niet worden uitgeschakeld of verwijderd zonder de volledige sandbox opnieuw in te stellen of te verwijderen. Ook kunnen velden na dit punt niet uit het schema worden verwijderd.
Als u met uw eigen gegevens werkt, is het raadzaam de volgende handelingen uit te voeren:
  • Eerst, ga sommige gegevens in uw datasets in.
  • Oplossen van problemen die zich tijdens het invoeren van gegevens voordoen (bijvoorbeeld problemen met gegevensvalidatie of -toewijzing).
  • Uw gegevenssets en schema's voor profiel inschakelen
  • Voer de gegevens opnieuw in, indien nodig

Een profiel valideren

U kunt een klantprofiel opzoeken in de interface Platform (of Journey Optimizer-interface) om te bevestigen dat de gegevens zijn geland in het Real-Time Klantprofiel. Zoals de naam suggereert, bevolken de profielen in real time, zodat is er geen vertraging zoals met het bevestigen van gegevens in de dataset.

Eerst moet u meer voorbeeldgegevens genereren. Herhaal de stappen uit eerdere versies in deze les om u aan te melden bij de Luma-website wanneer deze is toegewezen aan uw tag-eigenschap. Inspect het verzoek van de SDK van het Web van het Platform om ervoor te zorgen het gegevens met lumaCRMId verzendt.

  1. In de interface van het Experience Platform, uitgezochte Customer > Profiles in de linkernavigatie

  2. Als Identity namespace use lumaCRMId

  3. Kopieer en plak de waarde van de lumaCRMId die is doorgegeven in de aanroep die u hebt gecontroleerd in Foutopsporing op Experience Platform, in dit geval 112ca06ed53d3db37e4cea49cc45b71e .

    Profiel

  4. Als het profiel voor lumaCRMId een geldige waarde bevat, wordt een profiel-id in de console gevuld:

    Profiel

  5. Als u de volledige Customer Profile voor elke id wilt weergeven, selecteert u de Profile ID in het hoofdvenster.

    note note
    NOTE
    U kunt de hyperlink van de profiel-id selecteren of als u de rij selecteert, wordt een rechts menu geopend waarin u de hyperlink Profiel-id kunt selecteren
    profiel van de Klant

    Hier ziet u alle identiteiten die aan lumaCRMId zijn gekoppeld, zoals de ECID .

    profiel van de Klant

U hebt nu Platform Web SDK voor Experience Platform ingeschakeld (En Real-Time CDP! En Journey Optimizer! En Customer Journey Analytics!).

Een kwaliteitsschema maken en voorbeeldgegevens invoeren

Deze exercitie zal naar verwachting worden voltooid voor klanten van Real-time Customer Data Platform en Journey Optimizer.

Wanneer de gegevens van SDK van het Web in Adobe Experience Platform worden opgenomen, kan het door andere gegevensbronnen worden verrijkt u in Platform hebt ingebed. Bijvoorbeeld, wanneer een gebruiker zich bij de plaats van de Luma aanmeldt, wordt een identiteitsgrafiek gebouwd in Experience Platform en alle andere profiel-toegelaten datasets kunnen potentieel samen worden samengevoegd om de Profielen van de Klant in real time te bouwen. Om dit in actie te zien, creeer snel een andere dataset in Adobe Experience Platform met wat gegevens van de steekproefloyaliteit zodat u de Profielen van de Klant in real time met Real-time Customer Data Platform en Journey Optimizer kunt gebruiken. Aangezien u reeds soortgelijke oefeningen hebt uitgevoerd, zullen de instructies kort zijn.

Maak het loyaliteitsschema:

  1. Een nieuw schema maken

  2. Kies Individual Profile als de base class

  3. Geef het schema een naam Luma Loyalty Schema

  4. De veldgroep Loyalty Details toevoegen

  5. De veldgroep Demographic Details toevoegen

  6. Selecteer het veld Person ID en markeer het als een Identity en Primary identity met Luma CRM Id Identity namespace .

  7. Het schema inschakelen voor Profile . Als u de schakeloptie Profiel niet kunt vinden, klikt u op de schemanaam linksboven.

  8. Het schema opslaan

    Schema van de Loyalty

Om de dataset tot stand te brengen en de steekproefgegevens in te gaan:

  1. Een nieuwe gegevensset maken met de Luma Loyalty Schema

  2. Geef de gegevensset een naam Luma Loyalty Dataset

  3. De gegevensset inschakelen voor Profile

  4. Download het steekproefdossier luma-loyalty-forWeb.json

  5. Sleep het bestand naar uw gegevensset en zet het neer

  6. Bevestig dat de gegevens correct zijn ingevoerd

    Schema van de Loyalty

Een publiek maken

Groepprofielen van soorten publiek worden gecombineerd rond algemene kenmerken. Bouw een snel publiek u in uw Webcampagne kunt gebruiken:

  1. Ga in de interface Experience Platform of Journey Optimizer naar Customer > Audiences in de linkernavigatie

  2. Selecteren Create audience

  3. Selecteren Build rule

  4. Selecteren Create

    Een doelgroep maken

  5. Selecteren Attributes

  6. Het veld Loyalty > Tier zoeken en naar de sectie Attributes slepen

  7. Het publiek definiëren als gebruikers met tier is gold

  8. Noem het publiek Luma Loyalty Rewards – Gold Status

  9. Selecteer Edge als de Evaluation method

  10. Selecteren Save

    De doelgroep definiëren

Omdat dit een heel eenvoudig publiek is, kunnen we de evaluatiemethode van Edge gebruiken. Het publiek van Edge evalueert op de rand, zodat in het zelfde verzoek dat door SDK van het Web aan de Edge Network van het Platform wordt gemaakt, kunnen wij de publieksdefinitie evalueren en onmiddellijk bevestigen als de gebruiker zal kwalificeren.

Volgende:

NOTE
Bedankt dat u tijd hebt geïnvesteerd in het leren over de SDK van Adobe Experience Platform Web. Als u vragen hebt, algemene terugkoppelen wilt delen, of suggesties over toekomstige inhoud hebben, gelieve hen op deze Communautaire besprekingspost van de Experience League te delen
recommendation-more-help
8cbc0fd8-ca1d-433b-9c3d-bc3f113347d4