Adobe Target toevoegen

In deze les, zullen wij de uitbreiding van Adobe Targetmet een verzoek van de paginading en douaneparameters uitvoeren.

Adobe Targetis de oplossing van Adobe Experience Cloud die alles verstrekt u uw klanten' ervaring moet aanpassen en personaliseren, zodat kunt u opbrengst op uw Web en mobiele plaatsen, apps, sociale media, en andere digitale kanalen maximaliseren.

Leerdoelen

Aan het eind van deze les, zult u kunnen:

Vereisten

Om de lessen in deze sectie te voltooien, moet u de lessen in eerst voltooien vormen markeringenen de Dienst van de Identiteittoevoegen.

Het vooraf verborgen doelfragment toevoegen

Voordat we aan de slag kunnen, moeten we de code voor het insluiten van tags enigszins bijwerken. Wanneer de code-insluitcodes asynchroon worden geladen, is de rendering van de pagina mogelijk voltooid voordat de doelbibliotheek volledig is geladen en de inhoud ervan is omgewisseld. Dit kan leiden tot wat "flikkering"wordt genoemd waar de standaardinhoud kort toont alvorens door de gepersonaliseerde inhoud wordt vervangen die door Doel wordt gespecificeerd. Als u deze flikkering wilt vermijden, raden we u ten zeerste aan een speciaal vooraf verborgen fragment hard te coderen vlak voor de asynchrone insluitcodes van tags.

Dit is al gedaan op de plaats van de Luma, maar laten we verdergaan en dit op de steekproefpagina doen zodat begrijpt u de implementatie. Kopieer de volgende coderegels:

<script>
   //prehiding snippet for Adobe Target with asynchronous tags deployment
   ;(function(win, doc, style, timeout) {
   var STYLE_ID = 'at-body-style';
   function getParent() {
      return doc.getElementsByTagName('head')[0];
   }
   function addStyle(parent, id, def) {
      if (!parent) {
      return;
      }
      var style = doc.createElement('style');
      style.id = id;
      style.innerHTML = def;
      parent.appendChild(style);
   }
   function removeStyle(parent, id) {
      if (!parent) {
      return;
      }
      var style = doc.getElementById(id);
      if (!style) {
      return;
      }
      parent.removeChild(style);
   }
   addStyle(getParent(), STYLE_ID, style);
   setTimeout(function() {
      removeStyle(getParent(), STYLE_ID);
   }, timeout);
   }(window, document, "body {opacity: 0 !important}", 3000));
</script>

Open de voorbeeldpagina en plak deze vlak voor de code die u met de tag insluit, zoals hieronder wordt weergegeven (maak je geen zorgen als de regelnummers verschillend zijn). In deze schermafbeelding is het voorverborgen fragment geminiatuurd:

Laad de voorbeeldpagina opnieuw. De pagina wordt drie seconden verborgen voordat deze wordt weergegeven. Dit gedrag is tijdelijk en zal verdwijnen nadat u Doel hebt opgesteld. Dit gedrag voor het voorverbergen wordt beheerd door twee configuraties helemaal aan het einde van het fragment, die kunnen worden aangepast maar meestal het beste links blijven bij de standaardinstellingen:

Voor meer details en om het niet-geminiatuurde pre-verbergende fragment te verkrijgen, te zien gelieve de uitbreiding van Adobe Target met een asynchrone plaatsing ​.

De doelextensie toevoegen

De Adobe Target-extensie ondersteunt client-side implementaties met behulp van de JavaScript SDK van Target voor het moderne web, at.js. De klanten nog die de oudere bibliotheek van het Doel, mbox.js gebruiken, zouden aan at.js 2.xmoeten bevorderen om markeringen te gebruiken.

De extensie Doel v2 bestaat uit twee hoofdonderdelen:

In deze eerste oefening zullen wij de uitbreiding toevoegen en de configuraties bekijken. In latere oefeningen zullen wij de acties gebruiken.

om de Uitbreiding toe te voegen

Op dit moment doet Target niets, dus is er niets te valideren.

Doel laden en verzoek pagina laden afvuren

Marketers gebruiken Doel om de bezoekerservaring op de pagina te bepalen wanneer ze inhoud testen en als doel instellen. Vanwege deze belangrijke rol in de weergave van de pagina, moet u Doel zo vroeg mogelijk laden om de invloed op de zichtbaarheid van de pagina te minimaliseren. In deze sectie wordt de JavaScript-doelbibliotheek—at.js—geladen en wordt de aanvraag voor het laden van de pagina uitgevoerd (in eerdere versies van at.js wordt deze ''global mbox'' genoemd).

