ドキュメントAEM 6.4オーサリングガイド

Adobe Campaign コンポーネント adobe-campaign-components

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

作成対象：

  • User
CAUTION
AEM 6.4 の拡張サポートは終了し、このドキュメントは更新されなくなりました。 詳細は、 技術サポート期間. サポートされているバージョンを見つける ここ.

Adobe Campaignと統合すると、ニュースレターやフォームを扱う際に使用できるコンポーネントが用意されます。 このドキュメントでは、両方について説明します。

Adobe Campaign ニュースレターコンポーネント adobe-campaign-newsletter-components

すべての Adobe Campaign コンポーネントは、メールテンプレートのベストプラクティスで大まかに説明されているベストプラクティスに従います。また、Adobe マークアップ言語 HTL をベースとしています。

Adobe Campaign と連携するように設定されているニュースレターまたはメールを開くと、「Adobe Campaign ニュースレター」セクションに以下のコンポーネントが表示されます。

  • 見出し (Campaign)
  • 画像 (Campaign)
  • リンク（Campaign）
  • Dynamic Media画像テンプレート (Campaign)
  • ターゲット参照 (Campaign)
  • テキストと画像 (Campaign)
  • テキストおよびパーソナライゼーション（Campaign）

これらのコンポーネントの説明は、次の節で説明します。

コンポーネントは次のように表示されます。

chlimage_1-105

見出し (Campaign) heading-campaign

見出しコンポーネントでは、次のいずれかを実行できます。

  • 現在のページの名前を表示するには、 タイトル フィールドが空白です。
  • 指定したテキストを タイトル フィールドに入力します。

次を編集： 見出し (Campaign) コンポーネントを直接使用します。 ページのタイトルを使用するには、空白のままにしてください。

chlimage_1-106

次の項目を設定できます。

  • タイトル
    ページタイトル以外の名前を使用する場合は、ここに入力します。

  • 見出しレベル（1、2、3、4）
    HTML の見出しサイズ 1～4 に基づいた見出しレベル。

見出し（Campaign）コンポーネントの表示例を以下に示します。

chlimage_1-107

画像 (Campaign) image-campaign

画像（キャンペーン）コンポーネントには、指定したパラメーターに従って、画像と付属のテキストが表示されます。

画像をアップロードした後、編集および操作できます（例えば、切り抜き、回転、リンク/タイトル/テキストの追加）。

画像は、 アセットブラウザー コンポーネントまたはその上に直接 設定ダイアログ. 設定ダイアログから画像をアップロードすることもできます。また、このダイアログボックスでは、画像のすべての定義と操作も制御します。

chlimage_1-108

NOTE
「代替テキスト」フィールドに情報を入力する必要があります。入力しないと画像を保存できません。

画像をアップロードした後に、インプレース編集を使用して、必要に応じて画像を切り抜いたり回転したりできます。

NOTE
インプレースエディターでは、編集時に、画像の元のサイズと縦横比を使用します。高さと幅のプロパティも指定できます。プロパティで定義したサイズや縦横比の制限は、編集の変更内容を保存するときに適用されます。
インスタンスによっては、ページのデザインによって最小および最大の制限が課される場合もあります。これらは、プロジェクト実装時に開発されます。

フルスクリーン編集モードで使用できる追加オプションがいくつか用意されています（マップ、ズームなど）。

画像を読み込む際は、次の設定が可能です。

  • マップ

    画像をマップするには、「マップ」を選択します。画像マップの作成方法（長方形、多角形など）を指定し、領域が指す位置を指定します。

  • 切り抜き

    「切り抜き」をクリックして画像を切り抜きます。マウスを使用して画像を切り抜きます。

  • 回転

    画像を回転するには、「回転」を選択します。画像が目的の向きになるまで繰り返し使用します。

  • 消去

    現在の画像を削除します。

  • ズームバー（クラシックのみ）

    画像のズームインおよびズームアウトを行うには、画像の下（「OK」および「キャンセル」ボタンの上）のスライドバーを使用します。

  • タイトル

    画像のタイトル。

  • 代替テキスト

    アクセシブルなコンテンツを作成する際に使用する代替テキスト。

  • リンク先

    web サイト内のアセットまたはその他のページへのリンクを作成します。

  • 説明

    画像の説明。

  • サイズ

    画像の高さと幅を設定します。

