Adobe Target instellen met Platform Web SDK

Leer hoe u Adobe Target implementeert met Adobe Experience Platform Web SDK. Leer hoe u ervaringen kunt bieden en hoe u extra parameters aan Target kunt doorgeven.

Adobe Targetis de toepassing van Adobe Experience Cloud die alles verstrekt u uw klanten' ervaring moet aanpassen en personaliseren, zodat kunt u opbrengst op uw Web en mobiele plaatsen, apps, en andere digitale kanalen maximaliseren.

Leerdoelstellingen

Aan het eind van deze les, kunt u het volgende met een implementatie van SDK van het Web van Doel doen:

Vereisten

Om de lessen in deze sectie te voltooien, moet u eerst:

Flikkeringsafhandeling toevoegen

Bepaal voordat u begint of er een extra flikkerafhandelingsoplossing nodig is, afhankelijk van de manier waarop de tagbibliotheek is geladen.

Asynchrone implementatie

Wanneer een tagbibliotheek asynchroon wordt geladen, kan de pagina de rendering voltooien voordat Target de standaardinhoud heeft vervangen door gepersonaliseerde inhoud. Dit gedrag kan leiden tot wat "flikkering"wordt genoemd, waar de standaardinhoud kort toont alvorens door de gepersonaliseerde inhoud wordt vervangen. Als u deze flikkering wilt vermijden, raadt de Adobe aan een speciaal vooraf verborgen fragment toe te voegen vlak voor de asynchrone code voor het insluiten van tags.

Dit fragment is al aanwezig op de Luma-site, maar laten we eens nader kijken om te begrijpen wat deze code doet:

<script>
  !function(e,a,n,t){var i=e.head;if(i){
  if (a) return;
  var o=e.createElement("style");
  o.id="alloy-prehiding",o.innerText=n,i.appendChild(o),setTimeout(function(){o.parentNode&&o.parentNode.removeChild(o)},t)}}
  (document, document.location.href.indexOf("adobe_authoring_enabled") !== -1, ".personalization-container { opacity: 0 !important }", 3000);
</script>

Het vooraf verborgen fragment maakt een stijltag in de kop van de pagina met de CSS-definitie van uw keuze. Deze stijlmarkering wordt verwijderd wanneer een reactie van Doel wordt ontvangen, of de onderbreking wordt bereikt.

Het gedrag voor het voorverbergen wordt bepaald door twee configuraties helemaal aan het einde van het fragment.

Het voorverborgen fragment is ook beschikbaar binnen tags:

Synchrone implementatie

Adobe raadt u aan om tags asynchroon te implementeren, zoals op de Luministocatie wordt getoond. Als de tagbibliotheek echter synchroon wordt geladen, is het vooraf verborgen fragment niet vereist. In plaats daarvan, wordt de pre-verbergende stijl gespecificeerd in de de uitbreidingsmontages van SDK van het Web van het Platform.

De pre-verbergende stijl voor synchrone implementaties kan als volgt worden gevormd:

Om meer over te leren hoe SDK van het Web van het Platform flikkering kan leiden, kunt u naar de gids sectie verwijzen: die flikkering voor gepersonaliseerde ervaringenbeheert.

De gegevensstroom configureren

Het doel moet in de gegevensstroomconfiguratie worden toegelaten alvorens om het even welke activiteiten van het Doel door het Web SDK van het Platform kunnen worden geleverd.

Om Doel in de gegevensstroom te vormen:

Eigenschappentoken

Klanten van Target Premium hebben de mogelijkheid om gebruikersmachtigingen te beheren met eigenschappen. Met de doeleigenschappen kunt u grenzen vaststellen waar gebruikers doelactiviteiten kunnen uitvoeren. Verwijs naar de sectie van de Toestemmingen van de Ondernemingvan de documentatie van het Doel voor details.

Om bezitstokens te plaatsen of te vinden, navigeer aan Adobe Target > Administration > Properties. Het pictogram </> geeft de implementatiecode weer. De at_property -waarde is de eigenschap token die u in de gegevensstroom zou gebruiken.

Er kan slechts één eigenschapstoken per gegevensstroom worden opgegeven, maar met overschrijvingen van eigenschapstoken kunt u alternatieve eigenschapstokens opgeven ter vervanging van het primaire eigenschapstoken dat in de gegevensstroom is gedefinieerd. Een update van de handeling sendEvent is ook nodig om de gegevensstroom te overschrijven.

Id van doelomgeving

Milieu'sin de hulp van het Doel u uw implementatie door alle stadia van ontwikkeling beheert. Deze optionele instelling geeft aan welke doelomgeving u voor elke gegevensstroom wilt gebruiken.

