Upgrade uitvoeren vanaf 0,js 1.x aan at.js 2.x

De nieuwste versie van at.js in Adobe Target biedt rijke functiesets die uw bedrijf uitrusten om personalisatie uit te voeren op client-side technologieën van de volgende generatie. Deze nieuwe versie wordt geconcentreerd op bevordering at.js om harmonieuze interactie met enige paginatoepassingen (SPAs) te hebben.

Hier volgen enkele voordelen van het gebruik van at.js 2.x die niet beschikbaar in vorige versies zijn:

te.js 2.x systeemdiagrammen

De volgende diagrammen helpen u het werkschema van at.js 2 begrijpen.x met Meningen en hoe dit de integratie van het KUUROORD verbetert. Een betere introductie van de concepten die worden gebruikt in at.js 2.x, zie ​ Enige implementatie van de Toepassing van de Pagina ​.

(Klik op de afbeelding om deze uit te breiden naar de volledige breedte.)

{modal="regular"}

Nu, waar triggerView() op uw SPA wordt uitgevoerd, worden de Meningen en de acties teruggewonnen van geheim voorgeheugen en aan de gebruiker zonder een servervraag getoond. triggerView() vraagt ook een melding naar de Target -backend om het aantal impressies te verhogen en op te nemen.

(Klik op de afbeelding om deze uit te breiden naar de volledige breedte.)

{modal="regular"}

Implementeer om.js 2.x

Implementeer om.js 2.x via markeringen in ​ Adobe Experience Platform ​ uitbreiding.

Vervangen at.js-functies

Er zijn verschillende functies die zijn vervangen in at.js 2.x.

U kunt de vervangen functies en hun tegenhanger hieronder vinden. Voor een volledige lijst van functies, zie ​ at.js functies ​.

mboxCreate(mbox,params)

Beschrijving:

Voert een aanvraag uit en past de aanbieding toe op de dichtstbijzijnde DIV met de klassenaam mboxDefault .

Voorbeeld:

<div class="mboxDefault">
  default content to replace by offer
</div>
<script>
  mboxCreate('mboxName','param1=value1','param2=value2');
</script>

at.js 2.x equivalent

Een alternatief voor mboxCreate(mbox, params) is getOffer() en applyOffer() .

Voorbeeld:

<div class="mboxDefault">
  default content to replace by offer
</div>
<script>
  var el = document.currentScript.previousElementSibling;
  adobe.target.getOffer({
    mbox: "mboxName",
    params: {
      param1: "value1",
      param2: "value2"
    },
    success: function(offer) {
      adobe.target.applyOffer({
        mbox: "mboxName",
        selector: el,
        offer: offer
      });
    },
    error: function(error) {
      console.error(error);
      el.style.visibility = "visible";
    }
  });
</script>

mboxDefine() en mboxUpdate()

Beschrijving:

Maakt een interne toewijzing tussen een element en een naam van een box, maar voert de aanvraag niet uit. Wordt gebruikt in combinatie met mboxUpdate() , die de aanvraag uitvoert en de aanbieding toepast op het element dat wordt geïdentificeerd door de nodeId in mboxDefine() . Kan ook worden gebruikt om een door mboxCreate geïnitieerde box bij te werken.

Voorbeeld:

<div id="someId" class="mboxDefault"></div>
<script>
 mboxDefine('someId','mboxName','param1=value1','param2=value2');
 mboxUpdate('mboxName','param3=value3','param4=value4');
</script>

at.js 2.x equivalent:

Een alternatief voor mboxDefine() en mboxUpdate is getOffer() en applyOffer() , met de selectoroptie gebruikt in applyOffer() . Met deze methode kunt u de aanbieding aan een element toewijzen met elke CSS-kiezer, niet alleen met een id.

Voorbeeld:

<div id="someId" class="mboxDefault">
  default content to replace by offer
</div>
<script>
  adobe.target.getOffer({
    mbox: "mboxName",
    params: {
      param1: "value1",
      param2: "value2",
      param3: "value3",
      param4: "value4"
    },
    success: function(offer) {
      adobe.target.applyOffer({
        mbox: "mboxName",
        selector: "#someId",
        offer: offer
      });
    },
    error: function(error) {
      console.error(error);
      var el = document.getElementById("someId");
      el.style.visibility = "visible";
    }
  });