NOTE
「詳細」タブの「代替テキスト」フィールドに情報を入力する必要があります。入力しない場合は画像を保存できず、次のエラーメッセージが表示されます。
Validation failed. Verify the values of the marked fields.

画像（Campaign）コンポーネントの表示例を以下に示します。

chlimage_1-109

リンク（キャンペーン）コンポーネントを使用して、ニュースレターにリンクを追加できます。

以下の項目を「表示」、「URL 情報」または「詳細」タブで設定できます。

  • リンクのキャプション

    リンクのキャプション。 ユーザーに表示されるテキストです。

  • リンクツールヒント

    リンクの使用方法に関する追加情報を追加しました。

  • LinkType

    ドロップダウンリストで、 カスタム URL および アダプティブドキュメント. このフィールドは必須です. 「カスタム URL 」を選択した場合は、リンク URL を指定できます。 「アダプティブドキュメント」を選択した場合は、ドキュメントのパスを指定できます。

  • 追加の URL パラメータ

    その他の URL パラメーターを追加します。 「項目を追加」をクリックして、複数の項目を追加します。

NOTE
「URL 情報」タブの「リンクタイプ」フィールドに情報を入力する必要があります。入力しない場合はコンポーネントを保存できず、次のエラーメッセージが表示されます。
Validation failed. Verify the values of the marked fields.

リンク（Campaign）コンポーネントの表示例を以下に示します。

chlimage_1-110

Scene7 画像テンプレート (Campaign) scene-image-template-campaign

Scene7画像テンプレート はレイヤー化された画像ファイルで、コンテンツとプロパティをパラメータ化して可変性を持たせることができます。 この 画像テンプレート コンポーネントを使用すると、ニュースレター内でDynamic Media Classic( 旧称Scene7) テンプレートを使用して、テンプレートパラメーターの値を変更できます。 さらに、パラメーターの内部で Adobe Campaign メタデータ変数を使用して、ユーザーごとにパーソナライズされた画像を表示できます。

chlimage_1-111

コンポーネントを設定するには、「編集」をクリックします。このセクションで説明した設定を行うことができます。このDynamic Media Classic( 旧称Scene7) の画像テンプレートについて詳しくは、 Scene7画像テンプレートコンポーネント.

さらに、パラメーターパネルには、Dynamic Media Classic( 旧称Scene7) のテンプレートに対して定義されたすべてのテンプレートパラメーターが表示されます。 これらの各パラメーターについて、値を適応させたり、変数を挿入したり、デフォルト値にリセットしたりできます。

chlimage_1-112

ターゲット参照 (Campaign) targeted-reference-campaign

ターゲット参照 (Campaign) コンポーネントを使用して、ターゲット段落への参照を作成できます。

このコンポーネントでは、ターゲットの段落に移動して選択します。

フォルダーアイコンをクリックして、参照する段落に移動します。 終了したら、チェックマークをクリックします。

テキストと画像 (Campaign) text-image-campaign

テキストと画像 (Campaign) コンポーネントは、テキストブロックと画像を追加します。

クリックしてこのコンポーネントを設定する際には、「テキスト」または「画像」を選択します。

chlimage_1-113

選択 テキスト インラインエディタを表示します。

選択 画像 は、画像のインプレースエディターを表示します。

詳しくは、 画像 (Campaign) コンポーネント 画像の操作について詳しくは、を参照してください。 詳しくは、 テキストおよびパーソナライゼーション (Campaign) コンポーネント を参照してください。

テキストおよびパーソナライゼーション（Campaign）コンポーネントや画像（Campaign）コンポーネントと同様に、次の項目を設定できます。

  • テキスト

    テキストを入力. ツールバーを使用して、書式の変更、リストの作成、リンクの追加を行います。

  • 画像

    コンテンツファインダーから画像をドラッグするか、クリックして画像を参照します。 必要に応じて切り抜くか回転します。

  • 画像のプロパティ（詳細画像プロパティ）

    以下を指定できます。

    • タイトル

      ブロックのタイトル。マウスオーバーで表示されます。

    • 代替テキスト

      画像を表示できない場合に表示する代替テキスト。

    • リンク先

      web サイト内のアセットまたはその他のページへのリンクを作成します。

    • 説明

      画像の説明。

    • サイズ

      画像の高さと幅を設定します。

