Show Menu
TÓPICOS×

Adobe Target para TVML/TVJS

Você pode alavancar o Adobe Target em seus aplicativos TVML/TVJS fazendo substituições diretas em seus arquivos .xml. Atribua áreas da sua página para serem substituídas pelo conteúdo do Target usando o elemento ADBTarget XML personalizado.
Antes de usar o elemento ADBTarget em suas páginas TVML, você deve configurar o aplicativo TVML/TVJS para usar o tvOS SDK. Para obter mais informações, consulte Implementação da Apple TV com tvOS .

Introdução

  1. Identifique o arquivo .xml no qual você deseja usar a localização do seu Target.
  2. Adicione um elemento ADBTarget ao arquivo como filho do elemento <document> .
  3. Se o Target não encontrar a localização da Mbox, ou se atingir o tempo limite, o valor entre as tags <ADBTarget> e </ADBTarget> será usado como conteúdo padrão.

Configurar a Mbox no Target

O conteúdo retornado do Target substitui todo o conteúdo entre <ADBTarget> e </ADBTarget> , incluindo as tags ADBTarget .
É necessário planejar o item que será substituído.
Seu caso de uso pode ser tão simples como substituir um valor da cadeia de caracteres em um rótulo ou tão complexo como substituir uma página inteira.

Configurar o elemento ADBTarget

No elemento ADBTarget , você deve fornecer o nome da na propriedade mbox mbox. Opcionalmente, é possível adicionar propriedades personalizadas à solicitação no formato customParameterName="customParameterValue" .
  • mbox
    Nome da localização da Mbox.
    • Tipo de propriedade: String
    • Esta propriedade é obrigatória.
  • id
    A ID do pedido.
    • Tipo de propriedade: String
    • Esta propriedade não é obrigatória.
  • total
    O total do pedido.
    • Tipo de propriedade: String
    • Esta propriedade não é obrigatória.
  • purchasedProductIds
    Uma lista separada por vírgulas de IDs de produtos adquiridos para este pedido.
    • Esta é a amostra de código para essa propriedade:
      purchasedProductIds="product1,product2,product3" 
      
      
    • Tipo de propriedade: String
    • Esta propriedade não é obrigatória.
  • mboxParameters
    Uma lista de pares de valores chave para mboxParameters . Cada entrada nessa sequência é separada por um ponto e vírgula, e os valores-chave são separados por dois pontos.
    • Esta é a amostra de código para essa propriedade:
      mboxParameters="mboxparameterKey:mboxParameterValue;mboxParameterKey1:mboxParameterValue1;mboxParameterKey2:mboxParameterValue2"
      
      
    • Tipo de propriedade: String
    • Esta propriedade não é obrigatória.
  • customParameterName
    O valor dessa propriedade é customParameterValue .
    • Tipo de propriedade: String
    • Esta propriedade não é obrigatória.

Exemplos

Exemplo 1

O seguinte exemplo usa um elemento ADBTarget na página LandingPage.xml.js para substituir os conteúdos de um alerta:

Configurar Target

Suponha que você tenha um local da Mbox chamado landingPage e o conteúdo da oferta esteja configurado para ser o seguinte:
<title>My cool landing page</title> 
<description>Thanks for coming to my page</description> 

Configurar landingPage.xml.js

  • Esta é a configuração de landingPage.xml.js:
    <alertTemplate> 
        <ADBTarget mbox="landingPage">  
            <title>TargetTestPage</title> 
            <description>Load fail or timeout (defaultContent)</description> 
        </ADBTarget>  
    </alertTemplate> 
    
    
  • Se a solicitação ao Target for bem-sucedida e o conteúdo da sua oferta for retornado, sua página resultará em:
    <alertTemplate> 
        <title>My cool landing page</title> 
        <description>Thanks for coming to my page</description> 
    </alertTemplate>
    
    
  • Se o servidor Target não puder ser alcançado ou a solicitação expirar, sua página resultará em:
    <alertTemplate> 
        <title>TargetTestPage</title> 
        <description>Load fail or timeout (defaultContent)</description> 
    </alertTemplate>
    
    

Exemplo 2

O exemplo a seguir ilustra como adicionar dados personalizados ao elemento ADBTarget . Esse método permite que você crie experiências condicionais e ofereça conteúdo para essa localização da Mbox no Target:
<alertTemplate> 
    <ADBTarget mbox="landingPage" customData="custom data" moreCustomData="more custom data"> 
        <title>TargetTestPage</title> 
        <description>Load fail or timeout (defaultContent)</description> 
    </ADBTarget>  
</alertTemplate>