Adobe Target toevoegen

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

Adobe richt zich op de Adobe Experience Cloud-oplossing die alles biedt wat u nodig hebt om de ervaring van uw klanten op maat te maken en aan te passen, zodat u uw omzet kunt maximaliseren op uw website en mobiele sites, apps, sociale media en andere digitale kanalen.

OPMERKING

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:

  • platform launch (clientzijde) is nu tags
  • platform launch Server-zijde is nu event forwarding
  • Randconfiguraties zijn nu datastreams

Leerdoelen

Aan het eind van deze les, zult u kunnen:

  • Voeg het vooraf verborgen fragment toe dat wordt gebruikt voor het beheren van flikkering wanneer u Doel gebruikt met asynchrone tags insluiten-codes
  • De extensie Doel v2 toevoegen
  • Vuur de aanvraag voor het laden van de pagina aan (voorheen "global mbox" genoemd)
  • Parameters toevoegen aan de aanvraag voor het laden van de pagina
  • Beschrijf hoe profiel- en entiteitsparameters kunnen worden toegevoegd aan het verzoek om pagina te laden
  • Geef de vereiste parameters op voor het bevestigen van de bestelling
  • Uitleggen hoe u geavanceerde configuraties, zoals Bibliotheekkoptekst en Bibliotheekvoettekst, kunt toevoegen
  • Een doelimplementatie valideren

Vereisten

Om de lessen in deze sectie te voltooien, moet u de lessen in Configure markeringen en Add de Dienst van de Identiteit eerst voltooien.

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(g,b,d,f){(function(a,c,d){if(a){var e=b.createElement("style");e.id=c;e.innerHTML=d;a.appendChild(e)}})(b.getElementsByTagName("head")[0],"at-body-style",d);setTimeout(function(){var a=b.getElementsByTagName("head")[0];if(a){var c=b.getElementById("at-body-style");c&&a.removeChild(c)}},f)})(window,document,"body {opacity: 0 !important}",3E3);
</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):

Houd de extensie boven

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:

  • body {opacity: 0 !important} geeft de css-definitie aan die moet worden gebruikt voor het vooraf verbergen totdat Doel wordt geladen. Standaard wordt het gehele lichaam verborgen. Als u een verenigbare DOM structuur met een gemakkelijk identificeerbaar containerelement hebt dat alle inhoud onder uw navigatie verpakt, bijvoorbeeld, en u nooit uw navigatie wilde testen of personaliseren, kon u dit plaatsen gebruiken om het pre-verbergen tot dat containerelement te beperken.
  • 3E3 Hiermee wordt de time-out-instelling voor het voorverbergen opgegeven. Als Doel niet in drie seconden is geladen, wordt de pagina standaard weergegeven. Dit zou zeer zeldzaam moeten zijn.

Zie de Adobe Target-extensie met een asynchrone implementatie ​ voor meer informatie en voor het verkrijgen van het niet-geminiateerde voorverborgen fragment.

De doelextensie toevoegen

De Adobe Target-extensie ondersteunt client-side implementaties met de JavaScript SDK van Target voor het moderne web, at.js. Klanten die nog gebruikmaken van de oudere bibliotheek van Target, mbox.js, dienen te upgraden naar at.js 2.x om tags te kunnen gebruiken.

De extensie Doel v2 bestaat uit twee hoofdonderdelen:

  1. De extensieconfiguratie die de kernbibliotheekinstellingen beheert
  2. Handelingen van de regel om het volgende te doen:
    1. Doel laden (at.js 2.x)
    2. Params toevoegen aan verzoeken om pagina te laden
    3. Params toevoegen aan alle aanvragen
    4. Aanvraag voor laden van brandbluspagina

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

De extensie toevoegen

  1. Ga naar Extensies > Catalogus

  2. Typ target in het filter om snel de Adobe Target-extensies te zoeken. Er zijn twee extensies: Adobe Target en Adobe Target v2. In deze zelfstudie wordt de v2-versie van de extensie gebruikt die de nieuwste versie van at.js (momenteel 2.x) gebruikt. Deze versie is ideaal voor traditionele websites en toepassingen van één pagina (SPA).

  3. Klik Installeren

    De extensie Doel v2 installeren

  4. Wanneer u de extensie toevoegt, worden veel, maar niet alle at.js-instellingen uit de doelinterface geïmporteerd, zoals hieronder wordt weergegeven. Eén instelling die niet wordt geïmporteerd, is de Time-out, die altijd 3000 ms zal duren nadat de extensie is toegevoegd. Laat de standaardinstellingen voor de zelfstudie ongewijzigd. Opmerking: aan de linkerkant ziet u de versie at.js die wordt meegeleverd bij de huidige versie van de extensie.

  5. Klik Opslaan in bibliotheek

    De extensie opslaan

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

