Upgrade uitvoeren vanaf 0,js 1.x tot en met at.js 2.x

De nieuwste versie van at.js in Adobe Target verstrekt rijke eigenschapreeksen die uw zaken uitrusten om verpersoonlijking op volgende-generatie, cliënt-zijtechnologieën uit te voeren. Deze nieuwe versie is gericht op het upgraden van at.js voor harmonieuze interacties met toepassingen van één pagina (SPA).

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

te.js 2.x systeemdiagrammen

De volgende diagrammen helpen u het werkschema van at.js 2 begrijpen.x met Weergaven en hoe dit de SPA integratie verbetert. Een betere introductie van de concepten die worden gebruikt in at.js 2.x, zie Toepassing van één pagina.

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

Nu, overal triggerView() wordt geïmplementeerd op uw SPA, worden de weergaven en acties opgehaald uit het cachegeheugen en aan de gebruiker getoond zonder een serveraanroep. triggerView() verzoekt de Commissie tevens Target achterkant om het aantal beeldingen te verhogen en op te nemen.

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

Implementeer om.js 2.x

Implementeer om.js 2.x via tags in Adobe Experience Platform extensie.

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. Zie voor een volledige lijst met functies at.js-functies.

mboxCreate(mbox,params)

Beschrijving:

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

Voorbeeld:

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

te.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 het verzoek uitvoert en de aanbieding op het element toepast dat door nodeId wordt geïdentificeerd in mboxDefine(). Kan ook worden gebruikt om een box bij te werken die is gestart door mboxCreate.

Voorbeeld:

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

te.js 2.x equivalent:

Een alternatief voor mboxDefine() en mboxUpdate is getOffer() en applyOffer()met de optie Selector 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() voor conversie-tracking moet worden gebruikt trackEvent() of getOffer().

Levering aanbieden

Klanten die niet vervangen mboxCreate() with getOffer() of applyOffer() risico dat er geen aanbiedingen zijn gedaan.

Mag om.js 2.x worden gebruikt op sommige pagina's en op 0,js 1.x bevindt zich 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 een nieuwe API, die wij de levering API noemen. Om te kunnen bepalen of at.js het Target de randserver correct, kunt u het lusje van het Netwerk van de Hulpmiddelen van de Ontwikkelaar van uw browser aan "levering"filtreren, "tt.omtrdc.net," of uw clientcode. U zult ook merken dat Target verzendt een JSON-payload in plaats van sleutel-waardeparen.

Target Globale box wordt niet meer gebruikt

In at.js 2.x, ziet u niet langer "target-global-mbox" zichtbaar in de netwerkvraag. In plaats daarvan hebben we de "target-global-mbox" syntaxis naar "execute > pageLoad" in de aan de Target servers, zoals hieronder weergegeven:

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

In wezen is het concept global mbox geïntroduceerd om Target weet of aanbiedingen en inhoud tijdens het laden van de pagina moeten worden opgehaald. Daarom hebben we dit in onze nieuwste versie duidelijker gemaakt.

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

Klanten kunnen een algemene mbox-naam opgeven via Target > Administration > Implementation > Edit at.js Settings. Deze instelling wordt gebruikt door de Target te vertalen Edge-servers > pageLoad om de algemene naam van het selectievakje in het dialoogvenster Target UI. 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. Wij adviseren sterk dat u ook ervoor zorgt de zelfde globale naam mbox op wordt gevormd Administration > Visual Experience Composer pagina, ook als u nog pagina's hebt die at.js 1 gebruiken.x, zoals in de volgende afbeeldingen wordt getoond.

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 in te dienen bij de Target Edge-servers bij laden van pagina. 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 wordt verwerkt op de Target achterzijde target-global-mbox.

Als mijn op formulieren gebaseerde activiteiten gericht zijn op de target-global-mbox, zullen deze activiteiten blijven functioneren?

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

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

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. Voor het bijhouden van andere domeinen, Target gebruikt een cookie van een andere fabrikant om bezoekers in verschillende domeinen bij te houden. Zo kunt u een Target activiteit die zich uitstrekt siteA.com en siteB.com en bezoekers blijven in dezelfde ervaring wanneer ze door unieke domeinen navigeren. Deze functie is verbonden met TargetHet cookie-gedrag van derden en van de eerste fabrikant.

In Target, wordt het cookie van de andere fabrikant 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 in te stellen mboxSession en mboxPC, 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. Dit werkschema is mogelijk omdat wij de methode van de GET van HTTP gebruiken.

In punt 2.js.x, HTTP-GET wordt niet gebruikt. In plaats daarvan wordt HTTP-POST gebruikt via at.js 2.x om JSON-payloads te verzenden naar Target Edge-servers. Het gebruiken van de POST van HTTP betekent het omleidingsverzoek om te controleren of browser derdekoekjes steunt 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 (ouder dan 2.10) wordt niet vanuit het vak ondersteund. Alleen om.js 1.x heeft out-of-box 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 vóór 2.10, kunt u optie nr. 1 hierboven uitvoeren (installeer de ECID-bibliotheek).

Automatisch globale box maken wordt ondersteund

