リッチメディアレコメンデーション

リッチメディアのレコメンデーションテンプレートを表示するには、必要なタグとAPI呼び出しをページに追加します。

  1. ページヘッダーで次の操作を行います。

    1. RTP タグをインストールします。
    2. レコメンデーションを入力するGET呼び出しを追加します。
    3. テンプレートを設定するSET呼び出しを追加します。
  2. ページ本文:

    1. テンプレートを表示する場所にテンプレートタグ(div クラス)を配置します。

詳しくは、Web リッチメディアの予測コンテンツを有効にするを参照してください。

テンプレートタグ

属性
オプション/必須
説明
クラス
必須
div HTML要素をRTP レコメンデーション divとして識別します。
data-rtp-template-id
必須
レコメンデーションの整合性を決定します。 水平方向の整列には「template1」、垂直方向の整列には「template2」、タイトルと説明のみを含む垂直方向の整列には「template3」を使用します。 スクリプトは、一致するテンプレートをこのdivに挿入します。 使用可能な値:template1、template2、template3。

「template1」を使用して、レコメンデーションを水平方向に表示します。

<div class="RTP_RCMD2" data-rtp-template-id="template1"></div>

レコメンデーションを垂直方向に表示するには、「template2」を使用します。

<div class="RTP_RCMD2" data-rtp-template-id="template2"></div>

「template3」を使用すると、タイトルと説明のみでレコメンデーションを垂直方向に表示できます。

<div class="RTP_RCMD2" data-rtp-template-id="template3"></div>

​ テンプレートの整列の例を参照してください。

レコメンデーションの入力

このメソッドは、ページ上のすべてのリッチメディア <divs>にレコメンデーションを入力します。

使用方法

rtp('get', 'rcmd', 'richmedia');

パラメーター
オプション/必須
タイプ
説明
‘get’
必須
文字列
メソッドアクション。
‘rcmd’
必須
文字列
メソッド名。
‘richmedia’
必須
文字列
サブメソッド名。

テンプレート設定の変更

このメソッドは、デフォルトのテンプレート設定を変更します。

rtp (‘get’,‘rcmd’, ‘richmedia’)を呼び出す前に、このメソッドを呼び出してください。

使用方法

rtp('set', 'rcmd', 'richmedia', 'template_id', conf_obj);

パラメーター
オプション/必須
タイプ
説明
‘set’
必須
文字列
メソッドアクション。
‘rcmd’
必須
文字列
メソッド名。
‘richmedia’
必須
文字列
サブメソッド名。
template_id
オプション
文字列
設定変更のテンプレート ID。 1 つのテンプレートのみの設定変更を指定するのに使用します。
conf_obj
必須
オブジェクト
新しい設定。 オブジェクトは、すべての設定をキーと値のペアとして保持します。

次の使用例は、テンプレートのタイトル テキストを変更します。

rtp("set", "rcmd", "richmedia","template1",
    {
        "rcmd.title.text": "RECOMMENDED CONTENT"
    }
);

次の使用例は、テンプレートのカテゴリと複数の設定プロパティを設定します。

rtp("set", "rcmd", "richmedia",
    {
        "template1":
        {
            "rcmd.title.text": "RECOMMENDED CONTENT",
            "rcmd.general.font.family": "arial",
            "category":
            [
                "webinar",
                "blog posts",
                "pricing_page_category",
                "product_a_category"
            ]
        }
    }
);

予測コンテンツレコメンデーションに表示されるコンテンツをフィルタリングするには、「カテゴリ」を使用します。 有効なすべてのコンテンツに予測コンテンツを使用するには、「カテゴリ」を空のままにします。

リッチメディアテンプレート内の特定のコンテンツのみをレコメンデーションするには、コンテンツの設定ページでコンテンツのカテゴリを追加します。 その後、そのカテゴリをレコメンデーションテンプレートコードに関連付けます。 たとえば、web サイトの製品セクションやソリューションセクションごとに、関連コンテンツを分類します。

次の使用例は、テンプレートに複数の設定プロパティを設定します。

rtp("set", "rcmd", "richmedia",
    {
        "template1":
        {
            "rcmd.title.text": "RECOMMENDED CONTENT",
            "rcmd.general.font.family": "arial"
        }
    }
);

設定プロパティ

