Adobe Target für TVML/TVJS

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.

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.

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“

• 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>
  

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>