Adobe Analytics 1.4 OAuthコネクター

その他のペイン

スケジュール設定、再試行、更新に関するオプションなど、コネクターインターフェースのその他のペインに表示されるオプションについては、「コネクターを使用してDataSetを追加する」を参照してください。

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演算子を使って検索ができます。以下の表は、これらの演算子を説明したものです。

以下の例では、「help」または「faq」がページ名またはURLに含まれるページを、上位3位まで検索しています。「OR」を「AND」に置き換えると、AND検索もできます。 

{
"id": "page",
"top": 3,
"search": {
"type": "OR",
"keywords": ["help","faq"]
}
}

以下のような特殊文字を使うと、より複雑な検索もできます。

以下がこれらの文字を使った検索の例です。

{
"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週間でサイトにアクセスされた回数ではなく、ページにアクセスした人数が正確にカウントされます。以下の表はこれを視覚的に表した例です。

APIエクスプローラー

Adobe AnalyticsにあるAPIエクスプローラーを使って、レポートを実行し、その結果を確認できます。https://marketing.adobe.com/developer/api-explorerから入手できます。

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データ取得に使用しているプロセスは以下のとおりです。

1. レポートをキューに登録：DomoがAdobeに対象とするレポートのパラメーターを送信します。https://github.com/AdobeDocs/analytics-1.4-apis/blob/master/docs/reporting-api/methods/r_Queue.md

2. レポートIDを取得：DomoがレポートIDを受け取ります。

3. レポート完了まで待機：DomoはAdobeのキューを確認し、レポートが完了するまで待機します。https://github.com/AdobeDocs/analytics-1.4-apis/blob/master/docs/reporting-api/methods/r_GetQueue.md

4. レポートを取得：レポートがキューに表示されなくなると、Domoはステップ2で受け取ったレポートIDを使って、レポートのデータを要求します。https://github.com/AdobeDocs/analytics-1.4-apis/blob/master/docs/reporting-api/methods/r_Get.md