</script>

adobe.target.registerExtension()

Beschrijving:

Verstrekt een standaardmanier om een specifieke uitbreiding te registreren.

Dit wordt niet meer ondersteund en mag niet worden gebruikt.

Overzicht van vervangen, nieuwe en ondersteunde at.js-functies in 2.x

Beperkingen en callouts

Houd rekening met de volgende beperkingen en bijschriften:

Conversie bijhouden

Klanten die mboxCreate() gebruiken voor het bijhouden van conversies, moeten trackEvent() of getOffer() gebruiken.

Levering aanbieden

Klanten die mboxCreate() niet vervangen door getOffer() of applyOffer() , lopen het risico dat er geen voorstellen worden geleverd.

Mag om.js 2.x wordt gebruikt op sommige pagina’s terwijl at.js 1.x is op andere pagina’s?

Ja, het bezoekersprofiel blijft op alle pagina’s behouden met verschillende versies en bibliotheken. De cookieindeling is hetzelfde.

Nieuw API-gebruik in at.js 2.x

te.js 2.x gebruikt nieuwe API, die wij levering API roepen. Om te zuiveren of at.js correct de Target randserver roept, kunt u het lusje van het Netwerk van de Hulpmiddelen van de Ontwikkelaar van uw browser aan “levering”, "tt.omtrdc.net,"of uw cliëntcode filtreren. U zult ook merken dat Target een JSON-lading verzendt in plaats van sleutel-waardeparen.

Target Globale box wordt niet meer gebruikt

In at.js 2.x, ziet u niet meer "target-global-mbox"zichtbaar in de netwerkvraag. In plaats daarvan hebben we de syntaxis “target-global-mbox” vervangen in “execute > pageLoad” in de JSON-lading die naar de Target -servers wordt verzonden, zoals hieronder wordt getoond:

{
  "id": {
    // ...
  },
  "context": {
    "channel": "web",
    // ...
  },
  "execute": {
    "pageLoad": {}
  }
}

Het algemene mbox-concept is geïntroduceerd om Target te laten weten of aanbiedingen en inhoud moeten worden opgehaald tijdens het laden van de pagina. Daarom hebben we dit in onze nieuwste versie duidelijker gemaakt.

Maakt de globale naam van de box in at.js nog uit?

Klanten kunnen de naam van een globale box opgeven via Target > Administration > Implementation > Edit at.js Settings . Deze instelling wordt door de Edge-servers van Target gebruikt om uitvoering > pageLoad om te zetten in de algemene naam van het selectievakje die in de gebruikersinterface van Target wordt weergegeven. Hierdoor kunnen klanten API’s aan de serverzijde, de op formulieren gebaseerde composer, profielscripts blijven gebruiken en een publiek maken met de algemene mbox-naam. We raden u ten zeerste aan om ook ervoor te zorgen dat dezelfde algemene naam van het selectievakje is geconfigureerd op de pagina Administration > Visual Experience Composer , voor het geval dat er nog pagina’s zijn die at.js 1 gebruiken.x, zoals aangetoond in de volgende illustraties.

en

Moet de instelling voor automatisch maken van globale mbox worden ingeschakeld voor at.js 2.x?

In de meeste gevallen ja. Deze instelling vertelt at.js 2.x om een verzoek aan de Target Edge servers op paginading in brand te steken. Omdat globale mbox wordt vertaald om uit te voeren > pageLoad, en als u een verzoek op paginading wilt in werking stellen, dan zou deze het plaatsen moeten zijn.

Zal de bestaande activiteiten VEC blijven werken, hoewel de doel globale mbox naam niet van at.js 2 wordt gespecificeerd.x?

Ja, omdat execute > pageLoad op de Target backend wordt behandeld als target-global-mbox .

Als mijn op vorm-gebaseerde activiteiten aan target-global-mbox worden gericht, zullen die activiteiten blijven werken?

Ja, omdat execute > pageLoad op de Target edge servers wordt behandeld zoals target-global-mbox .

Ondersteund en niet-ondersteund at.js 2.x Montages