U kunt de All Pages - Library Loaded regel gebruiken u in de les " creeerde voegt de Elementen van Gegevens, Regels en Bibliotheken"toe om Doel uit te voeren omdat het reeds zo vroeg mogelijk op paginaladading wordt teweeggebracht.

om Doel te laden

Als de handeling Load Target is toegevoegd, wordt at.js geladen op de pagina. Er worden echter geen doelverzoeken geactiveerd totdat de handeling Fire Page Load Request wordt toegevoegd.

om het Verzoek van de Lading van de Pagina te vuur te nemen

De aanvraag voor het laden van de pagina valideren

Nu u de extensie Doel v2 hebt toegevoegd en de handelingen Load Target en Fire Page Load Request hebt geactiveerd, moet er een aanvraag voor het laden van de pagina worden ingediend op alle pagina's waar de eigenschap Tag wordt gebruikt.

om de Acties van het Verzoek van de Lading van het Doel van de Lading en van de Pagina van de Vuur te bevestigen

Gefeliciteerd! U hebt Target geïmplementeerd!

Parameters toevoegen

Het overgaan van parameters in het verzoek van het Doel voegt krachtige mogelijkheden aan uw het richten, het testen, en verpersoonlijkingsactiviteiten toe. De tagextensie biedt twee acties om parameters door te geven:

Deze acties kunnen vóór de Load Target actie worden gebruikt en kunnen verschillende parameters op verschillende pagina's plaatsen die op uw regelconfiguraties worden gebaseerd. Gebruik de functie voor het ordenen van regels die u hebt gebruikt bij het instellen van id's van klanten met de identiteitsservice om aanvullende parameters in te stellen voor de gebeurtenis Library Loaded voordat de regel wordt geactiveerd die de aanvraag voor het laden van de pagina afvaagt.

Parameters aanvragen (mbox)

De parameters worden gebruikt om douanegegevens tot Doel over te gaan, die uw verpersoonlijkingsmogelijkheden verrijken. Ze zijn ideaal voor kenmerken die tijdens een bladersessie vaak veranderen, zoals de paginanaam, sjabloon, enzovoort. en niet blijven bestaan.

Voeg het Page Name gegevenselement toe dat wij vroeger in creeerden de Elementen van Gegevens, Regels en van Bibliothekenles als verzoekparameter.

om de verzoekparameter toe te voegen

Aanvraagparameters valideren

Voor het tijd-zijn, zijn de douaneparameters die met at.js 2.x- verzoeken worden overgegaan niet gemakkelijk zichtbaar in Debugger, zodat zullen wij de ontwikkelaarshulpmiddelen van browser gebruiken.

om de pageName verzoekparameter te bevestigen

Profielparameters

Net als bij aanvraagparameters worden profielparameters ook doorgegeven via de aanvraag Doel. Nochtans, worden de profielparameters opgeslagen in het gegevensbestand van het de bezoekersprofiel van het Doel en zullen voor de duur van het profiel van de bezoekerblijven. U kunt ze instellen op de ene pagina van uw site en ze gebruiken in doelactiviteiten op een andere pagina. Hier is een voorbeeld van een automobielwebsite. Wanneer een bezoeker naar een pagina met voertuigen gaat, kunt u een profielparameter "profile.lastViewed=sportscar" doorgeven om de interesse van de bezoeker in dat voertuig te registreren. Wanneer de bezoeker naar andere, niet-voertuigpagina's bladert, kunt u inhoud als doel instellen op basis van het laatst bekeken voertuig. Profielparameters zijn ideaal voor kenmerken die zelden worden gewijzigd of die alleen beschikbaar zijn op bepaalde pagina's

In deze zelfstudie zult u geen profielparameters doorgeven, maar de workflow is bijna gelijk aan wat u zojuist hebt gedaan bij het doorgeven van de parameter pageName . Het enige verschil is dat u parameternamen voor profielen een voorvoegsel profile. moet geven. Zo ziet een profielparameter met de naam "userType" eruit in de handeling Add Params to Page Load Request :

Entiteitsparameters

De parameters van de entiteit zijn speciale parameters die in Recommendations implementatiesom drie belangrijke redenen worden gebruikt:

U hoeft geen entiteitsparameters in deze zelfstudie door te geven, maar de workflow is gelijk aan wat u eerder hebt gedaan toen u de parameter pageName request doorgaf—maar geef de parameter een naam die vooraf is ingesteld op "entiteit". en deze aan het relevante gegevenselement toewijzen. Merk op dat sommige gemeenschappelijke entiteiten gereserveerde namen hebben die moeten worden gebruikt (bijvoorbeeld entiteit.id voor de productsku). Dit is wat het zou kijken als plaatsen entiteitsparameters in de Add Params to Page Load Request actie:

Parameters van klant-id toevoegen

