Adobe Target クラウドサービスの設定

メモ

単一ページアプリケーションフレームワークを基にしたクライアント側レンダリング(React など)が必要なプロジェクトでは、SPA エディターを使用することをお勧めします。詳細情報を参照してください。

メモ

このドキュメントは、『AEM Mobile🔗使用の手引き』ガイドの一部です。AEM Mobileを参照する際に推奨される出発点です。

コンテンツ作成者がモバイルアプリ用のターゲットコンテンツを生成できるようになるには、いくつかの手順をまとめる必要があります。ユーザーとグループに対して適切な権限のセットを取得し、クラウドサービスを作成し、アクティビティ用のアプリケーションを設定して、最後にコンテンツを生成します。

今後は、AEM Mobile Hybrid Reference Applicationが正常にデプロイされ、AEM Mobileダッシュボードからアクセスできることを前提としています。

権限

パーソナライゼーションコンソールへのアクセスを必要とするユーザーは、target-activity-authorsグループに属している必要があります。 ユーザーおよびグループのセットアップの一環として、target-activity-authors グループを apps-admins グループに追加することをお勧めします。target-activity-authorsグループを追加すると、パーソナライゼーションのナビゲーションメニューエントリを表示できます。

パーソナライゼーション管理コンソールへのアクセス権を付与するユーザーまたはグループを target-activity-authors グループに追加し忘れると、パーソナライゼーションコンソールがユーザーに表示されません。

Cloud Services

モバイルアプリケーションでターゲットコンテンツを機能させるには、次の2つのサービスを設定する必要があります。Adobe Target ServiceとMobile ServicesAdobeサービス。 Adobe Targetサービスは、クライアント要求を処理し、パーソナライズされたコンテンツを返すためのエンジンを提供します。 AdobeMobile Servicesサービスは、AMS CordovaAdobeで使用されるADBMobileConfig.jsonファイルを介して、プラグインサービスとモバイルアプリケーションの間の接続を提供します。 AEM Mobile Dashboardで、2つのサービスを追加してアプリケーションを設定できます。

Adobe Target クラウドサービス

AEM Mobile ダッシュボードで、「クラウドサービスを管理」を探し、+ ボタンをクリックします。

chlimage_1-8

クラウドサービスを追加ウィザードで、「Adobe Target」クラウドサービスカードを選択し、「次へ」をクリックします。

chlimage_1-9

「設定を選択」ドロップダウンでは、新しい設定を作成することも、既存の設定を選択することもできます。新しい設定を作成するには、ドロップダウンから「設定を作成」を選択します。 Target設定のタイトルを入力します。 Targetアカウントに関連付けられているクライアントコード、電子メール、パスワードを入力します。 これらのフィールドの値が不明な場合は、Adobe Targetサポートにお問い合わせください。 「検証」ボタンをクリックして、資格情報を検証します。検証が完了したら、「送信」ボタンをクリックして、クラウドサービスを作成します。

作成されたクラウドサービスは、ウィザードによって自動的にモバイルアプリケーションと関連付けられます。cq:cloudserviceconfigsプロパティ値は、appsグループノードのjcr:contentノードに設定されます。 ハイブリッドアプリのサンプルの場合、 /content/mobileapps/hybrid-reference-app/jcr:contentに設定され、 /etc/cloudservices/testandtarget/adobe-target—aem-apps/frameworkにある自動生成フレームワークノードを指す値が設定されます。 フレームワークノードには、デフォルトで設定される 2 つのプロパティ(gender および age)があります。フレームワークは AEM のプレビューのみで使用され、デバイスには影響しません。

ウィザードを完了すると、クラウドサービスを管理タイルに Target クラウドサービスが表示されますが、Adobe Mobile Services アカウントがないという警告が示されています。

chlimage_1-10

Adobe Mobile Services

Adobe Mobile Services(AMS)アカウントもアプリケーションにリンクする必要があります。AMS サービスは、Target クライアントコード情報を格納する必須の ADBMobileConfig.json ファイルを提供します。AMSアカウントとの関連付けを作成する前に、AMSに対する権限を持つユーザーがAMSアカウントを変更する必要があります。

クライアントコード

AMSサービスにログインするには、https://mobilemarketing.adobe.comにアクセスし、モバイルアプリケーションを選択して、設定をクリックします。 「 SDKのTargetオプション」フィールドを探し、フィールドにクライアントコードを配置して、「保存」をクリックします。

chlimage_1-11

クライアントコードをモバイルアプリケーションと関連付けると、Adobe Mobile ダッシュボードで AMS クラウドサービスを設定する際に、サービスの設定が ADBMobileConfig.json ファイルから提供されます。

Adobe Mobile Services クラウドサービス

AMS を設定したら、次は Adobe Mobile ダッシュボードでモバイルアプリケーションを関連付けます。AEM Mobile ダッシュボードで、「クラウドサービスを管理」を探し、+ ボタンをクリックします。

chlimage_1-12

「Adobe Mobile Services」カードを選択し、「次へ」をクリックします。

chlimage_1-13

「作成または選択」ウィザードステップで、「Mobile Service」ドロップダウンを選択し、「設定を作成」項目を選択します。タイトル、会社、ユーザー名、パスワードを入力し、適切なデータセンターを選択します。 これらの値が不明な場合は、AdobeMobile Service管理者に問い合わせて取得してください。 すべてのフィールドに入力したら、「検証」ボタンをクリックします。 検証プロセスがAMSに移動し、アカウントの資格情報を検証します。検証が成功すると、モバイルアプリケーションのリストが表示され、ドロップダウンから関連するモバイルアプリケーションを選択できます。 「送信」ボタンをクリックして、ウィザードを完了します。 このプロセスでは、設定データと、アプリケーションに関連する分析を取得するのに少し時間がかかる場合があります。 プロセスが完了したら、モーダルの「完了」ボタンをクリックして、「モバイルAdobe」に戻ります。

Mobile ダッシュボードに戻ると、クラウドサービスを管理タイルに AMS クラウドサービスが表示されます。また、指標を分析タイルには、ライフサイクルレポートが表示されます。

chlimage_1-14

Target のコンテンツ同期ハンドラー

ユーザーのデバイスにコンテンツを配信するには、AEM コンテンツ作成者が作成したオファーをレンダリングすることにより、コンテンツを生成します。ターゲットオファーのレンダリングを処理するために、オファーを処理する新しいコンテンツ同期ハンドラーが用意されています。 Hybrid Reference Applicationをサンプルとして使用し、en(英語)コンテンツパッケージには、mobileappoffersハンドラーを含むContentSyncConfigが含まれています。 オファーをデバイスにレンダリングするには、次の手順が非常に重要です。mobileappoffersハンドラーには、アプリケーションに使用されるパーソナライゼーションアクティビティへのパスを識別するpathプロパティがあります。

例えば、/content/campaigns/hybridref​にあるアクティビティがある場合、このパスをコピーして、mobileappoffersハンドラーの​path​プロパティに値として貼り付けます。

Hybrid Reference App の場合、2 つの mobileappoffers ハンドラーがあり、1 つは開発用、もう 1 つは実稼動用です。

mobileappoffers ハンドラーの path プロパティでアクティビティのパスを設定したら、ハンドラーを保存します。これで、ハンドラーは、モバイルデバイス用のオファーのレンダリングを開始する準備が整いました。

レンダリングモード

パブリッシュセットアップと開発セットアップでは、mobileappoffers ハンドラーの設定が異なります。パブリッシュ設定の場合、renderMode​というプロパティがあり、値は​publish​で、cq:ContentSyncConfigノードに設定されます。 mobileappoffersハンドラーはrenderModeを参照し、publishに設定されている場合は、作成されるmbox IDを変更します。 デフォルトでは、AEMによって作成されたmboxには、mbox IDに —author値が追加されます。 これは、アクティビティが公開されていないこと、およびオファーの解決に未公開のキャンペーンを使用する必要があることを示します。

Adobe Mobile ダッシュボードでコンテンツがステージングされると、ステージングされたコンテンツは、実稼動の準備ができたコンテンツとみなされ、開発用でないコンテンツ同期設定を使用してレンダリングされます。この方法でレンダリングすると、—authorがすべてのmbox IDから削除され、公開済みのアクティビティがTargetサーバーで使用できるようになります。 ステージングされたコンテンツをテストする前に、アクティビティが公開されていることを確認します。

コンテンツの作成

クラウドサービスが作成され、mobileappoffers ハンドラーが設定されたので、コンテンツ作成者はターゲットエクスペリエンスの生成を開始できます。

このページ