NOTE
「詳細」タブの「代替テキスト」フィールドは必須です。入力されていない場合、コンポーネントを保存できず、次のエラーメッセージが表示されます。
Validation failed. Verify the values of the marked fields.

テキストと画像（Campaign）コンポーネントの表示例を以下に示します。

chlimage_1-114

テキストおよびパーソナライゼーション（Campaign） text-personalization-campaign

テキストおよびパーソナライゼーション（Campaign）コンポーネントを使用すると、リッチテキストエディターの機能を備えた WYSIWYG エディターでテキストブロックを入力できます。さらに、このコンポーネントでは、Adobe Campaign のコンテキストフィールドとパーソナライゼーションブロックを使用できます。パーソナライゼーションの挿入も参照してください。

フォントの文字、配置、リンク、リスト、インデントなど、多様なアイコンでテキストの書式を設定できます。タッチ操作向け UI とクラシック UI の機能は基本的に同じですが、ルックアンドフィールは異なります。

chlimage_1-115

インプレースエディターでは、テキストの追加、位置合わせの変更、リンクの追加と削除、コンテキストフィールドやパーソナライゼーションブロックの追加、フルスクリーンモードの開始を行うことができます。 テキスト/パーソナライゼーションの追加が完了したら、チェックマークを選択して変更を保存します（または「x」を選択してキャンセルします）。 詳しくは、インプレース編集を参照してください。

NOTE
  • 使用できるパーソナライゼーションフィールドは、ニュースレターがリンクされている Adobe Campaign テンプレートによって異なります。
  • ContextHub からペルソナを選択すると、選択したプロファイルのデータでパーソナライゼーションフィールが自動的に置き換えられます。
詳しくは、 パーソナライゼーションの挿入.

chlimage_1-116

NOTE
nms:seedMember スキーマまたはその拡張で定義されているフィールドのみが考慮されます。nms:seedMember にリンクしているテーブルの属性は使用できません。

Adobe Campaign フォームコンポーネント adobe-campaign-form-components

Adobe Campaignコンポーネントを使用して、ユーザーがニュースレターの購読、ニュースレターの購読解除またはユーザープロファイルの更新を行うために入力するフォームを作成します。 詳しくは、 Adobe Campaign Formsの作成 を参照してください。

各コンポーネントフィールドは、 Adobe Campaignデータベースフィールドにリンクできます。 使用可能なフィールドは、の節で説明しているように、含まれるデータのタイプに応じて異なります コンポーネントとデータタイプ. Adobe Campaignで受信者スキーマを拡張する場合、データタイプが一致するコンポーネントで新しいフィールドが使用可能になります。

Adobe Campaign と統合するように設定されているフォームを開くと、「Adobe Campaign」セクションに以下のコンポーネントが表示されます。

  • チェックボックス （Campaign）
  • 日付フィールド (Campaign) と日付フィールド/HTML5 (Campaign)
  • 暗号化されたプライマリキー (Campaign)
  • エラー表示 (Campaign)
  • 非表示の紐付けキー（Campaign）
  • 数値フィールド （Campaign）
  • オプションフィールド （Campaign）
  • 購読チェックリスト（Campaign）
  • テキストフィールド （Campaign）

コンポーネントは次のように表示されます。

chlimage_1-117

ここでは、各コンポーネントについて詳しく説明します。

コンポーネントとデータタイプ components-and-data-type

次の表に、Adobe Campaignプロファイルデータの表示と変更に使用できるコンポーネントを示します。 各コンポーネントをAdobe Campaignプロファイルフィールドにマッピングして、値を表示し、フォームの送信時にフィールドを更新できます。 異なるコンポーネントは、適切なデータタイプのフィールドにのみ一致させることができます。

コンポーネント
Adobe Campaign フィールドのデータタイプ
フィールドの例
チェックボックス （Campaign）
ブール値
今後の連絡は不要（すべてのチャネル）

日付フィールド （Campaign）

日付フィールド / HTML 5 （Campaign）

date
生年月日
数値フィールド （Campaign）
数値 (byte、short、long、double)
年齢
オプションフィールド （Campaign）
関連する値のバイト
性別
テキストフィールド （Campaign）
文字列
メール

ほとんどのコンポーネントに共通の設定 settings-common-to-most-components