OPMERKING

Elke versie van de extensie Doel wordt geleverd met een specifieke versie van at.js. Deze versie wordt vermeld in de extensiebeschrijving. U werkt de versie at.js bij door de uitbreiding van het Doel bij te werken.

Doel laden en aanvraag voor laden van pagina 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 geladen—at.js—en wordt de aanvraag voor het laden van de pagina uitgevoerd (in eerdere versies van at.js wordt deze ''globale box'' genoemd).

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

Doel laden

  1. Ga naar Regels in de linkernavigatie en klik dan op All Pages - Library Loaded om de regelredacteur te openen

    Alle pagina's openen - regel geladen door bibliotheek

  2. Klik onder Acties op Klik op het plusteken om een nieuwe handeling toe te voegen

    Klik op het plusteken om een nieuwe handeling toe te voegen

  3. Selecteer Extensie > Adobe Target v2

  4. Selecteer Type handeling > Doel laden

  5. Klik Wijzigingen behouden

    Klik op Wijzigingen behouden

Als de handeling Load Target is toegevoegd, wordt at.js op de pagina geladen. Nochtans, zullen geen verzoeken van het Doel in brand steken tot wij Fire Page Load Request actie toevoegen.

Aanvraag voor laden van pagina afvuren

  1. Klik onder Handelingen nogmaals op Klik op het plusteken om een andere handeling toe te voegen

    Klik op het plusteken om een andere handeling toe te voegen

  2. Selecteer Extensie > Adobe Target v2

  3. Selecteer Actietype > Aanvraag voor laden van brandbluspagina

  4. Er zijn enkele configuraties beschikbaar voor de aanvraag voor het laden van de pagina die betrekking hebben op het al dan niet verbergen van de pagina en de CSS-kiezer voor het vooraf verbergen. Deze instellingen werken in combinatie met het vooraf verborgen fragment dat op de pagina is gecodeerd. Laat de standaardinstellingen staan.

  5. Klik Wijzigingen behouden

    Aanvraag voor laden van brandbluspagina

  6. De nieuwe actie wordt toegevoegd opeenvolgend na de Load Target actie en de acties zullen in deze orde uitvoeren. U kunt de acties slepen en neerzetten om de volgorde te wijzigen, maar in dit scenario moet Load Target vóór Fire Page Load Request zijn.

  7. Klik Opslaan in bibliotheek en bouwen

    Opslaan en samenstellen

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 zijn die wordt uitgevoerd op alle pagina's waar uw eigenschap tag wordt gebruikt.

De handelingen voor de aanvraag voor het laden van doel- en branddoelpagina valideren

  1. Laad de voorbeeldpagina opnieuw. Er wordt niet langer een vertraging van drie seconden weergegeven voordat de pagina zichtbaar is. Als u de voorbeeldpagina laadt met behulp van het file://-protocol, moet u deze stap uitvoeren in Firefox- of Safari-browsers, aangezien Chrome geen verzoek voor Doel uitvoert bij gebruik van het file://-protocol.

  2. Open de Luminatiesite

  3. Zorg ervoor Debugger het markeringsbezit aan uw ontwikkelomgeving in kaart brengt, zoals die in vroegere les wordt beschreven

    De ontwikkelomgeving voor tags die wordt weergegeven in Foutopsporing

  4. Ga naar het tabblad Overzicht van Foutopsporing

  5. Bevestig in de sectie Launch dat Target onder de kop Extensions wordt weergegeven

  6. Bevestig in de sectie Target dat de bibliotheekversie van at.js wordt weergegeven

    Bevestig dat Doel in het Summiere lusje van Debugger verschijnt

  7. Tot slot ga naar het Target lusje, breid uw cliëntcode uit, en bevestig uw verzoek van het paginading verschijnt:

    Bevestig dat het verzoek Pagina laden is gedaan

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:

  1. Add Params to Page Load Request, die parameters toevoegt aan verzoeken om pagina te laden (gelijk aan de targetPageParams()- methode)

  2. Add Params to All Requests, die parameters toevoegt in alle aanvragen van het Doel, bijvoorbeeld de aanvraag voor het laden van de pagina plus extra verzoeken die zijn gedaan uit acties van de Code van de Douane of die op uw plaats worden gehard (gelijkwaardig aan targetPageParamsAll() methode)

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 regelbestelfunctie die u hebt gebruikt bij het instellen van de id's van de klant met de identiteitsservice om aanvullende parameters in te stellen voor de gebeurtenis Library Loaded voordat de regel die de aanvraag voor het laden van de pagina afvaagt.