Deze instelling vertelt at.js 2.x om een verzoek in te dienen bij de Target Edge-servers bij het laden van de pagina. Omdat het globale mbox wordt vertaald om > pageLoad uit te voeren, en dit door Target Edge-servers moeten klanten deze optie inschakelen als ze een aanvraag willen indienen bij het laden van een pagina.

Algemene naam van box wordt ondersteund

Klanten kunnen een algemene mbox-naam opgeven via Target > Administration > Implementation > Edit. Deze instelling wordt gebruikt door de Target Edge-servers die moeten worden vertaald, uitvoeren > pageLoad naar 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 om.js van toepassing op triggerView() of is het alleen bedoeld voor applyOffer() of applyOffers()?

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

Het zegt wanneer ik bel triggerView() met &accolade;"page" : "true"&Broce; hiermee wordt een bericht verzonden naar de Target de indruk vergroten. Zorgt het er ook voor dat de profielscripts worden uitgevoerd?

Wanneer een prefetch vraag aan wordt gemaakt Target als achtergrond, worden de profielmanuscripten uitgevoerd. Daarna worden de profielgegevens gecodeerd en teruggestuurd naar de clientzijde. Na triggerView() with {"page": "true"} wordt aangeroepen, wordt een melding samen met de gecodeerde profielgegevens verzonden. Dit is wanneer de Target backend zal dan de profielgegevens decrypteren en in de gegevensbestanden opslaan.

Moeten wij pre-verbergende code toevoegen alvorens te roepen triggerView() om flikkering te beheren?

Nee, u hoeft geen code toe te voegen die voor het aanroepen verborgen is triggerView(). te.js 2.x beheert de logica voor het vooraf verbergen en flikkeren voordat de weergave wordt weergegeven en toegepast.

welke om.js 1.x parameters voor het maken van soorten publiek worden niet ondersteund in at.js 2.x?

De volgende parameters om 1.js zijn NOT momenteel ondersteund voor het maken van publiek bij gebruik van at.js 2.x:

te.js 2.x biedt geen ondersteuning voor het maken van soorten publiek met behulp van 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 mbox-parameters naar de Target back-end. Na het migreren naar om.js 2.x kunt u geen publiek meer maken met deze parameters omdat at.js 2.x verzendt de parameters mbox verschillend.

at.js-compatibiliteit

In de volgende tabellen wordt om .js uitgelegd. 2.x compatibiliteit met verschillende typen activiteiten, integraties, functies en at.js-functies.

Typen activiteiten

Integraties

Functies

Parameters van queryreeks

Reactietokens

te.js 2.x, net als bij.js 1.x gebruikt u de aangepaste gebeurtenis at-request-succeeded op tokens voor oppervlakreactie. Voor codevoorbeelden met de at-request-succeeded aangepaste gebeurtenis, zie Reactietokens.

te.js 1.x parameters tot at.js 2.x lading toewijzen

In deze sectie worden de toewijzingen tussen at.js 1 beschreven.x en te.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, de beschrijving ervan en de bijbehorende 2.x JSON-lading (indien van toepassing):

at_property

(te.js 1.x parameter)

Gebruikt voor Machtigingen voor zakelijke gebruikers.

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

mboxHost

(te.js 1.x parameter)

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

te.js 2.x JSON-lading:

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

webGLRenderer

(te.js 1.x parameter)

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

te.js 2.x JSON-lading:

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

mboxURL

(te.js 1.x parameter)

De pagina-URL.

te.js 2.x JSON-lading:

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

mboxReferrer

(te.js 1.x parameter)

De paginareferentie.

te.js 2.x JSON-lading:

{
  "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.

te.js 2.x JSON-lading:

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

mbox (de naam) is niet gelijk aan global 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 JSON-lading:

{
  "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 JSON-lading:

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

mboxTime

(te.js 1.x parameter)

Niet meer gebruikt.

mboxSession

(te.js 1.x parameter)

Sessie-id wordt verzonden als een querytekenreeks-parameter (sessionId) naar het API-eindpunt van de levering.

mboxPC

(te.js 1.x parameter)

De TNT-id wordt doorgegeven aan id > tntId.

te.js 2.x JSON-lading:

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

mboxMCGVID

(te.js 1.x parameter)

Bezoeker-id van Marketing Cloud wordt doorgegeven aan id > marketingCloudVisitorId.

te.js 2.x JSON-lading:

{
  "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 JSON-lading:

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

mbox3rdPartyId

(te.js 1.x parameter)

Id van derde partij van klant die wordt gebruikt om verschillende koppelingen te maken Target ID's.

te.js 2.x JSON-lading:

{
  "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 JSON-lading:

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

vst.trk

(te.js 1.x parameter)

Analytics trackingserver. Moet worden doorgegeven aan experienceCloud > analytics > trackingServer.

te.js 2.x JSON-lading:

{
  "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 JSON-lading:

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

mboxMCGLH

(te.js 1.x parameter)

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

te.js 2.x JSON-lading:

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

mboxAAMB

(te.js 1.x parameter)

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

te.js 2.x JSON-lading:

{
  "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 architectuurdiagram

te.js 2.x verbetert Adobe TargetDe ondersteuning voor SPA en integreert met andere Experience Cloud-oplossingen. In deze video wordt uitgelegd hoe alles bij elkaar komt.

Zie Begrijpen hoe at.js 2.x werken voor meer informatie .