式フラグメントの活用 use-expression-fragments
パーソナライゼーションエディターを使用する場合は、現在のサンドボックスに作成または保存されたすべての式フラグメントを活用できます。
フラグメントは、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」の値で上書きしています。 これにより、「スポーツ」変数が参照されるあらゆる場所で、フラグメントコンテンツに「ヨガ」が表示されます。
式フラグメントに編集可能なフィールドを追加し、メール作成時にその値を上書きする方法を示す例は、このセクション で利用できます。
継承を解除 break-inheritance
パーソナライゼーションエディターにフラグメント IDを追加すると、元のエクスプレッションフラグメントに加えられた変更が同期されます。
ただし、エクスプレッションフラグメントのコンテンツをエディターにペーストすることもできます。 コンテキストメニューから、「フラグメントを貼り付け」を選択して、そのコンテンツを挿入します。
その場合、元のフラグメントからの継承は壊れています。 フラグメントのコンテンツがエディターにコピーされ、変更が同期されなくなります。
これは、元のフラグメントにリンクされなくなったスタンドアロン要素になります。コード内の他の要素として編集できます。