Använd Adobe Target och Web SDK för personalisering

Adobe Experience Platform Web SDK kan leverera och återge personaliserade upplevelser som hanteras i Adobe Target till webbkanalen. Du kan använda en WYSIWYG-redigerare, som kallas Visual Experience Composer (VEC), eller ett icke-visuellt gränssnitt, formulärbaserad Experience Composer, för att skapa, aktivera och leverera dina aktiviteter och personaliseringsupplevelser.

Följande funktioner har testats och stöds för närvarande i Target:

Web SDK systemdiagram

Följande diagram hjälper dig att förstå arbetsflödet för Target- och Web SDK-kantbeslut.

Aktiverar Adobe Target

Så här aktiverar du Target:

Du kan sedan även lägga till följande alternativ:

Använda Adobe Target VEC

Om du vill använda VEC med en Web SDK-implementering installerar och aktiverar du Firefoxeller Chrome VEC Helper Extension.

Mer information finns i Hjälptillägg för Visual Experience Composer i Adobe Target-handboken.

Återge personaliserat innehåll

Mer information finns i Återge anpassat innehåll.

Målgrupper i XDM

När du definierar målgrupper för dina Target-aktiviteter som levereras via Web SDK måste XDM definieras och användas. När du har definierat XDM-scheman, klasser och schemafältgrupper kan du skapa en Target målgruppsregel som definieras av XDM-data för målgruppsanpassning. I Target visas XDM-data i Audience Builder som en anpassad parameter. XDM serialiseras med punktnotation (till exempel web.webPageDetails.name).

Om du har Target aktiviteter med fördefinierade målgrupper som använder anpassade parametrar eller en användarprofil levereras de inte korrekt via SDK. I stället för att använda egna parametrar eller användarprofilen måste du använda XDM i stället. Det finns dock färdiga målgruppsfält som stöds via Web SDK och som inte kräver XDM. De här fälten är tillgängliga i användargränssnittet Target som inte kräver XDM:

Mer information finns i Kategorier för målgrupper i Adobe Target-handboken.

Svarstoken

Svarstoken används för att skicka metadata till tredje part som Google eller Facebook. Svarstoken returneras
i fältet meta i propositions -> items. Här följer ett exempel:

{
  "id": "AT:eyJhY3Rpdml0eUlkIjoiMTI2NzM2IiwiZXhwZXJpZW5jZUlkIjoiMCJ9",
  "scope": "__view__",
  "scopeDetails": ...,
  "renderAttempted": true,
  "items": [
    {
      "id": "0",
      "schema": "https://ns.adobe.com/personalization/dom-action",
      "meta": {
        "experience.id": "0",
        "activity.id": "126736",
        "offer.name": "Default Content",
        "offer.id": "0"
      }
    }
  ]
}

Om du vill samla in svarstoken måste du prenumerera på alloy.sendEvent, iterera genom propositions och extrahera informationen från items -> meta.

Varje proposition har ett renderAttempted booleskt fält som anger om proposition återgavs eller inte. Se exemplet nedan:

alloy("sendEvent",
  {
    "renderDecisions": true,
    "decisionScopes": [
      "hero-container"
    ]
  }).then(result => {
    const { propositions } = result;

    // filter rendered propositions
    const renderedPropositions = propositions.filter(proposition => proposition.renderAttempted === true);

    // collect the item metadata that represents the response tokens
    const collectMetaData = (items) => {
      return items.filter(item => item.meta !== undefined).map(item => item.meta);
    }

    const pageLoadResponseTokens = renderedPropositions
      .map(proposition => collectMetaData(proposition.items))
      .filter(e => e.length > 0)
      .flatMap(e => e);
  });

När automatisk återgivning är aktiverat innehåller propositionsarrayen:

Vid sidinläsning:

I vyn - ändra (för cachelagrade vyer):

När automatisk återgivning är inaktiverat innehåller propositionsarrayen:

Vid sidinläsning:

I vyn - ändra (för cachelagrade vyer):

Uppdatering av en profil

Med Web SDK kan du uppdatera profilen till Target-profilen och till Web SDK som en upplevelsehändelse.

Om du vill uppdatera en Target-profil kontrollerar du att profildata skickas med följande:

Fördröj sparandet av profil- eller enhetsparametrar tills innehållet har visats för slutanvändaren

Om du vill fördröja inspelningsattribut i profilen tills innehållet visas anger du data.adobe.target._save=false i din begäran.

Till exempel innehåller din webbplats tre beslutsomfattningar som motsvarar tre kategorilänkar på webbplatsen (Män, Kvinnor och barn) och du vill spåra den kategori som användaren slutligen besökte. Skicka dessa förfrågningar med flaggan __save inställd på false för att undvika att kategorin bevaras när innehållet begärs. När innehållet har visualiserats skickar du rätt nyttolast (inklusive eventToken och stateToken) för motsvarande attribut som ska registreras.

Exemplet nedan skickar ett trackEvent-liknande meddelande, kör profilskript, sparar attribut och registrerar omedelbart händelsen.

alloy("sendEvent", {
    "renderDecisions": true,
    "data": {
        "xdm": { // Experience Event XDM data },
            "__adobe": {
                "target": {
                    " __save": true|false,
                    //defaults to true if omitted
                    "profile.gender": "female",
                    "profile.age": 30,
                    "entity.name": "T-shirt",
                    "entity.id": "1234"
                }
            }
        }
    }
})

Begär rekommendationer

I följande tabell visas Recommendations attribut och om vart och ett stöds via Web SDK:

Så här skickar du Recommendations-attribut till Adobe Target:

alloy("sendEvent", {
  "renderDecisions": true,
  "data": {
    "__adobe": {
      "target": {
        "entity.id": "123",
        "entity.genre": "Drama"
      }
    }
  }
});

Visa konverteringsmått för mbox display-mbox-conversion-metrics

Exemplet nedan visar hur du kan spåra konverteringar av visningsrutor och skicka profilparametrar till Adobe Target, utan att behöva kvalificera dig för något innehåll eller någon aktivitet.

alloy("sendEvent", {
    "xdm": {
        "_experience": {
            "decisioning": {
                "propositions": [{
                    "scope": "conversion-step-1" //example scope name
                }],
                "propositionEventType": {
                    "display": 1
                }
            }
        },
        "eventType": "decisioning.propositionDisplay"
    }
});

Felsökning

mboxTrace och mboxDebug har tagits bort. Använd en metod för Web SDK-felsökning i stället.

Terminologi

Föreslag: I Adobe Target korrelerar förslag till upplevelsen som väljs från en aktivitet.

Schema: Schemat för ett beslut är typen av erbjudande i Adobe Target.

Scope: Beslutets omfattning. I Adobe Target är omfattningen mBox. Den globala mBox är __view__-scopet.

XDM: XDM serialiseras till punktnotation och placeras sedan i Adobe Target som mBox-parametrar.