Adobe Campaign Classic との統合

Adobe Campaign を使用すると、電子メール配信コンテンツおよびフォームを Adobe Experience Manager で直接管理できます。

両方のソリューションを同時に使用するには、最初に互いに接続するように設定する必要があります。これには、Adobe Campaign と Adobe Experience Manager の両方での設定手順が含まれます。これらの手順は、このドキュメントで詳しく説明します。

AEM での Adobe Campaign の操作には、Adobe Campaign を使用して電子メールを送信する機能が含まれています。これについては Adobe Campaign の操作で説明します。また、AEM ページのフォームを使用したデータの操作も含まれます。

さらに、AEM を Adobe Campaign と統合する際に参考となるトピックを次に示します。

• 電子メールテンプレートのベストプラクティス
• Adobe Campaign 統合に関するトラブルシューティング

Adobe Campaign との統合を拡張する場合は、次のページが参考になります。

• カスタム拡張の作成
• カスタムフォームマッピングの作成

AEM と Adobe Campaign の統合ワークフロー

ここでは、キャンペーンを作成し、コンテンツを配信する際の AEM と Adobe Campaign の間の一般的なワークフローについて説明します。

一般的なワークフローには、次が含まれます。詳細について説明します。

1. （Adobe Campaign と AEM で）キャンペーンの構築を開始します。
2. コンテンツをリンクして配信する前に、AEM でコンテンツをパーソナライズして、Adobe Campaign で配信を作成します。
3. Adobe Campaign で、コンテンツをリンクして配信します。

キャンペーンの作成の開始

キャンペーンの作成は、いつでも開始できます。コンテンツをリンクする前は、AEM と AC は独立しています。つまり、マーケティング担当者は、キャンペーンの作成およびターゲティングを Adobe Campaign で開始でき、同時にコンテンツ作成者は、AEM でデザインに取り組むことができます。

コンテンツのリンクおよび配信の前に

コンテンツをリンクして配信メカニズムを作成する前に、次の手順を実行する必要があります。

AEM で

• テキストおよびパーソナライゼーション​コンポーネントのパーソナライゼーションフィールドを使用してパーソナライズする

Adobe Campaign で

• aemContent タイプの配信を作成する

コンテンツのリンクと配信の設定

リンクおよび配信用のコンテンツを用意したら、コンテンツのリンク方法とリンク先を決めます。

これらのすべての手順は、Adobe Campaign で完了します。

1. どの AEM インスタンスを使用するかを指定します。
2. 「同期」ボタンをクリックして、コンテンツを同期します。
3. コンテンツピッカーを開いて、コンテンツを選択します。

AEM を初めて使用する場合

AEM を初めて使用する場合は、AEM を理解するのに次のリンクが参考になります。

• AEM の開始
• レプリケーションエージェントの概要
• ログファイルの検索と使用
• AEM プラットフォームの概要

Adobe Campaign の設定

Adobe Campaign の設定には、次が含まれます。

1. AEM 統合パッケージの Adobe Campaign へのインストール。
2. 外部アカウントの設定。
3. AEMResourceTypeFilter が正しく設定されていることの検証。

さらに、ユーザーが設定可能な次のような高度な設定があります。

• コンテンツブロックの管理
• パーソナライゼーションフィールドの管理

高度な設定を参照してください。

前提条件

事前に、次の要素があることを確認してください。

• AEM 作成者インスタンス
• AEM 発行インスタンス
• Adobe Campaign Classic インスタンス - クライアントおよびサーバーを含みます
• Internet Explorer 11

AEM 統合パッケージのインストール

AEM 統合​パッケージを Adobe Campaign にインストールする必要があります。次の手順を実行します。

1. AEM とリンクしたい Adobe Campaign インスタンスに移動します。

2. ツール／詳細／パッケージをインポート…​を選択します。

   

3. 「標準パッケージをインストール」をクリックして、「AEM 統合」パッケージを選択します。

   

4. 「次へ」をクリックし、「開始」をクリックします。

   このパッケージには、AEM サーバーを Adobe Campaign に接続するために使用する aemserver 演算子が含まれています。

   注意

   デフォルトでは、この演算子には、セキュリティゾーンは設定されていません。AEM を使用して Adobe Campaign に接続するには、これを選択する必要があります。

   ログイン／パスワードで認証して AEM を Adobe Campaign に接続するには、serverConf.xml ファイルで、選択したセキュリティゾーンの allowUserPassword 属性を true に設定する必要があります。

   セキュリティの問題を回避するために、AEM 専用のセキュリティゾーンを作成することを強くお勧めします。この件について詳しくは、インストールガイドを参照してください。

   

AEM 外部アカウントの設定

Adobe Campaign を AEM インスタンスに接続可能な外部アカウントを設定する必要があります。

外部 AEM アカウントを設定するには：

1. 管理／プラットフォーム／外部アカウント​ノードに移動します。

2. 新しい外部アカウントを作成して、AEM タイプを選択します。

3. AEM オーサーインスタンスのアクセスパラメーター（サーバーアドレスと、このインスタンスに接続するために使用される ID およびパスワード）を入力します。campaign-api ユーザーアカウントのパスワードは、AEM で campaign-remote user に設定したパスワードと同じです。

   メモ

   サーバーアドレスは、末尾がスラッシュで​終わらない​ようにします。例えば、https://yourserver:4502/ の代わりに https://yourserver:4502 を入力します

   

4. 「有効」チェックボックスが選択されていることを確認します。

AEMResourceTypeFilter オプションの検証

「AEMResourceTypeFilter」オプションを使用すると、Adobe Campaign で使用できる AEM リソースのタイプをフィルタリングできます。これにより、Adobe Campaign でのみ使用されるように特別に設計された AEM コンテンツを Adobe Campaign で取得できます。

このオプションは、事前設定されている必要があります。ただし、このオプションを変更すると、統合が機能しなくなる可能性があります。

AEMResourceTypeFilter オプションが設定されていることを検証するには：

1. プラットフォーム／オプション​に移動します。

2. 「AEMResourceTypeFilter」オプションで、パスが正しいことをチェックします。このフィールドには、次の値が含まれている必要があります。

   mcm/campaign/components/newsletter,mcm/campaign/components/campaign_newsletterpage,mcm/neolane/components/newsletter

   また、場合によっては、この値は次のようになります。

   mcm/campaign/components/newsletter

   

Adobe Experience Manager の設定

AEM を設定するには、次の手順を実行する必要があります。

• インスタンス間のレプリケーションを設定します。
• クラウドサービスを使用して、AEM を Adobe Campaign に接続します。
• Externalizer を設定します。

AEM インスタンス間のレプリケーションの設定

AEM オーサーインスタンスから作成されたコンテンツは、最初にパブリッシュインスタンスに送信されます。ニュースレターの画像をパブリッシュインスタンスで利用でき、ニュースレター受信者が入手できるように、公開する必要があります。レプリケーションエージェントは、その結果として、AEM オーサーインスタンスから AEM パブリッシュインスタンスにレプリケートするように設定される必要があります。

また、この手順は、あるオーサーインスタンス設定をパブリッシュインスタンスにレプリケートするためにも必要です。

AEM インスタンス間のレプリケーションを設定するには：

1. オーサーインスタンスで、AEM のロゴ／「ツール」アイコン／導入／レプリケーション／作成者のエージェント​を選択し、「デフォルトエージェント」をクリックします。

   

   メモ

   パブリッシュおよびオーサーインスタンスが両方とも同じコンピューターにある場合を除いて、Adobe Campaign との統合を設定する際に、localhost（これは、AEM のローカルコピーです）を使用するのを回避します。

2. 「編集」をタップまたはクリックして、「トランスポート」タブを選択します。

3. localhost を IP アドレスまたは AEM パブリッシュインスタンスのアドレスに置き換えることで、URI を設定します。

   

AEM から Adobe Campaign への接続

AEM と Adobe Campaign を一緒に使用する前に、両方のソリューション間のリンクを確立して、通信できるようにする必要があります。

1. AEM オーサーインスタンスに接続します。

2. AEM のロゴ／「ツール」アイコン​／導入／クラウドサービス​を選択して、Adobe Campaign セクションの「今すぐ設定」を選択します。

   

3. 「タイトル」にタイトルを入力して「作成」をクリックするか、Adobe Campaign インスタンスとリンクしたい既存の設定を選択することで、新しい設定を作成します。

4. 設定を編集して、Adobe Campaign インスタンスのパラメーターと一致するようにします。

   • ユーザー名：aemserver（2 つのソリューション間のリンクを確立するために使用される Adobe Campaign AEM 統合パッケージ演算子）。
   • パスワード：Adobe Campaign aemserver 演算子のパスワード。この演算子のパスワードを Adobe Campaign で直接再指定する必要があることがあります。
   • API エンドポイント：Adobe Campaign インスタンス URL。

5. 「Adobe Campaign に接続」を選択し、「OK」をクリックします。

   

   メモ

   電子メールを作成して公開したら、パブリッシュインスタンスに設定を再公開する必要があります。

   

Externalizer の設定

オーサーインスタンスの AEM に Externalizer を設定する必要があります。Externalizer は、リソースパスを外部 URL および絶対 URL に変換できる OSGi サービスです。このサービスは、これらの外部 URL を設定および構築するための一元化された場所を提供します。

一般的な指示については、Externalizer の設定を参照してください。Adobe Campaign 統合について、https://<host>:<port>/system/console/configMgr/com.day.cq.commons.impl.ExternalizerImpl の公開サーバーが localhost:4503 ではなく、Adobe Campaign コンソールが到達可能なサーバーを指すように設定していることを確認してください。

localhost:4503 または Adobe Campaign が到達できない別のサーバーを指している場合、Adobe Campaign コンソールに画像が表示されません。

高度な設定

また、次のような高度な設定を実行できます。

• パーソナライゼーションフィールドおよびブロックの管理。
• パーソナライゼーションブロックのアクティベート解除。
• ターゲット拡張データの管理。

パーソナライゼーションフィールドおよびブロックの管理

パーソナライゼーションを AEM の電子メールコンテンツに追加可能なフィールドおよびブロックは、Adobe Campaign で管理されます。

デフォルトのリストは提供されますが、変更できます。また、パーソナライゼーションフィールドおよびブロックを追加または非表示にすることができます。

パーソナライゼーションフィールドの追加

新しいパーソナライゼーションフィールドを既に利用可能なフィールドに追加するには、次のように Adobe Campaign の nms:seedMember スキーマを拡張する必要があります。

1. Adobe Campaign のナビゲーションで、管理／設定／データスキーマ​ノードに移動します。

2. 「新規」を選択します。

   

3. ポップアップウィンドウで「拡張スキーマを使用してテーブルのデータを拡張する」を選択し、「次へ」をクリックします。

   

4. 拡張されたスキーマの別のパラメーターを入力します。

   • スキーマ：nms:seedMember スキーマを選択します。ウィンドウのその他のフィールドは、自動的に入力されます。
   • 名前空間：拡張されたスキーマの名前空間をパーソナライズします。

5. スキーマの XML コードを編集して、そこに追加したいフィールドを指定します。Adobe Campaign のスキーマ拡張について詳しくは、設定ガイドを参照してください。

6. スキーマを保存してから、コンソールの​ツール／詳細／データベース構造を更新​メニューで、Adobe Campaign データベース構造を更新します。

7. 変更を保存するために、Adobe Campaign コンソールを切断してから再接続します。AEM で利用可能なパーソナライゼーションフィールドのリストに新しいフィールドが表示されます。

例

「登録番号」フィールドを追加するには、次の要素が必要です。

• 次を含む cus:recipient という名前の nms:recipient スキーマ拡張：

<element desc="Recipient table (profiles)" img="nms:recipient.png" label="Recipients" labelSingular="Recipient" name="recipient">

  <attribute dataPolicy="smartCase" desc="Recipient registration number"
  label="Registration Number"
  length="50" name="registrationNumber" type="string"/>

</element>

次を含む cus:seedMember という名前の nms:seedMember スキーマ拡張：

<element desc="Seed to insert in the export files" img="nms:unknownad.png" label="Seed addresses" labelSingular="Seed" name="seedMember">

  <element name="custom_nms_recipient">
    <attribute name="registrationNumber"
    template="cus:recipient:recipient/@registrationNumber"/>
  </element>

</element>

「登録番号」フィールドが、利用可能なパーソナライゼーションフィールドに含まれるようになります。

パーソナライゼーションフィールドを非表示にする

パーソナライゼーションフィールドを既に利用可能なフィールドの中から非表示にするには、パーソナライゼーションフィールドの追加の節で説明しているとおり、Adobe Campaign の nms:seedMember スキーマを拡張する必要があります。次の手順を適用します。

1. 拡張されたスキーマの nms:seedMember スキーマから取得したいフィールドをコピーします（例：cus:seedMember）。

2. advanced="true" XML 属性をフィールドに追加します。AEM で利用可能なパーソナライゼーションフィールドのリストに表示されなくなります。

   例えば「ミドルネーム」フィールドを非表示にするには、cud:seedMember スキーマに次の要素を含める必要があります。

   <element desc="Seed to insert in the export files" img="nms:unknownad.png" label="Seed addresses" labelSingular="Seed" name="seedMember">
   
     <element name="custom_nms_recipient">
       <attribute advanced="true" name="middleName"/>
     </element>
   
   </element>
   

パーソナライゼーションブロックのアクティベート解除

利用可能なもののパーソナライゼーションブロックのアクティベートを解除するには：

1. Adobe Campaign のナビゲーションで、リソース／キャンペーン管理／パーソナライゼーションブロック​ノードに移動します。

2. AEM でアクティベートを解除したいパーソナライゼーションブロックを選択します。

3. 「カスタマイズメニューに表示」チェックボックスをオフにして、変更を保存します。ブロックが、Adobe Campaign で利用可能なパーソナライゼーションブロックのリストに表示されなくなります。

   

ターゲット拡張データの管理

パーソナライゼーション用にターゲット拡張データを挿入することもできます。ターゲット拡張データ（「Target データ」とも呼ばれる）は、例えば、キャンペーンワークフローのクエリのデータを機能強化または追加することに由来します。詳しくは、クエリの作成およびデータの機能強化の節を参照してください。