Parameters doorgeven aan een globale box

Last update: Thu Jul 27 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Onderwerpen:

Gemaakt voor:

Ontwikkelaar

JavaScript targetPageParams functie wordt gebruikt om parameters door te geven aan de algemene mbox in Adobe Target. Dit is nodig in elk scenario waarin aanvullende informatie over doelgerichtheid/context moet worden doorgegeven Target.

In een Recommendations-activiteit gebruikt u bijvoorbeeld de parameters om het huidige product of de categorie te vertegenwoordigen die wordt weergegeven.

De code die de JavaScript-functie moet aanroepen, moet vóór het globale vakje op de pagina komen, ongeacht of het globale vakje als onderdeel van at.js is geactiveerd of handmatig in de paginacode is opgenomen.

NOTE

Als u parameters wilt toevoegen aan alle vakken op de pagina en niet alleen aan de globale box, gebruikt u de optie targetPageParamsAll() functie.

U kunt parameters doorgeven aan target-global-mbox met de targetPageParams() op een van de volgende manieren te werken:

Een array
Een JSON-object
Een door ampersand gescheiden lijst

Gebruik deze drie methoden om te controleren of de parameters correct worden doorgegeven. Mogelijk kunt u ook controleren of parameters zijn doorgegeven met de opdracht Adobe Experience Cloud Debugger.

U moet de JavaScript-functie definiëren voordat u het globale vakje aan de pagina toevoegt. De naam moet targetPageParams.

Tekenreeks query

p1=v1&p2=v2&p3=hello%20world

Naam: targetPageParams
Geretourneerde waarde: een "&" gescheiden parameters, met URL-gecodeerde parameterwaarden.

Voorbeeld:

In dit voorbeeld heeft p3 de waarde hello world, die URL-gecodeerd is.

Overweeg de volgende voorbeeldpaginacode:

<html>
  <head>
    <title>Title here..</title>
    <script type="text/javascript">
        function targetPageParams() {
          return "p1=v1&p2=v2&p3=hello%20world";
        }
    </script>
    <script src="mbox.js" type="text/javascript"></script>
  </head>
  <body>Body here...
  </body>
</html>

In dit voorbeeld worden de volgende gegevens naar de mbox-rand verzonden:

p1=v1
p2=v2
p3=hello wereld

Array

<!--window.-->targetPageParams = function() {
  return ["a=1", "b=2", "c=hello world"];
};

Waarden hoeven niet via URL te worden gecodeerd. Als een waarde bijvoorbeeld een spatie bevat, is het niet nodig de spatie te coderen.

In dit voorbeeld worden de volgende gegevens naar de mbox-rand verzonden:

a=1
b=2
c=hello wereld

JSON

JSON is een krachtige manier om parameters door te geven. Target gebruikt de JSON-objectsleutels om gecompliceerde structuren samen te voegen tot eenvoudige parameters.

<!--window.-->targetPageParams = function() {
  return {
    "a": 1,
    "b": 2,
    "profile": {
                  "memberStatus": Gold,
                  "country": {
                                "city": "San Francisco"
                            }
              }
  };
};

Waarden hoeven niet via URL te worden gecodeerd. "San Francisco" vereist bijvoorbeeld niet dat de ruimte wordt gecodeerd. Een spatie volstaat.

In dit voorbeeld worden de volgende gegevens naar de mbox-rand verzonden:

a=1
b=2
profile.memberStatus=Goud
profile.country.city=San Francisco

recommendation-more-help

6906415f-169c-422b-89d3-7118e147c4e3