De Adobe Experience Platform Identity Service toevoegen

Deze les zal uw door de stappen begeleiden die worden vereist om uit te voeren Adobe Experience Platform Identity Service-extensie en sturen Customer ids.

De Adobe Experience Platform Identity Service Hiermee wordt een gemeenschappelijke bezoeker-id ingesteld voor alle Adobe-oplossingen, zodat de Experience Cloud-mogelijkheden, zoals het delen van het publiek tussen de oplossingen, worden ingeschakeld. U kunt ook uw eigen klanten-id's naar de service sturen, zodat u toepassingen op verschillende apparaten kunt zoeken en kunt integreren met uw CRM-systeem (Customer Relationship Management).

NOTE
Adobe Experience Platform Launch wordt in Adobe Experience Platform geïntegreerd als een reeks technologieën voor gegevensverzameling. Verschillende terminologiewijzigingen zijn geïmplementeerd in de interface die u tijdens het gebruik van deze inhoud moet onthouden:

Leerdoelen

Aan het eind van deze les, zult u kunnen:

  • De extensie Identiteitsservice toevoegen
  • Een gegevenselement maken om uw klantgegevens te verzamelen
  • Maak een regel die de actie "Customer ID's instellen" gebruikt om de id's van de klant naar Adobe te sturen
  • Gebruik de functie voor regelvolgorde om regels uit te voeren die op dezelfde gebeurtenis worden geactiveerd

Vereisten

U had de lessen in het Tags configureren sectie.

De extensie Identiteitsservice toevoegen

Aangezien dit de eerste extensie is die u toevoegt, volgt hier een kort overzicht van extensies. Extensies zijn een van de kernkenmerken van tags. Een extensie is een integratie die is gebouwd door Adobe, een Adobe-partner of een klant van een Adobe die nieuwe en eindeloze opties toevoegt voor de tags die u kunt implementeren op uw website. Als u tags als besturingssysteem beschouwt, zijn extensies de toepassingen die u installeert, zodat tags de taken kunnen uitvoeren die u nodig hebt.

De extensie Identiteitsservice toevoegen

  1. Klik in de linkernavigatie op Extensies

  2. Klikken Catalogus naar de pagina Extensiecatalogus gaan

  3. Let op de verschillende extensies die beschikbaar zijn in de catalogus

  4. Typ in het filter bovenaan "id" om de catalogus te filteren

  5. Klik op de kaart voor de Adobe Experience Platform Identity Service op Installeren

    Extensie Identiteitsservice installeren

  6. De organisatie-id van de Experience Cloud is automatisch voor u gedetecteerd.

  7. Alle standaardinstellingen behouden en klikken Opslaan in bibliotheek en samenstellen

    De extensie opslaan

NOTE
Elke versie van de uitbreiding van de Dienst van de Identiteit komt met een specifieke versie van VisitorAPI.js die in de uitbreidingsbeschrijving wordt genoteerd. U werkt de versie VisitorAPI.js bij door de uitbreiding van de Dienst van de Identiteit bij te werken.

De extensie valideren

De uitbreiding van de Dienst van de Identiteit is één van de weinige marktextensies die een verzoek indient zonder het moeten een regelactie gebruiken. De extensie zal automatisch een aanvraag indienen bij de Identity Service wanneer de eerste pagina van het eerste bezoek aan een website wordt geladen. Zodra de id is aangevraagd, wordt deze opgeslagen in een cookie van de eerste partij die begint met "AMCV_".

De extensie Identiteitsservice valideren

  1. Open de Luminantiesite

  2. Controleer of Foutopsporing de eigenschap tag toewijst aan uw Ontwikkelomgeving, zoals beschreven in de eerdere les.

  3. Op het tabblad Overzicht van Foutopsporing geeft de sectie Tags aan dat de extensie Adobe Experience Platform Identity Service is geïmplementeerd.

  4. Ook, op het Summiere lusje, zou de sectie van de Dienst van de Identiteit met zelfde identiteitskaart moeten bevolken van Org die op uw scherm van de uitbreidingsconfiguratie in de interface van de Inzameling van Gegevens was:

    Controleren of de extensie Adobe Experience Platform Identity Service is geïmplementeerd

  5. Het aanvankelijke verzoek om identiteitskaart van de Bezoeker terug te winnen zou op het lusje van de Dienst van de Identiteit van Debugger kunnen verschijnen. Misschien is het al gevraagd, dus maak je geen zorgen als je het niet ziet:
    Controleer of er een aanvraag is voor de identiteitsservice met uw organisatie-id

  6. Na de eerste aanvraag om de bezoeker-id op te halen, wordt de id opgeslagen in een cookie waarvan de naam begint met AMCV_. U kunt als volgt bevestigen dat de cookie is ingesteld:

    1. De ontwikkelaarsgereedschappen van uw browser openen

    2. Ga naar de Application tab

    3. Uitbreiden Cookies links

    4. Klik op het domein https://luma.enablementadobe.com

    5. Zoek naar het AMCV_ cookie aan de rechterkant. U ziet mogelijk verschillende keren dat de Luma-site is geladen met zowel de eigenschap hardcoded tag als de eigen eigenschap.

      Controleer het cookie AMCV_

