Adobe Target für TVML/TVJS

Sie können Adobe Target in Ihren TVML-/TVJS-Apps nutzen, indem Sie Ihre .xml-Dateien direkt ersetzen. Geben Sie Seitenbereiche an, die durch Seiteninhalte ersetzt werden sollen, indem Sie das benutzerdefinierte ADBTarget-XML-Element verwenden.

WICHTIG

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.

Erste Schritte

  1. Bestimmen Sie die .xml-Datei, in der Sie Ihre Target-Position verwenden möchten.
  2. Fügen Sie ein ADBTarget-Element zur Datei als ein untergeordnetes Element des <document>-Elements hinzu.
  3. Falls Target Ihre Mbox-Position nicht finden kann oder eine Zeitüberschreitung auftritt, wird der Wert zwischen Ihren <ADBTarget>- und </ADBTarget>-Tags als Standardinhalt verwendet.

mbox in Target konfigurieren

Der aus Target zurückgegebene Inhalt ersetzt alle Inhalte zwischen <ADBTarget> und </ADBTarget>, einschließlich der beiden ADBTarget-Tags.

TIPP

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.

ADBTarget-Element konfigurieren

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.

    • Eigenschaftstyp: String (Zeichenfolge)
    • Diese Eigenschaft ist erforderlich.
  • id

    Die Bestell-ID.

    • Eigenschaftstyp: String (Zeichenfolge)
    • Diese Eigenschaft ist nicht erforderlich.
  • total

    Die Bestellsumme.

    • Eigenschaftstyp: String (Zeichenfolge)
    • Diese Eigenschaft ist nicht erforderlich.
  • 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.

    • Eigenschaftstyp: String (Zeichenfolge)
    • Diese Eigenschaft ist nicht erforderlich.

Beispiele

Beispiel 1

Im folgenden Beispiel wird ein ADBTarget-Element auf der Seite LandingPage.xml.js verwendet, um die Inhalte eines Alarms zu ersetzen:

Konfigurieren von Target

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> 

Konfigurieren von „landingPage.xml.js“

  • Die Konfiguration für landingPage.xml.js lautet wie folgt:

    <alertTemplate> 
        <ADBTarget mbox="landingPage">  
            <title>TargetTestPage</title> 
            <description>Load fail or timeout (defaultContent)</description> 
        </ADBTarget>  
    </alertTemplate> 
    
  • Wenn die Anforderung zur Zielgruppe erfolgreich ausgeführt wurde und Ihr Angebot-Inhalt zurückgegeben wird, resultiert Ihre Seite wie folgt:

    <alertTemplate> 
        <title>My cool landing page</title> 
        <description>Thanks for coming to my page</description> 
    </alertTemplate>
    
  • Wenn der Zielgruppe-Server nicht erreicht werden kann oder die Anforderung eine Zeitüberschreitung aufweist, ergibt sich Folgendes:

    <alertTemplate> 
        <title>TargetTestPage</title> 
        <description>Load fail or timeout (defaultContent)</description> 
    </alertTemplate>
    

Beispiel 2

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>

Auf dieser Seite