このページでは、式フラグメントをパーソナライゼーションエディターに挿入して再利用する方法、暗黙的な変数を操作する方法、ループ内でフラグメントを使用する方法、編集可能なフィールドをカスタマイズする方法、Adobe Journey Optimizerでの継承を解除する方法について説明します。
パーソナライゼーションエディターを使用すると、現在のサンドボックスに作成または保存されたすべての式フラグメントを活用できます。
フラグメントは、Journey Optimizer キャンペーンおよびジャーニー全体で参照できる、再利用可能なコンポーネントです。 この機能を使用すると、複数のカスタムコンテンツブロックを事前に構築し、マーケティングユーザーはそのコンテンツブロックを使用して、改善されたデザインプロセスでコンテンツを迅速に組み立てることができます。 詳しくは、フラグメントを参照してください。
➡️ フラグメントの管理、作成、使用方法について詳しくは、このビデオを参照してください。
式フラグメントの使用 use-expression-fragment
コンテンツに式フラグメントを追加するには、次の手順に従います。
-
パーソナライゼーションエディターを開き、左側のパネルで「フラグメント」ボタンを選択します。
リストには、現在のサンドボックスで作成またはフラグメントとして保存されたすべての式フラグメントが表示されます。 フラグメントの作成方法を学ぶ
作成日で並べ替えられます。最近追加された式フラグメントは、リストの最初に表示されます。
また、このリストを更新することもできます。
note NOTE コンテンツの編集中に一部のフラグメントが変更または追加された場合、リストは最新の変更内容に更新されます。 -
式フラグメントの横にある「+」アイコンをクリックして、対応するフラグメント ID をエディターに挿入します。
note caution CAUTION 任意の ドラフト または ライブ フラグメントをコンテンツに追加できます。 ただし、ジャーニーまたはキャンペーンで ドラフト ステータスのフラグメントを使用している場合、そのジャーニーまたはキャンペーンはアクティブ化できません。 ジャーニーまたはキャンペーンの公開時に、ドラフトフラグメントにエラーが表示されるので、公開するには承認する必要があります。 -
フラグメント ID を追加したら、対応する式フラグメントを開いてインターフェイスから編集すると、変更が同期されます。 これらは、そのフラグメント ID を含むすべてのドラフトまたはライブジャーニー／キャンペーンに自動的に生成されます。
-
フラグメントの横にある「その他のアクション」ボタンをクリックします。 開いたコンテキストメニューから「フラグメントを表示」を選択すると、そのフラグメントに関する詳細情報が表示されます。 また、フラグメント ID も表示され、ここからコピーできます。
-
コンテキストメニューの「フラグメントを開く」オプションを使用するか、フラグメント情報パネルから式フラグメントを別のウィンドウで開き、そのコンテンツとプロパティを編集できます。 詳しくは、フラグメントの編集方法を参照してください
-
その後、パーソナライゼーションエディターのパーソナライズ機能とオーサリング機能をすべて使用して、通常どおりコンテンツをカスタマイズして検証できます。
-
場合によっては、変数の計算のみが必要となり、式フラグメントのコンテンツは非表示にした方がよいこともあります。 これを行うには、
render属性を使用してfalseに設定します。 次に例を示します。code language-none Hi {{profile.person.name.firstName|fragment id='ajo:fragmentId/variantId' mode ='inline' render=false}}
暗黙的変数の使用 implicit-variables
暗黙的変数は、既存のフラグメント機能を強化して、コンテンツの再利用性とスクリプトのユースケースの効率を向上させます。 フラグメントは入力変数を使用し、キャンペーンおよびジャーニーコンテンツで使用できる出力変数を作成できます。
この機能は、例えば、現在のキャンペーンやジャーニーに基づいてメールのトラッキングパラメーターを初期化し、これらのパラメーターをメールコンテンツに追加されたパーソナライズされたリンクに使用できます。
次のようなユースケースが考えられます。
-
フラグメントでの入力変数の使用
フラグメントをキャンペーン／ジャーニーアクションコンテンツで使用すると、フラグメント外で宣言された変数を活用できます。 以下に例を示します。
utm_content変数がキャンペーンコンテンツで宣言されていることがわかります。 ヒーローブロックというフラグメントが使用されると、utm_contentパラメーター値が追加されるリンクが表示されます。 最終結果は、https://luma.enablementadobe.com?utm_campaign= Product_launch&utm_content= start_shoppingです。 -
フラグメントの出力変数の使用
フラグメント内で計算または定義された変数は、コンテンツ内で使用できます。 次の例では、フラグメント F1 によって、一連の変数が宣言されています。
メールコンテンツでは、次のパーソナライズ機能を使用できます。
フラグメント F1 は、変数
utm_campaignおよびutm_contentを初期化します。 次に、メッセージコンテンツ内のリンクに、これらのパラメーターが追加されます。 最終結果は、https://luma.enablementadobe.com?utm_campaign= Product_launch&utm_content= start_shoppingです。
ループ内の式フラグメントの使用 fragments-in-loops
{{#each}} ループ内で式フラグメントを使用する際は、変数範囲の仕組みを理解することが重要です。 式フラグメントは、メッセージコンテンツで定義されているグローバル変数にアクセスできますが、ループ固有の変数をパラメーターとして受け取ることはできません。
サポートされているパターン：グローバル変数の使用 global-variables-in-loops
式フラグメントは、ループ内から呼び出される場合でも、フラグメント外部で定義されているグローバル変数を参照できます。 これは、反復コンテキストでフラグメントを使用する必要がある場合に推奨されるアプローチです。
例：ループ内でグローバル変数を使用したフラグメントの使用
メッセージコンテンツで、グローバル変数を定義し、それを参照するフラグメントを使用します。
式フラグメント（fragment123）では、globalDiscount 変数を参照できます。
このパターンが機能するのは、ループコンテキストに関係なく、フラグメント内を含むメッセージ全体でグローバル変数にアクセスできるからです。
サポートされないパターン：フラグメントパラメーターとしてのループ変数の受け渡し loop-variables-limitations
現在の反復項目（上記の例では product）をパラメーターとして式フラグメントに渡すことはできません。 フラグメントは、周囲の {{#each}} ブロックからループ範囲の変数に直接アクセスできません。
例：機能しない内容
現在の実装ではループ固有の変数に対するパラメーターの受け渡しがサポートされていないので、フラグメントは product をパラメーターとして受け取り、内部で使用できません。
推奨される回避策 fragments-in-loops-workarounds
ループからのデータで式フラグメントを使用する必要がある場合は、次の方法を考慮します。
-
メッセージにロジックを直接含める：ループ固有のロジックにフラグメントを使用する代わりに、
{{#each}}ブロック内にパーソナライゼーションコードを直接追加します。code language-handlebars {{#each context.journey.actions.GetProducts.items as |product|}} <div class="product"> <h3>{{product.name}}</h3> <p>Price: ${{product.price}}</p> {{#if product.price > 100}} <span class="premium-badge">Premium Product</span> {{/if}} </div> {{/each}} -
ループ外でフラグメントを使用：フラグメントコンテンツがループに依存しない場合は、反復ブロックの前または後にフラグメントを呼び出します。
code language-handlebars {{fragment id='ajo:fragment123/variant456' mode='inline'}} {{#each context.journey.actions.GetProducts.items as |product|}} <div class="product"> <h3>{{product.name}}</h3> <p>Price: ${{product.price}}</p> </div> {{/each}} -
複数のグローバル変数を設定：反復をまたいでフラグメントに異なる値を渡す必要がある場合は、各フラグメントの呼び出しの前にグローバル変数を設定します（ただし、これにより柔軟性が制限されます）。
編集可能フィールドのカスタマイズ customize-fields
変数を使用して式フラグメントの特定の部分が編集可能になっている場合は、特定の構文を使用して、それらのデフォルト値を上書きできます。 詳しくは、フラグメントをカスタマイズ可能にする方法を参照してください
フィールドをカスタマイズするには、次の手順に従います。
-
フラグメントメニューからコードにフラグメントを挿入します。
-
構文の最後にある
<fieldId>="<value>"コードを使用して、変数のデフォルト値を上書きします。次の例では、ID が「sports」である変数の値を「yoga」値で上書きしています。 これにより、フラグメントコンテンツで「sport」変数が参照されているすべての箇所に「yoga」が表示されます。
メールの作成時に編集可能なフィールドを式フラグメントに追加し、その値を上書きする方法を示す例について詳しくは、この節を参照してください。
動的フラグメント解決の使用 dynamic-resolution
デザイン時にフラグメント IDを静的に埋め込む代わりに、受信者ごとに実行時にフラグメント IDを動的に解決できます。 これにより、プロファイル属性、データセット参照、コンテキストデータにもとづいて、異なるプロファイルが同じキャンペーンやジャーニー内で完全に異なるコンテンツブロックを受け取ることができます。
継承の解除 break-inheritance
パーソナライゼーションエディターにフラグメント ID を追加すると、元の式フラグメントに行った変更が同期されます。
ただし、式フラグメントのコンテンツをエディターにペーストすることもできます。 コンテキストメニューから「フラグメントをペースト」を選択して、そのコンテンツを挿入します。
その場合、元のフラグメントからの継承は壊れます。 フラグメントのコンテンツはエディターにコピーされ、変更内容は同期されなくなります。
これは、元のフラグメントにリンクされなくなったスタンドアロン要素になります。コード内の他の要素として編集できます。
クイックリファレンス quick-reference
このセクションには、このトピックに関連する解釈、検索、質問への回答をサポートすることを目的とした構造化された知識が含まれています。
理解を深めるには、この情報をこのページのドキュメントと組み合わせる必要があります。 どちらのソースも単独で使用することを意図していません。このページでは、機能について説明しますが、この節では、用語、意図、適用可能性、および制約の曖昧さを解消するのに役立つ追加のコンテキストを提供します。
TL;DR
このページでは、パーソナライゼーションエディターでエクスプレッションフラグメントを挿入、カスタマイズ、管理する方法について説明します。具体的には、暗黙的な変数、ループ内のフラグメントの使用、編集可能なフィールド、動的解決、ブレイキング継承などが含まれます。
インテント
- フラグメントメニューからエクスプレッションフラグメントを挿入し、自動変更の反映について理解する
- 暗黙的な変数を使用：入力変数（フラグメントの外側で宣言され、内部で使用される）および出力変数（フラグメントの内側で宣言され、周囲のメッセージコンテンツで使用される）を使用します。
- ループ内で式フラグメントを使用する – フラグメントへのアクセスにグローバル変数を活用します。ループ範囲の変数をパラメーターとして渡す際の制限について説明します。
<fieldId>="<value>"構文を使用して、カスタマイズ可能なフラグメントの編集可能フィールドを上書きする- プロファイル属性、データセット参照、コンテキストデータにもとづいて、実行時にフラグメント IDを動的に解決します
- フラグメントコンテンツを直接エディターにペーストすることで、継承を解除できます
- 式フラグメント：施策とジャーニーでIDによって参照される再利用可能なパーソナライゼーション式コンポーネント。フラグメントへの変更は、それを参照するすべてのコンテンツに自動的に反映されます。 （製品固有）
- 暗黙的な変数: フラグメント機能を拡張する変数 – 入力変数（キャンペーン/ジャーニーコンテンツで宣言され、フラグメント内で消費される）および出力変数（フラグメント内で宣言され、周囲のメッセージコンテンツで使用可能）。 （製品固有）
- 入力変数: フラグメントが内部的に参照して使用できる、（キャンペーンまたはジャーニーコンテンツ内の）フラグメントの外部で宣言された変数。
- 出力変数: フラグメント内で宣言または計算された変数。フラグメントが呼び出された後、周囲のメッセージコンテンツで使用できるようになります。
- 編集可能なフィールド：挿入ユーザーがフラグメントソースを編集せずに
<fieldId>="<value>"構文を使用してデフォルト値を上書きできるように公開されたフラグメント変数。 （製品固有） - 動的フラグメント解決：デザイン時に静的フラグメント IDを埋め込むのではなく、実行時（プロファイル属性、データセット参照、コンテキストデータに基づく）にフラグメント IDを解決する機能。 （製品固有）
- 継承を解除: コンテキストメニューから「フラグメントをペースト」を使用すると、フラグメントのコンテンツが、元のフラグメントと同期しなくなったスタンドアロン要素としてエディターにコピーされます。 （製品固有）
- 正規名：式フラグメント – バリアント：フラグメント、式フラグメント
- 類義語： 「フラグメント ID」 =式でフラグメントを参照するために使用される識別子
- IDでフラグメントを挿入する（参照済み、変更内容がすべてのコンテンツに自動的に反映される）≠、継承/ペースト フラグメントを壊す（コンテンツがエディターにコピーされる、スタンドアロン要素が元の要素にリンクされなくなった）を混同しないでください
- 入力変数を混同しないでください（フラグメントの外側で宣言され、内部で消費される）≠出力変数（フラグメントの内側で宣言され、周囲のメッセージコンテンツの外側で消費される）
- ドラフトフラグメント：を混同しないでください（コンテンツに追加できますが、承認されるまでジャーニー/キャンペーンの公開をブロックします） ≠ ライブフラグメント（完全に公開されます。アクティブなジャーニーとキャンペーンに対して安全です）
- 1つの配信に最大30個のフラグメントを追加できます。
- フラグメントをネストできるのは 1 レベルまでです。
- ジャーニーまたはキャンペーンは、ドラフトステータスのフラグメントが含まれている場合、アクティブ化または公開できません。ドラフトフラグメントは、公開前に承認する必要があります。
- 式フラグメントは、ループ範囲の変数（現在の
{{#each}}回の反復項目）をパラメーターとして受け取ることができません。これは既知の制限です。 回避策として、グローバル変数またはインラインロジックを使用します。 - SMSまたはプッシュコンテンツで複数の改行を含むフラグメントが使用されている場合、改行は保持されます。送信前にコンテンツをテストします。
Q: 1回の配信で追加できるフラグメントの数は？
最大30個のフラグメント。
Q: フラグメントを他のフラグメント内にネストできますか？
はい。ただし、最大1 レベルのネストのみです。
Q: ジャーニーまたはキャンペーンでドラフトフラグメントを使用するとどうなりますか？
ドラフトフラグメントをコンテンツに追加することはできますが、フラグメントが承認され、ステータスが「ライブ」に変更されるまで、ジャーニーまたはキャンペーンをアクティブ化または公開することはできません。
Q：式フラグメントは、現在のループ項目（{{#each}}のproductなど）をパラメーターとして受け取ることができますか？
いいえ。 式フラグメントは、ループスコープの変数をパラメーターとして受け取ることはできません。 ループの外で宣言されたグローバル変数（フラグメントがアクセス可能）を使用するか、フラグメントを使用する代わりにパーソナライゼーションロジックをループ内に直接含めます。
Q：継承の解除とは何ですか。また、いつ使用すればよいですか？
継承を解除すると、コンテキストメニューの「フラグメントをペースト」を使用して、フラグメントのコンテンツをエディターに直接コピーする必要があります。 ペーストされたコンテンツは、元のフラグメントと同期しなくなったスタンドアロン要素になります。この要素は、編集可能なフィールドを超えてコンテンツをカスタマイズする必要がある場合に使用します。元のフラグメントに対する今後の変更はこのコピーに反映されません。