.xmlファイルを直接置き換えることで、TVML/TVJSアプリでAdobe Targetを活用できます。 カスタムのADBTarget XML要素を使用して、ターゲットコンテンツに置き換えるページ領域を指定します。
TVML ページで ADBTarget
要素を使用する前に、tvOS SDK を使用するように TVML/TVJS アプリを設定する必要があります。詳しくは、「tvOS を使用した Apple TV 実装」を参照してください。
.xml
ファイルを特定します。ADBTarget
要素を <document>
要素の子としてファイルに追加します。<ADBTarget>
タグと </ADBTarget>
タグの間の値がデフォルトコンテンツとして使用されます。Target から返されたコンテンツで、<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
です。
以下の例では、ADBTarget
ページ内で LandingPage.xml.js
要素を使用して、アラートのコンテンツを置き換えています。
landingPage
という名前の Mbox ロケーションがあり、オファーコンテンツが次のように設定されているとします。
<title>My cool landing page</title>
<description>Thanks for coming to my page</description>
landingPage.xml.jsの設定を次に示します。
<alertTemplate>
<ADBTarget mbox="landingPage">
<title>TargetTestPage</title>
<description>Load fail or timeout (defaultContent)</description>
</ADBTarget>
</alertTemplate>
ターゲットへのリクエストが成功し、オファーのコンテンツが返された場合、ページの結果は次のようになります。
<alertTemplate>
<title>My cool landing page</title>
<description>Thanks for coming to my page</description>
</alertTemplate>
ターゲットサーバーに到達できない場合、または要求がタイムアウトした場合、ページは次の結果になります。
<alertTemplate>
<title>TargetTestPage</title>
<description>Load fail or timeout (defaultContent)</description>
</alertTemplate>
以下の例は、カスタムデータを 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>