Skip to main content
コードテンプレートでは、ウィジェットの JavaScript、CSS、HTML を自分で記述します。その後、チームメンバーは、ウィジェットごとに設計された構成フォームに入力します。
コーディングに不慣れな場合は、すぐに使えるウィジェットを利用するか、開発者に協力を依頼してください。

新しいテンプレートを作成する

コードを使用して新しいウィジェットテンプレートを作成するには、次の手順に従います。
  1. Studio > Widgets > New widget をクリックします。
  2. Using code を選択します。
  3. テンプレートに名前を付け、Web サイトを関連付け、必要に応じて説明とタグを追加します。
  4. Create をクリックします。

テンプレートエディタ

テンプレートエディタには左パネルとコンテンツゾーンがあります。

Left panel

左上にはテンプレートのタイトルが表示されます。タイトルにカーソルを合わせ、pencil icon をクリックしてテンプレートの名前を変更します。 このパネルには、テンプレートを作成するための 2 つのステップがあります。
  • Code to run
  • Configuration form

Content zone

テンプレートのコードを入力する、テンプレートエディタのコンテンツゾーン
このエリアにテンプレートのコードを入力します。

テンプレートをコーディングする

中央のコンテンツエリアを使ってウィジェットテンプレートをコーディングします。このコードは、Web サイトのページ上にウィジェットを生成します。エディタには、異なるコードタイプ用の 3 つのタブがあります。
  • JS(JavaScript)
  • CSS
  • HTML
デフォルトでは JS タブがアクティブです。コードを空白エリアに記述します。 テンプレートを検証するには、JS タブに少なくとも 10 文字を入力します。テンプレートを作成するのに JavaScript だけで十分ですが、HTML や CSS も追加できます。 リストやテキストフィールドなどの要素を Kameleoon スタイルシートに従ってフォーマットするには、このデフォルト CSS を使用します。
コードを記述した後、左パネルの Configuration form をクリックして構成ステップに進みます。

特殊なケース: 変数

ウィジェットでチームメンバーが入力するフィールド(変数)を使用するには、Configuration form ステップの対応するフィールドに templateData 属性を追加します。 例:
変数を取得するには、Code to run ステップで UserData を使用します。 例:

構成フォームを作成する

Configuration form interface
Configuration form ステップを使って、チームメンバーがウィジェットを設定するためのフォームを構築します。このステップでは HTML タブと CSS タブのみが利用できます。

HTML tab

HTML タブに構成フォーム用の HTML コードを入力します。チームメンバーはこのフォームを使用してテンプレートを設定し、ウィジェットを作成します。 フォームの各フィールドには、次の構文で属性を含める必要があります: templateData="[NameOfYourChoice]"。

CSS tab

CSS タブで追加したスタイルは構成フォームに適用されます。このステップは任意です。

Activate the template

テンプレートを確定するには、エディタページの右上隅にある Activate をクリックします。
JS タブに 10 文字未満を入力した場合、Activate は利用できません。

作成したテンプレートを管理する

テンプレートを作成すると、Widgets ダッシュボードにカードとして表示されます。

実験でウィジェットを使用する

コードウィジェットを実験に関連付けるには:
  1. Graphic editor を使って実験を開くか作成します。
  2. 左サイドバーで Elements の横の Add をクリックします。
  3. 開いた Add element サイドバーで Widgets をクリックします。
  4. リストからカスタムウィジェットを選択して構成します。
Add widget

ウィジェットをプレビューする

コードベースのウィジェットテンプレートには直接的なSimulateアクションがありません。Widgetsダッシュボードの三点リーダーメニューでは、コードベースのウィジェットについてRename、Manage tags、Duplicate、Activate、Deleteのみが利用でき、テンプレートエディタのヘッダーではActivateのみが利用できます。
Three-dots menu for a code-based widget, showing no Simulate option
コードベースのウィジェットをプレビューするには、Graphic editorを使用してドラフト実験に追加します。左サイドバーでElementsの横のAddをクリックし、Widgetsをクリックして、リストからウィジェットを選択します。次に、Graphic editorでSimulateをクリックして、キャンペーン(ウィジェットを含む)を本番のような環境でテストしてから、ライブで公開します。シミュレーションパネルの詳細については、キャンペーンをシミュレートするを参照してください。