ドキュメントCampaignCampaign Classic v7 ドキュメント

[v8 にも適用されます]{class="badge positive" title="Campaign v8 にも適用されます"}

命令の前処理 pre-processing-instructions

Last update: Thu Sep 19 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • トピック：

作成対象：

  • ユーザー
  • 開発者

配信コンテンツで特定の構文を使用して、命令を追加し、トラッキングされるメールの URL をスクリプト化できます。 <%@ 命令は JavaScript ではありません。Adobe Campaign 固有の構文です。

<%@ 命令は、配信コンテンツのコンテキストでのみ適用されます。これは、メールの URL をスクリプト化し、引き続き（URL パラメーター以外を）トラッキングする唯一の方法です。<%@ 命令は、トラッキングするリンクを検出する前の配信分析中に、自動のコピー＆ペーストとして適用されることがあります。

次の 3 種類の命令があります。

  • include：主にオプション、パーソナライゼーションブロック、外部ファイル、ページに含まれる一部のコードを変数化します。詳細情報
  • value：配信のフィールド、配信変数、配信に読み込まれたカスタムオブジェクトにアクセスできるようにします。詳細情報
  • foreach：カスタムオブジェクトとして読み込まれた配列をループ処理します。 詳細情報

配信アシスタントから直接テストできます。これらはコンテンツのプレビューに適用され、トラッキングボタンをクリックすると、URL のリストが表示されます。

include include

最も一般的に使用される例を次に示します。

  • ミラーページリンクのインクルード：

    code language-none 
    <%@ include view="MirrorPage" %>

  • ミラーページの URL：

    code language-none 
    View as a <a href="<%@ include view='MirrorPageUrl' %>" _label="Mirror Page" _type="mirrorPage">web page.

  • 標準の購読解除 URL：

    code language-none 
    <%@ include option='NmsServer_URL' %>/webApp/unsub?id=<%= escapeUrl(recipient.cryptedId)%>

  • その他の例：

    code language-none 
    <%@ include file='http://www.google.com' %>
<%@ include file='file:///X:/france/service/test.html' %>
<%@ include option='NmsServer_URL' %>

    正しい構文を取得するには、配信アシスタントのパーソナライゼーションボタンを使用します。

value value

この命令は、すべての受信者に対して一定の配信パラメーターに対するアクセスを許可します。

構文：

<%@ value object="myObject" xpath="@myField" index="1" %>

説明：

  • object：オブジェクト（例：配信、プロバイダーなど）の名前。オブジェクトは次のいずれかになります。

    • delivery：現在の配信の場合（詳細と制限事項については下記を参照）。
    • provider：現在の配信プロバイダー／ルーティング（nms:externalAccount）の場合。
    • 追加のスクリプトオブジェクト：オブジェクトがコンテキスト内で次から読み込まれる場合：プロパティ／パーソナライゼーション／実行コンテキストにオブジェクトを追加。
    • foreach ループの項目：下の Foreach の節を参照してください。

  • xpath：フィールドの xpath。

  • index （オプション）：object が配列（追加のスクリプトオブジェクト向け）の場合、配列内の項目インデックス（0 から開始）。

delivery オブジェクト delivery-object

メールのパーソナライゼーションの場合、delivery オブジェクトは次の 2 とおりの方法でアクセスできます。

  • JavaScript の使用：

    code language-none 
    <%= delivery.myField %>`.

    JavaScript オブジェクト配信では、カスタムフィールドはサポートされていません。プレビューでは動作しますが、MTA では動作しません（MTA は標準の配信スキーマのみアクセス可能）。

  • 前処理の使用：

    code language-none 
    <%@ value object="delivery"

注意

ミッドソーシング経由で送信される配信に次の命令を使用する場合は、マーケティングプラットフォームとミッドソーシングプラットフォームの両方の nms:delivery スキーマにカスタムフィールド @myCustomField を追加する必要があります。

<%@ value object="delivery" xpath="@myCustomField" %>

配信パラメーターや配信変数の場合は、次の構文を使用します（delivery オブジェクトを使用）。

<%@ value object="delivery" xpath="variables/var[@name='myVar']/@stringValue" %>

JavaScript セクション内の value value-in-javascript

JavaScript セクションで <%@ value を使用できるようにするために、次の 2 つの特別なオブジェクトが <% と %> に置き換えられます。

<%@ value object='startScript' %>
<%@ value object='endScript' %>

例：

<%@ value object='startScript' %> var iMode = <%@ value object="delivery" xpath="@deliveryMode" %> if(iMode == 1) { ... } else { ... }`
`<%@ value object='endScript' %> is expanded in something like <% var iMode = 1 if(iMode == 1) { ... } else { ... } %>.

foreach foreach

この命令は、配信に読み込まれたオブジェクトの配列の反復を可能にし、オブジェクトに関連する個々のリンクをトラッキングします。

構文：

<%@ foreach object="myObject" xpath="myLink" index="3" item="myItem" %> <%@ end %>

説明：

  • object：開始点となるオブジェクトの名前。通常は追加のスクリプトオブジェクトですが、配信の場合もあります。
  • xpath（オプション）：ループ処理の対象となるコレクションの xpath。 デフォルトは「.」です。これは、オブジェクトがループ処理の対象となる配列であることを意味します。
  • index（オプション）：xpath が「.」でなく、オブジェクトが配列そのものである場合は、オブジェクトの項目インデックスです（0 から開始）。
  • item（オプション）：foreach ループ内で <%@ 値でアクセス可能な新しいオブジェクトの名前。 初期設定は、スキーマ内のリンク名です。

例：

配信プロパティ／パーソナライゼーションで、記事の配列と、受信者と記事のリレーションテーブルを読み込みます。

これらの記事へのリンクの表示は、次のように JavaScript を使用して容易におこなえます。

<%
  for(var i=0; i<recipient.rcpArticle.length; i++ )
  {
    %><a href="http://nl.net?a.jsp?article=<%=recipient.rcpArticle[i].article.@id%>">article</a><%
  }
%>

この方法では、すべての記事へのリンクが区別なくトラッキングされます。受信者が記事のリンクをクリックしたことはわかりますが、どの記事かはわかりません。

解決策は次のとおりです。

  1. 可能なすべての記事を、配信の追加スクリプト配列（articleList[]）で事前に読み込んでおきます。つまり、可能な記事数は有限である必要があります。

  2. コンテンツの先頭に JavaScript 関数を記述します。

    code language-none 
    <%@ value object='startScript' %>
function displayArticle(articleId)
{
  <%@ foreach object="articleList" item="article" %>
    if( articleId == <% value object="article" xpath="@id" %> )
    {
      <%@ value object='endScript' %>
        <a href="http://nl.net?a.jsp?article=<%@ value object="article" xpath="@id" %>">article</a>
      <%@ value object='startScript' %>
    }
  <%@ end @%>
}
<%@ value object='endScript' %>

  3. 関数を呼び出して記事を表示します。

    code language-none 
    <%
for(var i=0; i<recipient.rcpArticle.length; i++ )
{
 displayArticle(recipient.rcpArticle[i].article.@id)
}
%>
recommendation-more-help
601d79c3-e613-4db3-889a-ae959cd9e3e1