Show Menu
主题×

适用于 TVML/TVJS 的 Adobe Target

通过直接替换 .xml 文件,可以在 TVML/TVJS 应用程序中利用 Adobe Target。可使用自定义 ADBTarget XML 元素指定要被 Target 内容替换的页面区域。
在 TVML 页面中使用 ADBTarget 元素之前,必须将 TVML/TVJS 应用程序配置为使用 tvOS SDK。有关更多信息,请参阅 使用 tvOS 实施 Apple TV

入门指南

  1. 找到要使用 Target 位置的 .xml 文件。
  2. ADBTarget 元素作为 <document> 元素的子项添加到该文件中。
  3. 如果 Target 找不到 Mbox 位置或发生超时,将使用 <ADBTarget> </ADBTarget> 标记之间的值作为默认内容。

在 Target 中配置 Mbox

从 Target 返回的内容将替换 <ADBTarget> </ADBTarget> 之间的所有内容,其中包括两个 ADBTarget 标记。
您应当相应地计划要替换的内容。
您的用例可能不像在标签中替换字符串值一样简单,也不像替换整个页面一样复杂。

配置 ADBTarget 元素

ADBTarget 元素中,您必须在 mbox 属性中提供 Mbox 名称。您可以选择采用 customParameterName="customParameterValue" 格式将自定义属性添加到请求中。
  • mbox
    Mbox 位置名称。
    • 属性类型:字符串
    • 此属性是必需的。
  • id
    订单 ID。
    • 属性类型:字符串
    • 此属性​ 不是 ​必需的。
  • total
    订单总计。
    • 属性类型:字符串
    • 此属性​ 不是 ​必需的。
  • purchasedProductIds
    此订单的已购产品 ID 的逗号分隔列表。
    • 以下是此属性的代码示例:
      purchasedProductIds="product1,product2,product3" 
      
      
    • 属性类型:字符串
    • 此属性​ 不是 ​必需的。
  • mboxParameters
    mboxParameters 的键值对列表。此字符串中的各条目用分号分隔,键值用冒号分隔。
    • 以下是此属性的代码示例:
      mboxParameters="mboxparameterKey:mboxParameterValue;mboxParameterKey1:mboxParameterValue1;mboxParameterKey2:mboxParameterValue2"
      
      
    • 属性类型:字符串
    • 此属性​ 不是 ​必需的。
  • customParameterName
    此属性的值为 customParameterValue
    • 属性类型:字符串
    • 此属性​ 不是 ​必需的。

示例

示例 1

以下示例在 LandingPage.xml.js 页面中使用 ADBTarget 元素来替换警报的内容:

配置 Target

假定您有一个名为 landingPage 的 Mbox 位置,并且选件内容的设置如下所示:
<title>My cool landing page</title> 
<description>Thanks for coming to my page</description> 

配置 landingPage.xml.js

  • 以下是 landingPage.xml.js 的配置:
    <alertTemplate> 
        <ADBTarget mbox="landingPage">  
            <title>TargetTestPage</title> 
            <description>Load fail or timeout (defaultContent)</description> 
        </ADBTarget>  
    </alertTemplate> 
    
    
  • 如果对 Target 的请求成功,并且返回了您的选件内容,则您的页面将最终为:
    <alertTemplate> 
        <title>My cool landing page</title> 
        <description>Thanks for coming to my page</description> 
    </alertTemplate>
    
    
  • 如果 Target 服务器无法访问或请求超时,则您的页面将最终为:
    <alertTemplate> 
        <title>TargetTestPage</title> 
        <description>Load fail or timeout (defaultContent)</description> 
    </alertTemplate>
    
    

示例 2

以下示例说明了如何将自定义数据添加到 ADBTarget 元素。您可以通过此方法在 Target 中为此 Mbox 位置创建条件式体验和选件内容:
<alertTemplate> 
    <ADBTarget mbox="landingPage" customData="custom data" moreCustomData="more custom data"> 
        <title>TargetTestPage</title> 
        <description>Load fail or timeout (defaultContent)</description> 
    </ADBTarget>  
</alertTemplate>