On-device decisioning för at.js

Från och med version 2.5.0 erbjuder at.js on-device decisioning. Med On-device decisioning kan du cachelagra dina A/B Test - och Experience Targeting (XT)-aktiviteter i webbläsaren för att utföra minnesbaserad beslutsfattande utan någon blockerande nätverksbegäran till Edge Network Adobe Target.

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 on-device decisioning när prestanda är viktigast. 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 är:

Funktioner som stöds

JS SDK Adobe Target 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 att on-device decisioning ska fungera, se listan över funktioner som stöds:

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

Hur fungerar on-device decisioning?

När du distribuerar och initierar at.js med on-device decisioning aktiverat hämtas en regelartefakt som innehåller din on-device decisioning för A/B- och XT-aktiviteter, målgrupper och resurser från närmaste Akamai CDN till besökaren och cachelagras 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 introducerar Target 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å 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 i gränsnätverket Target, vilket innebär ett blockerande serveranrop. Den här metoden kan innebära inkrementell fördröjning, men den ger också avsevärda fördelar, som att du kan använda Targets maskininlärningsfunktioner som omfattar Recommendations-, Automated Personalization- (AP) och Automatiskt mål -aktiviteter.

Dessutom kan förbättringar av dina personaliserade upplevelser genom att använda användarprofilen för Target, som är beständig i olika sessioner och kanaler, ge ett kraftfullt resultat för ditt 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 diagram visar interaktionen mellan din besökare, webbläsaren, at.js 2.5.0+, och Adobe Target Edge-nätverket. Det här flödesdiagrammet fångar nya besökare och returnerar besökare.

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

Följande lista motsvarar siffrorna i diagrammet:

Endast på enheten

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

On-device decisioning kan leverera dina upplevelser och personaliseringsaktiviteter med blixtsnabb hastighet eftersom besluten fattas från en cache-lagrad regelartefakt som innehåller alla dina aktiviteter som är kvalificerade för on-device decisioning.

Mer information om vilka aktiviteter som är kvalificerade för on-device decisioning finns i 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 kommer Target-aktiviteter som inte är kvalificerade för on-device decisioning inte att levereras eller köras. 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.)

Följande lista motsvarar siffrorna i diagrammet:

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.)

Följande lista motsvarar siffrorna i diagrammet:

Hybrid

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

När du hanterar både on-device decisioning-aktiviteter och aktiviteter på serversidan kan det vara lite komplicerat och tråkigt att fundera på hur du ska distribuera och distribuera Target på dina sidor. Med hybridmetoden som beslutsmetod vet Target när det måste göra ett serveranrop till Edge-nätverket Adobe Target för aktiviteter som kräver körning på serversidan och även när endast enhetsbeslut ska verkställas.

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. Den här beslutsmetoden ser till att aktiviteter som du avser att leverera snabbt utförs via on-device decisioning och för aktiviteter som kräver mer kraftfull ML-driven personalisering utförs dessa aktiviteter via Adobe Target Edge-nätverket.

I följande diagram visas interaktionen mellan besökaren, webbläsaren, kl. 2.5.0+, Akamai CDN och Adobe Target Edge Network för att en ny besökare ska besöka din sida för första gången. Ingången från det här diagrammet är att JSON-regelartefakten hämtas asynkront medan besluten fattas via Edge-nätverket Adobe Target.

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.)

Följande lista motsvarar siffrorna i diagrammet:

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.)

Följande lista motsvarar siffrorna i diagrammet:

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:

När du har aktiverat växeln för On-Device Decisioning börjar Target generera och sprida regelartefakter för klienten.

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

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 valts i användargränssnittet för Target är konfigurerad i window.targetGlobalSettings under fältet decisioningMethod. Läs mer om decisioningMethod i 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 i window.targetGlobalSettings, men vill åsidosätta decisioningMethod för varje Adobe Target-beslut enligt ditt användningsexempel, kan du göra den här proceduren genom att ange decisioningMethod i getOffers() -anropet för At.js2.5.0+.

adobe.target.getOffers({

  decisioningMethod:"on-device",
  request: {
    execute: {
      mboxes: [
        {
          index: 0,
          name: "homepage"
        }
      ]
    }
 }
});

Cacheminne för felaktigheter

Målet representerar dina aktiviteter som är kvalificerade för 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ämtas och cachelagras den artefakt som representerar dina on-device decisioning-aktiviteter av användarens webbläsare.

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 berättigad?

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

Den här etiketten betyder inte att aktiviteten alltid levereras via on-device decisioning. Endast när at.js 2.5.0+ är konfigurerad 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 är on-device decisioning berättigade på aktivitetssidan via filtret Berättigat till beslut på enheten.

Sammanfattning av steg som säkerställer att mina on-device decisioning-aktiviteter levereras via At.js 2.5.0+?