Die JavaScript-Funktion targetPageParams
wird verwendet, um Parameter an die globale Mbox in Adobe Target zu übergeben. Dies ist in jedem Szenario erforderlich, in dem zusätzliche Targeting-/Kontextinformationen an Target weitergegeben werden sollen.
Verwenden Sie beispielsweise in einer Recommendations-Aktivität die Parameter, um das aktuelle Produkt oder die aktuelle Kategorie, die angezeigt wird, darzustellen.
Der Code zum Aufrufen der JavaScript-Funktion muss vor der globalen Mbox auf der Seite stehen, unabhängig davon, ob die globale Mbox als Teil von at.js ausgelöst oder manuell im Seiten-Code eingefügt wird.
Wenn Sie allen mboxes auf der Seite Parameter hinzufügen möchten, nicht nur der globalen Mbox, verwenden Sie die Funktion targetPageParamsAll().
Um Parameter an target-global-mbox
zu übergeben, können Sie die Funktion targetPageParams()
auf eine der folgenden Arten verwenden:
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.
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.
Das folgende Beispiel zeigt, wie der Code für die Seite aussehen könnte:
<html>
<head>
<title>Title here..</title>
<script type="text/javascript">
function targetPageParams() {
<b>return "p1=v1&p2=v2&p3=hello%20world"</b>;
}
</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:
<!--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:
JSON ist eine leistungsstarke Methode zur Übergabe von Parametern. Target verwendet die JSON-Objektschlüssel, um komplizierte Strukturen in einfache Parameter abzuflachen.
<!--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:
profile.memberStatus
=Goldprofile.country.city
=San Francisco