Show Menu
SUJETS×

Adobe Target pour TVML/TVJS

Vous pouvez exploiter Adobe Target dans vos applications TVML/TVJS en effectuant des remplacements directs dans vos fichiers .xml. Indiquez les zones de votre page à remplacer par du contenu Target en utilisant l’élément XML ADBTarget personnalisé.
Avant d’utiliser l’élément ADBTarget dans vos pages TVML, vous devez configurer votre application TVML/TVJS de façon à utiliser le SDK tvOS. Pour plus d’informations, voir Mise en œuvre de l’Apple TV avec tvOS .

Prise en main

  1. Identifiez le fichier .xml sur lequel vous souhaitez utiliser l’emplacement cible.
  2. Ajoutez un élément ADBTarget au fichier en tant qu’enfant de l’élément <document> .
  3. Si Target ne trouve pas votre emplacement mbox ou s’il expire, la valeur entre les balises <ADBTarget> et </ADBTarget> est utilisée en tant que contenu par défaut.

Configuration de votre mbox dans Target

Le contenu renvoyé depuis Target remplace l’ensemble du contenu entre <ADBTarget> et </ADBTarget> , y compris les deux balises ADBTarget .
Prévoyez ce que vous souhaitez remplacer en conséquence.
Votre cas peut se résumer à un simple remplacement de la valeur de chaîne dans une balise ou impliquer une opération plus complexe, comme le remplacement d’une page entière.

Configuration de l’élément ADBTarget

Indiquez le nom de dans la propriété ADBTarget mbox de l’élément mbox . Vous pouvez éventuellement ajouter des propriétés personnalisées à votre demande au format customParameterName="customParameterValue" .
  • mbox
    Nom de l’emplacement de la mbox.
    • Type de propriété : Chaîne
    • Cette propriété est obligatoire.
  • id
    L’ID de commande.
    • Type de propriété : Chaîne
    • Cette propriété n’est pas requise.
  • total
    Total de la commande.
    • Type de propriété : Chaîne
    • Cette propriété n’est pas requise.
  • purchasedProductIds
    Liste séparée par des virgules des identifiants de produit pour cette commande.
    • Voici l’exemple de code pour cette propriété :
      purchasedProductIds="product1,product2,product3" 
      
      
    • Type de propriété : Chaîne
    • Cette propriété n’est pas requise.
  • mboxParameters
    Liste de paires clé-valeur pour mboxParameters . Chaque entrée de cette chaîne est séparée par un point-virgule (;). Les paires clé-valeur sont séparées par deux-points (:).
    • Voici l’exemple de code pour cette propriété :
      mboxParameters="mboxparameterKey:mboxParameterValue;mboxParameterKey1:mboxParameterValue1;mboxParameterKey2:mboxParameterValue2"
      
      
    • Type de propriété : Chaîne
    • Cette propriété n’est pas requise.
  • customParameterName
    La valeur de cette propriété est customParameterValue .
    • Type de propriété : Chaîne
    • Cette propriété n’est pas requise.

Exemples

Exemple 1

L’exemple suivant utilise un élément ADBTarget dans la page LandingPage.xml.js pour remplacer le contenu d’une alerte :

Configuration de Target

Supposons que le nom de l’emplacement de la mbox soit landingPage et que le contenu de l’offre soit défini comme suit :
<title>My cool landing page</title> 
<description>Thanks for coming to my page</description> 

Configuration de landingPage.xml.js

  • La configuration de landingPage.xml.js est la suivante :
    <alertTemplate> 
        <ADBTarget mbox="landingPage">  
            <title>TargetTestPage</title> 
            <description>Load fail or timeout (defaultContent)</description> 
        </ADBTarget>  
    </alertTemplate> 
    
    
  • En cas de réussite de la demande vers Target et de renvoi de votre contenu d’offre, votre page se présentera comme suit :
    <alertTemplate> 
        <title>My cool landing page</title> 
        <description>Thanks for coming to my page</description> 
    </alertTemplate>
    
    
  • S’il n’est pas possible d’atteindre le serveur Target ou si la demande expire, votre page se présentera comme suit :
    <alertTemplate> 
        <title>TargetTestPage</title> 
        <description>Load fail or timeout (defaultContent)</description> 
    </alertTemplate>
    
    

Exemple 2

L’exemple suivant indique comment ajouter des données personnalisées à votre élément ADBTarget . Cette méthode vous permet de créer des expériences conditionnelles et offre du contenu pour cet emplacement de mbox dans Target :
<alertTemplate> 
    <ADBTarget mbox="landingPage" customData="custom data" moreCustomData="more custom data"> 
        <title>TargetTestPage</title> 
        <description>Load fail or timeout (defaultContent)</description> 
    </ADBTarget>  
</alertTemplate>