記事テンプレート

Adobe Analyticsについて

Adobe Analyticsは、ページビュー、ページ滞在時間、ユーザーのトラッキング履歴など、ウェブ訪問者のデータをレポートする強力なツールです。例えば、クアルトリクスで収集した満足度データをアドビに渡すことで、満足度の高い顧客とそうでない顧客のウェブ行動の違いに関するレポートを作成することができます。さらに、ウェブサイトフィードバックとAdobe Analyticsを統合することで、Adobe Analyticsの変数に基づいた訪問者ターゲットロジックを作成し、変数の値をクアルトリクスのデータセットに渡すことができます。

訪問者ターゲットロジックでのAdobe Analytics変数の使用

Adobe Analyticsのデータを使用して、Webサイト訪問者に特定のクリエイティブを表示するタイミングを決定します。ここでは、Adobe Analyticsの変数に基づいてアクションセットロジックとインターセプトロジックを作成する方法を説明します。

1. インターセプトレベルかアクションセットレベルのいずれかで、論理を追加する。
   

   Qtip: Add Intercept Display Logicをクリックするとインターセプト全体にロジックが追加されるので、個々のアクションセットにロジックを追加する必要はありません。
2. 最初のドロップダウンフィールドで、ウェブサイトを選択します。
   
3. Adobe Analyticsを選択します。
4. ドロップダウンからターゲットとするAdobe Analytics変数タイプを選択します（eVar、s.propなど）。
   

   Qtip:Adobe Analyticsの変数については、以下のドキュメントを参照してください：

   • 変数の概要
   • eバーズ
   • 構成変数（最も一般的な分析変数の一部）
5. ターゲットとする変数を選択します。有料の拡張機能を使用している場合は、作成したデータコネクタを選択できます。
   Qtip:このドロップダウンがない？おそらくAdobe Analyticsの権限がオンになっていないのでしょう。ブランド管理者に連絡し、有効にしてください。
6. 値が次へで指定した値と等しい、または等しくない訪問者をターゲットにするかどうかを示します。
7. 変数の値を入力する。

Adobe Analyticsの変数をクアルトリクスに渡す

埋め込みデータは、Adobe Analyticsの変数の値をサイトから取得し、クアルトリクスのデータセットに追加することができます。

1. どのアクションでも、Optionsをクリックします。
   
2. 埋め込みデータを選択。
3. 任意の変数タイプを入力する。この変数名は、クアルトリクスのアンケート調査データのフィールド名として表示されます。
   
   Qtip:埋め込みデータの値をすでに追加している場合は、プラス記号(+)をクリックして別の値を追加してください。
4. 値としてAdobe Analyticsを選択します。
5. Adobe Analyticsの変数タイプを選択します。
   Qtip:何を選べばいいかわからない場合は、Adobe Analyticsの変数に関するドキュメントを参照してください。
6. 特定の変数を選択する。
7. ［保存］をクリックします。
8. アンケート調査を見るを選択します。
   
9. インターセプトのターゲットアンケートに移動します。
10. アンケート調査フローを開きます。
    
11. Add a New Elementをクリックし、Embedded Dataを選択する。
12. フィールド名には、ステップ4で選んだ名前を入力する。フィールド名のすべてのフォーマットがインターセプト・オプションで設定した名前と同じであることを確認してください。
    
13. 移動］をクリックしたまま、要素をアンケート調査フローの上部にドラッグします。
14. ［適用］をクリックします。

これを設定すると、アンケート調査データのフィールドにインターセプトから取得した情報が保存されます。このフィールドは、クアルトリクス内でレポートを作成する際に使用でき、アンケート調査のデータをエクスポートする際にも表示されます。

クアルトリクスのデータをAdobe Analyticsに渡す

Adobe Analyticsとクアルトリクスサーベイプラットフォーム間の拡張機能により、クアルトリクスが収集したアンケートデータをAdobe Analyticsインスタンスに直接渡すことができます。

前提条件

• クアルトリクスでAdobe Analyticsのパーミッションを有効にしている必要があります。
• Adobe Analyticsの「製品」管理ユーザーアカウントへのアクセシビリティが必要です。
• 使用するeVar変数とリスト変数が1つずつ必要。

アドビ レポートスイートに変換クラスを追加する

クアルトリクスの回答データを正しく取り込むには、Adobeレポートスイートのリスト変数にコンバージョン分類を追加する必要があります。

