DocumentatieExperience PlatformTutorial voor Web SDK

Gegevens streamen naar Experience Platform met Web SDK

Last update: Sat Jun 01 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.

WebSDK en Adobe Experience Platform-diagram

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 gegevensset is 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 de Experience Platform of Journey Optimizer interface

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

  3. Openen Data Management > Datasets van de linkernavigatie

  4. Selecteren Create dataset

    Schema maken

  5. Selecteer de Create dataset from schema option

    Gegevensset maken van schema

  6. Selecteer de Luma Web Event Data schema gemaakt in het dialoogvenster eerdere les en selecteer vervolgens Next

    Gegevensset, schema selecteren

  7. Geef een Name en optioneel Description voor de gegevensset. Voor deze oefening, gebruik Luma Web Event Dataselecteert u 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 gegevens verzenden naar Adobe Experience Platform. De gegevensstroom is het verband tussen uw markeringsbezit, de Edge Network van het Platform, en de dataset van het Experience Platform.

  1. Open de Gegevensverzameling interface

  2. Selecteren Datastreams van de linkernavigatie

  3. Open de gegevensstroom die u in het dialoogvenster Een gegevensstroom configureren les, Luma Web SDK

    Selecteer de Luma Web SDK-gegevensstroom

  4. Selecteren Add Service
    Een service toevoegen aan de gegevensstroom

  5. Selecteren Adobe Experience Platform als de Service

  6. Selecteren Luma Web Event Data als de Event Dataset

  7. Selecteren Save.

    DataStream Config

Terwijl u verkeer op de Luma-demo-site Aan uw markeringsbezit 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 min of meer hetzelfde als wat u in het dialoogvenster Foutopsporingsles. 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 Luma-demosite en selecteert u de Experience Platform Debugger extensiepictogram

  2. Foutopsporing configureren om de eigenschap tag toe te wijzen aan uw Ontwikkelomgeving, zoals beschreven in de Valideren met foutopsporing les

    Uw ontwikkelomgeving voor Starten wordt weergegeven in Foutopsporing

  3. Log in op de Luministensite met de referenties test@adobe.com/test

  4. Terugkeren naar de Luminantiepage

  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

    Web SDK in Foutopsporing

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

Gegevens moeten nu worden ingevuld in het dialoogvenster Luma Web Event Data dataset en klaar voor de bevestiging van de Dataset van de Voorproef.

Een voorvertoning van de gegevensset weergeven

Om te bevestigen dat de gegevens in het datumpigment van Platform zijn geland, is het snel mogelijk om de Preview dataset 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 Experience Platform interface, selecteren Data Management > Datasets in de linkernavigatie om het dialoogvenster Datasets dashboard.

    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 te openen Dataset activity scherm.

    Webgebeurtenis DataSet Luma

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

  3. Van de Dataset activity scherm, selecteren Preview dataset in de rechterbovenhoek van het scherm om maximaal 100 rijen met gegevens voor te vertonen. Als de dataset leeg is, wordt de voorproefverbinding gedeactiveerd.

    Voorvertoning gegevensset

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

    Dataset Voorvertoning 1

De gegevens opvragen

  1. In de Experience Platform interface, selecteren Data Management > Queroes in de linkernavigatie om het dialoogvenster Queries scherm.
  2. Selecteren Create query
  3. Eerst, stel een vraag in werking om alle namen van de lijsten in het gegevensmeer te zien. Enter SHOW TABLES in de vraagredacteur en klik het playbackpictogram om de vraag in werking te stellen.
  4. In de resultaten ziet u hoe de naam van de tabel eruit ziet luma_web_event_data
  5. Vraag nu de lijst met een eenvoudige vraag die naar uw lijst van verwijzingen voorzien (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
Zie voor meer informatie over de Adobe Experience Platform-queryservice Gegevens verkennen in de sectie Platform-zelfstudies.

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 het aan te zetten

    Profiel in-/uitschakelen

  3. Bevestigen dat u wilt Enable de dataset

    Schakelen tussen profielen inschakelen

Het schema inschakelen:

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

  2. Selecteer de Profile Toggle om het aan te zetten

    Profiel in-/uitschakelen

  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

    Schakelen tussen profielen inschakelen

  5. Selecteren Save het bijgewerkte schema opslaan

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 SDK van het Web van het Platform om ervoor te zorgen het gegevens met verzendt lumaCRMId.

  1. In de Experience Platform interface, selecteren Customer > Profiles in de linkernavigatie

  2. Als de Identity namespace gebruiken lumaCRMId

  3. De waarde van de opdracht kopiëren en plakken lumaCRMId overgegaan in de vraag die u in Debugger van het Experience Platform inspecteerde, in dit geval 112ca06ed53d3db37e4cea49cc45b71e.

    Profiel

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

    Profiel

  5. Als u de volledige Customer Profile Selecteer voor elke id de optie 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
    Klantprofiel

    Hier kunt u alle identiteiten zien verbonden aan lumaCRMId, zoals de ECID.

    Klantprofiel

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. Voeg de Loyalty Details veldgroep

  5. Voeg de Demographic Details veldgroep

  6. Selecteer de Person ID veld en markeren als een Identity en Primary identity met de 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

    Loyaliteitsschema

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

  1. Maak een nieuwe dataset van de Luma Loyalty Schema

  2. De gegevensset een naam geven Luma Loyalty Dataset

  3. De gegevensset inschakelen voor Profile

  4. Het voorbeeldbestand downloaden luma-loyalty-forWeb.json

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

  6. Bevestig dat de gegevens correct zijn ingevoerd

    Loyaliteitsschema

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 publiek maken

  5. Selecteren Attributes

  6. Zoek de Loyalty > Tier en sleep het naar het Attributes sectie

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

  8. Naam van het publiek Luma Loyalty Rewards – Gold Status

  9. Selecteren Edge als de Evaluation method

  10. Selecteren Save

    Het publiek definiëren

Aangezien dit een zeer eenvoudig publiek is, kunnen wij de de evaluatiemethode van de Rand gebruiken. Het publiek van de rand 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 feedback wilt delen of suggesties voor toekomstige inhoud hebt, kunt u deze delen over deze Experience League Communautaire discussiestuk
recommendation-more-help
8cbc0fd8-ca1d-433b-9c3d-bc3f113347d4