Test van begin tot eind uploaden en implementeren

Als u tagextensies wilt testen in Adobe Experience Platform, gebruikt u de API-tags en/of opdrachtregelprogramma's om de extensiepakketten te uploaden. Vervolgens gebruikt u de interface van het platform of de gebruikersinterface voor gegevensverzameling om uw extensiepakket te installeren in een eigenschap en de mogelijkheden ervan uit te oefenen in een tagbibliotheek en te bouwen.

In dit document wordt beschreven hoe u end-to-end tests voor uw extensie kunt implementeren.

Uw extensie valideren validate

Zodra uw team met de prestaties van uw uitbreiding en de resultaten wordt tevredengesteld die zij in het Sandboxhulpmiddel zien, zou u bereid moeten zijn om uw uitbreidingspakket aan markeringen te uploaden.

Voordat u gaat uploaden, moet u controleren of de vereiste velden of instellingen aanwezig zijn. Bijvoorbeeld, die uw uitbreidingsmanifestherzien, is uw uitbreidingsconfiguratie, uw meningen, en uw bibliotheekmodules(bij een minimum) goede praktijk.

Een specifiek voorbeeld is uw logobestand: voeg een "iconPath": "example.svg", -regel toe aan uw extension.json -bestand en neem dat logoafbeeldingsbestand op in uw project. Dit is het relatieve pad naar het pictogram dat voor de extensie wordt weergegeven. Het mag niet beginnen met een schuine streep. De extensie moet verwijzen naar een SVG-bestand met de extensie .svg . De SVG moet normaal worden weergegeven wanneer deze vierkant wordt gerenderd en kan door de gebruikersinterface worden geschaald. Zie hoe te artikel van SVGvoor meer details schrapen.

Een Adobe I/O-integratie maken integration

Als u de API- of opdrachtregelprogramma's wilt gebruiken, hebt u een technisch account met Adobe I/O nodig. U moet de technische account maken in de I/O-console en vervolgens het gereedschap Uploader gebruiken om het extensiepakket te uploaden.

Voor informatie bij het creëren van een technische rekening voor gebruik met markeringen in Adobe Experience Platform, gelieve te verwijzen naar Reactor API diegids Aan de slag wordt.

Als u geen integratie kunt tot stand brengen, is het waarschijnlijk dat u niet de correcte toestemmingen hebt. Hiervoor is een Org Admin nodig om de stappen voor u te voltooien of om u toe te wijzen als ontwikkelaar.

Upload Uw extensiepakket upload

Nu u geloofsbrieven hebt, bent u bereid om uw uitbreidingspakket van begin tot eind te testen.

Wanneer u het extensiepakket voor het eerst uploadt, wordt de status development weergegeven. Dit betekent dat het alleen zichtbaar is voor uw eigen organisatie en alleen met een eigenschap die is gemarkeerd voor extensieontwikkeling.

Gebruik de opdrachtregel om de volgende opdracht uit te voeren in de map die uw .zip-pakket bevat.

npx @adobe/reactor-uploader

Met npx kunt u een npm-pakket downloaden en uitvoeren zonder dat u het op uw computer hoeft te installeren. Dit is de eenvoudigste manier om de Uploader uit te voeren.

Voor uploader hoeft u slechts enkele gegevens in te voeren. De clientId en clientSecret kunnen worden opgehaald vanaf de Adobe I/O-console. Navigeer aan de pagina van Integratiesin de I/O console. Selecteer de juiste organisatie in het vervolgkeuzemenu, zoek de juiste integratie en selecteer View .

Uw extensiepakket wordt vervolgens geüpload en de uploader geeft u de id van het extension_package.

Als u het uploaden van uw uitbreiding wilt beheren direct gebruikend API, zie de voorbeeldvraag creërendof het bijwerken vaneen uitbreidingspakket in de API documenten voor meer detail.

Een ontwikkeleigenschap maken property

Nadat u zich hebt aangemeld bij de gebruikersinterface en Tags hebt geselecteerd in de navigatie links, wordt het Properties -scherm weergegeven. Een eigenschap is een container voor de tags die u wilt implementeren en kan op een of meerdere sites worden gebruikt.

De eerste keer dat u zich aanmeldt, worden er geen eigenschappen op het scherm weergegeven. Selecteer Nieuw Bezit om te creëren. Voer een naam en een URL in. Gebruik de URL van uw testsite of de pagina waarop u de extensie gaat testen. Dit domeinveld kan door sommige extensies worden gebruikt of door een voorwaarde met de extensie Core.

