On-device decisioning for at.js
Vanaf versie 2.5.0 biedt at.js on-device decisioning aan. On-device decisioning laat u uw Test A/B in het voorgeheugen onderbrengen en Ervaring richtend (XT) activiteiten op browser om in-geheugenbesluiten zonder een blokkerend netwerkverzoek aan Adobe Target Edge Network uit te voeren.
Target biedt ook de flexibiliteit om de meest relevante en meest recente ervaring van uw experimenteren en machine leergedreven (ML-gedreven) verpersoonlijkingsactiviteiten via een levende servervraag te leveren. Met andere woorden, wanneer prestaties het belangrijkst zijn, kunt u ervoor kiezen om on-device decisioning te gebruiken. Nochtans, wanneer de meest relevante, bijgewerkte, en ML-gedreven ervaring nodig is, kan een servervraag in plaats daarvan worden gemaakt.
Wat zijn de voordelen van on-device decisioning?
De voordelen van on-device decisioning zijn onder andere:
- lever het opblazen snelle besluiten en ervaringen. De sluiting en de beslissing worden uitgevoerd in het geheugen en op browser om het blokkeren van netwerkverzoeken te vermijden.
- verbeter toepassingsprestaties. Voer experimenten uit en lever personalisatie aan uw klanten en gebruikers zonder de ervaringen van eindgebruikers in gevaar te brengen.
- verbeter de Score van de Kwaliteit van de Plaats van Google. Nu de beslissing in het geheugen plaatsvindt, verbetert u de score voor kwaliteit van de Google-site van uw onlinebedrijf om deze beter door de consument te kunnen ontdekken.
- leer van analyses in real time. de Inzichten van de winst van uw activiteitenprestaties in real time via Analytics voor Doel (A4T) rapporterend. A4T staat u toe om uw strategie op kritieke momenten te draaien.
Ondersteunde functies
De Adobe Target JS SDK biedt klanten de flexibiliteit om te kiezen tussen prestaties en versheid van gegevens voor beslissingen. Met andere woorden, als het voor u van het grootste belang is om de meest relevante en engaging van gepersonaliseerde inhoud via computerleren te leveren, moet er een live serveroproep worden gedaan. Maar als de prestaties kritischer zijn, moet een on-device en in-memory beslissing worden genomen. on-device decisioning werkt alleen als u de lijst met ondersteunde functies bekijkt:
- Typen activiteiten
- Doelgerichtheid publiek
- Toewijzingsmethode
Voor meer informatie, zie Gesteunde eigenschappen voor on-device decisioning.
Hoe werkt on-device decisioning?
Wanneer u bij.js met on-device decisioning toegelaten opstelt en initialiseert, a regelartefact dat uw on-device decisioning voor A/B en XT activiteiten, publiek, en activa omvat, wordt gedownload van dichtste Akamai CDN aan uw bezoeker en plaatselijk in het voorgeheugen ondergebracht op browser van uw bezoeker. Wanneer een verzoek van at.js wordt gedaan om een ervaring terug te winnen, wordt het besluit betreffende welke ervaring om in geheugen terug te keren wordt gemaakt, die op de meta-gegevens wordt gebaseerd in het caching regelartefact worden gecodeerd.
Beslissingsmethode
Met on-device decisioning introduceert Target een nieuwe instelling met de naam Decisioning Method. De instelling van de beslissingsmethode bepaalt hoe at.js uw ervaringen biedt. De beslissingsmethode heeft drie waarden:
- Alleen server
- Alleen op apparaat
- Hybride
Alleen server
Server-kant slechts is de standaardbeslissingsmethode die uit de doos wordt geplaatst wanneer at.js 2.5.0+ wordt uitgevoerd en op uw Webeigenschappen opgesteld.
Als alleen server-side wordt gebruikt als de standaardconfiguratie, worden alle beslissingen genomen in het Target edge-netwerk. Dit houdt in dat de server wordt geblokkeerd. Deze benadering kan stijgende latentie introduceren, maar het verstrekt ook significante voordelen, zoals het geven van u de capaciteit om Target machine-leert mogelijkheden van toepassing te zijn die Aanbevelingen omvatten, Automated Personalization (AP), en auto-Doel activiteiten.
Bovendien kan het verbeteren van uw persoonlijke ervaringen door het gebruikersprofiel van Target te gebruiken, dat door sessies en kanalen blijft bestaan, krachtige resultaten voor uw bedrijf opleveren.
Ten slotte kunt u met de server alleen de Adobe Experience Cloud gebruiken en het publiek afstemmen waarvoor u een doelgericht beroep kunt doen via de segmenten Audience Manager en Adobe Analytics.
In het volgende diagram ziet u de interactie tussen uw bezoeker, de browser, at.js 2.5.0+ en het Adobe Target Edge-netwerk. In dit stroomdiagram worden nieuwe bezoekers en terugkerende bezoekers vastgelegd.
(Klik op de afbeelding om deze uit te breiden naar de volledige breedte.)
{modal="regular"}
De volgende lijst komt overeen met de cijfers in het diagram:
De bibliotheek at.js kan ook asynchroon worden geladen met een optioneel vooraf verborgen fragment dat op de pagina is geïmplementeerd.
de Opslag van het Profiel vraagt gekwalificeerd publiek van de Bibliotheek van het Publiek (bijvoorbeeld, publiek dat van Adobe Analytics, Adobe Audience Manager wordt gedeeld, etc.).
de attributen van de Klant worden verzonden naar de Opslag van het Profiel in een partijproces.
Alleen op apparaat
Alleen op het apparaat is de beslissingsmethode die moet worden ingesteld in at.js 2.5.0+ wanneer on-device decisioning alleen moet worden gebruikt op alle webpagina’s.
On-device decisioning kan uw ervaringen en personalisatieactiviteiten op een razendsnelle manier aanbieden, omdat de beslissingen worden genomen op basis van een cacheovereenkomst die al uw activiteiten bevat die in aanmerking komen voor on-device decisioning .
Zie on-device decisioning Ondersteunde functies in voor meer informatie over welke activiteiten in aanmerking komen voor on-device decisioning .
Deze besluitvormingsmethode zou slechts moeten worden gebruikt als de prestaties hoogst kritiek over alle pagina’s zijn die besluiten van Doel vereisen. Houd er bovendien rekening mee dat wanneer deze beslissingsmethode wordt geselecteerd, uw Target -activiteiten die niet in aanmerking komen voor on-device decisioning niet worden uitgevoerd of uitgevoerd. De bibliotheek at.js 2.5.0+ wordt gevormd om het caching regelartefact slechts te zoeken om besluiten te nemen.
In het volgende diagram ziet u de interactie tussen uw bezoeker, de browser, at.js 2.5.0+ en de CDN van Akamai. De Akamai CDN slaat het artefact van de regels voor het eerste bezoek van de bezoeker in het voorgeheugen op. Voor het eerste paginabezoek voor een nieuwe bezoeker, moet het artefact van de JSON- regels van Akamai CDN worden gedownload om plaatselijk op browser van de bezoeker in het voorgeheugen onder te brengen. Nadat het artefact van JSON-regels is gedownload, wordt de beslissing onmiddellijk genomen zonder een blokkerende netwerkaanroep. In het volgende stroomdiagram worden nieuwe bezoekers vastgelegd.
(Klik op de afbeelding om deze uit te breiden naar de volledige breedte.)
{modal="regular"}
De volgende lijst komt overeen met de cijfers in het diagram:
de bibliotheek at.js kan ook asynchroon met een facultatief pre-verbergend die fragment worden geladen op de pagina wordt uitgevoerd.
In het volgende diagram ziet u de interactie tussen uw bezoeker, de browser, op .js 2.5.0+ en de JSON-regelartefact in de cache voor het volgende paginahit of terugkerend bezoek van de bezoeker. Omdat het artefact van JSON-regels al in het cachegeheugen is opgeslagen en beschikbaar is in de browser, wordt de beslissing onmiddellijk genomen zonder een blokkerende netwerkaanroep. Dit stroomdiagram legt volgende paginanavigatie of terugkerende bezoekers vast.
(Klik op de afbeelding om deze uit te breiden naar de volledige breedte.)
{modal="regular"}
De volgende lijst komt overeen met de cijfers in het diagram:
de bibliotheek at.js kan ook asynchroon met een facultatief pre-verbergend die fragment worden geladen op de pagina wordt uitgevoerd.
Hybride
Hybride is de beslissingsmethode die moet worden ingesteld in at.js 2.5.0+ wanneer zowel on-device decisioning als activiteiten die een netwerkaanroep naar het Adobe Target Edge-netwerk vereisen, moeten worden uitgevoerd.
Wanneer u zowel on-device decisioning -activiteiten als serveractiviteiten beheert, kan dit een beetje ingewikkeld en vervelend zijn wanneer u nadenkt over het implementeren en plaatsen van Target op uw pagina’s. Met hybride methoden als de beslissingsmethode weet Target wanneer een server moet worden aangeroepen naar het Adobe Target Edge-netwerk voor activiteiten die uitvoering op de server vereisen, en ook wanneer alleen beslissingen op het apparaat moeten worden uitgevoerd.
Het Artefact van de JSON-regels bevat metagegevens om at.js te laten weten of een box een serveractiviteit heeft die wordt uitgevoerd of een on-device decisioning -activiteit. Deze beslissingsmethode zorgt ervoor dat activiteiten die u snel wilt laten uitvoeren, worden uitgevoerd via on-device decisioning en voor activiteiten die krachtigere, door ML gestuurde personalisatie vereisen, worden deze activiteiten uitgevoerd via het Adobe Target Edge-netwerk.
In het volgende diagram ziet u de interactie tussen uw bezoeker, de browser, op .js 2.5.0+, de Akamai CDN en de Adobe Target Edge Network voor een nieuwe bezoeker die uw pagina voor het eerst bezoekt. Het weghalen van dit diagram is dat het artefact van de JSON-regels asynchroon wordt gedownload terwijl de beslissingen via het Adobe Target Edge-netwerk worden genomen.
Deze benadering zorgt ervoor dat de grootte van het artefact, dat vele activiteiten kan omvatten, niet negatief de latentie van de beslissing beïnvloedt. Het synchroon downloaden van de JSON-regels en het vervolgens nemen van de beslissing kan ook negatieve gevolgen hebben voor de latentie en kan inconsistent zijn. Daarom is de hybride besluitvormingsmethode een beste praktijkaanbeveling om altijd een server-zijvraag voor het besluit voor een nieuwe bezoeker te maken, en aangezien de JSON regels artefact parallel in het voorgeheugen wordt opgeslagen. Voor om het even welke verdere paginabezoeken en terugkeerbezoeken, worden de besluiten genomen van het geheime voorgeheugen en in geheugen door het JSON regelartefact.
(Klik op de afbeelding om deze uit te breiden naar de volledige breedte.)
{modal="regular"}
De volgende lijst komt overeen met de cijfers in het diagram:
de bibliotheek at.js kan ook asynchroon met een facultatief pre-verbergend die fragment worden geladen op de pagina wordt uitgevoerd.
Het volgende diagram illustreert de interactie tussen uw bezoeker, browser, at.js 2.5.0+, en het caching JSON regelt artefact voor een verdere paginanavigatie of een terugkeerbezoek. In dit diagram, concentreert zich slechts op het gebruiksgeval dat een op-apparatenbesluit voor de verdere paginanavigatie of terugkeerbezoek wordt genomen. Houd in mening dat afhankelijk van welke activiteiten voor bepaalde pagina’s levend zijn, een server-zijvraag kan worden gemaakt om server-zijbesluiten uit te voeren.
(Klik op de afbeelding om deze uit te breiden naar de volledige breedte.)
{modal="regular"}
De volgende lijst komt overeen met de cijfers in het diagram:
de bibliotheek at.js kan ook asynchroon met een facultatief pre-verbergend die fragment worden geladen op de pagina wordt uitgevoerd.
Hoe schakel ik on-device decisioning in?
On-device decisioning is beschikbaar voor alle Target -klanten die At.js 2.5.0+ gebruiken.
on-device decisioning inschakelen:
-
Klik op Administration > Implementation > Account details.
-
Schuif onder Account details de schakeloptie On-Device Decisioning naar de positie “aan”.
De optie Alle bestaande on-device decisioning gekwalificeerde activiteiten opnemen in het artefact wordt weergegeven als u on-device decisioning inschakelt.
-
(Voorwaardelijk) Schuif de schakeloptie naar de positie “aan” als u wilt dat al uw live Target -activiteiten die voor on-device decisioning in aanmerking komen, automatisch in het artefact worden opgenomen.
Als u deze schakeloptie uitschakelt, moet u alle on-device decisioning -activiteiten opnieuw maken en activeren, zodat deze worden opgenomen in het gegenereerde artefact voor regels. Met andere woorden, elke activiteit in live-toestand voordat de beslissingsschakeloptie op het apparaat wordt ingeschakeld, is niet opgenomen in het artefact van de regels.
Na het toelaten van de knevel van het Beslissen op apparaat, Target begint producerend en verspreidend regelartefacten voor uw cliënt.
Hoe configureer ik at.js 2.5.0+ voor gebruik van on-device decisioning?
-
Klik op Administration > Implementation > Account details.
-
Onder Implementation Methods > Main Implementation Method klikt u op Edit naast uw versie at.js (moet .js 2.5.0 of hoger zijn).
note warning WARNING Voordat u deze standaardinstellingen wijzigt, raadpleegt u eerst de Client Care om te voorkomen dat de huidige implementatie wordt beïnvloed. -
Selecteer de gewenste beslissingsmethode:
- Alleen server
- Alleen op apparaat
- Hybride
Algemene instellingen
U kunt een standaardbeslissingsmethode configureren voor alle Target -beslissingen. De verschillende besluitvormingsmethodes zijn server-kant slechts, slechts op apparaat, en Hybrid. De beslissingsmethode die is geselecteerd in de Target -gebruikersinterface, wordt geconfigureerd in window.targetGlobalSettings onder het veld decisioningMethod . Leer meer over decisioningMethod in targetGlobalSettings () .
<head>
<script type="text/javascript">
window.targetGlobalSettings = {
clientCode: "yourClientCodeHere",
imsOrgId: "imsOrgId@AdobeOrg",
decisioningMethod: "on-device"
};
</script>
<script type="text/javascript" src="at.js"></script>
</head>
Aangepaste instelling
Als u decisioningMethod in window.targetGlobalSettings plaatst, maar decisioningMethod voor elk Adobe Target besluit volgens uw gebruiksgeval zou willen met voeten treden, kunt u deze procedure doen door decisioningMethod in At.js2.5.0+ te specificeren getOffers () vraag.
adobe.target.getOffers({
decisioningMethod:"on-device",
request: {
execute: {
mboxes: [
{
index: 0,
name: "homepage"
}
]
}
}
});
decisioningMethod heeft als "op apparaat" of "hybride". De bibliotheek at.js 2.5.0+ moet weten of om het Artefact van de regels JSON onmiddellijk na het laden op de pagina te downloaden en in het voorgeheugen onder te brengen. Als de besluitvormingsmethode voor het globale plaatsen aan "server-kant"wordt geplaatst, en "op-apparaat"of "hybride"besluitvormingsmethode wordt overgegaan in de getOffers () vraag, zou at.js 2.5.0+ niet het JSON regelartefact in het voorgeheugen ondergebracht hebben om uw op-apparatenbesluiten uit te voeren.Artefactcache TTL
Het doel vertegenwoordigt uw activiteiten die voor on-device decisioning als artefact kwalificeren dat uit meta-gegevens, regels, en voorwaarden bestaat. Dit artefact wordt in het cachegeheugen opgeslagen op de Akamai CDN. Tijdens het eerste bezoek van uw gebruiker, downloadt browser van de gebruiker en caches het artefact dat uw on-device decisioning activiteiten vertegenwoordigt.
Bij volgende bezoeken aan uw site controleert de browser automatisch of er een nieuwere versie van het artefact moet worden gedownload. Met deze controle wordt latentie toegevoegd. De Artefacache TTL definieert het aantal minuten dat de browser niet mag controleren op een bijgewerkt artefact sinds de laatste geslaagde download. Hoe langer het tijdsbestek, hoe beter de prestaties. Hoe korter het tijdkader, hoe beter de gegevens worden versnipperd, maar dit gaat ten koste van extra latentie.
Hoe weet ik dat een activiteit on-device decisioning in aanmerking komt?
Nadat u een activiteit creeert die on-device decisioning in aanmerking komt, is een etiket dat Beslissingen op Apparaat Geschikt leest, zichtbaar in de pagina van het Overzicht van de activiteit.
Dit label betekent niet dat de activiteit altijd via on-device decisioning wordt geleverd. Alleen wanneer at.js 2.5.0+ is geconfigureerd voor gebruik van on-device decisioning , wordt deze activiteit op het apparaat uitgevoerd. Als at.js 2.5.0+ niet wordt gevormd om op-apparaat te gebruiken, dan zal deze activiteit nog via een servervraag worden geleverd die van at.js wordt gemaakt.
U kunt filteren voor alle activiteiten die on-device decisioning in aanmerking komen op de pagina Activiteiten via het filter In aanmerking komende voor besluitvorming op het apparaat.
Overzicht van stappen om ervoor te zorgen dat mijn on-device decisioning activiteiten via At.js 2.5.0+ worden geleverd?
-
Open de gebruikersinterface van Adobe Target en navigeer naar Administration > Implementation > Account Details om de On-Device Decisioning -schakeloptie in te schakelen.
-
Schakel de “Include all existing on-device decisioning qualified activities in the artifact” -schakeloptie in.
De eerste JSON-regels kunnen tot 10 minuten duren.
-
Maak en activeer een type activiteit dat door on-device decisioning wordt ondersteund, en controleer of dit on-device decisioning mogelijk is.
-
Stel de Decisioning Method in op “Hybrid” of “On-device only” via de interface voor instellingen bij.js.
-
Download en implementeer At.js 2.5.0+ op uw pagina’s.