DokumentationTarget Developer Guide

Hur at.js fungerar

Last update: Sat Jul 20 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Ämnen:

Skapat för:

  • Utvecklare

Om du vill implementera Adobe Target på klientsidan måste du använda JavaScript-biblioteket at.js.

I en implementering på klientsidan av Adobe Target levererar Target upplevelserna som är kopplade till en aktivitet direkt till klientwebbläsaren. Webbläsaren avgör vilken upplevelse som ska visas och visar den. Med en implementering på klientsidan kan du använda en WYSIWYG-redigerare, Visual Experience Composer (VEC) eller ett icke-visuellt gränssnitt, formulärbaserad Experience Composer, för att skapa test- och personaliseringsupplevelser.

Vad är at.js?

At.js-biblioteket är implementeringsbiblioteket för implementering på klientsidan av Adobe Target. at.js-biblioteket ger bättre sidladdningstider för webbimplementeringar och ger bättre implementeringsalternativ för enkelsidiga program. at.js är det rekommenderade implementeringsbiblioteket och uppdateras ofta med nya funktioner. Vi rekommenderar att alla kunder implementerar eller migrerar till den senaste versionen av at.js.

Mer information finns i Målbibliotek för JavaScript.

I implementeringen av Targetsom visas nedan implementeras följande Adobe Experience Cloud-lösningar: Analytics, Target och Audience Manager. Dessutom implementeras följande Experience Cloud-bastjänster: Adobe Experience Platform, Audiences och Visitor ID Service.

Vad är skillnaden mellan at.js 1?x och at.js 2.x arbetsflödesdiagram?

Mer information om skillnaderna som introducerades i 2.O från 1 finns i Uppgradera från at.js 1.x till at.js 2.x.x.

Från en högnivåvy finns det några skillnader mellan de två versionerna:

  • at.js 2.x har inte något globalt koncept för mbox-begäran utan snarare en sidinläsningsbegäran. En sidladdningsbegäran kan visas som en begäran om hämtning av innehåll som ska användas vid den första sidladdningen på webbplatsen.
  • at.js 2.x hanterar koncepten Views, som används för Single Page-program (SPA). at.js 1.x känner inte till det här konceptet.

at.js 2.x-diagram

Följande diagram hjälper dig att förstå arbetsflödet för at.js 2.x med Views och hur detta förbättrar SPA integrering. Mer information om begreppen som används i at.js 2.x finns i Implementering av enkelsidiga program.

(Klicka på bilden för att expandera till full bredd.)

Målflöde med at.js 2.x

Steg
Information
1
Samtalet returnerar Experience Cloud ID om användaren är autentiserad. Ett annat anrop synkroniserar kund-ID:t.
2
At.js-biblioteket läses in synkront och döljer dokumentets brödtext.
at.js kan också läsas in asynkront med ett valfritt predhide-fragment implementerat på sidan.
3
En sidinläsningsbegäran görs med alla konfigurerade parametrar (MCID, SDID och kund-ID).
4
Profilskript körs och matas sedan in i Profile Store. Sto begär kvalificerade målgrupper från Audience Library (till exempel målgrupper som delas från Adobe Analytics, Audience Manager osv.).
Kundattribut skickas till Profile Store i en gruppbearbetning.
5
Baserat på parametrar för URL-begäran och profildata avgör Target vilka aktiviteter och upplevelser som ska returneras till besökaren för den aktuella sidan och framtida vyer.
6
Målinriktat innehåll skickas tillbaka till sidan, eventuellt med profilvärden för ytterligare personalisering.
Målinnehåll på den aktuella sidan visas så snabbt som möjligt utan att standardinnehållet flimrar.
Målanpassat innehåll för vyer som visas som ett resultat av användaråtgärder i en SPA cachelagras i webbläsaren så att det kan tillämpas direkt utan ett extra serveranrop när vyerna aktiveras via triggerView().
7
Analysdata skickas till Data Collection servrar.
8
Måldata matchas mot analysdata via SDID och bearbetas till rapportlagringen Analytics.
Analytics data kan sedan visas i både Analytics- och Target via (A4T)-rapporter.