Dat is het! U hebt de eerste extensie toegevoegd! Voor meer informatie over de configuratieopties van de Identiteitsdienst, zie de documentatie.

Klant-id's verzenden

Vervolgens stuurt u een Klant-id aan de identiteitsdienst. Hierdoor kunt u uw CRM integreren met de Experience Cloud en de bezoekers van het spoor over apparaten.

In de vorige les: Gegevenselementen, regels en bibliotheken toevoegen u creeerde een gegevenselement en gebruikte het in een regel. Nu gebruikt u dezelfde technieken om een klant-id te verzenden wanneer de bezoeker is geverifieerd.

Gegevenselementen maken voor de id's van de klant

Begin door twee gegevenselementen te creëren:

  1. Authentication State—om vast te leggen of de bezoeker al dan niet is aangemeld
  2. Email (Hashed)—om de gehashte versie van het e-mailadres (gebruikt als klant ID) van de gegevenslaag te vangen

Het gegevenselement voor de verificatiestatus maken

  1. Klikken Gegevenselementen in de linkernavigatie

  2. Klik op de knop Gegevenselement toevoegen knop

    Klik op Gegevenselement toevoegen

  3. Geef het gegevenselement een naam Authentication State

  4. Voor de Type gegevenselement, selecteert u Aangepaste code

  5. Klik op de knop Editor openen knop

    Open de Editor om de aangepaste code voor het gegevenselement toe te voegen

  6. In de Code bewerken venster, gebruik de volgende code om waarden van "het programma geopend"of "het programma geopend"gebaseerd op een attribuut in de de gegevenslaag van de plaats van de Luma terug te keren:

    code language-javascript
    if (digitalData.user[0].profile[0].attributes.loggedIn)
        return "logged in"
    else
        return "logged out"
    
  7. Klikken Opslaan om de aangepaste code op te slaan

    De aangepaste code opslaan

  8. Alle andere instellingen op de standaardwaarden laten staan

  9. Klikken Opslaan in bibliotheek om het gegevenselement op te slaan en terug te keren naar de pagina met gegevenselementen. We hoeven geen 'Build' te doen voordat we al onze wijzigingen hebben aangebracht en klaar zijn om te valideren.

    Het gegevenselement opslaan

Door de authentificatiestatus van de gebruiker te kennen, weet u wanneer klantenidentiteitskaart op de pagina zou moeten bestaan om naar de Dienst van de Identiteit te verzenden. De volgende stap is een gegevenselement voor klantenidentiteitskaart zelf tot stand te brengen. Op de demo-site Luma gebruikt u de gehashte versie van het e-mailadres van de bezoeker.

Het gegevenselement voor de gehashte-e-mail toevoegen

  1. Klik op de knop Gegevenselement toevoegen knop

    Een gegevenselement toevoegen

  2. Geef het gegevenselement een naam Email (Hashed)

  3. Voor de Type gegevenselement, selecteert u JavaScript-variabele

  4. Als de JavaScript variabelenaam gebruikt u de volgende aanwijzer naar een variabele in de gegevenslaag van de Luministensite: digitalData.user.0.profile.0.attributes.username

  5. Alle andere instellingen op de standaardwaarden laten staan

  6. Klikken Opslaan in bibliotheek om het gegevenselement op te slaan

    Het gegevenselement opslaan

Een regel toevoegen om de klant-id's te verzenden

De Adobe Experience Platform Identity Service geeft de id's van de Klant door in regels met de actie "Customer ID's instellen". U maakt nu een regel om deze handeling te activeren wanneer de bezoeker wordt geverifieerd.

