DocumentatieDoelontwikkelaarsgids

Hoe werkt at.js

Last update: Thu Jul 27 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Gemaakt voor:

  • Developer

Om Adobe Target aan clientzijde, moet u de JavaScript-bibliotheek at.js gebruiken.

Bij een clientimplementatie van Adobe Target, Target levert de ervaringen verbonden aan een activiteit rechtstreeks aan cliëntbrowser. De browser bepaalt welke ervaring wordt weergegeven en geeft deze weer. Met een cliënt-zijimplementatie, kunt u een redacteur gebruiken WYSIWYG, Visual Experience Composer (VEC) of een niet-visuele interface Form-based Experience Composer, om uw test- en personaliservaringen te maken.

Wat is at.js?

De bibliotheek at.js is de implementatiebibliotheek voor client-side implementatie van Adobe Target. De bibliotheek at.js verbetert de laadtijden voor webimplementaties en biedt betere implementatieopties voor toepassingen van één pagina. at.js is de aanbevolen implementatiebibliotheek en wordt regelmatig bijgewerkt met nieuwe mogelijkheden. Wij adviseren dat alle klanten uitvoeren of aan migreren nieuwste versie van at.js.

Zie voor meer informatie JavaScript-doelbibliotheken.

In de Targetde volgende Adobe Experience Cloud-oplossingen worden geïmplementeerd: Analytics, Doel en Audience Manager. Daarnaast worden de volgende Experience Cloud de kerndiensten worden uitgevoerd : Adobe Experience Platform, Audiences, en Visitor ID Service.

Wat is het verschil tussen at.js 1.x en werkstroomdiagrammen bij .js 2.x?

Zie Bijwerken van at.js 1.x naar at.js 2.x voor meer informatie over de verschillen die in 2.O van 1 werden ingevoerd.x.

Vanuit een weergave op hoog niveau zijn er enkele verschillen tussen de twee versies:

  • at.js 2.x heeft geen globaal mbox verzoekconcept maar eerder een pagina-lading verzoek. Een verzoek om pagina's te laden kan worden beschouwd als een verzoek om inhoud op te halen die moet worden toegepast op het eerste laadmoment van de pagina van uw website.
  • at.js 2.x beheert de concepten die Views, die worden gebruikt voor toepassingen voor één pagina (SPA). te.js 1.x is zich niet bewust van dit concept.

at.js 2.x-diagrammen

De volgende diagrammen helpen u het werkschema van at.js 2.x begrijpen met Views en hoe dit de integratie van de SPA verbetert . Voor een betere inleiding van de concepten die in at.js 2.x worden gebruikt, zie Toepassing van één pagina.

(Klik op de afbeelding om deze uit te breiden naar de volledige breedte.)

Doelstroom met at.js 2.x

Stap
Details
1
De vraag keert terug Experience Cloud ID als de gebruiker voor authentiek wordt verklaard; een andere vraag synchroniseert de klantenidentiteitskaart
2
De bibliotheek at.js wordt synchroon geladen en de hoofdtekst van het document verborgen.
at.js kan ook asynchroon worden geladen met een optioneel vooraf verborgen fragment dat op de pagina is geïmplementeerd.
3
Er wordt een aanvraag voor het laden van een pagina ingediend, inclusief alle geconfigureerde parameters (MCID, SDID en klant-id).
4
Profielscripts worden uitgevoerd en vervolgens toegevoegd aan het dialoogvenster Profile Store. De Stoverzoeken om gekwalificeerd publiek van de Audience Library (bijvoorbeeld publiek dat wordt gedeeld vanuit Adobe Analytics, Audience Manager, enz.).
Klantkenmerken worden naar de Profile Store in een batchproces.
5
Gebaseerd op parameters en profielgegevens van het URL-verzoek, Target bepaalt welke activiteiten en ervaringen u wilt retourneren aan de bezoeker voor de huidige pagina en de toekomstige weergaven.
6
Gerichte inhoud wordt teruggestuurd naar de pagina, waarbij eventueel ook profielwaarden voor extra personalisatie worden opgenomen.
Gerichte inhoud op de huidige pagina wordt zo snel mogelijk zichtbaar zonder flikkering van de standaardinhoud.
Gerichte inhoud voor weergaven die worden weergegeven als gevolg van gebruikershandelingen in een SPA, wordt in de browser in cache geplaatst, zodat deze direct kan worden toegepast zonder een extra serveraanroep wanneer de weergaven worden geactiveerd triggerView().
7
Analysegegevens worden verzonden naar Data Collection servers.
8
De gerichte gegevens worden aangepast aan de analysegegevens via SDID en worden verwerkt in de Analytics rapporteringsopslag.
Analytics gegevens kunnen vervolgens in beide worden weergegeven Analytics en Target via (A4T) rapporten.

