Ladda upp och implementera testning från början till slut

Om du vill testa taggtillägg i Adobe Experience Platform använder du tagg-API:t och/eller kommandoradsverktygen för att överföra dina tilläggspaket. Använd sedan användargränssnittet för plattformen eller användargränssnittet för datainsamling för att installera tilläggspaketet i en egenskap och använda funktionerna i ett taggbibliotek och skapa det.

I det här dokumentet beskrivs hur du implementerar kompletta tester för ditt tillägg.

Validera tillägget validate

När ditt team är nöjd med hur tillägget fungerar och vilka resultat de får visas i Sandbox kan du överföra tilläggspaketet till taggar.

Innan du överför filen kontrollerar du att det finns obligatoriska fält eller inställningar. Du kan till exempel granska tilläggsmanifest, tilläggskonfiguration, vyeroch biblioteksmoduler (åtminstone) är god praxis.

Ett specifikt exempel är din logotypfil: Lägg till en "iconPath": "example.svg", linje till extension.json och ta med logotypbilden i projektet. Det här är den relativa sökvägen till ikonen som ska visas för tillägget. Det ska inte börja med ett snedstreck. Den måste referera till en SVG-fil med en .svg tillägg. SVG ska visas normalt när den återges fyrkantig och kan skalas av användargränssnittet. Se Så här skalförändrar du SVG-artikel för mer information.

Skapa integrering med Adobe I/O integration

Om du vill använda API- eller kommandoradsverktygen behöver du ett tekniskt konto hos Adobe I/O. Du måste skapa det tekniska kontot i I/O-konsolen och sedan använda verktyget Överför för att överföra tilläggspaketet.

Mer information om hur du skapar ett tekniskt konto som kan användas med taggar i Adobe Experience Platform finns i Reaktor-API - komma igång guide.

Om du inte kan skapa en integrering har du förmodligen inte rätt behörighet. Detta kräver antingen en organisationsadministratör för att slutföra stegen åt dig eller för att du ska kunna utses till utvecklare.

Överför ditt tilläggspaket upload

Nu när du har inloggningsuppgifter kan du testa tilläggspaketet från början till slut.

När du först överför tilläggspaketet försätts det i development. Det innebär att det bara är synligt för din egen organisation, och bara med en egenskap som har markerats för tilläggsutveckling.

Använd kommandoraden för att köra följande kommando i katalogen som innehåller ditt ZIP-paket.

npx @adobe/reactor-uploader

npx Med kan du hämta och köra ett npm-paket utan att installera det på datorn. Detta är det enklaste sättet att köra Uploader.

I Uploader måste du ange flera uppgifter. Det tekniska konto-ID:t, API-nyckeln och annan information kan hämtas från Adobe I/O-konsolen. Navigera till Integrationssida i I/O-konsolen. Välj rätt organisation i listrutan, hitta rätt integration och välj View.

Tilläggspaketet kommer sedan att överföras och den överförande filen ger dig ID:t för extension_package.

Skapa en utvecklingsegenskap property

När du har loggat in på användargränssnittet och valt Tags i den vänstra navigeringen visas Properties visas. En egenskap är en behållare för de taggar som du vill distribuera och den kan användas på en eller flera platser.

Du kommer inte att se några egenskaper på skärmen första gången du loggar in. Välj Ny egenskap för att skapa en. Ange ett namn och en URL. Använd URL-adressen till testwebbplatsen eller den sida där du testar tillägget. Det här domänfältet kan användas av vissa tillägg eller av ett villkor med Core-tillägget.

Om du vill använda den här egenskapen för tilläggstestning måste du utöka AVANCERAD OPTIONS och se till att kryssrutan Konfigurera för tilläggsutveckling.

Välj Spara längst ned för att spara den nya egenskapen.

Skärmen Egenskaper visas. Välj namnet på den egenskap som du nyss skapade. Skärmen Egenskapsöversikt visas. Den innehåller länkar till varje område i systemet med de globala navigeringslänkarna i kolumnen till vänster.

Installera tillägget install-extension

Om du vill installera tillägget i den här egenskapen väljer du Tillägg i huvudnavigeringslänkarna i den vänstra kolumnen. The Core tillägget visas på Installerad skärm. Tillägget Core innehåller alla tagghanteringsfunktioner i datainsamlingen.

Om du vill lägga till tillägget väljer du Katalog -fliken.

Katalogen visar kortikoner för varje tillgängligt tillägg. Om tillägget inte visas i katalogen kontrollerar du att du har slutfört stegen ovan i Adobe Administration Console Konfigurera och Skapa tilläggspaket. Tilläggspaketet kan också visas som Väntande om plattformen inte har slutfört den inledande bearbetningen.

Om du har följt de föregående stegen och fortfarande inte ser något väntande eller misslyckat tilläggspaket i katalogen, bör du kontrollera status för tilläggspaketet direkt med API:t. Information om hur du gör rätt API-anrop finns i Hämta ett ExtensionPackage i API-dokumentationen.

När tilläggspaketet har bearbetats väljer du Installera längst ned på kortet.

Konfigurationsskärmen öppnas (förutsatt att tillägget har ett). Lägg till information som behövs för att konfigurera tillägget och välj Spara längst ned. I det här exemplet på konfigurationsskärmen används Facebook-tillägget som kräver ett Pixel-ID.

