Show Menu
TEMAS×

Adobe Target para TVML/TVJS

Puede aprovechar Adobe Target en sus aplicaciones TVML/TVJS efectuando reemplazos directos en los archivos .xml. Designe áreas de su página que se reemplazarán con contenido de Target empleando el elemento XML personalizado ADBTarget.
Antes de usar el elemento ADBTarget en sus páginas TVML, debe configurar la aplicación TVML/TVJS para que utilice el SDK para tvOS. Para obtener más información, consulte Implementación de Apple TV con tvOS .

Primeros pasos

  1. Identifique el archivo .xml en el que quiere utilizar su ubicación de Target.
  2. Agregue un elemento ADBTarget al archivo como secundario del elemento <document> .
  3. Si Target no encuentra su ubicación Mbox o si se excede el tiempo de respuesta, el valor entre las etiquetas <ADBTarget> y </ADBTarget> se utiliza como contenido predeterminado.

Configuración de Mbox en Target

El contenido devuelto desde Target reemplaza todo el contenido entre <ADBTarget> y </ADBTarget> , incluidas ambas etiquetas ADBTarget .
Debe planificar en consecuencia qué desea reemplazar.
Su caso de uso podría ser tan sencillo como sustituir un valor de cadena en una etiqueta, o tan complejo como reemplazar una página entera.

Configurar el elemento ADBTarget

En el elemento ADBTarget , debe proporcionar el nombre de en la propiedad mbox mbox. Si lo desea, puede agregar propiedades personalizadas a la solicitud con el formato customParameterName="customParameterValue" .
  • mbox
    Nombre de su ubicación Mbox.
    • Tipo de propiedad: Cadena
    • Esta es una propiedad obligatoria.
  • id
    ID del pedido.
    • Tipo de propiedad: Cadena
    • Esta propiedad no es obligatoria.
  • total
    El total del pedido.
    • Tipo de propiedad: Cadena
    • Esta propiedad no es obligatoria.
  • purchasedProductIds
    Una lista separada por comas del ID de los productos adquiridos en este pedido.
    • Este es un ejemplo de código para esta propiedad:
      purchasedProductIds="product1,product2,product3" 
      
      
    • Tipo de propiedad: Cadena
    • Esta propiedad no es obligatoria.
  • mboxParameters
    Una lista de pares clave-valor para mboxParameters . Cada entrada en la cadena se separa con un punto y coma, mientras que los elementos clave-valor se separan con dos puntos.
    • Este es un ejemplo de código para esta propiedad:
      mboxParameters="mboxparameterKey:mboxParameterValue;mboxParameterKey1:mboxParameterValue1;mboxParameterKey2:mboxParameterValue2"
      
      
    • Tipo de propiedad: Cadena
    • Esta propiedad no es obligatoria.
  • customParameterName
    El valor de esta propiedad es customParameterValue .
    • Tipo de propiedad: Cadena
    • Esta propiedad no es obligatoria.

Ejemplos

Ejemplo 1

El siguiente ejemplo utiliza un elemento ADBTarget en la página LandingPage.xml.js para reemplazar el contenido de una alerta:

Configure Target

Suponga que tiene una ubicación Mbox llamada landingPage y que el contenido de la oferta se establece del siguiente modo:
<title>My cool landing page</title> 
<description>Thanks for coming to my page</description> 

Configure landingPage.xml.js

  • Esta es la configuración para landingPage.xml.js:
    <alertTemplate> 
        <ADBTarget mbox="landingPage">  
            <title>TargetTestPage</title> 
            <description>Load fail or timeout (defaultContent)</description> 
        </ADBTarget>  
    </alertTemplate> 
    
    
  • Si la solicitud a Target se realiza correctamente y se devuelve el contenido de la oferta, su página resultará así:
    <alertTemplate> 
        <title>My cool landing page</title> 
        <description>Thanks for coming to my page</description> 
    </alertTemplate>
    
    
  • Si el servidor de Target no está disponible o se excede el tiempo de la solicitud, su página resultará así:
    <alertTemplate> 
        <title>TargetTestPage</title> 
        <description>Load fail or timeout (defaultContent)</description> 
    </alertTemplate>
    
    

Ejemplo 2

El siguiente ejemplo ilustra cómo se agregan datos personalizados al elemento ADBTarget . Este método le permite crear experiencias condicionales y ofrecer contenido para esta ubicación Mbox en Target:
<alertTemplate> 
    <ADBTarget mbox="landingPage" customData="custom data" moreCustomData="more custom data"> 
        <title>TargetTestPage</title> 
        <description>Load fail or timeout (defaultContent)</description> 
    </ADBTarget>  
</alertTemplate>