Ondersteuning voor interdomeintracering in at.js 2.x

Met interdomeinspatiëring kunt u bezoekers aan elkaar koppelen in verschillende domeinen. Omdat voor elk domein een nieuwe cookie moet worden gemaakt, is het moeilijk bezoekers bij te houden wanneer ze van domein naar domein navigeren. Target gebruikt een cookie van een andere fabrikant om bezoekers in verschillende domeinen bij te houden. Op deze manier kunt u een Target -activiteit maken die siteA.com en siteB.com omvat en bezoekers in dezelfde ervaring blijven wanneer ze door unieke domeinen navigeren. Deze functionaliteit past in het cookie-gedrag van derden en van andere bedrijven van Target.

In Target wordt het cookie van derden opgeslagen in <CLIENTCODE>.tt.omtrdc.net . Het cookie van de eerste partij wordt opgeslagen in clientdomain.com . De eerste aanvraag retourneert HTTP-antwoordheaders die proberen cookies van derden met de naam mboxSession en mboxPC in te stellen, terwijl een omleidingsverzoek wordt teruggestuurd met een extra parameter (mboxXDomainCheck=true). Als de browser cookies van derden accepteert, bevat de omleidingsaanvraag deze cookies en wordt de ervaring geretourneerd. Deze workflow is mogelijk omdat we de HTTP GET-methode gebruiken.

In punt 2.js.x, wordt HTTP GET niet gebruikt. In plaats daarvan wordt HTTP POST gebruikt via at.js 2.x om JSON- nuttige ladingen naar Target servers van Edge te verzenden. Het gebruiken van HTTP POST betekent het omleidingsverzoek om te controleren of browser derde koekjes zal breken. Dit komt doordat HTTP GET-aanvragen epidemiologische transacties zijn, terwijl HTTP POST niet-epidemiologisch is en niet willekeurig mag worden herhaald. Daarom is het volgen tussen domeinen in at.js 2.x (voorafgaand aan 2.10) wordt niet gesteund uit de doos. Alleen om.js 1.x heeft uit-van-de-doos steun voor dwars-domein het volgen.

Als u interdomeintracering wilt gebruiken voor at.js v2.10 of hoger, kunt u een van de volgende handelingen uitvoeren:

Interdomeintracering gebruiken voor versies van at.js v2.x voorafgaand aan 2.10, kunt u optie #1 hierboven uitvoeren (installeer de bibliotheek ECID).

Automatisch globale box maken wordt ondersteund

Deze instelling vertelt at.js 2.x om een verzoek aan de Target Edge servers op pagina-lading in brand te steken. Omdat het algemene mbox wordt vertaald om > pageLoad uit te voeren, en dit wordt geïnterpreteerd door de Target Edge-servers, moeten klanten dit inschakelen als ze een aanvraag willen indienen bij het laden van een pagina.

Algemene naam van box wordt ondersteund

Klanten kunnen de naam van een globale box opgeven via Target > Administration > Implementation > Edit . Deze instelling wordt door de Edge-servers van Target gebruikt om uitvoering > pageLoad om te zetten in de ingevoerde algemene naam van het selectievakje. Hierdoor kunnen klanten API’s aan de serverzijde, de op formulieren gebaseerde composer, profielscripts blijven gebruiken en een publiek maken dat zich richt op de algemene box.

Zijn de onderstaande aangepaste gebeurtenissen at.js van toepassing op triggerView() of is het alleen voor applyOffer() of applyOffers() ?

Ja, de aangepaste gebeurtenissen at.js zijn ook van toepassing op triggerView() .

Er staat: wanneer ik triggerView() aanroep met &stempel;accolade; "page" : "true" &trace; er wordt een melding naar de Target -backend verzonden en de indruk vergroot. Zorgt het er ook voor dat de profielscripts worden uitgevoerd?

Wanneer een prefetch-aanroep naar de Target backend wordt gemaakt, worden de profielscripts uitgevoerd. Daarna worden de profielgegevens gecodeerd en teruggestuurd naar de clientzijde. Nadat triggerView() met {"page": "true"} is aangeroepen, wordt een melding samen met de gecodeerde profielgegevens verzonden. Dit is wanneer de Target backend dan de profielgegevens zal decrypteren en in de gegevensbestanden opslaat.