TIP

Aangezien de meeste implementaties de aanvraag voor het laden van de pagina gebruiken voor levering van activiteit, volstaat het gewoonlijk om alleen de actie Add Params to Page Load Requests te gebruiken.

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 Page Name gegevenselement toe dat wij vroeger in Gegevenselementen, Regels en Bibliotheken hebben gecreeerd als verzoekparameter.

De parameter request toevoegen

  1. Ga naar Regels in de linkernavigatie en klik dan op All Pages - Library Loaded om de regelredacteur te openen.

    Alle pagina's openen - regel geladen door bibliotheek

  2. Klik onder Acties op Klik op het plusteken om een nieuwe handeling toe te voegen

    Klik op het plusteken om een nieuwe handeling toe te voegen

  3. Selecteer Extensie > Adobe Target v2

  4. Selecteer Type handeling > Params toevoegen aan verzoek om pagina laden

  5. pageName invoeren als Naam

  6. Klik op het pictogram gegevenselement om het gegevenselement modaal te openen

  7. Klik op het gegevenselement Page Name

  8. Klik op de knop Selecteren

    Klik op de knop Selecteren

  9. Klik Wijzigingen behouden

    Klik op Wijzigingen behouden

  10. Klik en sleep op de linkerrand van de handeling Add Params to Page Load Request om de handelingen die vóór de handeling Fire Page Load Request staan opnieuw te rangschikken (dit kan voor of na Load Target zijn)

  11. Klik Opslaan in bibliotheek en bouwen

    Klik op Opslaan in bibliotheek en Samenstellen

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.

