Adobe Experience Manager コンテンツフラグメントの操作 aem-fragments
Adobe Experience ManagerとJourney Optimizerの連携は、次のデータフローに従います。
-
Dispatcherの設定: Journey Optimizerがコンテンツフラグメント管理APIを介してAdobe Experience Manager コンテンツフラグメントにアクセスできるようにするには、まずDispatcherを設定する必要があります。 これは統合の前提条件です。
-
作成およびオーサー: コンテンツは、Adobe Experience Managerでコンテンツフラグメントとして作成および設定されます。
-
タグ付け: コンテンツフラグメントには、Journey Optimizer固有のタグ (
ajo-enabled:{OrgId}/{SandboxName})を付ける必要があります。 -
公開: コンテンツフラグメントはAdobe Experience Managerで公開され、Journey Optimizerで利用できるようになります。
-
アクセス: Journey Optimizerは、Adobe Experience Manager パブリッシュインスタンスから利用可能なコンテンツフラグメントをリアルタイムで取得して表示します。
-
統合: コンテンツフラグメントが選択され、キャンペーンまたはジャーニーに統合されます。
コンテンツフラグメントがAdobe Experience Managerで公開されると、Journey Optimizer側のコンテンツを更新するイベントが送信されます。 更新が成功すると、単一ジャーニーの場合は約5分以内に、次の処理バッチのユースケースでコンテンツフラグメントが使用可能になります。 更新がJourney Optimizerで利用可能になると、最新の公開済みコンテンツが、該当するすべてのキャンペーンとジャーニーで使用されます。
Experience Manager でのタグの作成と割り当て
Journey Optimizer でコンテンツフラグメントを使用する前に、Journey Optimizer 専用のタグを作成する必要があります。
-
Experience Manager 環境にアクセスします。
-
ツールメニューで、「タグ付け」を選択します。
-
「タグを作成」をクリックします。
-
ID が次の構文
ajo-enabled:{AJO-OrgId}/{AJO-SandboxName}に従っていることを確認します。 -
「作成」をクリックします。
-
Experience Manager ドキュメントの説明に従ってコンテンツフラグメントモデルを定義し、新しく作成した Journey Optimizer タグを割り当てます。
このリアルタイムの連携により、コンテンツが常に最新の状態に保たれるだけでなく、公開されたフラグメントの変更が、アクティブなキャンペーンやジャーニーにすぐに影響を与えます。
これで、Journey Optimizer で後で使用するためにコンテンツフラグメントの作成と設定を開始できます。詳しくは、Experience Manager ドキュメントを参照してください。
Experience Manager コンテンツフラグメントの追加 aem-add
AEM コンテンツフラグメントを作成およびパーソナライズした後、それを Journey Optimizer キャンペーンまたはジャーニーに読み込めるようになりました。
-
AEM コンテンツフラグメントにアクセスするには、任意のテキストフィールド内の
をクリックするか、HTML コンテンツコンポーネントを通じてソースコードを開きます。
-
左側のペインの AEM コンテンツフラグメントメニューで、「AEM CF セレクターを開く」をクリックします。
-
リストを参照し、コンテンツフラグメントを選択して、Journey Optimizer コンテンツに読み込みます。
note note NOTE フラグメントに1つ以上の公開済み バリエーションがある場合、バリエーション ドロップダウンがセレクターに表示されます。 バリエーションが選択されていない場合、メイン バリエーションが自動的に使用されます。 詳しくは、 コンテンツフラグメントのバリエーションの操作を参照してください。 -
「フィルターを表示」をクリックして、コンテンツフラグメントリストを微調整します。
デフォルトでは、コンテンツフラグメントフィルターは承認済みコンテンツのみを表示するようにプリセットされています。
-
コンテンツフラグメントを選択したら、選択をクリックして追加します。
-
「フラグメントを表示」をクリックして、フラグメント情報を表示します。フラグメント情報メニューを開くと、エディターは読み取り専用モードになります。
Adobe Experience Manager でフラグメントを表示するには、右側のメニューから「プレビュー」を選択します。
-
をクリックして、フラグメントの詳細メニューにアクセスします。- フラグメントをスワップ
- 参照を探索
- AEM で開く
-
フラグメントから目的のフィールドを選択して、コンテンツに追加します。
-
コンテンツフラグメント属性に保存されている画像URL (例:フラグメントモデルのパスまたはURL フィールド)を表示するには、HTMLに
<img>タグとフラグメント属性をソースとして挿入します。例:code language-html <img src="[insert your AEM Content Fragment attribute here]">note note NOTE Adobe Experience Managerの相対的な画像URLはサポートされていません。絶対 URLを使用してください。 -
丸薬:オフを選択して、丸薬のエクスペリエンスを有効にし、長い属性パスを非表示にして読みやすさを向上させます。
-
Adobe Experience Managerで作成された パーソナライゼーションプレースホルダー をフラグメントテキスト内で使用するには、Adobe Experience Managerのコンテンツフラグメントで次のように定義します。
{{name}}。Journey Optimizerでは、これらのトークンはプレースホルダーです。 丸薬のエクスペリエンスがオンになっている状態で、右側のパネルのAEM コンテンツフラグメント セクションにフラグメントフィールドと共に表示されます。
-
リアルタイムのパーソナライゼーションを有効にするには、コンテンツフラグメント内で使用されるすべてのプレースホルダーを、フラグメントヘルパータグ内のパラメーターとしてユーザーが明示的に宣言する必要があります。次のように、これらのプレースホルダーをプロファイル属性、コンテキスト属性、静的文字列、または定義済み変数にマッピングします。
-
プロファイルまたはコンテキスト属性のマッピング:プレースホルダーをプロファイルまたはコンテキスト属性に割り当てます(例:name = profile.person.name.firstName)。
-
静的文字列マッピング:二重引用符で囲んで固定文字列値を割り当てます(例:name = "John")。
-
変数マッピング:同じ HTML 内で以前に宣言された変数を参照します(例:name = 'variableName')。
この場合、次の構文を使用して、フラグメント ID を追加する前に、variableName が宣言されていることを確認します。code language-html {% let variableName = attribute name %}
次の例では、month プレースホルダーが、フラグメント内の profile.person.birthDate 属性にマッピングされています。
{modal="regular"}
-
-
「保存」をクリックします。メッセージのコンテンツをテストして確認するには、この節を参照してください。
テストを実行してコンテンツを検証したら、キャンペーンを送信したり、オーディエンスにジャーニーを公開したりできます。
Adobe Experience Manager を使用すると、コンテンツフラグメントが使用されている Journey Optimizer キャンペーンまたはジャーニーを識別できます。詳しくは、Adobe Experience Manager ドキュメントを参照してください。
コンテンツフラグメントのバリエーションの操作 aem-variations
Adobe Experience Managerでは、各コンテンツフラグメントは次の要素で構成されています。
- Main:常に存在するフラグメントのコアコンテンツは削除できず、すべてのバリエーションの基礎となります。
- バリエーション:作成者が特定のチャネルまたはシナリオ用に作成する メイン の1つ以上の置換。 バリエーションはフラグメント内に存在し、個別のアセットとしてではなく、Mainと比較して同期できます。
バリエーションの使用例:
- プッシュ通知のコピーの短いバージョンとメールの長いバージョン。
- 別のフラグメントを作成することなく、地域のトーンを調整。
- チャネル別メッセージ(モバイルと比較したwebなど)。
➡️ 詳しくは、Adobe Experience Manager ドキュメント を参照してください
Journey Optimizerでは、フラグメントを挿入する際に使用するバリエーションを選択できるので、フラグメントを複製することなく、Adobe Experience Managerの同じソースコンテンツの異なるレンディションに依存して、様々なキャンペーンやジャーニーを作成できます。
バリエーションを選択するには:
-
キャンペーン または ジャーニーを開きます。
-
任意のテキストフィールドで
をクリックするか、HTML コンテンツコンポーネントからHTML ソースを開きます。 -
AEM コンテンツフラグメントから、CF セレクターを開くをクリックします。
-
テーブルビューでロケール固有のAdobe Experience Manager コンテンツフラグメントを選択するには、テーブルのカスタマイズを使用して 言語 列を追加します。 ロケール値がテーブルに表示され、適切なフラグメントを特定して選択できます。
-
コンテンツフラグメントを選択します。
-
をクリックして、詳細 メニューを開きます。 フラグメントに1つ以上の公開済みバリエーションがある場合、フラグメントの詳細の横に「バリエーション」ドロップダウンが表示されます。
-
クイックの詳細 メニューで「参照を検索」をクリックすると、Adobe Experience Managerで関連オプションを開いて、バリエーションの詳細、プレビュー、プルーフが利用可能な場合に表示されます。
-
バリエーションを選択し、選択をクリックします。
note note NOTE バリエーションを選択しない場合、またはバリエーションのサポートが利用可能になる前にフラグメントが追加された場合、Journey Optimizerは配信時にMain バリエーションを自動的に使用します。
バリエーションを含むフラグメントを挿入した後、Adobe Experience Managerでフラグメントを再公開すると、アクティブなキャンペーンまたはジャーニー内の 参照バリエーション ごとに自動的に更新されます。 プレビューとプルーフでは、選択したバリエーションと、そのバリエーションの最新の公開コンテンツが引き続き使用されます。