Gebruiken Adobe Target en Web SDK voor personalisatie

Adobe Experience Platform Web SDK kan persoonlijke ervaringen leveren en weergeven die worden beheerd in Adobe Target naar het webkanaal. U kunt een redacteur gebruiken WYSIWYG, genoemd Visual Experience Composer (VEC) of een niet-visuele interface Form-based Experience Composer, om uw activiteiten en personaliservaringen te maken, te activeren en te leveren.

De volgende functies zijn getest en worden momenteel ondersteund in Target:

Web SDK systeemdiagram

Het volgende diagram helpt u het werkschema van begrijpen Target en Web SDK randbeslissing.

Inschakelen Adobe Target

Inschakelen TargetGa als volgt te werk:

Vervolgens kunt u desgewenst ook de volgende opties toevoegen:

Adobe Target VEC gebruiken

Als u de VEC met een Web SDK de implementatie, installatie en activeer Firefox of Chroom VEC Helper Extension.

Zie voor meer informatie Helpextensie Visual Experience Composer in de Adobe Target-gids.

Aangepaste inhoud renderen

Zie Renderen van personalisatie-inhoud voor meer informatie .

Soorten publiek in XDM

Wanneer u een publiek voor uw Target activiteiten die via de Web SDK, XDM moeten worden gedefinieerd en gebruikt. Nadat u XDM schema's, klassen, en de groepen van het schemagebied bepaalt, kunt u tot een Target publieksregel gedefinieerd door XDM-gegevens voor doelversie. Within Target, XDM-gegevens worden weergegeven in de Audience Builder als een aangepaste parameter. XDM wordt geserialiseerd gebruikend puntaantekening (bijvoorbeeld) web.webPageDetails.name).

Als u Target activiteiten met vooraf gedefinieerde doelgroepen die aangepaste parameters of een gebruikersprofiel gebruiken, worden niet correct via de SDK geleverd. In plaats van aangepaste parameters of het gebruikersprofiel te gebruiken, moet u in plaats daarvan XDM gebruiken. Er is echter een out-of-the-box-publiek voor doelgebieden die worden ondersteund via de Web SDK die geen XDM vereisen. Deze velden zijn beschikbaar in het dialoogvenster Target UI die geen XDM vereist:

Zie voor meer informatie Categorieën voor soorten publiek in de Adobe Target-gids.

Reactietokens

Reactietokens worden gebruikt om metagegevens naar derden, zoals Google of Facebook, te verzenden. De tokens van de reactie zijn teruggekeerd in meta veld binnen propositions -> items. Hier volgt een voorbeeld:

{
  "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"
      }
    }
  ]
}

Als u de reactietokens wilt verzamelen, moet u zich abonneren op alloy.sendEvent beloven, doorlopen propositionsen haalt de gegevens uit items -> meta.

Elke proposition heeft een renderAttempted Booleaans veld dat aangeeft of de proposition is weergegeven of niet. Zie het onderstaande voorbeeld:

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);
  });

Wanneer automatische rendering is ingeschakeld, bevat de proposities-array:

Bij laden van pagina:

Bij weergave - wijzigen (voor weergaven in cache):

Wanneer automatische rendering is uitgeschakeld, bevat de proposities-array:

Bij laden van pagina:

Bij weergave - wijzigen (voor weergaven in cache):

Eén profiel bijwerken

De Web SDK Hiermee kunt u het profiel bijwerken naar de Target en de Web SDK als een ervaringsgebeurtenis.

Als u een Target , zorgt u ervoor dat de profielgegevens worden doorgegeven met het volgende:

Opslagprofiel of entiteitsparameters vertragen totdat de inhoud aan de eindgebruiker is weergegeven

Als u de opnamekenmerken in het profiel wilt vertragen totdat de inhoud is weergegeven, stelt u data.adobe.target._save=false in uw verzoek.

Uw website bevat bijvoorbeeld drie beslissingsbereiken die overeenkomen met drie categorielink op de website (Men, Vrouwen en Kinderen) en u wilt de categorie bijhouden die de gebruiker uiteindelijk heeft bezocht. Deze aanvragen verzenden met de __save markering ingesteld op false om te voorkomen dat de categorie blijft bestaan op het moment dat de inhoud wordt opgevraagd. Nadat de inhoud is weergegeven, verzendt u de juiste lading (inclusief de eventToken en stateToken) voor de desbetreffende kenmerken die moeten worden opgenomen.

In het onderstaande voorbeeld wordt een bericht in de stijl trackEvent verzonden, worden profielscripts uitgevoerd, worden kenmerken opgeslagen en wordt de gebeurtenis direct vastgelegd.

alloy ( "sendEvent" , {
  renderDecisions : true,
  data : {
    __adobe : {
      target : {
        "profile.gender" : "female",
        "profile.age" : 30,
        "entity.name" : "T-shirt" ,
        "entity.id" : "1234" ,
        "track": {
          "scopes": [ "mbox1", "mbox2"],
          "type": "display|click|..."
        }
      }
    }
  }
} ) ;

sendEventmet profielgegevens

alloy("sendEvent", {
   renderDecisions: true|false,
   xdm: { // Experience Event XDM data },
   data: { // Freeform data }
});

Profielkenmerken verzenden naar Adobe Target:

alloy("sendEvent", {
  "renderDecisions": true,
  "data": {
    "__adobe": {
      "target": {
        "profile.gender": "female",
        "profile.age": 30
      }
    }
  }
});

Aanbevelingen aanvragen

De volgende tabellijsten Recommendations kenmerken en of elk kenmerk wordt ondersteund via de Web SDK:

Recommendations-kenmerken verzenden naar Adobe Target:

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

Foutopsporing

mboxTrace en mboxDebug zijn vervangen. Een methode gebruiken WebSDK-foutopsporing in plaats daarvan.

Terminologie

Voorstellen: In Adobe Target, correleren met de ervaring die is geselecteerd uit een activiteit.

Schema: Het schema van een besluit is het soort aanbod in Adobe Target.

Toepassingsgebied: De reikwijdte van het besluit. In Adobe Target, het bereik is de mBox. De algemene mBox is de __view__ bereik.

XDM: XDM wordt geserialiseerd in puntnotatie en dan gezet in Adobe Target als mBox-parameters.