De Adobe raadt aan om de ID van het Milieu van het Doel voor elk van uw ontwikkeling, het opvoeren, en productiegegevensstromen verschillend te plaatsen om dingen eenvoudig te houden. Alternatief, kunt u uw milieu's in de interface van het Doel organiseren gebruikend de gasthereneigenschap.

Om milieu IDs te plaatsen of te vinden, navigeer aan Adobe Target > Administration > Environments.

Doelnaamruimte voor id van derden

Met deze optionele instelling kunt u opgeven welk identiteitssymbool u wilt gebruiken voor de doel-id van derden. Het doel ondersteunt alleen profielsynchronisatie op één identiteitssymbool of naamruimte. Voor meer informatie, kunt u naar het in real time profiel verwijzen dat voor mbox3rdPartyIdsectie van de gids van het Doel synchroniseert.

De Symbolen van de Identiteit worden gevonden in de identiteitslijst onder Inzameling van Gegevens > Customer > Identities.

Voor dit leerprogramma dat de plaats van de Luma gebruikt, gebruik de opstelling van het Symbool van de Identiteit lumaCrmId tijdens de les over Identiteiten.

Besluiten over visuele personalisatie renderen

De visuele verpersoonlijkingsbesluiten verwijzen naar de ervaringen die in Adobe Target visuele ervaringscomposer worden gecreeerd. Eerst, zou u de terminologie moeten begrijpen die in het Doel wordt gebruikt en etiketteert interfaces:

De handeling Send event bijwerken

De visuele verpersoonlijkingsbesluiten van Doel worden geleverd door het Web SDK van het Platform, als het Doel in de datastream wordt toegelaten. Nochtans, worden zij niet automatisch teruggegeven. U moet de handeling Send event bijwerken om automatische rendering in te schakelen.

Renderen visuele verpersoonlijkingsbesluiten die tot het Web SDK van het Platform automatisch om het even welke wijzigingen toepassen die gebruikend Composer van de Ervaring van het Doel Visuele of "globale mbox"werden gespecificeerd.

Als u deze beslissingen liever zelf rendert of activeert met behulp van aangepaste code, kunt u de instelling Render visual personalization decisions uitgeschakeld laten. De SDK van het Web van het platform is flexibel en verstrekt dit vermogen om u volledige controle te geven. U kunt naar de gids voor meer informatie over verwijzen manueel teruggevend gepersonaliseerde inhoud.

Opstelling een activiteit van het Doel met Visuele Composer van de Ervaring

Nu het basisgedeelte van de implementatie volledig is, creeer een Ervaring richtend (XT) activiteit in Doel om te bevestigen dat alles correct werkt. U kunt naar het leerprogramma van het Doel voor het creëren van Ervaring richten activiteitenverwijzen als u hulp nodig hebt.

Valideren met Foutopsporing

Als u een activiteit instelt, wordt de inhoud weergegeven op de pagina. Nochtans, zelfs als geen activiteiten levend zijn, kunt u de Send het netwerkvraag van de Gebeurtenis ook bekijken om te bevestigen dat het Doel behoorlijk wordt gevormd.

Een aangepast beslissingsbereik instellen en maken

Het besluitvormingswerkingsgebied van de douane (vroeger genoemd geworden "mboxes") kan worden gebruikt om HTML of inhoud JSON op een gestructureerde manier te leveren gebruikend de Vorm-Gebaseerde Composer van de Ervaring van het Doel. De inhoud die aan één van deze douanewerkingsgebied wordt geleverd wordt niet automatisch teruggegeven door het Web SDK van het Platform. Het kan worden teruggegeven gebruikend een actie in Markeringen.

Een bereik toevoegen aan de Send event action

Wijzig de regel voor het laden van de pagina om een aangepast beslissingsbereik toe te voegen:

De reactie van Doel verwerken

Nu u SDK van het Web van het Platform hebt gevormd om inhoud voor het homepage-hero werkingsgebied te verzoeken, moet u iets met de reactie doen. De de markeringsuitbreiding van SDK van het Web van het Platform verstrekt een Send Event Complete gebeurtenis, die kan worden gebruikt om een nieuwe regel onmiddellijk teweeg te brengen wanneer een reactie van een Send Event actie wordt ontvangen.

Een doelactiviteit instellen met de Form-based Experience Composer

Nu u een regel hebt om een gebied van de douanebeslissing manueel terug te geven, kunt u een andere Ervaring creëren richtend (XT) activiteit in Doel. Dit keer gebruikt u de Form-Based Experience Composer.

Valideren met Foutopsporing

Als u uw activiteit hebt geactiveerd, wordt de inhoud weergegeven op de pagina. Maar zelfs als er geen activiteiten actief zijn, kunt u ook naar de Send Event -netwerkaanroep kijken om te bevestigen dat Target inhoud aanvraagt voor uw aangepaste bereik.