De inzameling van klantenidentiteitskaart met de Dienst van de Identiteit van Adobe Experience Platform maakt het gemakkelijk om de gegevens van CRM in Doel in te voeren gebruikend de eigenschap van de Attributen van de Klantvan Adobe Experience Cloud. Het laat ook dwars-apparatenbezoeker toe diestitching, u toestaat om een verenigbare gebruikerservaring te handhaven aangezien uw klanten tussen hun laptops en hun mobiele apparaten schakelen.

Het is absoluut noodzakelijk om de klant-id in te stellen in de actie Set Customer IDs van de identiteitsservice voordat de aanvraag voor het laden van de pagina wordt geactiveerd. Zorg er daarom voor dat u de volgende mogelijkheden op uw site hebt:

In de vorige les, voeg de Dienst van de Identiteit van Adobe Experience Platformtoe, creeerde u de All Pages - Library Loaded - Authenticated - 10 regel om de "Vastgestelde identiteitskaart van de Klant"actie in brand te steken. Omdat deze regel een Order instelling 10 heeft, worden de id's van de klant ingesteld voordat onze aanvraag voor het laden van de pagina door de All Pages - Library Loaded -regel wordt geactiveerd met de Order instelling 50 . U hebt dus al de collectie van klantid's voor Target geïmplementeerd!

De klant-id valideren

Voor het tijd-zijn, zijn de douaneparameters die met at.js 2.x- verzoeken worden overgegaan niet gemakkelijk zichtbaar in Debugger, zodat zullen wij de ontwikkelaarshulpmiddelen van browser gebruiken.

om identiteitskaart van de Klant te bevestigen

De parameter voor het token van eigenschappen toevoegen

Het bezitstoken is een gereserveerde parameter die met de 1} eigenschap van de Toestemmingen van de Gebruiker van de Onderneming van de Premium van het Doel wordt gebruikt.Het wordt gebruikt om verschillende digitale eigenschappen te bepalen zodat de verschillende leden van een Organisatie van het Experience Cloud verschillende toestemmingen op elk bezit kunnen worden toegewezen. U wilt bijvoorbeeld dat één groep gebruikers doelactiviteiten kan instellen op uw website, maar niet in uw mobiele toepassing.

De eigenschappen van het doel zijn analoog aan etiketeigenschappen en de rapportreeksen van Analytics. Een onderneming met meerdere merken, websites en marketingteams kan voor elke website of mobiele app een andere doeleigenschap, tag-eigenschap en analytische rapportsuite gebruiken. De eigenschappen van markeringen worden onderscheiden door hun insluitcodes, de rapportreeksen van Analytics worden onderscheiden door hun identiteitskaart van de rapportreeks, en de eigenschappen van het Doel worden verschillend door hun bezit symbolische parameter.

Het eigenschapstoken moet worden geïmplementeerd met behulp van een aangepaste code in tags met de functie targetPageParams() . Als u veelvoudige plaatsen met verschillend gebruikend verschillende at_property waarden met één enkel markeringsbezit uitvoert, kon u de at_property waarde via een gegevenselement beheren.

Hier volgt een optionele oefening als u een klant van de Premium van het Doel bent en een bezitstoken in uw bezit van de Zelfstudie zou willen uitvoeren:

Eigenschaptoken valideren

Voor het tijd-zijn, zijn de douaneparameters die met at.js 2.x- verzoeken worden overgegaan niet gemakkelijk zichtbaar in Debugger, zodat zullen wij de ontwikkelaarshulpmiddelen van browser gebruiken.

om de Symbolische parameter van het Bezit te bevestigen

Aangepaste verzoeken toevoegen

Een aanvraag voor een orderbevestiging toevoegen

Het verzoek om bevestiging van de bestelling is een speciaal type verzoek dat wordt gebruikt om ordergegevens naar Target te verzenden. De opneming van drie specifieke verzoekparameters-orderId, orderTotal, en productPurchasedId-is wat een regelmatig verzoek van het Doel in een ordeverzoek omzet. Naast de opbrengsten van de rapportage, doet het verzoek om opdracht ook het volgende:

De beste praktijk is om een verzoek tot bevestiging van de bestelling in alle orderkanalen, zelfs op niet-detailhandelslocaties, te gebruiken. De plaatsen van de loodgeneratie hebben bijvoorbeeld gewoonlijk loodtrechters met een unieke "loodidentiteitskaart"die aan het eind wordt geproduceerd. Deze plaatsen zouden een ordeverzoek moeten uitvoeren, gebruikend een statische waarde (b.v. "1") voor orderTotal.

