Vous pouvez tirer parti d’Adobe Target dans vos applications TVML/TVJS en effectuant des remplacements directs dans vos fichiers .xml. Désignez les zones de votre page à remplacer par du contenu Target à l’aide de 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.
.xml
sur lequel vous souhaitez utiliser l’emplacement cible.ADBTarget
au fichier en tant qu’enfant de l’élément <document>
.<ADBTarget>
et </ADBTarget>
est utilisée en tant que contenu par défaut.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.
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.
id
L’ID de commande.
total
Total de la commande.
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
.
L’exemple suivant utilise un élément ADBTarget
dans la page LandingPage.xml.js
pour remplacer le contenu d’une alerte :
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>
Voici la configuration de landingPage.xml.js :
<alertTemplate>
<ADBTarget mbox="landingPage">
<title>TargetTestPage</title>
<description>Load fail or timeout (defaultContent)</description>
</ADBTarget>
</alertTemplate>
Si la requête envoyée à Target aboutit et que le contenu de votre offre est renvoyé, votre page se traduira par :
<alertTemplate>
<title>My cool landing page</title>
<description>Thanks for coming to my page</description>
</alertTemplate>
Si le serveur Target n’est pas accessible ou si la demande expire, votre page se traduira par :
<alertTemplate>
<title>TargetTestPage</title>
<description>Load fail or timeout (defaultContent)</description>
</alertTemplate>
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>