Parameters naar doel verzenden

In deze sectie, zult u specifiek doel-specifieke gegevens overgaan en een dichtere blik nemen bij hoe de gegevens XDM aan de parameters van het Doel in kaart worden gebracht.

Parameters pagina (mbox) en XDM

Alle gebieden XDM worden automatisch overgegaan tot Doel als paginaparametersof mbox parameters.

Sommige van deze XDM-velden worden toegewezen aan speciale objecten op de achtergrond van Target. web.webPageDetails.URL is bijvoorbeeld automatisch beschikbaar voor het maken van op URL gebaseerde doelvoorwaarden of als het page.url -object bij het maken van profielscripts.

U kunt ook paginaparameters toevoegen met het gegevensobject.

Speciale parameters en het gegevensobject

Er zijn enkele gegevenspunten die nuttig kunnen zijn voor Doel en die niet zijn toegewezen vanuit het XDM-object. Deze speciale doelparameters zijn onder meer:

Deze parameters moeten in het object data worden verzonden in plaats van in het object xdm . Bovendien kunnen pagina- (of mbox-)parameters ook in het data -object worden opgenomen.

Om het gegevensvoorwerp te bevolken, creeer het volgende gegevenselement, hergebruikend gegevenselementen die in worden gecreeerd gegevenselementenles creëren:

De regel voor het laden van de pagina bijwerken

Als u aanvullende gegevens voor Doel buiten het XDM-object wilt doorgeven, moet u alle toepasselijke regels bijwerken. Voor dit voorbeeld, moet de enige wijziging u maken het nieuwe {gegevenselement 0} data.content aan de generische de regel van de paginalading en van de productpagina meningsregel omvatten.

Personalization- en analyseverzoeken splitsen

De gegevenslaag op de Luminasite is volledig gedefinieerd voordat de tags code insluiten. Op deze manier kunnen we een enkele oproep doen om persoonlijke inhoud op te halen (bijvoorbeeld vanuit Adobe Target) en analysegegevens te verzenden (bijvoorbeeld naar Adobe Analytics).

Op vele websites, echter, kan de gegevenslaag niet vroeg genoeg of snel genoeg worden geladen om één enkele vraag voor beide toepassingen te gebruiken. In dergelijke situaties kunt u twee Send event -acties gebruiken voor één pagina die wordt geladen, de eerste acties voor personalisatie en de tweede acties voor analyse. Door de gebeurtenissen op deze manier op te splitsen, kan de verpersoonlijkingsgebeurtenis zo vroeg mogelijk worden geactiveerd, terwijl wordt gewacht tot de gegevenslaag volledig is geladen voordat de gebeurtenis Analytics wordt verzonden. Dit is vergelijkbaar met veel implementaties van SDK vóór het web, waarbij Adobe Target de target-global-mbox boven aan de pagina in brand zou steken en Adobe Analytics de s.t() -aanroep onder aan de pagina zou starten

Om verpersoonlijking-op-hoogste verzoek tot stand te brengen:

U kunt als volgt het verzoek Analytics-on-bottom maken:

Valideren met Foutopsporing

Nu de regels zijn bijgewerkt, kunt u controleren of de gegevens correct worden doorgegeven met de Adobe Debugger.

Valideren in de interface Doel

Daarna, kijk in de interface van het Doel om te bevestigen dat de gegevens werden ontvangen en beschikbaar om in publiek en activiteiten te gebruiken zijn. XDM-gegevens worden automatisch toegewezen aan aangepaste doelparameters. U kunt controleren of XDM-gegevens door Target zijn ontvangen en beschikbaar zijn door een publiek te maken.

Controleer vervolgens of het kenmerk voor het profiel van de aanmeldingsstatus is geslaagd.

Als u Target Premium hebt, kunt u ook controleren of de eenheidgegevens correct zijn doorgegeven en de productgegevens naar de Recommendations-productcatalogus zijn geschreven.

Valideren met betrouwbaarheid

Bovendien kunt u Verzekering waar nodig gebruiken om de het besluitvormingsverzoeken van het Doel te bevestigen krijgen de correcte gegevens en dat om het even welke server zijtransformaties correct voorkomen. U kunt campagne en ervaringsinformatie ook bevestigen is bevat in de vraag van Adobe Analytics zelfs wanneer het besluit van het Doel en de vraag van Adobe Analytics afzonderlijk worden verzonden.

Dit bevestigt dat de informatie A4T die voor recentere transmissie een rij werd gevormd toen wij de vraag van het doelbesluit maakten behoorlijk werd verzonden wanneer de analytische volgende vraag later op de pagina in brand werd gestoken.

Nu u deze les hebt voltooid zou u een werkende implementatie van Adobe Target moeten hebben gebruikend het Web SDK van het Platform.

Volgende: