手動での Adobe Target との統合の設定 manually-configuring-the-integration-with-adobe-target
ウィザードの使用時に行ったオプトインウィザードの設定を変更するか、ウィザードを使用せずに手動でAdobe Targetと統合できます。
オプトインウィザードの設定の変更 modifying-the-opt-in-wizard-configurations
AEM を Adobe Target と統合するオプトインウィザードでは、プロビジョニングされた Target 設定という名前の Target クラウド設定が自動的に作成されます。また、「プロビジョニングされた Target フレームワーク」という名前のクラウド設定用の Target フレームワークも作成します。 必要に応じて、クラウド設定とフレームワークのプロパティを変更できます。
A4T Analytics Cloud設定を設定して、コンテンツをターゲティングする際にAdobe Targetをレポートソースとして使用するようにAdobe Targetを設定することもできます。
クラウド設定とフレームワークの場所を特定するには、ツール／デプロイメントt／クラウド の クラウドサービス に移動します。（http://localhost:4502/libs/cq/core/content/tools/cloudservices.html）
「Adobe Target」の下で、「 設定を表示.
プロビジョニングされた Target 設定のプロパティ provisioned-target-configuration-properties
オプトインウィザードで作成されるプロビジョニング済み Target 設定クラウド設定では、次のプロパティ値が使用されます。
-
クライアントコード： オプトインウィザードに入力されたとおりです。
-
電子メール： オプトインウィザードに入力されたとおりです。
-
パスワード： オプトインウィザードに入力されたとおりです。
-
API タイプ： REST
-
Adobe Target からセグメントを同期： 選択されています。
-
クライアントライブラリ： mbox.js
-
DTM を使用してクライアントライブラリを提供： 選択されていません。DTMまたは別のタグ管理システムを使用して mbox.js または AT.js ファイルをホストする場合は、このオプションを選択します。ライブラリの配信には AEM ではなく DTM を使用することをお勧めします。
-
カスタム mbox.js：何も指定されておらず、デフォルトの mbox.js ファイルが使用されます。必要に応じて、使用するカスタム mbox.js ファイルを指定します。 は、mbox.js を選択した場合にのみ表示されます。
-
カスタム AT.js： 何も指定されておらず、デフォルトの AT.js ファイルが使用されます。必要に応じて、使用するカスタム AT.js を指定します。AT.js を選択した場合にのみ表示されます。
- Web 実装のページ読み込み時間の改善
- セキュリティの向上
- シングルページアプリケーション向けの実装オプションの改善
- AT.js は、target.js に含まれるコンポーネントを含むので、target.js を呼び出す必要がなくなりました
プロビジョニングされた Target フレームワークのプロパティ provisioned-target-framework-properties
オプトインウィザードで作成されるプロビジョニング済み Target フレームワークは、プロファイルデータストアからコンテキストデータを送信するように設定されます。 ストアの年齢と性別のデータ項目は、デフォルトで Target に送信されます。 ソリューションには、追加のパラメーターの送信が必要な場合があります。
追加のコンテキスト情報を Target に送信するようにフレームワークを設定できます。詳しくは、 Target フレームワークの追加.
A4T Analytics Cloud設定の指定 configuring-a-t-analytics-cloud-configuration
コンテンツをターゲティングする際に、Adobe Analyticsをレポートソースとして使用するようにAdobe Targetを設定できます。
これを行うには、Adobe Target クラウド設定を接続する A4T クラウド設定を指定する必要があります。
-
AEM のロゴ／ツール／デプロイメント／クラウドサービス の順に移動して クラウドサービス にアクセスします。
-
「Adobe Target」セクションで、「今すぐ設定」をクリックします。
-
Adobe Target設定に再接続します。
-
内 A4T Analytics Cloud設定 ドロップダウンメニューから、フレームワークを選択します。
note note NOTE A4T に対して有効になっている Analytics 設定のみを使用できます。 AEMを使用して A4T を設定する際に、設定参照にエントリが見つからない場合があります。 分析フレームワークを選択できるようにするには、次の手順を実行します。 - ツール／一般／CRXDE Lite に移動します。
- /libs/cq/analytics/components/testandtargetpage/dialog/items/tabs/items/tab1_general/items/a4tAnalyticsConfig に移動します。
- プロパティ 無効化 を false に設定します。
- 「すべて保存」をタップまたはクリックします。
「OK」をクリックします。Adobe Targetでコンテンツをターゲット設定すると、 レポートソースの選択.
Adobe Targetとの手動統合 manually-integrating-with-adobe-target
オプトインウィザードを使用せずに、手動でAdobe Targetと統合します。
AT.js は、mbox.js ライブラリに対していくつかの強化点を提供します。
- Web 実装のページ読み込み時間の改善
- セキュリティの向上
- シングルページアプリケーション向けの実装オプションの改善
- AT.js は、target.js に含まれるコンポーネントを含むので、target.js を呼び出す必要がなくなりました
Target クラウド設定の作成 creating-a-target-cloud-configuration
AEMがAdobe Targetとやり取りできるようにするには、Target クラウド設定を作成します。 設定を作成するには、Adobe Targetのクライアントコードとユーザーの資格情報を指定します。
Target クラウド設定を作成するのは、1 回のみです。これは、設定を複数のAEMキャンペーンに関連付けることができるからです。 複数のAdobe Targetクライアントコードがある場合、各クライアントコードに対して 1 つの設定を作成します。
クラウド設定を設定して、Adobe Targetからセグメントを同期することができます。 同期を有効にした場合、クラウド設定が保存されるとすぐに、セグメントがバックグラウンドで Target から読み込まれます。
AEMで Target クラウド設定を作成するには、以下の手順を実行します。
-
AEM のロゴ／ツール／デプロイメント／クラウドサービス の順に移動して クラウドサービス にアクセスします。（http://localhost:4502/libs/cq/core/content/tools/cloudservices.html）
Adobe Marketing Cloud の概要ページが表示されます。
-
「Adobe Target」セクションで、「今すぐ設定」をクリックします。
-
設定を作成 ダイアログで、次の操作を実行します。
- 設定の「タイトル」を入力します。
- 「Adobe Target 設定」テンプレートを選択します。
- 「作成」をクリックします。
編集ダイアログが開きます。
note note NOTE AEMを使用して A4T を設定する際に、設定参照にエントリが見つからない場合があります。 分析フレームワークを選択できるようにするには、次の手順を実行します。 - ツール／一般／CRXDE Lite に移動します。
- /libs/cq/analytics/components/testandtargetpage/dialog/items/tabs/items/tab1_general/items/a4tAnalyticsConfig に移動します。
- プロパティ 無効化 を false に設定します。
- 「すべて保存」をタップまたはクリックします。
-
ダイアログで、次のプロパティの値を入力します。
-
クライアントコード：Target アカウントのクライアントコード
-
電子メール:Target アカウントの電子メール。
-
パスワード:Target アカウントのパスワード。
-
API タイプ:REST または XML
-
A4T Analytics クラウド設定：ターゲットアクティビティの目標と指標に使用する Analytics クラウド設定を選択します。これは、コンテンツをターゲット化するときに、Adobe Analytics をレポートソースとして使用している場合に必要です。クラウド設定が表示されない場合は、A4T Analytics クラウドの設定のメモを参照してください。
-
正確なターゲット設定を使用：デフォルトでは、このチェックボックスはオンになっています。選択した場合、クラウドサービス設定は、コンテキストの読み込みを待ってから、コンテンツを読み込みます。 次の注意を参照してください。
-
Adobe Target からセグメントを同期：Target で定義されているセグメントをダウンロードして AEM で使用するには、このオプションをオンにします。API Type プロパティが REST の場合は、このオプションを選択する必要があります。インラインセグメントはサポートされず、常に Target のセグメントを使用する必要があるからです。 (「セグメント」のAEM用語は、Target の「オーディエンス」と同じです )。
-
クライアントライブラリ： クライアントライブラリとして mbox.js と AT.js のいずれを使用するかを選択します。
-
DTM を使用してクライアントライブラリを提供 - AT.js または mbox.js を DTM または別のタグ管理システムから使用する場合は、このオプションを選択します。このオプションを使用するには、DTM 統合を設定する必要があります。ライブラリの配信には AEM ではなく DTM を使用することをお勧めします。
-
カスタム mbox.js:DTM ボックスをオンにした場合やデフォルトの mbox.js を使用する場合は空白のままにします。 または、カスタム mbox.js をアップロードします。 は、mbox.js を選択した場合にのみ表示されます。
-
カスタムの AT.js:DTM ボックスをオンにした場合やデフォルトの AT.js を使用する場合は空白のままにします。 または、カスタムの AT.js をアップロードします。 AT.js を選択した場合にのみ表示されます。
note note NOTE デフォルトでは、Adobe Target 設定ウィザードをオプトインすると、正確なターゲット設定が有効になります。
正確なターゲティングとは、クラウドサービスの設定が、コンテキストの読み込みを待ってからコンテンツを読み込むことを意味します。 その結果、パフォーマンスに関しては、正確なターゲティングによって、コンテンツを読み込む前に数ミリ秒の遅延が生じる場合があります。
正確なターゲット設定は、オーサーインスタンスで常に有効になっています。 ただし、パブリッシュインスタンスでは、クラウドサービス設定の「正確なターゲティング」の横にあるチェックマークをオフにすることで、正確なターゲティングをグローバルにオフにすることができます (http://localhost:4502/etc/cloudservices.html) をクリックします。 また、クラウドサービス設定での設定に関係なく、個々のコンポーネントに対して正確なターゲティングのオン/オフを切り替えることもできます。
この設定を変更しても、作成済みの対象コンポーネントには影響しません***。***これらのコンポーネントに対して直接変更を加える必要があります。 -
-
「Target に接続」をクリックして、Target との接続を開始します。接続に成功すると、「接続に成功しました」というメッセージが表示されます。 メッセージの「OK」をクリックして、ダイアログの「OK」をクリックします。
Target に接続できない場合は、 トラブルシューティング 」セクションに入力します。
Target フレームワークの追加 adding-a-target-framework
Target クラウド設定を設定したら、Target フレームワークを追加します。このフレームワークは、使用可能な ClientContext または ContextHub コンポーネント。 Target は、パラメーターを使用して、現在のコンテキストに適用されるセグメントを決定します。
1 つの Target 設定に対して複数のフレームワークを作成できます。 Web サイトのセクションごとに異なるパラメーターセットを Target に送信する必要がある場合は、複数のフレームワークが便利です。 送信する必要のあるパラメーターの各セットに対してフレームワークを作成します。 Web サイトの各セクションを適切なフレームワークに関連付けます。 Web ページでは、一度に 1 つのフレームワークのみを使用できます。
-
Target 設定ページで、「使用できるフレームワーク」の横の「+」（プラス符号）をクリックします。
-
フレームワークを作成ダイアログで、「タイトル」を指定し、「Adobe Target フレームワーク」を選択して、「作成」をクリックします。
フレームワークページが表示されます。サイドキックに、マッピングできる ClientContext または ContextHub の情報を表すコンポーネントが表示されます。
-
マッピングに使用するデータを表す ClientContext コンポーネントをドロップターゲットにドラッグします。または、ContextHub ストア コンポーネントをフレームワークにドラッグします。
note note NOTE マッピング時に、パラメーターは単純な文字列を使用して mbox に渡されます。 ContextHub から配列をマッピングすることはできません。 例えば、サイト訪問者に関する プロファイルデータ を使用して Target キャンペーンを管理するには、「プロファイルデータ」コンポーネントをページにドラッグします。Target パラメーターへのマッピングに使用できるプロファイルデータ変数が表示されます。
-
該当する列の「共有」チェックボックスをオンにして、Target システムで表示する変数を選択します。
note note NOTE パラメーターの同期は、AEMからAdobe Targetへの 1 つの方法のみです。
フレームワークが作成されました。 フレームワークをパブリッシュインスタンスにレプリケートするには、 フレームワークを有効化 オプションを選択します。
アクティビティと Target クラウド設定の関連付け associating-activities-with-the-target-cloud-configuration
AEM アクティビティを Target クラウド設定に関連付け、アクティビティを Adobe Target にミラーリングできるようにします。
- この xt_only オプションが、Adobe Targetへの接続にAEM側で使用されるAdobe Targetテナント (clientcode) で有効になっている場合、 のみ AEMの XT アクティビティ。
- この xt_only オプション： not Adobe Targetテナント (clientcode) で有効にした場合、 両方 AEMの XT および A/B アクティビティ。
Target フレームワークとサイトの関連付け associating-the-target-framework-with-your-site
AEMで Target フレームワークを作成した後、Web ページをフレームワークに関連付けます。 ページ上のターゲットコンポーネントは、フレームワークで定義されたデータをAdobe Targetに送信し、トラッキングをおこないます。 （コンテンツのターゲティングを参照）。
ページをフレームワークに関連付けると、子ページが関連付けを継承します。
-
Sites コンソールで、設定するサイトに移動します。
-
「クラウドサービス」タブを選択します。
-
「編集」をタップまたはクリックします。
-
タップまたはクリック 設定を追加 under Cloud Service設定 を選択し、 Adobe Target.
-
以下で必要なフレームワークを選択します。 設定リファレンス.
note note NOTE 必ず 枠組み 作成された Target クラウド設定ではなく、作成元のクラウド設定が含まれていることを確認します。 -
「完了」をタップまたはクリックします。
-
Web サイトのルートページをアクティベートして、パブリッシュサーバーにレプリケートします。 ( ページの公開方法.)
note note NOTE ページに関連付けたフレームワークがまだアクティベートされていない場合は、ウィザードが開き、それを公開することもできます。
Target 接続の問題のトラブルシューティング troubleshooting-target-connection-problems
Target に接続する際に発生する問題のトラブルシューティングをおこなうには、次のタスクを実行します。
- 指定したユーザー資格情報が正しいことを確認します。
- AEMインスタンスが Target サーバーに接続できることを確認します。 例えば、ファイアウォール規則が送信AEM接続をブロックしていないこと、またはAEMが必要なプロキシを使用するように設定されていることを確認します。
- AEMエラーログで役立つメッセージを探します。 error.log ファイルは、 crx-quickstart/logs AEMがインストールされているディレクトリ。
- Adobe Targetでアクティビティを編集する際、URL は localhost を指しています。 AEM Externalizer を正しい URL に設定して、この問題を回避します。