Nu bör du se Installerad skärm med tillägget Core och tillägget.

Skapa resurser för att testa tillägget resources

Tillägg ger nya funktioner för användare av Adobe Experience Platform. Dessa visas vanligtvis i dataelement eller i regelbyggaren.

Dataelement

Syftet med taggdataelement är att hjälpa användarna att behålla värden. Varje dataelement är en mappning eller pekare till källdata. Ett enskilt dataelement är en variabel som kan mappas till frågesträngar, URL:er, cookie-värden, JavaScript-variabler osv. Välj Dataelement från det vänstra navigeringsfältet, och Skapa nytt dataelement.

Tillägg kan definiera dataelementtyper om det behövs för att tillägget ska fungera, eller helt enkelt som en smidighet för användarna. När ett tillägg innehåller dataelementtyper visas de i en listruta för användare på Skapa dataelement skärm:

När en användare väljer ditt tillägg i dialogrutan Tillägg listrutan, Dataelementtyp listrutan fylls i med eventuella dataelementtyper som anges av tillägget. Användaren kan sedan mappa varje dataelement till dess källvärde. Dataelement kan sedan användas när du skapar regler i Ändra dataelement eller Anpassad kodhändelse för att aktivera en regel som ska köras. Ett dataelement kan också användas i Dataelementvillkor eller andra villkor, undantag eller åtgärder i en regel.

När dataelementet har skapats (mappningen har konfigurerats) kan användarna referera till källdata genom att referera till dataelementet. Om värdekällan ändras (webbplatsen ändrar design osv.) -användare behöver bara uppdatera mappningen en gång i användargränssnittet och alla dataelement får automatiskt det nya källvärdet.

Regler

Välj Regler länk i den vänstra navigeringen och sedan Skapa ny regel.

Ange först ett beskrivande namn för regeln. The Skapa regel skärmen konfigureras som if-then -programsats.

Om en händelse inträffar, och villkoren skickas och det inte finns några undantag, utlöses åtgärden. Samma flöde finns i tillägg där du kan skapa eller återanvända händelser, villkor, undantag, dataelement eller åtgärder.

Med hjälp av Facebook-tillägget lägger du till en händelse för varje tillfälle en sida läses in på testwebbplatsen.

The Window Loaded Händelsetyp säkerställer att den här regeln aktiveras varje gång en sida läses in på testwebbplatsen. Välj Behåll ändringar. I det här exemplet ignorerar du Villkor eftersom regeln ska aktiveras för alla sidor på testwebbplatsen.

Under ÅTGÄRDER välj Lägg till. The Åtgärdskonfiguration visas.Sedan måste du välja det tillägg som regeln ska tillämpas på och vilken åtgärd som ska utföras när regeln aktiveras. Välj Facebook Pixel från Tillägg nedrullningsbar lista och Skicka sidvy från Åtgärdstyp listruta. Välj Behåll ändringar och sedan Spara på följande Redigera regel skärm.

När du testar tillägget ska du välja relevanta händelser, villkor osv. tillhandahålls av ditt tillägg enligt ett valfritt antal regler.

Publicera ändringarna publish

I huvudnavigeringen väljer du Publicering, sedan på Lägg till nytt bibliotek länk:

Ett bibliotek är en uppsättning instruktioner för hur tillägg, dataelement och regler ska samverka med varandra och med en webbplats. Biblioteken kompileras till byggen. Ett bibliotek kan innehålla så många ändringar som en användare känner sig bekväm med att göra eller testa samtidigt.

På Skapa bibliotek på skärmen lägger du till ett namn i Namn textfält. Taggar innehåller en standardutvecklingsmiljö med namnet Utveckling. Välj Utveckling från Miljö listruta. Lägg till alla tillgängliga resurser för enkelhetens skull. Välj Lägg till alla ändrade resurser väljer Spara.

Nu när alla ändringar har tagits med i det nyligen skapade biblioteket (namngivna dev i det angivna exemplet) väljer du Spara och bygg till utveckling.

När byggprocessen är klar visas en grön framgång visas bredvid biblioteksnamnet.

Taggbiblioteket är nu publicerat och tillgängligt för användning. Testsidan måste använda det nya biblioteket för att testa sidbeteendet för slutanvändaren i en webbläsare.

Installera taggar på en testplats install-data-collection-tags

Installationsanvisningar finns på fliken Miljöer. På den här sidan visas alla tillgängliga miljöer och du kan även skapa fler. När biblioteket publicerades i utvecklingsmiljön markerar du ruteikonen i INSTALLERA kolumn på Utveckling rad.

The Instruktioner för webbinstallation dialogrutan för utvecklingsmiljön visas. Markera kopieringsikonen om du vill kopiera hela <script> -tagg.

Slutför installationen genom att montera denna <script> -taggen inuti <head> i dokumentet eller webbplatsmallen. Gå sedan till testwebbplatsen för att undersöka hur ditt publicerade taggbibliotek fungerar.

Test test

Nedan följer en lista med användbara konsolkommandon för att validera tillägget på testsidan eller -platsen.

Syftet med den här testningen är att kontrollera funktionaliteten i det distribuerade biblioteket och se till att tilläggspaketet beter sig som förväntat efter att det har registrerats i ett bibliotek.

När du upptäcker ändringar som behöver göras i tilläggspaketet liknar iterationsprocessen utvecklingsprocessen.