Adobe Campaignコンポーネントには、すべてのコンポーネントで共通の設定があります ( 暗号化されたプライマリキーと非表示の紐付けキーコンポーネントを除く )。

ほとんどのコンポーネントでは、次の設定を行うことができます。

タイトルとテキスト title-and-text

chlimage_1-118

  • タイトル

    要素名以外の名前を使用する場合は、ここに入力します。

  • タイトルを非表示にする

    タイトルを表示しない場合は、このチェックボックスを選択します。

  • 説明

    フィールドに説明を追加して、ユーザーに詳細情報を提供します。

  • 値の表示のみ

    値が存在する場合にのみ値を表示

Adobe Campaign adobe-campaign

次の項目を設定できます。

  • マッピング

    必要に応じて、Adobe Campaignのパーソナライゼーションフィールドを選択します。

  • 調整キー

    このフィールドが紐付けキーの一部である場合は、このチェックボックスを選択します。

chlimage_1-119

制約 constraints

  • 必須

    このコンポーネントを必須にするには、このチェックボックスを選択します。つまり、ユーザーは値を入力する必要があります。

  • 必須メッセージ

    オプションで、フィールドが必須であることを示すメッセージを追加します。

chlimage_1-120

スタイル設定 styling

  • CSS
    このコンポーネントに使用する CSS クラスを入力します。

chlimage_1-121

チェックボックス （Campaign） checkbox-campaign

チェックボックス (Campaign) コンポーネントを使用すると、ブール型データタイプのAdobe Campaignプロファイルフィールドをユーザーが変更できます。 例えば、受信者がどのチャネルからも連絡を受けたくないことを指定できるチェックボックス（キャンペーン）コンポーネントがあるとします。

以下が可能です。 ほとんどのAdobe Campaignコンポーネントに共通の設定を構成 」をクリックします。

次の例は、チェックボックス (Campaign) コンポーネントの表示を示しています。

chlimage_1-122

日付フィールド (Campaign) と日付フィールド/HTML5 (Campaign) date-field-campaign-and-date-field-html-campaign

日付フィールドを使用して、受信者に日付の指定を許可します。例えば、受信者に生年月日を指定してもらいたい場合があります。 日付形式は、Adobe Campaignインスタンスで使用されている形式と一致します。

大部分の Adobe Campaign コンポーネントに共通の設定に加え、次の項目を設定できます。

  • 制約 — 制約 ドロップダウン

    次を選択できます。 なし または 日付 — 日付の制約を追加するか、制約を追加しません。 「日付」を選択した場合、ユーザーはこのフィールドに日付形式で値を入力する必要があります。

  • 制約メッセージ

    また、制約メッセージを追加して、回答を適切に書式設定する方法をユーザーに知らせることもできます。

  • スタイル設定 — 幅
    フィールドの幅を調整するには、
    + および - アイコンをクリックするか、数値を入力します。

幅が調整された日付フィールド（Campaign）コンポーネントの表示例を以下に示します。

chlimage_1-123

暗号化されたプライマリキー (Campaign) encrypted-primary-key-campaign

