Show Menu
THEMEN×

Adobe Target für TVML/TVJS

Sie können Adobe Target in Ihren TVML-/TVJS-Apps nutzen, indem Sie direkte Ersetzungen in Ihren .xml-Dateien vornehmen. Bestimmen Sie Bereiche Ihrer Seite, die durch Target-Inhalt 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 .

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.
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“

  • Im Folgenden finden Sie 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 Anforderung zu Target erfolgreich ist und Ihr Angebotsinhalt zurückgegeben wird, wird auf Ihrer Seite Folgendes ausgegeben:
    <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 bei der Anforderung eine Zeitüberschreitung auftritt, wird auf Ihrer Seite Folgendes ausgegeben:
    <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>