Een regel maken om de klant-id's te verzenden

  1. Klik in de linkernavigatie op Regels

  2. Klikken Regel toevoegen om de Bouwer van de Regel te openen

    Een regel toevoegen

  3. Naam van de regel All Pages - Library Loaded - Authenticated - 10

    note tip
    TIP
    Deze naamgevingsconventie geeft aan dat u deze regel boven aan alle pagina's afvuurt wanneer de gebruiker wordt geverifieerd en de regel de volgorde "10" heeft. Het gebruiken van een noemende overeenkomst als dit-in plaats van het voor de oplossingen te noemen die in actie-wordt teweeggebracht zal u toestaan om het algemene aantal regels te minimaliseren nodig door uw implementatie.
  4. Onder Gebeurtenissen klikken Toevoegen

    Een gebeurtenis toevoegen

    1. Voor de Type gebeurtenis selecteren Bibliotheek geladen (pagina boven)
    2. Breid uit Geavanceerde opties en voor de Volgorde enter 10. De orde controleert de opeenvolging van regels die door de zelfde gebeurtenis worden teweeggebracht. Regels met een lagere volgorde worden vervangen door regels met een hogere volgorde. In dit geval, wilt u klantenidentiteitskaart plaatsen alvorens u het verzoek van het Doel in werking stelt, dat u in de volgende les met een regel met een orde van 50 .
    3. Klik op de knop Wijzigingen behouden knoop om aan de Bouwer van de Regel terug te keren

    De gebeurtenis opslaan

  5. Onder Voorwaarden klikken Toevoegen

    Een voorwaarde aan de regel toevoegen

    1. Voor de Type voorwaarde selecteren Waardevergelijking

    2. Klik op de knop pictogram gegevenselement pictogram om het gegevenselement modaal te openen

      het gegevenselement modaal openen

    3. Klik op de module Gegevenselement op Verificatiestatus en klik vervolgens op Selecteren

      de verificatiestatus instellen

  6. Controleer of Equals is de operator

  7. Typ "aangemeld" in het tekstveld, waardoor de regel wordt geactiveerd wanneer de waarde "Aangemeld" is voor het gegevenselement "Aanmeldingsstatus"

  8. Klikken Wijzigingen behouden

    De voorwaarde opslaan

  9. Onder Handelingen klikken Toevoegen

    Een nieuwe handeling toevoegen

    1. Voor de Extensie selecteren Experience Cloud ID-service

    2. Voor de Type handeling selecteren Klant-id's instellen

    3. Voor de Integratiecode enter crm_id

    4. Voor de Waarde open de selecteur van het Element van Gegevens modaal en selecteer Email (Hashed)

    5. Voor de Deelstaat Auth selecteren Geverifieerd

    6. Klik op de knop Wijzigingen behouden knoop om de actie te bewaren en aan de Bouwer van de Regel terug te keren

      De handeling configureren en de wijzigingen opslaan

  10. Klik op de knop Opslaan in bibliotheek en samenstellen knop om de regel op te slaan

    De regel opslaan

U hebt nu een regel gecreeerd die identiteitskaart van de Klant als variabele zal verzenden crm_id wanneer de bezoeker voor authentiek wordt verklaard. Aangezien u de volgorde hebt opgegeven als 10 deze regel wordt geactiveerd voordat u All Pages - Library Loaded regel die is gemaakt in het dialoogvenster Gegevenselementen, regels en bibliotheken toevoegen les die de standaardwaarde van de Orde van gebruikt 50.

De klant-id's valideren

Als u uw werk wilt valideren, meldt u zich aan bij de Lumasite om het gedrag van de nieuwe regel te bevestigen.

Aanmelden bij de Luministsite

  1. Open de Luminantiesite

  2. Controleer of Foutopsporing de eigenschap tag toewijst aan uw Ontwikkelomgeving, zoals beschreven in de eerdere les

    De ontwikkelomgeving voor tags die wordt weergegeven in Foutopsporing

  3. Klik op de knop AANMELDEN koppeling in de rechterbovenhoek van de Luma-site

    Klik op Aanmelden in de bovenste navigatie

  4. Enter test@adobe.com als de gebruikersnaam

  5. Enter test als wachtwoord

  6. Klik op de knop AANMELDEN knop

    Voer referenties in en klik op Aanmelden

  7. Terug naar de startpagina

Bevestig nu dat de klant-id naar de service wordt verzonden met de extensie Foutopsporing.

Om te controleren of de Identiteitsdienst klantenidentiteitskaart overgaat

  1. Zorg ervoor dat de tab met de Luminasite de focus heeft

  2. Ga in Foutopsporing naar het tabblad Adobe Experience Platform Identity Service

  3. Uw organisatie-id uitbreiden

  4. Klik met de Customer ID - crm_id value

  5. Let in het modaal op de waarde van de klant-id en op het feit dat AUTHENTICATED toestand wordt weerspiegeld:

    Bevestig de klant-id in Foutopsporing

  6. U kunt de gehashte e-mailwaarde bevestigen door de broncode van de pagina Luma weer te geven en de eigenschap username te bekijken. Deze moet overeenkomen met de waarde die u in Foutopsporing ziet:

    gehashte-e-mail in de broncode

Aanvullende tips voor validatie

Tags hebben ook uitgebreide functies voor consoleregistratie. Ga naar de Gereedschappen in Foutopsporing en schakel de optie Logboekregistratie voor tagconsole schakelen.

Logboekregistratie console van tags in-/uitschakelen

Hierdoor wordt het aanmelden van de console ingeschakeld in uw browserconsole en op het tabblad Logs van Foutopsporing. U zou het registreren van alle regels moeten zien u tot nu toe hebt gecreeerd! Merk op dat de nieuwe logboekingangen aan de bovenkant van de lijst worden toegevoegd, zodat zou uw regel "Alle Pagina's - Bibliotheek Geladen - voor authentiek verklaard - 10"vóór de "Alle Pagina's - Bibliotheek Geladen"regel moeten in brand steken en onder het in het Logboek van de Console van Foutopsporing verschijnen:

Tabblad Logs van Foutopsporing

Volgende "Adobe Target toevoegen" >

recommendation-more-help
45774420-d03e-4a6b-94b5-cd639ae825b2