Om dit bezit voor het testen van de uitbreidingsontwikkeling te gebruiken, moet u ADVANCED OPTIONS uitbreiden en ervoor zorgen om de doos voor te controleren voor uitbreidingsontwikkeling vormt.

Selecteer sparen bij de bodem om uw nieuw bezit te bewaren.

Het scherm Eigenschappen wordt weergegeven. Selecteer de naam van de eigenschap die u zojuist hebt gemaakt. Het scherm van het Overzicht van het Bezit verschijnt. Het voorziet verbindingen met elk gebied van het systeem van de globale navigatiekoppelingen in de kolom op de linkerzijde.

De extensie installeren install-extension

Om uw uitbreiding in dit bezit te installeren, selecteer de verbinding van Uitbreidingen in de belangrijkste navigatiekoppelingen in de linkerkolom. De uitbreiding van de Kern wordt getoond op het Geïnstalleerde scherm. De extensie Core bevat alle functionaliteit voor tagbeheer binnen de gegevensverzameling.

Om uw uitbreiding toe te voegen, selecteer de Catalogus tabel.

In de catalogus worden kaartpictogrammen weergegeven voor elke beschikbare extensie. Als uw extensie niet wordt weergegeven in de catalogus, controleert u of u de bovenstaande stappen hebt uitgevoerd in de secties Stel de beheerconsole van de Adobe in en Creating Your Extension Package. Uw extensiepakket wordt mogelijk ook weergegeven als In behandeling als Platform de eerste verwerking niet heeft voltooid.

Als u de vorige stappen hebt uitgevoerd en nog steeds geen extensiepakket in behandeling of Mislukt ziet in de catalogus, moet u de status van het extensiepakket rechtstreeks controleren met de API. Voor informatie over hoe te om de aangewezen API vraag te maken, lees Vets een ExtensionPackagein de API documentatie.

Nadat uw extensiepakket verwerking heeft gebeëindigd, selecteert u Installeren onder aan de kaart.

Het configuratiescherm wordt geopend (op voorwaarde dat de extensie er een heeft). Voeg om het even welke informatie nodig toe om uw uitbreiding te vormen en te selecteren sparen bij de bodem. In het voorbeeld van het configuratiescherm dat u hier ziet, wordt de Facebook-extensie gebruikt waarvoor een Pixel-id is vereist.

U zou nu het Geïnstalleerde uitbreidingsscherm met de uitbreiding van de Kern en uw uitbreiding moeten zien.

Bronnen maken om uw extensie te testen resources

Extensies bieden nieuwe mogelijkheden voor gebruikers van Adobe Experience Platform. Deze worden typisch getoond in de Elementen van Gegevens of de Bouwer van de Regel.

Gegevenselementen

Het doel van elementen met taggegevens is om gebruikers te helpen bij het behouden van waarden. Elk gegevenselement is een toewijzing of aanwijzer aan brongegevens. Eén gegevenselement is een variabele die kan worden toegewezen aan querytekenreeksen, URL's, cookie-waarden, JavaScript-variabelen, enzovoort. Selecteer Elementen van Gegevens van de linkernavigatiebar, en creeer Nieuw Element van Gegevens.

Extensies kunnen gegevenselementen definiëren als dat nodig is om de extensie te laten werken of eenvoudig als gebruiksvriendelijk voor gebruikers. Wanneer een uitbreiding gegevenselemetypes verstrekt, verschijnen zij in een vervolgkeuzelijst voor gebruikers op het Create scherm van het Element van Gegevens:

Wanneer een gebruiker uw uitbreiding van Uitbreiding dropdown selecteert, wordt het Type van Element van Gegevens dropdown bevolkt met om het even welke die types van gegevenselement door uw uitbreiding worden verstrekt. De gebruiker kan dan elk gegevenselement aan zijn bronwaarde in kaart brengen. De elementen van gegevens kunnen dan worden gebruikt wanneer het bouwen van regels in de Gebeurtenis van de Verandering van het Element van Gegevens of de Gebeurtenis van de Code van de Douane om een uit te voeren regel teweeg te brengen. Een gegevenselement kan ook in de Voorwaarde van het Element van Gegevens of andere Voorwaarden, Uitzonderingen, of Acties in een regel worden gebruikt.

Zodra het gegevenselement wordt gecreeerd (de afbeelding wordt opstelling), kunnen de gebruikers de brongegevens door het gegevenselement eenvoudig van verwijzingen te voorzien van verwijzingen voorzien. Als de bron van de waarde verandert (site wordt opnieuw ontworpen, enz.) gebruikers hoeven de toewijzing slechts eenmaal in UI bij te werken en alle gegevenselementen zullen automatisch de nieuwe bronwaarde ontvangen.

