Adobe Target en Web SDK gebruiken voor personalisatie

Adobe Experience Platform Web SDK kan persoonlijke ervaringen die in Adobe Target worden beheerd, leveren en renderen naar het webkanaal. U kunt een redacteur gebruiken WYSIWYG, genoemd de Visuele Composer van de Ervaring(VEC), of een niet-visuele interface, de Op vorm-gebaseerde Composer van de Ervaring, om, uw activiteiten en verpersoonlijkingservaringen tot stand te brengen te activeren en te leveren.

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

Web SDK systeemdiagram

In het volgende diagram krijgt u inzicht in de workflow voor het bepalen van randen in Target en Web SDK .

Adobe Target inschakelen

Ga als volgt te werk om Target in te schakelen:

Vervolgens kunt u desgewenst ook de volgende opties toevoegen:

Adobe Target VEC gebruiken

Om VEC met a Web SDK implementatie te gebruiken, installeer en activeer of Firefoxof de HelperUitbreiding van ChromeVEC.

Voor meer informatie, zie de helperuitbreiding van de Composer van de Visuele Ervaringin de gids van Adobe Target.

Aangepaste inhoud renderen

Zie teruggevend verpersoonlijkingsinhoudvoor meer informatie.

Soorten publiek in XDM

Wanneer het bepalen van publiek voor uw Target activiteiten die via Web SDK worden geleverd, XDMmoet worden bepaald en worden gebruikt. Nadat u XDM schema's, klassen, en de groepen van het schemagebied bepaalt, kunt u een Target publieksregel tot stand brengen die door XDM gegevens voor het richten wordt bepaald. Binnen Target worden XDM-gegevens in de Audience Builder weergegeven als een aangepaste parameter. De XDM wordt geserialiseerd met behulp van puntnotatie (bijvoorbeeld web.webPageDetails.name ).

Als u Target -activiteiten hebt met vooraf gedefinieerd publiek dat aangepaste parameters of een gebruikersprofiel gebruikt, worden deze 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 dat zich richt op velden die worden ondersteund via de Web SDK en die geen XDM vereisen. Deze velden zijn beschikbaar in de gebruikersinterface van Target waarvoor geen XDM vereist is:

Voor meer informatie, zie Categorieën voor publiekin de gids van Adobe Target.

Reactietokens

Reactietokens worden gebruikt om metagegevens naar derden, zoals Google of Facebook, te verzenden. Respontokens worden geretourneerd
in het meta -veld in 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 promise, propositions doorlopen en de details uit items -> meta extraheren.

Elke proposition heeft een renderAttempted booleaans veld dat aangeeft of de proposition is gerenderd 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

Met Web SDK kunt u het profiel als een ervaringsgebeurtenis bijwerken naar het Target -profiel en Web SDK .

Als u een Target -profiel wilt bijwerken, moet u ervoor zorgen dat de profielgegevens worden doorgegeven met het volgende:

de reddingsProfiel van de vertraging of entiteitsparameters tot de inhoud aan het eind - gebruiker is getoond

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

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. Verzend deze aanvragen met de markering __save 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 overeenkomende 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,
    "xdm": { /* Experience Event XDM data */ },
    "data": {
        "__adobe": {
            "target": {
                " __save": true|false,
                //defaults to true if omitted
                "profile.gender": "female",
                "profile.age": 30,
                "entity.name": "T-shirt",
                "entity.id": "1234"
            }
        }
    }
})

Aanbevelingen aanvragen

In de volgende tabel worden de Recommendations -kenmerken weergegeven en wordt aangegeven of elk kenmerk wordt ondersteund via Web SDK :

hoe te om de attributen van Recommendations naar Adobe Target te verzenden:

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

Mbox-omzettingscijfers weergeven display-mbox-conversion-metrics

In het onderstaande voorbeeld ziet u hoe u de conversies van weergavekaders kunt bijhouden en profielparameters naar Adobe Target kunt verzenden zonder dat u hiervoor in aanmerking hoeft te komen.

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

Foutopsporing

mboxTrace en mboxDebug zijn vervangen. Gebruik in plaats hiervan een methode van het zuiveren van SDK van het Web.

Terminologie

Voorstellen: in Adobe Target, correleert de voorstellen met de ervaring die van een Activiteit wordt geselecteerd.

Schema: het schema van een besluit is het type van aanbieding in Adobe Target.

Reikwijdte: het werkingsgebied van het besluit. In Adobe Target is het bereik de mBox. De algemene mBox is het __view__ bereik.

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