Nu, overal triggerView() wordt geïmplementeerd op uw SPA, Views en de acties worden teruggewonnen uit geheim voorgeheugen en aan de gebruiker getoond zonder een servervraag. triggerView() verzoekt de Commissie tevens Target achterkant om het aantal beeldingen te verhogen en op te nemen. Ga voor meer informatie over at.js voor SPA met Weergaven naar Toepassing van één pagina.

(Klik op de afbeelding om deze uit te breiden naar de volledige breedte.)

Doelstroom bij.js 2.x triggerView

Stap
Details
1
triggerView() wordt in de SPA aangeroepen om de View en past handelingen toe om visuele elementen te wijzigen.
2
De gerichte inhoud voor de mening wordt gelezen van het geheime voorgeheugen.
3
Gerichte inhoud wordt zo snel mogelijk zichtbaar zonder flikkering van de standaardinhoud.
4
Aanmelding wordt verzonden naar de Target Profile Store om de bezoeker te tellen in de activiteit en verhogingsmetriek.
5
Analytics gegevens verzonden naar Data Collection Servers.
6
Target gegevens komen overeen met Analytics gegevens via de SDID en worden verwerkt in de Analytics rapporteringsopslag. Analytics gegevens kunnen vervolgens in beide worden weergegeven Analytics en Target via A4T-rapporten.

Video - op.js 2.x architecturaal diagram

at.js 2.x verbetert de Adobe Target-ondersteuning voor SPA en integreert deze met andere Experience Cloud-oplossingen. In deze video wordt uitgelegd hoe alles bij elkaar komt.

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

Zie Begrijpen hoe at.js 2.x werkt voor meer informatie .

bij.js 1.x-diagram

Met de volgende diagrammen krijgt u inzicht in de workflow van at.js 1.x.

(Klik op de afbeelding om deze uit te breiden naar de volledige breedte.)

Doelstroom bij.js 1.x

Stap
Beschrijving
Bellen
Beschrijving
1
De vraag keert identiteitskaart van de Experience Cloud terug (MCID) als de gebruiker voor authentiek wordt verklaard; een andere vraag synchroniseert de klantenidentiteitskaart
2
De bibliotheek at.js wordt synchroon geladen en de hoofdtekst van het document verborgen.
3
Er wordt een globaal mbox-verzoek ingediend, inclusief alle geconfigureerde parameters, MCID, SDID en klant-id (optioneel).
4
Profielscripts worden uitgevoerd en vervolgens toegevoegd aan de profielenwinkel. De winkel vraagt om gekwalificeerd publiek uit de Audience Library (bijvoorbeeld publiek dat wordt gedeeld vanuit Adobe Analytics, Audience Manager, enz.).
Klantkenmerken worden in een batchproces naar de profielopslag verzonden.
5
Gebaseerd op URL, mbox parameters, en profielgegevens, Target bepaalt welke activiteiten en ervaringen moeten worden teruggegeven aan de bezoeker.
6
Gerichte inhoud wordt teruggestuurd naar pagina, met eventueel ook profielwaarden voor extra personalisatie.
De ervaring wordt zo snel mogelijk getoond zonder flikkering van standaardinhoud.
7
De analysegegevens worden verzonden naar de servers van de Inzameling van Gegevens.
8
De doelgegevens worden via de SDID aangepast aan de analysegegevens en worden verwerkt in de analytische rapportageopslag.
De analysegegevens kunnen dan zowel in Analytics als Target via Analytics for Target (A4T) verslagen.

Video - kantooruren: tips en een overzicht op at.js (26 juni 2019)

Deze video is een opname van "Office Hours", een initiatief onder leiding van de Adobe Customer Care team.

  • Voordelen van het gebruik van at.js
  • at.js-instellingen
  • Flikkerverwerking
  • Foutopsporing bij.js
  • Bekende problemen
  • Veelgestelde vragen

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

Hoe at.js aanbiedingen met HTML-inhoud rendert

Bij rendering van aanbiedingen met HTML-inhoud past at.js het volgende algoritme toe:

  1. Afbeeldingen worden vooraf geladen (als er <img> -tags in HTML-inhoud).

  2. HTML-inhoud is gekoppeld aan het DOM-knooppunt.

  3. Inline scripts worden uitgevoerd (code omsloten in <script> -tags).

  4. Externe scripts worden asynchroon geladen en uitgevoerd (<script> tags met src kenmerken).

Belangrijke opmerkingen:

  • at.js verstrekt geen garanties op de orde van verre manuscriptuitvoering, aangezien deze asynchroon worden geladen.
  • Inline scripts mogen geen afhankelijkheden hebben van externe scripts, omdat deze later worden geladen en uitgevoerd.
recommendation-more-help
6906415f-169c-422b-89d3-7118e147c4e3