Klanten die de integratie Analytics for Target (A4T) voor het grootste deel van hun rapportage gebruiken, willen mogelijk ook het orderverzoek implementeren als ze Automated Personalization-activiteiten gebruiken, die geen A4T ondersteunen. Bovendien is het orderverzoek een essentieel element in Recommendations-implementaties, waarbij algoritmen op basis van aankoopgedrag worden ingeschakeld. Voor de recentste informatie over steun A4T, te zien gelieve de documentatie.

Het verzoek om bevestiging van de bestelling moet worden uitgevoerd vanuit een regel die alleen wordt geactiveerd op de pagina of gebeurtenis waarin uw bestelling wordt bevestigd. Vaak kan dit worden gecombineerd met een regel die de Adobe Analytics-aankoopgebeurtenis instelt. Het moet worden gevormd gebruikend de actie van de Code van de Douane van de uitbreiding van de Kern, gebruikend de aangewezen gegevenselementen om ordeId, orderTotal, en productPurchasedId parameters te plaatsen.

Voeg de gegevenselementen en regel toe die we nodig hebben om een aanvraag voor bevestiging van de bestelling in te dienen op de Luma-site. Aangezien u reeds verscheidene gegevenselementen hebt gecreeerd, zullen deze instructies worden afgekort.

om het gegevenselement voor identiteitskaart van de Orde te creëren

om het gegevenselement voor het Mate van de Kar te creëren

om het gegevenselement voor Kart SKUs (Doel) te creëren

Nu moeten wij een regel tot stand brengen om het verzoek van de ordesbevestiging met deze gegevenselementen als parameters op de pagina van de ordesbevestiging in brand te steken.

om de regel voor de bevestigingspagina van de Orde te creëren

Valideer het verzoek om bevestiging van bestelling

Voor het tijd-zijn, zijn de douaneparameters die met at.js 2.x- verzoeken worden overgegaan niet gemakkelijk zichtbaar in Debugger, zodat zullen wij de ontwikkelaarshulpmiddelen van browser gebruiken.

Aangepaste aanvragen

Er zijn zeldzame gevallen waarin u een ander doelverzoek moet indienen dan het verzoek om pagina te laden en de bestelling te bevestigen. Soms worden bijvoorbeeld belangrijke gegevens die u voor personalisatie wilt gebruiken, niet op de pagina gedefinieerd vóór de insluitcodes van de tag. Deze kunnen onderaan op de pagina worden gecodeerd of worden geretourneerd door een asynchrone API-aanvraag. Deze gegevens kunnen naar Target worden verzonden met behulp van een extra aanvraag, maar het is niet optimaal om deze aanvraag voor de levering van inhoud te gebruiken omdat de pagina al zichtbaar is. Deze gegevens kunnen worden gebruikt om het bezoekersprofiel te verrijken voor later gebruik (met behulp van profielparameters) of om de Recommendations-catalogus te vullen.

In deze omstandigheden, gebruik de actie van de Code van de Douane in de uitbreiding van de Kern om een verzoek in werking te stellen gebruikend getOffer ()applyOffer ()en trackEvent ()methodes. Dit is zeer gelijkaardig aan wat u enkel in het verzoek van de Bevestiging van de Ordeoefening deed, maar u zult enkel een verschillende verzoeknaam gebruiken en zult niet de speciale orde parameters gebruiken. Gebruik de handeling Load Target voordat u Target-aanvragen uitvoert vanuit aangepaste code.

Bibliotheekkoptekst en Bibliotheekvoettekst

Het scherm Edit at.js in het Doel gebruikersinterface heeft plaatsen waarin u douane JavaScript kunt kleven die onmiddellijk voor of na het at.js- dossier zal uitvoeren. De bibliotheekkoptekst wordt soms gebruikt om de instellingen van at.js te overschrijven via het dialoogvenster
targetGlobalSettings ()functie of pas gegevens van derden over gebruikend de 3} eigenschap van de Leveranciers van Gegevens {.De Voettekst van de Bibliotheek wordt soms gebruikt om at.js de luisteraars van de douanegebeurtenistoe te voegen.

Als u deze mogelijkheid in tags wilt repliceren, gebruikt u gewoon de handeling Aangepaste code in de Core-extensie en voert u de handeling voor (bibliotheekkoptekst) of na (Bibliotheekvoettekst) de handeling Doel laden uit. Dit kan worden gedaan in dezelfde regel als de Load Target -actie (zoals hieronder wordt afgebeeld) of in afzonderlijke regels met gebeurtenissen of orderinstellingen die op betrouwbare wijze worden geactiveerd voor of na de regel die Load Target bevat:

Zie de volgende bronnen voor meer informatie over de gebruiksgevallen voor aangepaste kop- en voetteksten:

Volgende "Adobe Analytics toevoegen" >