Nu hämtas Views och åtgärder från cachen och visas för användaren utan ett serveranrop, oavsett var triggerView() implementeras på din SPA. triggerView() skickar också en aviseringsbegäran till Target-serverdelen för att öka antalet och registrera antalet visningar. Mer information om at.js för SPA med vyer finns i Implementering av Single Page-program.

(Klicka på bilden för att expandera till full bredd.)

Målflöde at.js 2.x triggerView

Steg
Information
1
triggerView() anropas i SPA för att återge View och tillämpa åtgärder för att ändra visuella element.
2
Målinnehåll för vyn läses från cachen.
3
Målinriktat innehåll visas så snabbt som möjligt utan att man behöver flimra standardinnehållet.
4
Meddelandebegäran skickas till Target Profile Store för att räkna besökaren i aktiviteten och öka måtten.
5
Analytics data har skickats till Data Collection Servers.
6
Target-data matchas mot Analytics-data via SDID och bearbetas till rapportlagringen Analytics. Analytics data kan sedan visas i både Analytics och Target via A4T-rapporter.

Video - at.js 2.x - arkitekturdiagram

at.js 2.x förbättrar Adobe Target stöd för SPA och kan integreras med andra Experience Cloud-lösningar. Den här videon förklarar hur allt hänger ihop.

https://video.tv.adobe.com/v/26250/?quality=12

Mer information finns i Förstå hur at.js 2.x fungerar.

at.js 1.x-diagram

Följande diagram hjälper dig att förstå arbetsflödet i at.js 1.x.

(Klicka på bilden för att expandera till full bredd.)

Målflöde at.js 1.x

Steg
Beskrivning
Utlysning
Beskrivning
1
Samtalet returnerar Experience Cloud-ID (MCID) om användaren är autentiserad. Ett annat anrop synkroniserar kund-ID:t.
2
At.js-biblioteket läses in synkront och döljer dokumentets brödtext.
3
En global mbox-begäran görs med alla konfigurerade parametrar, MCID, SDID och kund-ID (valfritt).
4
Profilskript körs och matas sedan in i profilarkivet. Store begär kvalificerade målgrupper från Audience Library (till exempel målgrupper som delas från Adobe Analytics, Audience Manager).
Kundattribut skickas till profilarkivet i en gruppbearbetning.
5
Baserat på URL:er, mbox-parametrar och profildata avgör Target vilka aktiviteter och upplevelser som ska returneras till besökaren.
6
Målinriktat innehåll skickas tillbaka till sidan, och eventuellt även profilvärden för ytterligare personalisering.
Upplevelsen visas så snabbt som möjligt utan att något standardinnehåll flimrar.
7
Analysdata skickas till datainsamlingsservrar.
8
Måldata matchas mot Analytics-data via SDID och bearbetas till lagringsplatsen för analysrapporter.
Analysdata kan sedan visas både i Analytics- och Target via Analytics for Target-rapporter (A4T).

Video - kontorstid: tips och översikt (26 juni 2019)

Den här videon är en inspelning av"Office Hours", ett projekt som leds av Adobe Customer Care-teamet.

  • Fördelar med att använda at.js
  • at.js-inställningar
  • Hantering av flimmer
  • Felsöka på.js
  • Kända fel
  • Vanliga frågor

https://video.tv.adobe.com/v/27959/?quality=12

How at.js renders offers with HTML content

Vid återgivning av erbjudanden med HTML-innehåll använder at.js följande algoritm:

  1. Bilder är förinlästa (om det finns några <img>-taggar i HTML-innehåll).

  2. HTML-innehåll är kopplat till DOM-noden.

  3. Textbundna skript körs (koden omges av <script> taggar).

  4. Fjärrskript läses in asynkront och körs (<script> taggar med src attribut).

Viktigt:

  • at.js ger inga garantier i ordningen för fjärrexekvering av skript eftersom dessa läses in asynkront.
  • Textbundna skript får inte ha några beroenden till fjärrskript eftersom de läses in och körs senare.
recommendation-more-help
6906415f-169c-422b-89d3-7118e147c4e3