はじめに
Adobe Analyticsを使うと、顧客とのインタラクションを実行可能なインサイトに変え、ビジネスの全体像を把握できるようになります。DomoのAdobe Analytics Advancedコネクターを使うと、あらかじめ用意されたレポートやカスタマイズされたレポート経由で、またはAdobe Analytics APIにクエリを送信することでデータを取得できます。その後、メトリクスをCRM、POS、ほかのシステムからのデータと組み合わせ、より正確な情報にもとづいてよりスピーディーに、ビジネスの意思決定ができるようになります。Adobe Analytics APIについて詳しくは、ウェブサイト(https://marketing.adobe.com/developer/en_US/documentation)を参照してください。
Adobe Analytics APIには、Data Centerで接続します。このトピックでは、Adobe Analytics Advancedコネクターのユーザーインターフェースに固有のフィールドとメニューについて説明します。DataSetの追加や更新スケジュールの設定、DataSet情報の編集に関する一般的な情報は、「コネクターを使用してDataSetを追加する」を参照してください。
主な使用事例 |
マーケティング、ウェブアナリティクス |
主なメトリクス |
アクセス数、ページ閲覧数、ユニーク訪問者数など |
社内における主な権限 |
アナリスト、エグゼクティブ |
平均導入時間 |
60時間以内 |
使いやすさ(1から10のスケールで、1が「最も使いやすい」) |
8 |
APIの制限
-
1つのレポートにつき選択できるレポートスイートは1つのみです。
-
Adobeでは、各リクエストにつき要素が4つまで認められています。
-
最大30のメトリクスが選択できます。
-
セグメントは相互に排他的です。
-
デフォルトでは、APIは最初に選択されたメトリクスに従い、要素の上位10位の結果のみ返します。
必要条件
Adobe Analyticsに接続してDataSetを作成するには、Adobe Analyticsアカウントに関連付けられたクライアントIDとクライアントシークレットが必要です。
クライアントIDとクライアントシークレットの取得方法については、Adobe Oauth Connectionのドキュメントを参照してください。
Adobe Developer Consoleで新しいOAuthプロジェクトを作成する
Google Developers Consoleで新しいOAuthプロジェクトを作成するには、次の手順を実行します。
1. https://console.adobe.io/projectsにログインします。
2. [Create new project]ボタンをクリックします。
3. [Add API]をクリックしてAdobeサービスを開始します。
4. 利用可能なAPIは[Add an API]ウィンドウにリストされます。[Adobe Analytics]を選択します。
5. 認証タイプを選択します。ここで[OAuth]を選択します。
6. [Web]プラットフォームを選択してAPIを設定します。
[Default redirect URI]に「https://oauth.domo.com/api/data/v2/oauth/providers/adobe-analytics-oauth/exchange
」と入力し、[Redirect URI pattern]に「https://oauth//.domo//.com/api/data/v2/oauth/providers/adobe-analytics-oauth/exchange」と入力します。
7. [Save configured API]をクリックします。
Adobe Analytics OAuthアカウントに接続する
このセクションでは、Adobe Analytics OAuthコネクターページの[認証情報]および[詳細]ペインのオプションについて説明します。このページのほかのペインの項目にある[スケジュール設定]や[DataSetの名前を付け説明を入力]に関しては、ほとんどのタイプのコネクターで共通しています。詳細については、「コネクターを使用してDataSetを追加する」を参照してください。
[認証情報]ペイン
このペインには、Adobe Analytics APIに接続するための認証情報の入力フィールドが含まれています。下表では、各フィールドに必要なものを説明しています。
フィールド |
説明 |
---|---|
クライアントID | Adobe Analyticsアカウントに関連付けられているクライアントIDを入力します。 |
クライアントシークレット | Adobe Analyticsアカウントに関連付けられているクライアントシークレットを入力します。 |
有効な認証情報を一度入力しておくと、いつでも同じアカウントを使用して新しいAdobe Analytics 1.4 OAuth DataSetを作成することができます。コネクターのアカウントは、Data Centerの[アカウント]タブで管理することができます。このタブについて詳しくは、「コネクターのユーザーアカウントを管理する」を参照してください。
[詳細]ペイン
このペインには、2つのメインメニューである[レポートスイート]と[レポートタイプ]のほか、選択したレポートタイプに応じて表示または非表示になるそのほかの様々なメニューがあります。
メインメニュー
メニュー |
説明 |
||||||
---|---|---|---|---|---|---|---|
会社 | Adobe Analyticsで設定されている会社名を入力します。ここで入力した会社名が、Company.GetEndpointメソッドのパラメーターとして使用されます(https://github.com/AdobeDocs/analytics-1.4-apis/blob/master/docs/admin-api/methods/company/r_GetEndpoint.mdを参照)。 | ||||||
レポートスイート |
データを取得するAdobe Analyticsレポートスイートを選択します。 |
||||||
レポートタイプ |
レポートタイプを選択します。レポートタイプは、DataSetの設定に必要な入力を決定します。 レポートタイプは次のとおりです。
|
「簡単 ‐ 定義済み」レポートタイプのオプション
オプション |
説明 |
||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
所定のレポート |
実行するレポートを選択します。レポートタイプのリストについては、次のセクションを参照してください。 |
||||||||||||||||||||||||||||||||||||||
バックフィル |
最初にレポートを実行するときに遡るバックフィル日数を選択します。 |
||||||||||||||||||||||||||||||||||||||
レポート |
定義済みレポートを選択します。これらのレポートは[レポートタイプ]で[簡単 ‐ 定義済み]を選択した場合のみ利用可能です。
|
「中級 - カスタム」レポートタイプのオプション
オプション |
説明 |
---|---|
要素 |
最大で4つの要素名を選択できます。 要素はレポートのメトリクスデータを分類する構造です。例えば、ページ閲覧数(メトリクス)をページのアクセスに使用されたブラウザー(要素)別に分類したレポートを作成できます。作成されるレポートには、ブラウザーのタイプ別にページ閲覧数が一覧で表示されます。 デフォルトでは、Adobe Analytics APIは、要素の上位10位までの結果のみを返します。11位以降を確認するには、[その他要素の情報]フィールドに追加要素の情報を入力します。 要素について詳しくは、ウェブサイト(https://marketing.adobe.com/developer/documentation/analytics-reporting-1-4/elements)を参照してください。 |
その他要素の情報 |
APIエクスプローラーで定義されたJSONフォーマットを使って、追加要素の情報を入力します(https://marketing.adobe.com/developer/api-explorer#Report.Queue)。 例:
このパラメーターについては、「[Additional Elements]フィールドについて」というトピックで、後ほど詳細に説明します。 |
セグメント |
レポートのセグメント定義を選択します。セグメントはいくつでも必要な数を選択できます。セグメントについて詳しくは、APIエクスプローラーのドキュメント(https://marketing.adobe.com/developer/api-explorer#Report.Queue)を参照してください。 注記:セグメントはいくつでも選択できますが、選択したセグメントがデータ全体に与える影響を考慮する必要があります。セグメントの選択によって、データのグループ化が変更され、想定外の結果が生じる可能性があります。
|
インラインセグメント |
APIエクスプローラーで定義されたJSONフォーマットを使って、インラインセグメントの情報を入力します(https://marketing.adobe.com/developer/api-explorer#Report.Queue)。 インラインセグメントを使うと、最初にAdobe Analyticsでセグメントを定義することなく、コネクターにセグメントを作成できます。例えば、データをセグメント(フィルター)して、ホームページとショッピングカートのみ表示するには、以下のJSONスニペットでインラインセグメンテーションウィンドウを設定します。
フィルターにロジックを適用することもできます。 インラインセグメントについて詳しくは、ウェブサイト(https://marketing.adobe.com/developer/documentation/sitecatalyst-reporting/c-segments)を参照してください。 |
メトリクス |
レポートには最大30メトリクスを選択できます。Adobe Analyticsのメトリクスについて詳しくは 、ウェブサイト(https://github.com/AdobeDocs/analytics-1.4-apis/blob/master/docs/reporting-api/metrics.md)を参照してください。 一部のメトリクスの組み合わせでは、エラーが発生します。Adobeは、メトリクスの組み合わせのブラックリスト( |
日付の粒度 |
レポートの日付の粒度を選択します。これによりデータをどの単位(日、週など)で分割するかが決まります。 |
期間 |
レポートのデータの対象を、単一の日付にするか一定の期間にするかを指定します。 |
レポートの日付 |
レポートのデータを、選択した[日付の粒度]に従い、特定日付とするか相対日付とするかを選択します。例えば、[日付の粒度]に[日次]を選択すると、レポートの日付として[今日]を選択できます。この場合、データが更新されるたびに、現在の日付のデータが表示されます。 |
日付のオフセット |
相対日付をオフセットするために使用する過去日数を入力します。期間は、選択した[日付の粒度]にもとづきます。 例えば、[日付の粒度]に[日次]、[レポートの日付]に[昨日]を選択し、[日付のオフセット]に2を入力した場合、レポートは過去3日間(昨日の2日前)のデータを取得します。 |
特定の日付を選択 |
データを取得する日付を選択します。 |
開始日 |
日付範囲の開始日を、特定日付とするか相対日付とするかを指定します。範囲の最後の日付は、[終了日]で選択します。これらのメニューのオプションは、選択した[日付の粒度]によって決まります。 例えば、[日付の粒度]に[週次]を選択すると、[開始日]に[先週]、[終了日]に[今週]を選択できます。これで、レポートが更新されるたびに、今週と先週のデータが表示されます。 |
終了日 |
日付範囲の最終日を、特定日付とするか相対日付とするかを指定します。日付範囲の最初の日付を、[開始日]で選択します。これらのメニューのオプションは、選択した[日付の粒度]によって決まります。 例えば、[日付の粒度]に[週次]を選択すると、[開始日]に[先週]、[終了日]に[今週]を選択できます。これで、レポートが更新されるたびに、今週と先週のデータが表示されます。 |
開始日のオフセット |
日付範囲内の最初の日のオフセットのために遡る日数を入力します。期間は、選択した[日付の粒度]にもとづきます。 例えば、[日付の粒度]に[週次]、[開始日]に[先週]を選択し、[開始日のオフセット]に2を入力した場合、日付範囲の最初の日付は、3週間前(先週の2週間前)に設定されます。 |
終了日のオフセット |
日付範囲内の最後の日のオフセットのために遡る日数を入力します。期間は、選択した[日付の粒度]にもとづきます。 例えば、[日付の粒度]に[週次]、[終了日]に[今週]を選択し、[終了日のオフセット]に2を入力した場合、日付範囲の最後の日付は、2週間前(今週の2週間前)に設定されます。 |
特定の開始日を選択 |
日付範囲の最初の日付を選択します。 |
特定の終了日を選択 |
日付範囲の最終日を選択します。 |
タイムゾーン |
データの協定世界時(UTC)タイムゾーンを選択します。 |
全てのタイムゾーンを含める |
すべてのタイムゾーンをレポートに含める場合は、このボックスにチェックを入れます。 |
バックフィル |
最初にレポートを実行するときに遡るバックフィル日数を、選択した[日付の粒度]にもとづき、選択します。 |
「上級 ‐ クエリ」レポートタイプのオプション
オプション |
説明 |
---|---|
クエリ |
Adobe Analytics Web Service APIエクスプローラークエリに入力して、レポートのデータを取得します。クエリについて詳しくは、ウェブサイト(https://marketing.adobe.com/developer/api-explorer#Report.Queue)を参照してください。 例:
|
その他のペイン
スケジュール設定、再試行、更新に関するオプションなど、コネクターインターフェースのその他のペインに表示されるオプションについては、「コネクターを使用してDataSetを追加する」を参照してください。
[Additional Elements]フィールドについて
以下のJSONスニペットには、コネクターの[Additional Elements]パラメーターで使用する必要のあるコードがすべて含まれています。stringとintのみ、選択した値に置き換える必要があります。このJSONの使用しないセクションは、削除することもできます。この使用例は、この後のセクションで説明します。
{
"id":"string",
"classification":"string",
"top":"int",
"startingWith":"int",
"search":{
"type":"string",
"keywords":[
"string"
],
}
}
Additional Elementsを使用して返す上位結果を増やす
デフォルトでは、Adobe Analytics APIは、選択された要素の上位10位までの結果のみ返します。返す結果を増やすには、[Additional Elements]を使います。例えば、上位100位までの結果を返すには、[Additional Elements]フィールドに以下を追加します。
{“top”:100,
“id”:”page”}
「id」は対象とする要素のIDです。「上位」結果の数に上限はありませんが、クエリを使って取得する数が少ないほど、効率は上がります。カンマで分割すれば、複数の要素を対象にできます。
{“top”:100,
“id”:”page”},
{“top”:100,
“id”:”region”}
Additional Elementsを使用して要素のキーワード検索を行う
[Additional Elements]に正しくフォーマットされたJSONを入力することによって、要素のキーワード検索ができます。AND、OR、NOT演算子を使って検索ができます。以下の表は、これらの演算子を説明したものです。
値 |
説明 |
---|---|
AND |
複数の検索語を組み合わせ、すべての検索キーワードを含む結果を返します。 |
OR |
複数の検索語を組み合わせ、いずれかの検索キーワードを含む結果を返します。 |
NOT |
選択したキーワードを検索結果から除外します。 |
以下の例では、「help」または「faq」がページ名またはURLに含まれるページを、上位3位まで検索しています。「OR」を「AND」に置き換えると、AND検索もできます。
{
"id": "page",
"top": 3,
"search": {
"type": "OR",
"keywords": ["help","faq"]
}
}
以下のような特殊文字を使うと、より複雑な検索もできます。
特殊文字 |
説明 |
---|---|
* |
「ワイルドカード」特殊文字。キーワードの前または後に追加します(例:page*.html)。 |
^ |
「で始まる」特殊文字。キーワードまたは文字列の最初に付け、そのキーワードまたは文字列で始まる結果を検索します(例:^http://)。 |
¥ |
「で終わる」特殊文字。キーワードまたは文字列の最後に付け、そのキーワードまたは文字列で終わる結果を検索します(例:.html$)。 |
以下がこれらの文字を使った検索の例です。
{
"id": "page",
"top": 3,
"search": {
"type": "OR",
"keywords": [“help*","^faq"]
}
}
完全一致するキーワードを検索するには、「で始まる」と「で終わる」の特殊文字をキーワードの最初と最後に付けます。
{
"id": "page",
"top": 3,
"search": {
"type": "OR",
"keywords": ["^faq$"]
}
}
JSON構文に分類を追加する
上記の高度な関数と一緒にSAINT分類を使用する場合には、以下の例で示すように、JSON構文に分類を追加する必要があります。{
"id": “page",
“classification”:”region”,
"top": 3
}
トラブルシューティング
固有のメトリクス
Adobe Analyticsコネクターで最もよく発生する問題の1つとして、ユニーク訪問者数やユニークページ閲覧数など、固有のメトリクスに関連するものがあります。固有のメトリクスは加算式ではないため、表示されるときと同じ粒度でコネクターから取得する必要があります。異なる粒度でメトリクスを出力すると、数字がまとめられたときに、不正確になります。例えば、サイトの訪問者である訪問者1が、1週間にわたって1日1回サイトにアクセスしたとします。1週間のサイトアクセス者数のレポートを確認すると、日次の粒度でデータを出力した場合には、訪問者1は7回とカウントされます。一方、週次の粒度でデータを出力した場合には、訪問者1は1回のみカウントされ、1週間でサイトにアクセスされた回数ではなく、ページにアクセスした人数が正確にカウントされます。以下の表はこれを視覚的に表した例です。
ヒントとコツ
-
分類は要素リストの「->」で識別されます。
-
データソースごとの要素は少ないほど効率が上がります。
-
1つのデータソースあたりメトリクスを10未満にするようにします。
-
データソースの実行時間が重ならないようにします。
-
Adobe Analytics APIエクスプローラーの使用方法を習得します。
-
Adobe APIのドキュメントを参照します(URLはヘルプリンクにあります)。
-
セグメントは実行時間を長引かせます。
-
セグメントはいくつでも選択できますが、選択したセグメントがデータ全体に与える影響を考慮する必要があります。セグメントの選択によって、データのグループ化が変更され、想定外の結果が生じる可能性があります。
-
sPropsとeVarsは同時に出力できません。
よくある質問
Q:Adobe Analytics OAuthアカウントが正しく作成されたにもかかわらず、それから約2週間後に「Adobe Analytics OAuthアカウントが無効になりました」というアラートが表示されました。このアラートが表示されるのはなぜですか? この場合はどうすればよいですか?
A:Adobe Analytics OAuthには、2週間で期限切れになる更新トークンが付属しています(Adobeのドキュメントを参照)。このため、2週間が経過するとAdobe OAuthを認証できなくなります。これは、Adobeによって設定された制約事項です。以前のデータベースでは、WSSE認証方式(ユーザー名として会社名を入力し、パスワードを入力する認証方式)が使用されていましたが、AdobeはこのWSSE認証方式を廃止しました。この問題の解決策については、Adobeのサポート窓口にお問い合わせください。
Q:コネクターを設定するには、データサービスの何らかのアカウントが必要ですか?
A:管理者アクセスのあるアカウントが望ましいです。少なくとも、対象とするレポートスイートへのアクセスに加えて、APIから要素、メトリクス、セグメントを取得できるアクセスが必要です。
Q:Adobe Analytics OAuth datasetsで断続的にエラーが発生し、「現在、レポート処理を実行できません。後でもう一度お試しください。」というのエラーメッセージが表示されます。どうすればよいですか?
A:これは、Adobe側で発生しているエラーです。残念ながら、Domo側から直接的に関与することはできませんが、Adobeと連携して、こういったタイプのエラーの解消に努めています。しかし、こういったエラーの発生を軽減するステップがあります。例えば、コネクターの数、コネクターがデータを取得する頻度を減らしたり、リクエストのサイズを小さくしたりすることができます。また、リクエストが異なる時間に実行されるようスケジュールを組むことも有効です。別の解決策として、コネクターの「再試行」設定を使うという方法もあります。
Q:Adobe Analytics OAuth DataSetで5つ以上の要素を含める必要がある場合はどうすればよいですか?
A:AdobeのData Warehouseレポートを実行します。これはDomoコネクターを使用しない代わりに、スケジュールされたメールを利用して、Domoにデータをインポートします。これらのレポートでは、SFTPが使えます。Adobe Analyticsのフロントエンドとは結果が若干異なる可能性があることに注意してください。
Q:レポート作成に長時間かかります。より速くレポートを作成するにはどうすればよいですか?
「中級 - カスタム」レポートの場合、選択した要素の数と、[その他要素の情報]テキストボックスのパラメーターが、レポートのパフォーマンスに大きな影響を与えます。最小限必要な要素を選択するようにします。
Adobe Analyticsのキューに多数のレポートがあるために、レポートを完了できない可能性もあります。キューレポートを使って、現在Adobeで処理中のレポートを確認できます。
DataSetがたくさんある場合には、実行時間をずらすようにして、DataSetがAdobeのキューに一斉に登録されないようにします。
Q:Adobe Analytics APIから返されているデータを確認する方法はありますか?
A:Adobe AnalyticsのAPIエクスプローラーを使って、レポートを実行し、その結果を確認できます。https://marketing.adobe.com/developer/api-explorerから入手できます。
Q:取得できる要素の数に限りはありますか?
A:AdobeのAPIでは、最大4つの要素まで、要素あたり50,000行まで取得できます。
Q:Adobeからデータを取得するワークフローはどのようなものですか?
A:DomoがAdobeデータ取得に使用しているプロセスは以下のとおりです。
-
レポートをキューに登録:DomoがAdobeに対象とするレポートのパラメーターを送信します。https://github.com/AdobeDocs/analytics-1.4-apis/blob/master/docs/reporting-api/methods/r_Queue.md
-
レポートIDを取得:DomoがレポートIDを受け取ります。
-
レポート完了まで待機:DomoはAdobeのキューを確認し、レポートが完了するまで待機します。https://github.com/AdobeDocs/analytics-1.4-apis/blob/master/docs/reporting-api/methods/r_GetQueue.md
-
レポートを取得:レポートがキューに表示されなくなると、Domoはステップ2で受け取ったレポートIDを使って、レポートのデータを要求します。https://github.com/AdobeDocs/analytics-1.4-apis/blob/master/docs/reporting-api/methods/r_Get.md
ヘルプリンク
以下のリンクから、役に立つ情報が掲載されたAdobeのウェブサイトページにアクセスできます。
API概要:https://marketing.adobe.com/developer/get-started/introduction/c-introduction
Adobe Analytics APIエクスプローラー:https://marketing.adobe.com/developer/api-explorer
インラインセグメント:https://marketing.adobe.com/developer/documentation/sitecatalyst-reporting/c-segments
高レベルスキーマ概要:https://marketing.adobe.com/developer/blog/high-level-overview-of-the-schema-of-adobe-analytics
パスレポートとフォールアウトレポート:https://marketing.adobe.com/developer/documentation/analytics-reporting-1-4/pathing
Data Warehouseレポート:https://blogs.adobe.com/digitalmarketing/analytics/omniture-datawarehouse-inside-omniture-sitecatalyst/
コメント
0件のコメント
サインインしてコメントを残してください。