Übergeben von Parametern an eine globale Mbox
Die JavaScript targetPageParams -Funktion wird verwendet, um Parameter in Adobe Target an die globale Mbox zu übergeben. Dies ist in jedem Szenario erforderlich, in dem zusätzliche Targeting-/Kontextinformationen an Target übergeben werden sollen.
Beispiel: Verwenden Sie in einer Recommendations-Aktivität die Parameter zur Darstellung des aktuellen Produkts oder der Kategorie, die angezeigt wird.
Der Code zum Aufrufen der JavaScript-Funktion muss vor die globale Mbox auf der Seite gestellt werden, unabhängig davon, ob die globale Mbox als Teil von at.js ausgelöst oder manuell im Seiten-Code eingefügt wird.
Um Parameter an target-global-mbox zu übergeben, können Sie die Funktion targetPageParams() auf eine der folgenden Arten verwenden:
- Als Array
- Als JSON-Objekt
- Als eine durch kaufmännisches Und getrennte Liste
Verwenden Sie diese drei Methoden, um zu prüfen, ob die Parameter korrekt übergeben wurden. Sie können die Übergabe der Parameter möglicherweise auch mit dem Adobe Experience Cloud-Debugger prüfen.
Sie müssen die JavaScript-Funktion definieren, bevor Sie die globale Mbox zu der Seite hinzufügen. Der Name muss targetPageParams lauten.
Abfragezeichenfolge
p1=v1&p2=v2&p3=hello%20world
-
Name:
targetPageParams -
Ausgabewert: mit „&“ getrennte Parameter mit URL-codierten Parameterwerten.
Beispiel:
In diesem Beispiel hat p3 den Wert
hello world, der URL-codiert ist.
Betrachten Sie den folgenden Beispielseitencode:
<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 diesem Beispiel werden die folgenden Daten an die Mbox-Edge gesendet:
- p1=v1
- p2=v2
- p3=hello world
Array
<!--window.-->targetPageParams = function() {
return ["a=1", "b=2", "c=hello world"];
};
Die Werte müssen nicht URL-codiert sein. Wenn beispielsweise ein Wert ein Leerzeichen enthält, dann muss dieses Leerzeichen nicht codiert werden.
In diesem Beispiel werden die folgenden Daten an die Mbox-Edge gesendet:
- a=1
- b=2
- c=hello world
JSON
JSON ist eine leistungsstarke Methode zur Übergabe von Parametern. Target verwendet die JSON-Objektschlüssel, um komplizierte Strukturen in einfache Parameter zu reduzieren.
<!--window.-->targetPageParams = function() {
return {
"a": 1,
"b": 2,
"profile": {
"memberStatus": Gold,
"country": {
"city": "San Francisco"
}
}
};
};
Die Werte müssen nicht URL-codiert sein. Beispiel: Bei „San Francisco“ muss das Leerzeichen nicht codiert werden. Ein Leerzeichen genügt.
In diesem Beispiel werden die folgenden Daten an die Mbox-Edge gesendet:
- a=1
- b=2
profile.memberStatus=Goldprofile.country.city=San Francisco