Sie können Adobe Target in Ihren TVML-/TVJS-Apps nutzen, indem Sie direkte Ersetzungen an Ihren .xml-Dateien vornehmen. Legen Sie Bereiche Ihrer Seite fest, die durch Target-Inhalte ersetzt werden sollen, indem Sie das benutzerdefinierte ADBTarget-XML-Element verwenden.
Vor der Verwendung des Elements ADBTarget
auf Ihren TVML-Seiten müssen Sie Ihre TVML-/TVJS-App für die Verwendung des tvOS-SDK konfigurieren. Weitere Informationen finden Sie unter Apple TV-Implementierungen mit tvOS.
.xml
-Datei, in der Sie Ihre Target-Position verwenden möchten.ADBTarget
-Element zur Datei als ein untergeordnetes Element des <document>
-Elements hinzu.<ADBTarget>
- und </ADBTarget>
-Tags als Standardinhalt verwendet.Der aus Target zurückgegebene Inhalt ersetzt alle Inhalte zwischen <ADBTarget>
und </ADBTarget>
, einschließlich der beiden ADBTarget
-Tags.
Sie sollten entsprechend planen, was Sie ersetzen möchten.
Ihr Anwendungsfall sollte so einfach sein wie das Ersetzen eines Zeichenfolgenwerts in einer Bezeichnung oder so komplex wie das Ersetzen einer gesamten Seite.
Im Element ADBTarget
müssen Sie den Mbox-Namen in der Eigenschaft mbox
angeben. Sie können optional benutzerdefinierte Eigenschaften zu Ihrer Anforderung im Format customParameterName="customParameterValue"
hinzufügen.
mbox
Name Ihrer Mbox-Position.
id
Die Bestell-ID.
total
Die Bestellsumme.
purchasedProductIds
Eine kommagetrennte Liste der erworbenen Produkt-IDs für diese Bestellung.
Hier finden Sie ein Code-Beispiel für diese Eigenschaft:
purchasedProductIds="product1,product2,product3"
Eigenschaftstyp: String (Zeichenfolge)
Diese Eigenschaft ist nicht erforderlich.
mboxParameters
Eine Liste von Schlüssel-Wert-Paaren für mboxParameters
. Jeder Eintrag in dieser Zeichenfolge wird durch ein Semikolon getrennt. Schlüsselwerte werden durch einen Doppelpunkt getrennt.
Hier finden Sie ein Code-Beispiel für diese Eigenschaft:
mboxParameters="mboxparameterKey:mboxParameterValue;mboxParameterKey1:mboxParameterValue1;mboxParameterKey2:mboxParameterValue2"
Eigenschaftstyp: String (Zeichenfolge)
Diese Eigenschaft ist nicht erforderlich.
customParameterName
Der Wert dieser Eigenschaft lautet customParameterValue
.
Im folgenden Beispiel wird ein ADBTarget
-Element auf der Seite LandingPage.xml.js
verwendet, um die Inhalte eines Alarms zu ersetzen:
Angenommen, Sie besitzen eine Mbox-Position mit dem Namen landingPage
und der Angebotsinhalt ist auf Folgendes festgelegt:
<title>My cool landing page</title>
<description>Thanks for coming to my page</description>
Dies ist die Konfiguration für landingPage.xml.js:
<alertTemplate>
<ADBTarget mbox="landingPage">
<title>TargetTestPage</title>
<description>Load fail or timeout (defaultContent)</description>
</ADBTarget>
</alertTemplate>
Wenn die Anfrage an Target erfolgreich ist und Ihr Angebotsinhalt zurückgegeben wird, resultiert Ihre Seite aus:
<alertTemplate>
<title>My cool landing page</title>
<description>Thanks for coming to my page</description>
</alertTemplate>
Wenn der Target-Server nicht erreicht werden kann oder die Anfrage eine Zeitüberschreitung aufweist, ergibt sich für Ihre Seite Folgendes:
<alertTemplate>
<title>TargetTestPage</title>
<description>Load fail or timeout (defaultContent)</description>
</alertTemplate>
Im folgenden Beispiel wird veranschaulicht, wie Ihrem ADBTarget
-Element benutzerdefinierte Daten hinzugefügt werden. Mit dieser Methode können Sie bedingte Erfahrungen und Angebotsinhalte für diese Mbox-Position in Target erstellen:
<alertTemplate>
<ADBTarget mbox="landingPage" customData="custom data" moreCustomData="more custom data">
<title>TargetTestPage</title>
<description>Load fail or timeout (defaultContent)</description>
</ADBTarget>
</alertTemplate>