このコンポーネントは、Adobe Campaignプロファイル (メインリソース識別子 または 暗号化されたプライマリキー ( それぞれAdobe Campaign Standardと 6.1)。

Adobe Campaignプロファイルデータの表示と変更を行う各フォーム 必須 暗号化されたプライマリキーコンポーネントを含めます。

暗号化プライマリキー (Campaign) コンポーネントで、次の設定をおこなえます。

  • タイトルとテキスト — 要素名

    デフォルトでは、encryptedPK に設定されます。 要素名は、フォーム上の別の要素の名前と競合する場合にのみ変更する必要があります。 同じ要素名を持つフォームフィールドは 2 つありません。

  • Adobe Campaign - URL パラメーター EPK 用の URL パラメーターを追加します。例えば、
    epk.

次の例は、暗号化されたプライマリキー (Campaign) コンポーネントの表示を示しています。

chlimage_1-124

エラー表示 (Campaign) error-display-campaign

このコンポーネントを使用すると、バックエンドエラーを表示できます。 コンポーネントを正しく機能させるには、フォームのエラー処理を「Forward」に設定する必要があります。

次の例は、エラー表示 (Campaign) コンポーネントの表示を示しています。

chlimage_1-125

非表示の紐付けキー（Campaign） hidden-reconciliation-key-campaign

非表示の紐付けキー（Campaign）コンポーネントを使用して、非表示のフィールドを紐付け整キーの一部としてフォームに追加できます。

非表示の紐付けキー（Campaign）コンポーネントでは、次の項目を設定できます。

  • タイトルとテキスト — 要素名

    デフォルトは reconcilKey です。 要素名は、フォーム上の別の要素の名前と競合する場合にのみ変更する必要があります。 同じ要素名を持つフォームフィールドは 2 つありません。

  • Adobe Campaign - マッピング Adobe Campaign パーソナライゼーションフィールドにマッピングします。

非表示の紐付けキー（Campaign）コンポーネントの表示例を以下に示します。

chlimage_1-126

数値フィールド （Campaign） numeric-field-campaign

数値フィールドを使用して、受信者が年齢などの数値を入力できるようにします。

大部分の Adobe Campaign コンポーネントに共通の設定に加え、次の項目を設定できます。

  • 制約 — 制約 ドロップダウン

    次を選択できます。 なし または 数値 — 数値の制約を追加するか、制約を追加しません。 「数値」を選択した場合、ユーザーはこのフィールドに数値で回答を入力する必要があります。

  • 制約メッセージ

    また、制約メッセージを追加して、回答を適切に書式設定する方法をユーザーに知らせることもできます。

  • スタイル設定 — 幅
    フィールドの幅を調整するには、
    + および - アイコンをクリックするか、数値を入力します。

幅が設定された数値フィールド（Campaign）コンポーネントの表示例を以下に示します。

chlimage_1-127

オプションフィールド （Campaign） option-field-campaign

このドロップダウンリストで、オプションを選択できます。例えば、受信者の性別やステータスなどです。

以下が可能です。 ほとんどのAdobe Campaignコンポーネントに共通の設定を構成 をクリックします。 ドロップダウンリストに値を入力するには、Adobe Campaign記号をクリックまたはタップして、Adobe Campaignのパーソナライゼーションフィールドの適切なフィールドを選択し、そのフィールドに移動します。

chlimage_1-128

オプションフィールド（Campaign）コンポーネントの表示例を以下に示します。

chlimage_1-129

購読チェックリスト（Campaign） subscriptions-checklist-campaign

購読チェックリスト（Campaign） ​コンポーネントを使用して、Adobe Campaign プロファイルに関連付けられた購読を変更できます。

このコンポーネントをフォームに追加すると、利用可能なすべての購読がチェックボックスとして表示されるので、ユーザーに目的の購読を選択させることができます。ユーザーがフォームを送信すると、フォームのアクションタイプ（「Adobe Campaign：サービスに登録」または「Adobe Campaign：サービスの登録解除」）に応じて、選択されたサービスにユーザーが登録されるか、ユーザーの登録が解除されます。

NOTE
このコンポーネントは、ユーザーがどのサービスを購読または購読解除しているかを確認しません。

以下が可能です。 ほとんどのAdobe Campaignコンポーネントに共通の設定を構成 購読チェックリスト (Campaign) コンポーネント内。 ( このコンポーネントで使用できるAdobe Campaign設定はありません。)

次に、購読チェックリスト (Campaign) コンポーネントの表示例を示します。

chlimage_1-130

テキストフィールド （Campaign） text-field-campaign

テキストフィールド (Campaign) コンポーネントを使用して、名、姓、住所、電子メールアドレスなどの文字列タイプのデータを入力できます。

大部分の Adobe Campaign コンポーネントに共通の設定に加え、次の項目を設定できます。

  • 制約 — 制約 ドロップダウン

    次を選択できます。 なし、メール、 または 名前（ウムラウトなし） — 電子メールアドレス、名前、または制約なしの制約を追加します。 「メール」を選択した場合は、このフィールドにメールアドレスを入力する必要があります。「名前」を選択した場合は、名前を入力する必要があります（ウムラウトは使用できません）。

  • 制約メッセージ

    また、制約メッセージを追加して、回答を適切に書式設定する方法をユーザーに知らせることもできます。

  • スタイル設定 — 幅

    フィールドの幅を調整するには、 + および - アイコンをクリックするか、数値を入力します。

テキストフィールド（Campaign）コンポーネントの表示例を以下に示します。

chlimage_1-131

recommendation-more-help
5f6f1f67-8db1-40cb-84e9-024e65b9fc4c