設定
説明
rcmd.general.font.family
“rcmd.general.font.family” : “arial”
テンプレート内のすべてのテキストのフォントファミリーを変更します。 このプロパティは、ブラウザータイプ別のすべての CSS 値をサポートします。 ページに存在する場合は、カスタムフォントファミリーを使用できます。
rcmd.content.background.color
“rcmd.content.background.color” : “black”
テンプレートの内部ボックスの背景色を変更します。 このプロパティは、ブラウザータイプ別のすべての CSS 値をサポートします。
rcmd.title.text
“rcmd.title.text” : “RECOMMENDED CONTENT”
テンプレートのタイトルを変更します。
rcmd.title.background.color
“rcmd.title.background.color” : “blue”
タイトルボックスの背景色を変更します。 このプロパティは、すべての css カラー値(color name、rgb など)をサポートします。
rcmd.title.font.size
“rcmd.title.font.size” : “26px”
タイトルのフォントサイズを変更します。 このプロパティは、使用可能なすべてのフォントサイズの CSS 値(px、em など)をサポートします。
rcmd.title.font.color
“rcmd.title.font.color” : “white”
タイトルのフォントカラーを変更します。 このプロパティは、すべてのフォントカラー値(rgb、hex など)をサポートします
rcmd.description.font.color
“rcmd.description.font.color” : “white”
説明のフォントカラーを変更します。 このプロパティは、すべてのフォントカラー値(rgb、hex など)をサポートします
rcmd.cta.background.color
“rcmd.cta.background.color” : “green”
ボタンの背景色を変更します。 このプロパティは、すべての css カラー値(color name、rgb など)をサポートします。
rcmd.cta.font.color
“rcmd.cta.font.color” : “rgb(90, 84, 164)”
ボタンのフォントカラーを変更します。 このプロパティは、すべてのフォントカラー値(rgb、hex など)をサポートします
rcmd.cta.text
“rcmd.cta.text” : “Push”
ボタンのテキストを変更します。 テキストは、すべてのボタンで同じです。
カテゴリ
“category” : [“one category”]
このテンプレートがサポートするレコメンデーションカテゴリを変更します。 テンプレートには、この設定で指定されたカテゴリの 1 つを持つレコメンデーションのみが表示されます。

設定のサポートはテンプレートによって異なります。

基本的な例

次の使用例は、1つのテンプレートに3つの推奨事項を表示します。 この例をHTML ページにコピーし、RTP タグをタグに置き換えます。

<!DOCTYPE>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>RTP recommendation</title>
<!-- RTP tag -->
<script type='text/javascript'>

// This tag needs to be replaced with your account tag
(function(c,h,a,f,i,e){c[a]=c[a]||function(){(c[a].q=c[a].q||[]).push(arguments)};
c[a].a=i;c[a].e=e;var g=h.createElement("script");g.async=true;g.type="text/javascript";
g.src=f+'?aid='+i;var b=h.getElementsByTagName("script")[0];b.parentNode.insertBefore(g,b);
})(window,document,"rtp","//example.rtp.com/rtp-api/v1/rtp.js","account_id");

// Send page view (required by  the recommendation)
rtp('send','view');
// Populate recommendation
rtp('get','rcmd', 'richmedia');
</script>
<!-- End of RTP tag -->
</head>
<body>
<div class="RTP_RCMD2" data-rtp-template-id="template1"></div>
</body>
</html>

高度な例

次の使用例は、1つのテンプレートに3つの推奨事項を表示します。 テンプレートタイトルは「おすすめコンテンツ」、ボタンテキストは「続きを読む」です。 この例をHTML ページにコピーし、RTP タグをタグに置き換えます。

<!DOCTYPE>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>RTP recommendation</title>
<!-- RTP tag -->
<script type='text/javascript'>

// This tag needs to be replaced with your account tag
(function(c,h,a,f,i,e){c[a]=c[a]||function(){(c[a].q=c[a].q||[]).push(arguments)};
c[a].a=i;c[a].e=e;var g=h.createElement("script");g.async=true;g.type="text/javascript";
g.src=f+'?aid='+i;var b=h.getElementsByTagName("script")[0];b.parentNode.insertBefore(g,b);
})(window,document,"rtp","//example.rtp.com/rtp-api/v1/rtp.js","account_id");

// Send page view (required by  the recommendation)
rtp('send','view');
// Populate the recommendation zone
rtp('get', 'campaign',true);
// Change template configuration
rtp('set', 'rcmd', 'richmedia',
    {
        template1 :
        {
            "rcmd.title.text" : "RECOMMENDED CONTENT",
            "rcmd.cta.text" : "Read More"
        }
    }
);
// Populate recommendation
rtp('get','rcmd', 'richmedia');
</script>
<!-- End of RTP tag -->
</head>
<body>
<div class="RTP_RCMD2" data-rtp-template-id="template1"></div>
</body>
</html>

リッチメディアレコメンデーションテンプレート #1 の例

名前: template1

説明:画像、タイトル、説明、call-to-action ボタンを含む横方向のコンテンツ。

リッチメディアテンプレート

リッチメディアレコメンデーションテンプレート #2 の例

名前: template2

説明:画像、タイトル、説明、call-to-action ボタンを含む縦方向のコンテンツ。

リッチメディアテンプレート

リッチメディアレコメンデーションテンプレート #3 の例

名前: template3

説明: タイトルと説明のみを含む垂直方向のコンテンツ。 マウスカーソルを合わせると、ヘッダーの色が変わり、コンテンツ URLへのリンクが表示されます。 また、説明は色を変更せずにコンテンツにリンクされます。

リッチメディアテンプレート

recommendation-more-help
marketo-developer-help