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 プラットフォームの概要

Configuring Adobe Campaign

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

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

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

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

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

前提条件

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

• AEM 作成者インスタンス
• AEM 発行インスタンス
• Adobe Campaign Classicインスタンス （クライアントとサーバーを含む）
• Internet Explorer 11

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

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

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

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

   

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

   

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

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

   注意

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

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

   セキュリティの問題を回避するために、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

   

Configuring Adobe Experience Manager

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

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

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

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

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

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

1. オーサリングインスタンスから、AEM logo ツール​アイコン/ デプロイ / レプリケーション / 作成者のエージェント​を選択し、デフォルトエージェント​をクリックします。

   

   メモ

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

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

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

   

AEM から Adobe Campaign への接続

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

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

2. AEM logo / ツール​アイコン/ デプロイ / Cloud Services​を選択し、Adobe Campaignセクションで「今すぐ設定​」を選択します。

   

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

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

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

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

   

   メモ

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

   

また、AEM／Adobe Campaign 統合のトラブルシューティングも参照してください。

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 コンソールに画像が表示されません。

Advanced Configurations

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

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

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

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

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

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

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

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

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

   

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

   

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

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

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 データ」とも呼ばれる）は、例えば、キャンペーンワークフローのクエリのデータを機能強化または追加することに由来します。詳しくは、 クエリの作成およびデータのエンリッチメントの節を参照してください。