1. Adobe Analyticsアカウントにログインします。
2. 管理者 タブに移動し、レポートスイートを選択します。
3. 新しいレポートスイートを選択し、[設定の編集]、[変換]、[リスト変数]の順にクリックします。
   
4. リスト変数を作成して有効にし、保存をクリックする。
   
5. Edit Settings（設定の編集）］、［Conversion（変換）］、［Conversion Classifications（変換分類）］の順にクリックします。
   
6. リスト変数にカーソルを合わせ、Add Classificationをクリックします。
   
7. テキスト分類名には「アンケート調査」と入力してください。
   
8. ［保存］をクリックします。
9. “Question“
   “Response“
   “Survey > Question > Response” 以下の名前を持つ分類を作成するには、ステップ 6～8 を繰り返します。
   
   注意クアルトリクスアンケートの回答データを Adobe Analytics 内で正しく表示するには、ステップ 9 で指定した分類名を正確に使用する必要があります。

アドビ認証秘密の取得

クアルトリクスがAdobe Analyticsレポートスイートの認証を行うには、以下の認証機能が必要です。これらの認証情報は、クアルトリクス内でAdobeワークフローを設定したり、Adobe Analyticsとやり取りするためのアカウントを接続する際に使用されます。

• クライアント ID：クレデンシャルの詳細の一部として Adobe コンソールで提供されるクライアント ID。
• クライアントシークレット: クレデンシャルの詳細の一部として Adobe コンソールで提供されるクライアントシークレット。
• スコープ（オプション）：スコープを使用して、アクセスレベルを制限することができます。

クレデンシャルを取得するには、Adobe Analyticsで以下の手順に従ってください：

1. Adobe Developerコンソールに移動します。
2. Adobe Analyticsで設定されているプロジェクトに移動します。クアルトリクス・ウェブサイトフィードバックと統合できるプロジェクトには、クアルトリクス・セクションの「OAuth」とAPIセクションの「Adobe Analytics」が必要です。これらがない場合は、次へ の説明に従って新しいプロジェクトを作成する必要があります。
   
3. APIセクションで、Adobe Analyticsを選択します。
   
4. OAuth Server-to-Server認証情報を選択します。
5. クレデンシャルの詳細までスクロールダウンし、以下の値をコピーする：
   
   • クライアントID
   • クライアントシークレット
   • スコープ

アドビ認証秘密の作成

まだ自分らしくいられること認証機能をお持ちでない場合は、以下の手順に従って作成してください。詳しくはアドビのサポートドキュメントをご覧ください。

1. アドビアカウントのプロジェクトページに移動します。
2. Create new projectをクリックします。
   
3. Add APIをクリックします。
   
4. Adobe Analyticsを選択します。
   
5. ［次へ］をクリックします。
6. OAuth Server-to-Serverを選択します。
   
7. クレデンシャルに識別可能な名前をつける。
8. ［次へ］をクリックします。
9. Adobe Analyticsのアクセス許可を設定した製品プロファイルを選択します。クアルトリクスとの統合を機能させるには、選択した製品プロファイルに以下の機能のパーミッションが必要です：
   • 分析ツール：
     • ウェブサービス
     • 分析ワークスペース アクセスまたはレポート & アナリティクス アクセス。
   • レポートスイートツール：
     • クラス分け。
10. API認証情報を保存します。

クアルトリクスでアドビ アナリティクス ワークフローを設定する

1. ワークフローページに移動します。
   
2. ワークフローの作成 」をクリックします。
3. クアルトリクスデータをAdobe Analytics Report Suiteテンプレートに送信 ］を選択します。
   
   Qtip：これは「Strategic Research」または「CUSTOMXM」セクションで見つけることができます。また、検索バーを使用してAdobe Analyticsを検索することもできます。
4. 開始」をクリックします。
5. フィールドタイプにワークフロー名を 入力します。
   
6. アンケート調査 ドロップダウンで、分類とアンケート回答をアップロードするアンケートを選択します。
7. レポートスイート] フィールドに、分類とアンケートの回答をアップロードする Adobe Analytics のレポートスイート ID を入力します。
8. 回答変数］ フィールドに、Adobe Analyticsのコンバージョン変数を入力します。evar#”のような書式になり、”#”はevar番号である。
9. リスト変数］ フィールドに、Adobe Analyticsリスト変数を入力します。list#」のような書式になり、「#」はリストvarの番号である。
10. プロジェクトの作成をクリックします。
11. ワークフローが作成されたら、アンケート調査定義イベントをクリックします。
    
    Qtip：ワークフロー作成中に右上のステップバイステップの説明を クリックすると、これらの説明が表示されます。