Regels

Selecteer de verbinding van Regels in de linkernavigatie, dan creeer Nieuwe Regel.

Voer eerst een beschrijvende naam in als regel. creeer het scherm van de Regel is opstelling als een if-then verklaring.

Als een gebeurtenis plaatsvindt en de voorwaarden worden doorgegeven en er zijn geen uitzonderingen, wordt de actie geactiveerd. Deze zelfde stroom bestaat in uitbreidingen waar u gebeurtenissen, voorwaarden, uitzonderingen, gegevenselementen, of acties kunt tot stand brengen of hefboomwerking.

Voeg met het Facebook-extensievoorbeeld een gebeurtenis toe telkens wanneer een pagina op de testsite wordt geladen.

Het Window Loaded Type van Gebeurtenis zorgt ervoor dat om het even welke tijd een pagina op de testplaats laadt deze regel zal worden teweeggebracht. Selecteer houd Veranderingen. Voor dit voorbeeld, negeer Voorwaarden aangezien de regel voor om het even welke pagina op de testplaats zou moeten worden teweeggebracht.

Onder ACTIES uitgezocht voeg toe. Het scherm van de Configuratie van de Actie verschijnt.Daarna moet u de uitbreiding kiezen dat de regel moet worden toegepast op, en de actie om voor te komen wanneer de regel wordt teweeggebracht. Selecteer Pixel van Facebook van de 3} dropdown lijst van de Uitbreiding {, en verzend de Mening van de Pagina van het Type van Actie dropdown lijst. Selecteer houden Veranderingen, en dan sparen op het volgende uitgeven het scherm van de Regel.

Selecteer tijdens het testen van de extensie relevante gebeurtenissen, voorwaarden, enzovoort. die door uw extensie worden geleverd, in een willekeurig aantal regels.

Je wijzigingen Publish publish

In de belangrijkste navigatie, uitgezochte het Publiceren, dan op voeg Nieuwe Bibliotheek verbinding toe:

Een bibliotheek is een set instructies voor hoe extensies, gegevenselementen en regels met elkaar en met een website communiceren. Bibliotheken worden gecompileerd in builds. Een bibliotheek kan net zoveel wijzigingen bevatten als een gebruiker op een gemakkelijke manier tegelijk kan maken of testen.

Op creeer Bibliotheek scherm, voeg een naam op het 3} tekstgebied van de Naam {toe. De markeringen verstrekken een standaardontwikkelomgeving genoemd Ontwikkeling. Selecteer Ontwikkeling van de milieu dropdown lijst. Voeg voor het gemak alle beschikbare bronnen toe. Selecteer toevoegen Alle Gewijzigde Middelen, dan uitgezocht sparen.

Nu alle veranderingen in de pas gecreëerde bibliotheek (genoemd dev in het verstrekte voorbeeld) inbegrepen zijn, uitgezocht sparen en bouwt aan Ontwikkeling.

Nadat het bouwstijlproces voltooit, een groene succes indicatorvertoningen naast de bibliotheeknaam.

De tagbibliotheek is nu gepubliceerd en beschikbaar voor gebruik. De testpagina moet de nieuwe bibliotheek gebruiken om het paginagedrag voor de eindgebruiker in een browser te testen.

Tags op een testsite installeren install-data-collection-tags

Installatie-instructies zijn beschikbaar op het tabblad Omgevingen. Op deze pagina worden alle beschikbare omgevingen weergegeven en kunt u meer maken. Aangezien de bibliotheek aan het milieu van de Ontwikkeling werd gepubliceerd selecteer het bakpictogram in de INSTALLEER kolom op de 3} rij van de Ontwikkeling.

Het Web installeert de dialoog van Instructies voor het milieu van de Ontwikkeling verschijnt. Selecteer het kopieerpictogram om de volledige <script> -tag te kopiëren.

Voltooi de installatie door deze enkele <script> -tag in de <head> -sectie van uw document- of sitesjabloon te plaatsen. Ga vervolgens naar de testsite om het gedrag van uw gepubliceerde tagbibliotheek te bekijken.

Testen test

Hieronder volgt een lijst met handige consoleopdrachten voor het valideren van uw extensie op uw testpagina of site.

Het doel van deze test is de functionaliteit van de geïmplementeerde bibliotheek te controleren en ervoor te zorgen dat het extensiepakket zich gedraagt zoals u had verwacht nadat het in een bibliotheek is opgenomen.

Wanneer u veranderingen ontdekt die aan uw uitbreidingspakket moeten worden aangebracht, is het herhalingsproces gelijkaardig aan het ontwikkelingsproces.