Moeten we code toevoegen die u vooraf verbergt voordat u triggerView() aanroept om flikkering te beheren?

Nee, u hoeft geen voorverborgen code toe te voegen voordat u triggerView() aanroept. te.js 2.x beheert het pre-verbergen en flikkeren logica alvorens de mening wordt getoond en toegepast.

welke om.js 1.x parameters voor het creëren van publiek worden niet gesteund in at.js 2.x?

De volgende parameters at.js 1.x worden NIET momenteel gesteund voor publieksverwezenlijking wanneer het gebruiken van at.js 2.x:

te.js 2.x steunt het creëren van publiek niet gebruikend vst.* parameters

Klanten op om.js 1.x kon vst gebruiken.* mbox-parameters om een publiek te maken. Dit was een onbedoeld neveneffect van hoe at.js 1.x verzond mbox parameters naar het Target achterste eind. Na het migreren naar om.js 2.x, kunt u geen publiek meer tot stand brengen gebruikend deze parameters omdat at.js 2.x verzendt verschillend mbox parameters.

at.js-compatibiliteit

In de volgende tabellen wordt om .js uitgelegd. 2.x verenigbaarheid met verschillende activiteitentypes, integratie, eigenschappen, en functies at.js.

Typen activiteiten

Integraties

Functies

Parameters van queryreeks

Reactietokens

te.js 2.x, enkel als at.js 1.x, gebruikt de douanegebeurtenis at-request-succeeded aan tokens van de oppervlakreactie. Voor codevoorbeelden die de at-request-succeeded douanegebeurtenis gebruiken, zie ​ Tokens van de Reactie ​.

te.js 1.x parameters aan at.js 2.x lading afbeelding

In deze sectie worden de toewijzingen tussen at.js 1 beschreven.x en at.js 2.x.

Voordat u gaat overstappen op parametertoewijzing, zijn de eindpunten die in deze bibliotheekversies worden gebruikt, gewijzigd:

Een ander belangrijk verschil is dat:

De volgende secties maken een lijst van elk bij.js 1.x parameter, zijn beschrijving, en overeenkomstige 2.x nuttige lading JSON (als toepasselijk):

at_property

(te.js 1.x parameter)

Gebruikt voor ​ Toestemmingen van de Gebruiker van de Onderneming ​.

{
  ....
  "property": {
    "token": "1213213123122313121"
  }
  ....
}

mboxHost

(te.js 1.x parameter)

Het domein van de pagina waarop de Target -bibliotheek wordt uitgevoerd.

te.js 2.x lading JSON:

{
  "context": {
    "browser": {
       "host": "test.com"
    }
  }
}

webGLRenderer

(te.js 1.x parameter)

De WEB GL-renderermogelijkheden van de browser. Dit wordt gebruikt door ons mechanisme voor apparaatdetectie om te bepalen of het apparaat van de bezoeker een bureaublad, iPhone, Android, enz. is.

te.js 2.x lading JSON:

{
  "context": {
    "browser": {
       "webGLRenderer": "AMD Radeon Pro 560X OpenGL Engine"
    }
  }
}

mboxURL

(te.js 1.x parameter)

De pagina-URL.

te.js 2.x lading JSON:

{
  "context": {
    "address": {
       "url": "http://test.com"
    }
  }
}

mboxReferrer

(te.js 1.x parameter)

De paginareferentie.

te.js 2.x lading JSON:

{
  "context": {
    "address": {
       "referringUrl": "http://google.com"
    }
  }
}

mbox (de naam) is gelijk aan global mbox

(te.js 1.x parameter)

Delivery API heeft niet langer een globaal mbox-concept. In de JSON-payload moet u execute > pageLoad gebruiken.

te.js 2.x lading JSON:

{
  "execute": {
    "pageLoad": {
       "parameters": ....
       "profileParameters": ...
       .....
    }
  }
}

mbox (de naam) is niet gelijk aan globale mbox

(te.js 1.x parameter)

Als u de naam van een vak wilt gebruiken, geeft u deze door aan execute > mboxes . Een box vereist een index en een naam.

te.js 2.x lading JSON:

{
  "execute": {
    "mboxes": [{
       "index": 0,
       "name": "some-mbox",
       "parameters": ....
       "profileParameters": ...
       .....
    }]
  }
}

mboxId

(te.js 1.x parameter)

Niet meer gebruikt.

mboxCount

(te.js 1.x parameter)

Niet meer gebruikt.

mboxRid

(te.js 1.x parameter)

Id van verzoek die door stroomafwaartse systemen wordt gebruikt om met het zuiveren te helpen.

te.js 2.x lading JSON:

{
  "requestId": "2412234442342"
  ....
}

mboxTime

(te.js 1.x parameter)

Niet meer gebruikt.

mboxSession

(te.js 1.x parameter)

Identiteitskaart van de zitting wordt verzonden als parameter van het vraagkoord (sessionId) aan het leverings API eindpunt.

mboxPC

(te.js 1.x parameter)

De TNT-id wordt doorgegeven aan id > tntId .

te.js 2.x lading JSON:

{
  "id": {
    "tntId": "ca5ddd7e33504c58b70d45d0368bcc70.21_3"
  }
  ....
}

mboxMCGVID

(te.js 1.x parameter)

Marketing Cloud-bezoeker-id wordt doorgegeven aan id > marketingCloudVisitorId .

te.js 2.x lading JSON:

{
  "id": {
    "marketingCloudVisitorId": "797110122341429343505"
  }
  ....
}

vst.aaaa.id en vst.aaaa.authState

(te.js 1.x parameters)

Klantnamen moeten worden doorgegeven aan id > customerIds .

te.js 2.x lading JSON:

{
  "id": {
    "customerIds": [{
       "id": "1232131",
       "integrationCode": "aaaa",
       "authenticatedState": "....."
     }]
  }
  ....
}

mbox3rdPartyId

(te.js 1.x parameter)

Id van derde partij van klant die wordt gebruikt om verschillende Target id’s te koppelen.

te.js 2.x lading JSON:

{
  "id": {
    "thirdPartyId": "1232312323123"
  }
  ....
}

mboxMCSDID

(te.js 1.x parameter)

SDID, ook wel Supplemental Data ID genoemd. Moet worden doorgegeven aan experienceCloud > analytics > supplementalDataId .

te.js 2.x lading JSON:

{
  "experienceCloud": {
    "analytics": {
      "supplementalDataId": "1212321132123131"
    }
  }
  ....
}

vst.trk

(te.js 1.x parameter)

Analytics tracking-server. Moet worden doorgegeven aan experienceCloud > analytics > trackingServer .

te.js 2.x lading JSON:

{
  "experienceCloud": {
    "analytics": {
      "trackingServer": "analytics.test.com"
    }
  }
  ....
}

vst.trks

(te.js 1.x parameter)

Beveiliging van de analytische trackingserver. Moet worden doorgegeven aan experienceCloud > analytics > trackingServerSecure .

te.js 2.x lading JSON:

{
  "experienceCloud": {
    "analytics": {
      "trackingServerSecure": "secure-analytics.test.com"
    }
  }
  ....
}

mboxMCGLH

(te.js 1.x parameter)

Tip voor Audience Manager-locatie. Moet worden doorgegeven aan experienceCloud > audienceManager > locationHint .

te.js 2.x lading JSON:

{
  "experienceCloud": {
    "audienceManager": {
      "locationHint": 9
    }
  }
  ....
}

mboxAAMB

(te.js 1.x parameter)

Audience Manager blob. Moet worden doorgegeven aan experienceCloud > audienceManager > blob .

te.js 2.x lading JSON:

{
  "experienceCloud": {
    "audienceManager": {
      "blob": "2142342343242342"
    }
  }
  ....
}

mboxVersion

(te.js 1.x parameter)

Versie wordt verzonden als parameter van het vraagkoord via de versieparameter.

Trainingsvideo: at.js 2.x architecturaal diagram

te.js 2.x verbetert Adobe Target steun voor SPAs en integreert met andere oplossingen van Experience Cloud. In deze video wordt uitgelegd hoe alles bij elkaar komt.

Zie ​ Begrijpend hoe at.js 2.x werken ​ voor meer informatie.