On-device decisioning for at.js

Från och med version 2.5.0 erbjuder at.js on-device decisioning. On-device decisioning låter dig cachelagra A/B-test och Experience Targeting (XT) aktiviteter i webbläsaren som utför minnesbaserad beslutsfattande utan blockerande nätverksbegäran till Adobe Target Edge Network.

NOTE
On-device decisioning finns både för implementeringar på klientsidan och på serversidan. Den här artikeln beskriver on-device decisioning för klientsidan. För information om on-device decisioning för serversidan, se implementeringsdokumentationen på serversidan här.

Target erbjuder även flexibiliteten att leverera den mest relevanta och aktuella upplevelsen från dina experimentella och HTML-drivna personaliseringsaktiviteter (Machine Learning-driven) via ett live-serversamtal. Du kan med andra ord välja att använda när prestanda är viktigast on-device decisioning. Men när den mest relevanta, aktuella och ML-drivna upplevelsen behövs kan ett serveranrop göras istället.

Vilka är fördelarna med on-device decisioning?

Fördelarna med on-device decisioning inkludera:

  • Leverera blixtsnabba beslut och upplevelser. Buckling och beslut utförs i minnet och i webbläsaren för att undvika blockering av nätverksbegäranden.
  • Förbättra programmets prestanda. Kör experiment och leverera personalisering till kunder och användare utan att kompromissa med slutanvändarupplevelserna.
  • Förbättra Google Site Quality Score. I och med att beslut fattas i minnet kan du förbättra Google Site Quality-poängen för ditt onlineföretag så att det blir lättare att hitta för kunderna.
  • Lär dig av realtidsanalyser. Få insikter om aktivitetens resultat i realtid via Analyser för Target (A4T)-rapportering. Med A4T kan ni styra er strategi vid kritiska ögonblick.

Funktioner som stöds

The Adobe Target JS SDK ger kunderna flexibilitet att välja mellan prestanda och aktualitet för data för beslut. Med andra ord, om det viktigaste är att leverera det mest relevanta och engagerande personaliserade innehållet via maskininlärning, bör du ringa ett live-serversamtal. Men när prestanda är viktigare bör man fatta beslut på enheten och i minnet. För on-device decisioning för att arbeta, se listan över funktioner som stöds:

  • Typ av aktivitet
  • Målgruppsanpassning
  • Allokeringsmetod

Mer information finns i Funktioner som stöds för on-device decisioning.

Hur on-device decisioning arbete?

När du distribuerar och initierar at.js med on-device decisioning aktiverad, en regelartefakt som innehåller on-device decisioning för A/B- och XT-aktiviteter, målgrupper och resurser hämtas från närmaste Akamai CDN till besökaren och cachas lokalt i besökarens webbläsare. När en begäran görs från at.js för att hämta en upplevelse, bestäms vilken upplevelse som ska returneras i minnet utifrån de metadata som är kodade i den cachelagrade regelartefakten.

Beslutsmetod

Med on-device decisioning, Target introducerar en ny inställning med namnet Beslutsmetod. Inställningen Beslutsmetod styr hur at.js levererar dina upplevelser. Beslutsmetoden har tre värden:

  • Endast serversidan
  • Endast på enheten
  • Hybrid

Endast serversidan

Endast på serversidan är den standardmetod för beslut som anges i rutan när at.js 2.5.0+ implementeras och distribueras på dina webbegenskaper.

Om endast serversidan används som standardkonfiguration innebär det att alla beslut fattas på Target edge-nätverk, vilket innebär ett blockerande serveranrop. Den här metoden kan innebära inkrementell fördröjning, men ger även avsevärda fördelar, som att du kan använda Targetmaskininlärningsfunktioner som innefattar Recommendations, Automated Personalization (AP) och Automatiskt mål verksamhet.

Dessutom kan ni förbättra era personaliserade upplevelser genom att använda TargetAnvändarprofilen, som bevaras i olika sessioner och kanaler, kan ge ett kraftfullt resultat för ert företag.

Slutligen kan du bara använda Adobe Experience Cloud på serversidan och finjustera målgrupper som kan riktas mot Audience Manager och Adobe Analytics.

Följande bild visar interaktionen mellan besökaren, webbläsaren, at.js 2.5.0+, och Adobe Target Edge-nätverk. Det här flödesdiagrammet fångar nya besökare och returnerar besökare.

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

Endast serversidesflödesdiagram {modal="regular"}

Följande lista motsvarar siffrorna i diagrammet:

Steg
Beskrivning
1
Experience Cloud-besökar-ID hämtas från Adobe Experience Cloud Identity Service.
2
At.js-biblioteket läses in synkront och döljer dokumentets brödtext.
At.js-biblioteket kan också läsas in asynkront med ett valfritt fördolt fragment som implementerats på sidan.
3
At.js-biblioteket döljer kroppen för att förhindra flimmer.
4
En sidinläsningsbegäran görs som innehåller alla konfigurerade parametrar, t.ex. (ECID, Kund-ID, Anpassade parametrar, Användarprofil osv.)
5
Profilskript körs och matas sedan in i profilarkivet.
Profile Store begär kvalificerade målgrupper från Audience Library (till exempel målgrupper som delas från Adobe Analytics, Adobe Audience Manager och så vidare).
Kundattribut skickas till profilarkivet i en gruppbearbetning.
6
Profilarkivet används för att filtrera aktiviteter genom att kvalificera och klippa målgrupper.
7
Det resulterande innehållet väljs när upplevelsen bestäms från live Target verksamhet.
8
Med biblioteket at.js döljs motsvarande element på sidan som är kopplade till upplevelsen som måste återges.
9
I biblioteket at.js visas brödtexten så att resten av sidan kan läsas in så att besökaren kan se den.
10
At.js-biblioteket hanterar DOM för att återge upplevelsen från Target Edge Network.
11
Upplevelsen renderar för besökaren.
12
Hela webbsidan läses in.
13
Analysdata skickas till datainsamlingsservrar.
14
Målinriktade data matchas mot analysdata via SDID och bearbetas till lagringsplatsen för analysrapporter. Analysdata kan sedan visas både i Analytics och Target via Analytics for Target (A4T)-rapporter.

Endast på enheten

Endast på enheten är den beslutsmetod som måste anges i at.js 2.5.0+ när on-device decisioning ska bara användas på alla dina webbsidor.

On-device decisioning kan leverera dina upplevelser och personaliseringsaktiviteter blixtsnabbt eftersom besluten fattas utifrån en cache-lagrad regelartefakt som innehåller alla dina aktiviteter som kvalificerar sig för on-device decisioning.

Läs mer om vilka aktiviteter som är berättigade till on-device decisioning, se Funktioner som stöds i on-device decisioning.

Den här beslutsmetoden bör endast användas om prestanda är mycket kritiskt för alla sidor som kräver beslut från Target. Tänk dessutom på att när du väljer den här beslutsmetoden ska du Target aktiviteter som inte uppfyller kraven för on-device decisioning levereras eller verkställs inte. At.js-biblioteket 2.5.0+ är konfigurerat att endast söka efter den cachelagrade regelartefakten för att fatta beslut.

Följande diagram visar interaktionen mellan besökaren, webbläsaren, at.js 2.5.0+, och Akamai CDN. Akamai CDN cachar regelfelaktigheten vid besökarens första besök. Vid den första sidbesöket hos en ny besökare måste JSON-regelartefakten hämtas från Akamai CDN för att kunna cachas lokalt i besökarens webbläsare. När JSON-regelartefakten har hämtats fattas beslutet omedelbart utan ett blockerande nätverksanrop. I följande flödesdiagram visas nya besökare.

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

Flödesdiagram endast på enheten {modal="regular"}

Följande lista motsvarar siffrorna i diagrammet:

NOTE
Adobe Target Administratörsservrar är kvalificerade för alla dina aktiviteter som är berättigade till on-device decisioning, generera JSON-regelartefakten och sprider den till Akamai CDN. Dina aktiviteter övervakas kontinuerligt för uppdateringar av en ny JSON-regelartefakt som ska spridas till Akamai CDN.
Steg
Beskrivning
1
Experience Cloud-besökar-ID hämtas från Adobe Experience Cloud Identity Service.
2
At.js-biblioteket läses in synkront och döljer dokumentets brödtext.
At.js-biblioteket kan också läsas in asynkront med ett valfritt fördolt fragment som implementerats på sidan.
3
At.js-biblioteket döljer kroppen för att förhindra flimmer.
4
I at.js-biblioteket görs en begäran om att hämta JSON-regelartefakten från närmaste Akamai CDN till besökaren.
5
Akamai CDN svarar med JSON-regelartefakten.
6
JSON-regelartefakten cachelagras lokalt i besökarens webbläsare.
7
I biblioteket at.js tolkas JSON-regelartefakten och beslutet att hämta upplevelsen verkställs och de testade elementen döljs.
8
I biblioteket at.js visas brödtexten så att resten av sidan kan läsas in så att besökaren kan se den.
9
At.js-biblioteket ändrar DOM för att återge upplevelsen från den cachelagrade JSON-regelartefakten.
10
Upplevelsen renderar för besökaren.
11
Hela webbsidan läses in.
12
Analysdata skickas till datainsamlingsservrar. Målinriktade data matchas mot analysdata via SDID och bearbetas till lagringsplatsen för analysrapporter. Analysdata kan sedan visas både i Analytics och Target via Analytics for Target (A4T)-rapporter.

I följande diagram visas interaktionen mellan besökaren, webbläsaren, at.js 2.5.0+, och den cachelagrade JSON-regelartefakten för besökarens efterföljande sidträff eller återbesök. Eftersom JSON-regelartefakten redan är cachelagrad och tillgänglig i webbläsaren, fattas beslutet omedelbart utan ett blockerande nätverksanrop. Det här flödesdiagrammet fångar efterföljande sidnavigering eller returnerar besökare.

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

Flödesdiagram endast på enheten för efterföljande sidnavigering och återkommande besök {modal="regular"}

Följande lista motsvarar siffrorna i diagrammet:

NOTE
Adobe Target Administratörsservrar är kvalificerade för alla dina aktiviteter som är berättigade till on-device decisioning, generera JSON-regelartefakten och sprider den till Akamai CDN. Dina aktiviteter övervakas kontinuerligt för uppdateringar av en ny JSON-regelartefakt som ska spridas till Akamai CDN.
Steg
Beskrivning
1
Experience Cloud-besökar-ID hämtas från Adobe Experience Cloud Identity Service.
2
At.js-biblioteket läses in synkront och döljer dokumentets brödtext.
At.js-biblioteket kan också läsas in asynkront med ett valfritt fördolt fragment som implementerats på sidan.
3
At.js-biblioteket döljer kroppen för att förhindra flimmer.
4
I biblioteket at.js tolkas JSON-regelartefakten och beslutet i minnet verkställs för att hämta upplevelsen.
5
De testade elementen är dolda.
6
I biblioteket at.js visas brödtexten så att resten av sidan kan läsas in så att besökaren kan se den.
7
At.js-biblioteket ändrar DOM för att återge upplevelsen från den cachelagrade JSON-regelartefakten.
8
Upplevelsen renderar för besökaren.
9
Hela webbsidan läses in.
10
Analysdata skickas till datainsamlingsservrar. Målinriktade data matchas mot analysdata via SDID och bearbetas till lagringsplatsen för analysrapporter. Analysdata kan sedan visas både i Analytics och Target via Analytics for Target (A4T)-rapporter.

Hybrid

Hybrid är den beslutsmetod som måste anges i at.js 2.5.0+ när båda on-device decisioning och aktiviteter som kräver ett nätverkssamtal till Adobe Target Edge-nätverket måste köras.

När du hanterar båda on-device decisioning aktiviteter och aktiviteter på serversidan kan det vara lite komplicerat och omständligt när du funderar på hur du ska driftsätta och tillhandahålla Target på era sidor. Med hybridmetoden som beslutsmetod Target vet när servern måste ringa Adobe Target Edge Network för aktiviteter som kräver körning på serversidan och även när beslut endast ska verkställas på enheter.

JSON-regelartefakten innehåller metadata som informerar at.js om en mbox har en aktivitet på serversidan som körs eller en on-device decisioning aktivitet. Med den här beslutsmetoden kan du säkerställa att aktiviteter som du avser att leverera snabbt genomförs via on-device decisioning och för aktiviteter som kräver kraftfullare ML-driven personalisering utförs dessa aktiviteter via Adobe Target Edge-nätverk.

Följande diagram visar interaktionen mellan besökaren, webbläsaren, at.js 2.5.0+, Akamai CDN och Adobe Target Edge Network för en ny besökare som besöker din sida för första gången. Inställningen från det här diagrammet är att JSON-regelartefakten hämtas asynkront medan besluten fattas via Adobe Target Edge-nätverk.

Detta säkerställer att artefaktens storlek, som kan innehålla många aktiviteter, inte påverkar beslutets fördröjning negativt. Om du hämtar JSON-reglerna synkront och fattar beslut efter detta kan det också få negativa effekter på fördröjningen och kan vara inkonsekvent. Därför är hybridmetoden en rekommendation om att alltid göra ett anrop på serversidan för beslut om en ny besökare, och eftersom JSON-regelartefakten cachas parallellt. För efterföljande sidbesök och återbesök görs besluten från cacheminnet och i minnet via JSON-regelartefakten.

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

Hybrid-flödesdiagram för en förstagångsbesökare {modal="regular"}

Följande lista motsvarar siffrorna i diagrammet:

NOTE
Adobe Target Administratörsservrar är kvalificerade för alla dina aktiviteter som är berättigade till on-device decisioning, generera JSON-regelartefakten och sprider den till Akamai CDN. Dina aktiviteter övervakas kontinuerligt för uppdateringar av en ny JSON-regelartefakt som ska spridas till Akamai CDN.
Steg
Beskrivning
1
Experience Cloud-besökar-ID hämtas från Adobe Experience Cloud Identity Service.
2
At.js-biblioteket läses in synkront och döljer dokumentets brödtext.
At.js-biblioteket kan också läsas in asynkront med ett valfritt fördolt fragment som implementerats på sidan.
3
At.js-biblioteket döljer kroppen för att förhindra flimmer.
4
En sidinläsningsbegäran görs till Adobe Target Edge Network, inklusive alla konfigurerade parametrar som (ECID, Kund-ID, Anpassade parametrar, Användarprofil osv.)
5
Samtidigt begär at.js att JSON-regelartefakten ska hämtas från närmaste Akamai CDN till besökaren.
6
(Adobe Target Edge Network) Profilskript körs och matas sedan in i Profile Store. Profile Store begär kvalificerade målgrupper från Audience Library (till exempel målgrupper som delas från Adobe Analytics, Adobe Audience Manager och så vidare).
7
Akamai CDN svarar med JSON-regelartefakten.
8
Profilarkivet används för att filtrera aktiviteter genom att kvalificera och klippa målgrupper.
9
Det resulterande innehållet väljs när upplevelsen bestäms från live Target verksamhet.
10
Med biblioteket at.js döljs motsvarande element på sidan som är kopplade till upplevelsen som måste återges.
11
I biblioteket at.js visas brödtexten så att resten av sidan kan läsas in så att besökaren kan se den.
12
At.js-biblioteket hanterar DOM för att återge upplevelsen från Target Edge Network.
13
Upplevelsen renderar för besökaren.
14
Hela webbsidan läses in.
15
Analysdata skickas till datainsamlingsservrar. Målinriktade data matchas mot analysdata via SDID och bearbetas till lagringsplatsen för analysrapporter. Analysdata kan sedan visas både i Analytics och Target via Analytics for Target (A4T)-rapporter.

I följande diagram visas interaktionen mellan besökaren, webbläsaren, at.js 2.5.0+, och den cachelagrade JSON-regelartefakten för efterföljande sidnavigering eller ett returbesök. I det här diagrammet fokuserar du bara på det användningsfall som avgör om det är enheten som ska användas för den efterföljande sidnavigeringen eller det efterföljande besöket. Tänk på att beroende på vilka aktiviteter som är aktiva för vissa sidor kan ett anrop på serversidan göras för att köra beslut på serversidan.

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