12. アンケートがアクティブ、終了した、または公開されたときにワークフローを開始するかどうかを選択します。
    
    qtip:クアトリックスでは、アンケートが公開されたときにのみ、このワークフローを開始することを推奨しています。
13. Finishを クリックする。
14. 条件の編集 ］をクリックして、アンケート ID が正しいサーベイプロジェクトと等しい場合にのみワークフローが開始されるように条件を調整します。条件の作成と 調整については、条件の作成を 参照してください。
    
15. Upload Adobe Analytics classifications タスクを選択します。
16. 使用する既存のAdobeアカウントを選択するか、新しいアカウントを接続するにはユーザーアカウントの追加をクリックします。
    
17. 新規アカウントを追加する際は、認証情報の種類としてOAuthを選択し、以下のアカウント情報を入力してください：
    
    • 名前アカウントに識別可能な名前を付ける。
    • クライアントID：AdobeからのクライアントID。
    • クライアントシークレット：Adobeからのクライアントシークレット。
    • トークンのエンドポイント：自分らしくいられること認証エンドポイント。これは自動的に入力され、編集することはできません。
    • スコープ（オプション）：スコープを使用して、アクセスレベルを制限することができます。スコープはオプションですが、Adobeのセットアップにスコープが含まれている場合は、ここにもスコープを含める必要があります。
      注意サービスアカウント(JWT)認証情報はAdobeによって廃止されます。この認証機能の詳細については、Legacy JWT Credentialsを参照のこと。
18. アカウントの接続を選択します。
19. アカウントを選択したら、以下をクリックします。 次へ.
    
    
20. レポートスイート IDと回答リスト変数が正しく、Adobe アカウントに表示されているものと一致していることを確認します。
    
21. 保存を クリックする。
22. ワークフローが保存されたら、以下をクリックします。 背中だ。
    
23. ステップ 5 で指定したタスクを選択します。このタスクには「アンケート調査」のトリガーがあります。
    
24. アンケート調査の回答を選択します。
    
25. ドロップダウンから正しいアンケート調査プロジェクトを選択したことを確認します。
    
26. 次へ」をクリックします。
27. 新しいアンケートの回答が作成されたとき、既存の回答が API 経由で更新されたとき、またはその両方のときにワークフローを開始するかどうかを選択します。
    
28. Finishを クリックする。
29. データをAdobe Analyticsに送信 ］タスクを選択します。
    
30. アカウントを選択するか、Adobeアカウントをまだ追加していない場合はユーザーアカウントの追加をクリックします。ステップ17～18に従って、新しいユーザーアカウントに接続します。
    
31. 次へ 」をクリックします。
32. レポートスイート ID、回答リスト変数 、および回答 ID 変数が正しく、Adobe アカウントに表示されているものと一致していることを確認します。
    
33. レポート・スイートで「タイムスタンプが必要」設定が有効になっている場合は、「データと一緒にタイムスタンプを送信する」をチェックしてください。これらの設定は、Adobeアカウントで確認できます。詳細については、Adobeタイムスタンプのドキュメントを参照してください。
    QTip：タイムスタンプの設定が不一致の場合（クアルトリクス側で有効になっているがアドビ側で無効になっている場合、またはその逆の場合）、データはアドビのレポートスイートには表示されません。上記の例では、データはクアルトリクスから正常に送信されますが、タイムスタンプの設定が不一致のため、Adobeに表示される前に除外されます。タイムスタンプの設定を確認して、データがAdobeに表示されるようにしてください。
34. 部分的な回答をレポートスイートに送信する場合は、[部分的な回答を含める ] をチェックします。不完全な回答のワークフローの開始については、アンケート調査イベントを参照してください。
35. 保存を クリックする。
    注意作成したワークフローが両方ともOnになっていることを確認してください。

    

クアルトリクスのデータをAdobe Analyticsに渡す際のトラブルシューティング

クアルトリクス-Adobe Analytics拡張機能では、いくつかの一般的なエラーが発生する可能性があります。問題が発生した場合は、以下のヒントを参考にしてください。

データ消費の遅延

一般的に、Adobe Analyticsプラットフォームにデータが表示されるまで約24時間かかります。つまり、アンケート調査の拡張機能をオンにしても、少なくとも 1 日は Adobe Analytics プラットフォームに結果が表示されません。クアルトリクスで収集したアンケート調査結果は、すぐにクアルトリクスのインターフェイスに表示されます。