De aanvraagparameter pageName valideren

  1. Laad de Luma-site opnieuw, zorg dat deze is toegewezen aan uw eigen tag-eigenschap
  2. De ontwikkelaarsgereedschappen van uw browser openen
  3. Klik op het tabblad Netwerk
  4. Filter de verzoeken aan tt.omtrdc (of uw domein CNAME'd voor de verzoeken van het Doel)
  5. Vouw de sectie Headers > Request Payload > execute.pageLoad.parameters uit om de parameter en waarde pageName te valideren

pageName parameter in debugger

Profielparameters

Net als bij aanvraagparameters worden profielparameters ook doorgegeven via de aanvraag Doel. Profielparameters worden echter opgeslagen in de bezoekersprofieldatabase van Target en blijven geldig gedurende de duur van het profiel van de bezoeker. 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

U zult geen profielparameters in dit leerprogramma overgaan, maar het werkschema is bijna identiek aan wat u enkel toen het overgaan van de pageName parameter deed. Het enige verschil is dat u parameternamen voor profielen een voorvoegsel profile. moet geven. Dit is wat een profielparameter genoemd "userType"in de Add Params to Page Load Request actie zou kijken:

Een profielparameter instellen

Entiteitsparameters

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

  1. Als sleutel om productaanbevelingen teweeg te brengen. Als u bijvoorbeeld een aanbevolen algoritme gebruikt, zoals "Mensen die Product X bekeken, ook Y bekeken,", is "X" de "sleutel" van de aanbeveling. Meestal is het de productsku (entity.id) of categorie (entity.categoryId) die de bezoeker momenteel bekijkt.
  2. Om het gedrag van de bezoeker aan machtsaanbevelingen algoritmen, zoals "Onlangs Bekeken Producten"of "Meest Bekeken Producten te verzamelen
  3. De Recommendations-catalogus vullen. Recommendations bevat een database van alle producten of artikelen op uw website, zodat deze in de aanbevolen aanbieding kunnen worden gebruikt. Wanneer u bijvoorbeeld producten aanbeveelt, wilt u doorgaans kenmerken weergeven zoals de productnaam (entity.name) en de afbeelding (entity.thumbnailUrl). Sommige klanten vullen hun catalogus in met back-endfeeds, maar ze kunnen ook worden gevuld met eenheidsparameters in Target-aanvragen.

U hoeft geen profielparameters in deze zelfstudie door te geven, maar de workflow is identiek aan wat u eerder hebt gedaan toen u de aanvraagparameter pageName doorgeeft, maar geeft de parameter gewoon 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 entiteitparameters in de Add Params to Page Load Request actie te plaatsen:

Entiteitsparameters toevoegen

Parameters van klant-id toevoegen

Door de verzameling van klantgegevens bij de Adobe Experience Platform Identity Service kunt u eenvoudig CRM-gegevens naar Target importeren met de functie Klantkenmerken van de Adobe Experience Cloud. Het biedt ook ondersteuning voor bezoekers die op meerdere apparaten aansluiten, zodat u een consistente gebruikerservaring kunt behouden wanneer uw klanten schakelen tussen hun laptops en hun mobiele apparaten.

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:

  • De klant-id moet beschikbaar zijn op de pagina voordat de tags Code insluiten
  • De extensie Adobe Experience Platform Identity Service moet zijn geïnstalleerd
  • U moet de handeling Set Customer IDs gebruiken in een regel die bij de gebeurtenis "Bibliotheek geladen (Pagina boven)" wordt geactiveerd
  • Gebruik de handeling Fire Page Load Request in een regel die after de handeling "Klantid's instellen" in werking stelt

In de vorige les, Voeg de Dienst van de Identiteit van Adobe Experience Platform toe, creeerde u All Pages - Library Loaded - Authenticated - 10 regel om de "Vastgestelde actie van identiteitskaart van de Klant"in werking te stellen. Omdat deze regel een Order-instelling van 10 heeft, worden de id's van de klant ingesteld voordat onze aanvraag voor het laden van de pagina wordt geactiveerd door de All Pages - Library Loaded-regel met de Order-instelling van 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.

De klant-id valideren

  1. Open de Luminatiesite

  2. Zorg ervoor Debugger het markeringsbezit aan uw ontwikkelomgeving in kaart brengt, zoals die in vroegere les wordt beschreven

    De ontwikkelomgeving voor tags die wordt weergegeven in Foutopsporing

  3. Meld u aan bij de Luministsite met de referenties test@adobe.com/test

  4. Terugkeren naar de Luminantiepagina

  5. De ontwikkelaarsgereedschappen van uw browser openen

  6. Klik op het tabblad Netwerk

  7. Filter de verzoeken aan tt.omtrdc (of uw domein CNAME'd voor de verzoeken van het Doel)

  8. Vouw de sectie Headers > Request Payload > id.customerIds.0 uit om de instellingen en waarde voor de id van de klant te valideren:

de montages van identiteitskaart van de klant in debugger

WAARSCHUWING

Met de Adobe Experience Platform Identity Service kunt u meerdere id's naar de Service verzenden. Alleen de eerste id wordt echter naar Target verzonden.

De parameter Eigenschaptoken toevoegen

OPMERKING

Dit is een optionele exercitie voor Target Premium-klanten.

Het bezitstoken is een gereserveerde parameter die met de Premium de eigenschap van de Gebruiker van de Onderneming wordt gebruikt. Het wordt gebruikt om verschillende digitale eigenschappen te bepalen zodat de verschillende leden van een Organisatie van de 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 bezitstoken moet worden uitgevoerd gebruikend een actie van de douanecode in markeringen 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:

  1. Open de gebruikersinterface Doel op een apart tabblad

  2. Ga naar Beheer > Eigenschappen

  3. Identificeer het bezit dat u wilt gebruiken en </> (of creeer een nieuwe bezit) klikken

  4. Kopieer het codefragment in het <script></script> naar het klembord

    Haal het token Property op via de Adobe Target-interface

  5. Ga op het tabblad Codes naar Regels in de linkernavigatie en klik op All Pages - Library Loaded om de regeleditor te openen.

    Alle pagina's openen - regel geladen door bibliotheek

  6. Klik onder Handelingen op de handeling Core - Custom Code om Action Configuration te openen

    Open de handeling Params toevoegen aan verzoek om pagina laden

  7. Open de code-editor en plak de code in de interface Doel met de functie targetPageParams()

  8. Klik op de knop Opslaan

    Open de handeling Params toevoegen aan verzoek om pagina laden

  9. Schakel het selectievakje Globaal uitvoeren in zodat targetPageParams() is gedeclareerd in het algemene bereik

  10. Klik Wijzigingen behouden

    Klik op Wijzigingen behouden

  11. Klik Opslaan in bibliotheek en bouwen

    Klik op Opslaan en bouwen naar bibliotheek

WAARSCHUWING

Als u probeert om de at_property parameter via Add Params aan de actie van het Laden van de Pagina toe te voegen, zal de parameter in het netwerkverzoek bevolken maar de Visuele Composer van de Ervaring van het Doel (VEC) zal niet het automatisch kunnen ontdekken wanneer het laden van de pagina. at_property altijd vullen met de functie targetPageParams() in een handeling van de Code van de Douane.

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.

De parameter Eigenschaptoken valideren

  1. Open de Luminatiesite

  2. Zorg ervoor Debugger het markeringsbezit aan uw ontwikkelomgeving in kaart brengt, zoals die in vroegere les wordt beschreven

    De ontwikkelomgeving voor tags die wordt weergegeven in Foutopsporing

  3. De ontwikkelaarsgereedschappen van uw browser openen

  4. Klik op het tabblad Netwerk

  5. Filter de verzoeken aan tt.omtrdc (of uw domein CNAME'd voor de verzoeken van het Doel)

  6. Vouw de sectie Headers > Request Payload > property.token uit om de waarde te valideren
    De token voor eigenschap moet zichtbaar zijn als de parameter at_property in elke aanvraag

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:

  1. De-dupliceert toevallige orde opnieuw indient
  2. Filtert extreme orders (elke volgorde waarvan het totaal meer dan drie standaardafwijkingen van het gemiddelde was)
  3. Gebruikt een ander algoritme achter de schermen om het statistische vertrouwen te berekenen
  4. Hiermee maakt u een speciaal, downloadbaar auditrapport van afzonderlijke bestelgegevens

De beste praktijk is het gebruik en bestellen van een bevestigingsverzoek in alle orderkanalen, zelfs op niet-detailhandelslocaties. 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, moeten het orderverzoek ook implementeren, aangezien A4T nog niet compatibel is met activiteitstypen zoals Automatisch toewijzen, Automated Personalization en AutoTarget. Bovendien is het orderverzoek een essentieel element in Recommendations-implementaties, waarbij algoritmen op basis van aankoopgedrag worden ingeschakeld.

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. Het kan vaak 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.

Het gegevenselement voor Order-id maken

  1. Klik Gegevenselementen in de linkernavigatie
  2. Klik Gegevenselement toevoegen
  3. Naam van het gegevenselement Order Id
  4. Selecteer Gegevenselelementtype > JavaScript-variabele
  5. digitalData.cart.orderId gebruiken als JavaScript variable name
  6. Schakel de optie Clean text in
  7. Klik Opslaan in bibliotheek
    (We bouwen de bibliotheek pas als we alle wijzigingen voor het verzoek om bevestiging van de bestelling hebben aangebracht)

Het gegevenselement voor de starthoeveelheid maken

  1. Klik Gegevenselement toevoegen
  2. Naam van het gegevenselement Cart Amount
  3. Selecteer Gegevenselelementtype > JavaScript-variabele
  4. digitalData.cart.cartAmount gebruiken als JavaScript variable name
  5. Schakel de optie Clean text in
  6. Klik Opslaan in bibliotheek

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

  1. Klik Gegevenselement toevoegen

  2. Naam van het gegevenselement Cart SKUs (Target)

  3. Selecteer Gegevenselelementtype > Aangepaste code

  4. Voor Doel moet de skus een door komma's gescheiden lijst zijn. Met deze aangepaste code wordt de indeling van de array met gegevenslagen gewijzigd in de juiste indeling. Plak het volgende in de aangepaste code-editor:

    var targetProdSkus="";
    for (var i=0; i<digitalData.cart.cartEntries.length; i++) {
      if(i>0) {
        targetProdSkus = targetProdSkus + ",";
      }
      targetProdSkus = targetProdSkus + digitalData.cart.cartEntries[i].sku;
    }
    return targetProdSkus;
    
  5. Schakel de optie Force lowercase value in

  6. Schakel de optie Clean text in

  7. Klik Opslaan in bibliotheek

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.

De pagina Regel voor bevestiging van bestelling maken

  1. Klik Regels in de linkernavigatie
  2. Klik Regel toevoegen
  3. Naam van de regel Order Confirmation Page - Library Loaded - 60
  4. Klik Gebeurtenissen > Toevoegen
    1. Selecteer Gebeurtenistype > Geladen bibliotheek (boven pagina)
    2. Onder Geavanceerde opties, verander Order in 60 zodat het na de Load Target actie (die in onze All Pages - Library Loaded regel is waar Order aan 50 wordt geplaatst) zal in brand steken
    3. Klik Wijzigingen behouden
  5. Klik Voorwaarden > Toevoegen
    1. Selecteer Conditietype > Pad zonder query-tekenreeks

    2. Typ thank-you.html voor Path equals

    3. Schakel de optie Regex in of uit om de logica te wijzigen van equals in contains (u kunt de functie Test gebruiken om te bevestigen dat de test wordt doorstaan met de URL https://luma.enablementadobe.com/content/luma/us/en/user/checkout/order/thank-you.html

      dummywaarden invoeren voor voornaam en achternaam

    4. Klik Wijzigingen behouden

  6. Klik op Handelingen > Toevoegen
    1. Selecteer Type handeling > Aangepaste code

    2. Klik Editor openen

    3. Plak de volgende code in het modaal Edit Code

      adobe.target.getOffer({
        "mbox": "orderConfirmPage",
        "params":{
           "orderId": _satellite.getVar('Order Id'),
           "orderTotal": _satellite.getVar('Cart Amount'),
          "productPurchasedId": _satellite.getVar('Cart SKUs (Target)')
        },
        "success": function(offer) {
          adobe.target.applyOffer({
            "mbox": "orderConfirmPage",
            "offer": offer
          });
        },
        "error": function(status, error) {
          console.log('Error', status, error);
        }
      });
      
    4. Klik Opslaan om de aangepaste code op te slaan

    5. Klik Wijzigingen behouden om de handeling te behouden

  7. Klik Opslaan in bibliotheek en bouwen

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.

  1. Open de Luminatiesite

  2. Zorg ervoor Debugger het markeringsbezit aan uw ontwikkelomgeving in kaart brengt, zoals die in vroegere les wordt beschreven

    De ontwikkelomgeving voor tags die wordt weergegeven in Foutopsporing

  3. Blader door de site en voeg meerdere producten toe aan uw winkelwagentje

  4. Doorgaan met uitchecken

  5. Tijdens het uitcheckproces zijn de enige vereiste velden First Name en Last Name

    dummywaarden invoeren voor voornaam en achternaam

  6. Klik op de pagina Revisievolgorde op de knop Place Order

  7. De ontwikkelaarsgereedschappen van uw browser openen

  8. Klik op het tabblad Netwerk

  9. Filter de verzoeken aan tt.omtrdc (of uw domein CNAME'd voor de verzoeken van het Doel)

  10. Klik op de tweede aanvraag

  11. Vouw de sectie Headers > Request Payload > execute.mboxes.0 uit om de aanvraagnaam en de orderparameters te valideren:

aanvraaginstellingen bestellen in foutopsporing

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 nog steeds 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. Hiermee kunt u het bezoekersprofiel verrijken voor later gebruik (met behulp van profielparameters) of de Recommendations-catalogus vullen.

In deze omstandigheden gebruikt u de handeling Aangepaste code in de Core-extensie om een aanvraag uit te voeren met de methoden getOffer()/applyOffer() en trackEvent(). Dit is zeer gelijkaardig aan wat u enkel in de oefening van de Bevestiging van de Orde deed, maar u zult enkel een verschillende verzoeknaam gebruiken en zult niet de speciale orde parameters gebruiken. Zorg ervoor dat u de handeling Doel laden gebruikt voordat u doelverzoeken indient vanuit aangepaste code.

Bibliotheekkoptekst en Bibliotheekvoettekst

Het scherm Edit at.js in de gebruikersinterface van het Doel 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 geef gegevens door van derden met behulp van de functie Data Providers. De bibliotheekvoettekst wordt soms gebruikt om aangepaste gebeurtenislisteners at.js toe 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 in de zelfde regel zoals Load Target actie (zoals hieronder afgebeeld) of in afzonderlijke regels met gebeurtenissen of ordemontages worden gedaan die vóór of na de regel betrouwbaar zullen vuren die Load Target bevat:

Bibliotheekkop en -voettekst in de reeks Handelingen

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

Volgende "Adobe Analytics toevoegen" >

Op deze pagina