Hybridflödesdiagram för efterföljande sidnavigering och återkommande besök {modal="regular"}

Följande lista motsvarar siffrorna i diagrammet:

NOTE
Adobe Target Administratörsservrar är kvalificerade för alla dina aktiviteter som är berättigade till on-device decisioning, generera JSON-regelartefakten och sprider den till Akamai CDN. Dina aktiviteter övervakas kontinuerligt för uppdateringar av en ny JSON-regelartefakt som ska spridas till Akamai CDN.
Steg
Beskrivning
1
Experience Cloud-besökar-ID hämtas från Adobe Experience Cloud Identity Service.
2
At.js-biblioteket läses in synkront och döljer dokumentets brödtext.
At.js-biblioteket kan också läsas in asynkront med ett valfritt fördolt fragment som implementerats på sidan.
3
At.js-biblioteket döljer kroppen för att förhindra flimmer.
4
En begäran görs för att hämta en upplevelse.
5
At.js-biblioteket bekräftar att JSON-regelartefakten redan har cache-lagrats och kör beslutet i minnet för att hämta upplevelsen.
6
De testade elementen är dolda.
7
I biblioteket at.js visas brödtexten så att resten av sidan kan läsas in så att besökaren kan se den.
8
At.js-biblioteket ändrar DOM för att återge upplevelsen från den cachelagrade JSON-regelartefakten.
9
Upplevelsen renderar för besökaren.
10
Hela webbsidan läses in.
11
Analysdata skickas till datainsamlingsservrar. Målinriktade data matchas mot analysdata via SDID och bearbetas till lagringsplatsen för analysrapporter. Analysdata kan sedan visas både i Analytics och Target via Analytics for Target (A4T)-rapporter.

Hur aktiverar jag on-device decisioning?

On-device decisioning är tillgängligt för alla Target kunder som använder At.js 2.5.0+.

Aktivera on-device decisioning:

NOTE
Du måste ha administratören eller godkännaren användarroll om du vill aktivera eller inaktivera alternativet för beslut på enhet.
  1. Klicka på Administration > Implementation > Account details.

  2. Under Account details, för bilden On-Device Decisioning växla till"på"-positionen.

    On-device decisioning växla

    The "Include all existing on-device decisioning kvalificerade aktiviteter i artefaktalternativet visas om du aktiverar on-device decisioning.

  3. (Villkorligt) Om du vill ha alla dina aktiva foton drar du skjutreglaget till"på"-positionen Target aktiviteter som uppfyller kraven för on-device decisioning som automatiskt inkluderas i artefakten.

    Om du inte aktiverar det här alternativet måste du återskapa och aktivera on-device decisioning aktiviteter som de ska omfattas av den genererade regelartefakten. Det innebär att alla aktiviteter i live-läge innan du aktiverar reglaget för val på enhet inte ingår i regelartefakten.

När du har aktiverat alternativet för val på enhet, Target börjar generera och sprida regelartefakter för kunden.

WARNING
Se till att du aktiverar växlingsknappen innan du initierar Adobe Target SDK att använda on-device decisioning. Regelartefakterna måste först generera och sprida till Akamai CDN:er för on-device decisioning till jobbet. Spridning kan ta fem till tio minuter innan den första regelartefakten genereras och sprids till Akamai CDN.

Hur konfigurerar jag at.js 2.5.0+ att använda on-device decisioning?

  1. Klicka på Administration > Implementation > Account details.

  2. Under Implementation Methods > Main Implementation Method, klicka Edit bredvid din at.js-version (måste vara at.js 2.5.0 eller senare).

    Redigera inställningar för den huvudsakliga implementeringsmetoden

    note warning
    WARNING
    Innan du ändrar dessa standardinställningar bör du kontakta kundtjänst för att undvika att den aktuella implementeringen påverkas.
  3. Välj önskad beslutsmetod:

    • Endast serversidan
    • Endast på enheten
    • Hybrid

    Redigera inställningspanelen at.js

Globala inställningar