Adobe Analyticsに特定のデータが表示されない

クアルトリクス-Adobe Analytics エクステンションは、アンケート回答情報をリスト変数の形式で Adobe Analytics に渡します。ただし、渡されるのは特定の種類のデータだけだ：

• 識別値割り当てまたは埋め込みデータ値として表現できるデータはすべて Data Connector を通過しますが、それ以外のデータは通過できません。
• 多肢選択式の質問やリッカート・マトリックス表のようなアンケート調査要素への回答も含まれる。
• 自由文質問回答などの情報は含まれない。
• Adobe Analyticsに「コンテキストデータ」として渡すことができるのは、最初の60個の埋め込みデータフィールドのみです。その後、Adobeの「処理ルール」を使用して、そのコンテキストデータをAdobe Analytics変数にマッピングする必要があります。これらの手順を踏むと、Adobe Analyticsに渡された埋め込みデータに基づいてグラフやレポートを作成できるようになります。
  Qtip:60 以上のフィールドを一度に送信しようとすると、アンケートフローの上位 60 フィールドのみが Adobe に送信されます。
• 埋め込みデータフィールドは常に文字で始まること。埋め込みデータフィールド名でサポートされている文字には、数字、アルファベット、ハイフン、アンダースコアがある。

以下の手順に従って、統合をテストし、Adobeに渡される埋め込みデータフィールドを確認してください：

1. 埋め込みデータをレスポンスに追加します。これは、連絡先リストやアンケートフローなどの連絡先の埋め込みデータを介して行うことができます。
   
2. Adobe Analyticsでレポートやグラフを作成する埋め込みデータフィールドを選択します。使用する埋め込みデータフィールドを決めたら、Adobe Analyticsの「管理者 -> レポートスイート」セクションを開きます。
   Qtip：埋め込みデータフィールドをAdobe Analyticsに渡せるのは60個までです。また、埋め込みデータのキーと値は、Adobe Analyticsの制限により、255文字で「切り捨て」られます。
3. レポートスイートマネージャーセクションで、”Edit Settings -> General -> Processing Rules “に移動します。
   
4. ED1（キーボードのEnterキーを押すと自動的に “Context Data “が追加される）をePropまたはeVar変数にマッピングする新しい条件を作成する。アンケート調査の回答を上書きしてしまうので、リスト var は使用しないでください。以下の例では、埋め込みデータフィールドはAdobe Analyticsの “Prop1 “変数にマッピングされています。
5. 匿名リンクを使用した回答例を記入してください。
   
   Qtip: アンケートをプレビューしても、結果は Adobe Analytics には送信されません。
6. すべてが適切に設定されていれば、Adobe Analyticsの「レポート」セクションに移動し、「カスタムトラフィック -> カスタムトラフィック1-10 -> カスタムインサイト1」をクリックして、prop1変数のレポートを表示することができます（代わりにeVarを使用した場合は、「カスタムコンバージョン -> カスタムコンバージョン1-10」を使用してください）。そうすると、下のようなグラフが表示されるはずだ。
   

レガシーJWTクレデンシャル

注意AdobeはJWTクレデンシャルのサポートを終了することを決定しました。2024年末までにOAuth認証情報を使用するように設定を移行してください。新しい OAuth クレデンシャルを追加する手順に従って、クレデンシャルを移行できます。新しい認証情報を追加し、それが機能していることをテストしたら、その次へメニューをクリックし、アカウントの削除を選択することで、古い認証情報を削除することができます。

JWT クレデンシャルを追加または更新する：

1. 接続タイプはAdobeを選択する。
2. アカウント情報を入力してください：
   • クライアント ID：クレデンシャルの詳細の一部として Adobe コンソールで提供されるクライアント ID。
   • クライアントシークレット: クレデンシャルの詳細の一部として Adobe コンソールで提供されるクライアントシークレット。
   • テクニカルアカウント ID：クレデンシャルの詳細の一部として Adobe コンソールで提供されるテクニカルアカウント ID。
   • 組織 ID: Adobe コンソールでクレデンシャルの詳細の一部として提供される組織 ID。このIDは24文字の英数字の文字列で、その後に@AdobeOrgが続きます。
   • 秘密鍵：サービス・アカウント接続に添付されている公開鍵に対応する鍵。

Qtip:プロジェクト内のサービスアカウント情報に移動すると、アカウント情報を見つけることができます。