Du kan konfigurera en standardmetod för beslutsfattande för alla Target beslut. De olika beslutsmetoderna är endast på serversidan, endast på enheten och hybrider. Beslutsmetoden som är markerad i Target Gränssnittet är konfigurerat i window.targetGlobalSettings under decisioningMethod fält. Läs mer om 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>

Anpassad inställning

Om du anger decisioningMethod in window.targetGlobalSettings, men vill åsidosätta decisioningMethod för varje Adobe Target kan du göra det här genom att ange decisioningMethod in At.js2.5.0+'s getOffers() ring.

adobe.target.getOffers({

  decisioningMethod:"on-device",
  request: {
    execute: {
      mboxes: [
        {
          index: 0,
          name: "homepage"
        }
      ]
    }
 }
});
NOTE
För att kunna använda"on-device" eller"hybrid" som en beslutsmetod i getOffers()-anropet måste den globala inställningen ha decisioningMethod som"på enheten" eller"hybrid". At.js-biblioteket 2.5.0+ måste känna till om JSON-regelartefakten ska hämtas och cachelagras direkt efter att sidan har lästs in. Om beslutsmetoden för den globala inställningen är inställd på "server-side", och "on-device" eller "hybrid"-beslutsmetoden skickas till getOffers()-anropet, skulle at.js 2.5.0+ inte ha JSON-regelartefakten cachelagrad för att köra dina enhetsbeslut.

Cacheminne för felaktigheter

Målet representerar de aktiviteter som är berättigade till on-device decisioning som en artefakt som består av metadata, regler och villkor. Artefakten cachelagras på Akamai CDN. Under användarens första besök hämtar och cachelagrar användarens webbläsare den artefakt som representerar on-device decisioning verksamhet.

Vid efterföljande besök på webbplatsen kontrollerar webbläsaren automatiskt om en nyare version av artefakten måste hämtas. Den här kontrollen lägger till fördröjning. TTL för artefaktcache anger hur många minuter du inte vill att webbläsaren ska kontrollera om det finns en uppdaterad artefakt sedan den senaste slutförda hämtningen. Ju längre tidsram, desto bättre prestanda. Ju kortare tidsram, desto bättre dataaktualitet, men till priset av extra latens.

Hur vet jag att en aktivitet är on-device decisioning valbar?

När du har skapat en aktivitet som on-device decisioning är en etikett som läser Berättigad att bestämma på enheten visas på aktivitetens översiktssida.

Valbar etikett på aktivitetens översiktssida för val på enhet.

Den här etiketten betyder inte att aktiviteten alltid levereras via on-device decisioning. Endast när at.js 2.5.0+ har konfigurerats att använda on-device decisioning kommer den här aktiviteten att köras på enheten. Om at.js 2.5.0+ inte är konfigurerad att använda på enheten kommer aktiviteten fortfarande att levereras via ett serveranrop som görs från at.js.

Du kan filtrera efter alla aktiviteter som on-device decisioning som är berättigade till bidrag på aktivitetssidan via filtret Berättigat till beslut på enheter.

Berättigat filter på sidan Aktiviteter för val på enhet.

NOTE
Efter att en aktivitet som on-device decisioning kan det ta fem till tio minuter innan det ingår i den regelartefakt som genereras och sprids till Akamai CDN.

Sammanfattning av steg för att säkerställa on-device decisioning aktiviteter levereras via At.js 2.5.0+?

  1. Öppna Adobe Target Gränssnitt och navigera till Administration > Implementation > Account Details för att aktivera On-Device Decisioning växla.

  2. Aktivera “Include all existing on-device decisioning qualified activities in the artifact” växla.

    Den första genereringen av JSON-regelartefakter kan ta upp till 10 minuter.

  3. Skapa och aktivera en aktivitetstyp som stöds av on-device decisioningoch verifiera att det är on-device decisioning berättigade.

  4. Ange Decisioning Method till antingen “Hybrid” eller “On-device only” via användargränssnittet för at.js-inställningarna.

  5. Ladda ned och driftsätt At.js 2.5.0+ på sidorna.

recommendation-more-help
6906415f-169c-422b-89d3-7118e147c4e3