Sprinklrコネクター

はじめに

Sprinklr社は、大企業向けにソーシャルメディアマーケティング、ソーシャル広告、コンテンツ管理、コラボレーション、アドボカシー、ソーシャルメディアモニタリングを提供するソーシャルソフトウェアプラットフォーム（Sprinklrという名称で呼ばれる）の開発および販売を行う企業です。DomoのSprinklrコネクターを使用して、投稿インサイト、ブートストラップ情報、プロフィールなどに関する情報を取得します。Sprinklr APIの詳細については、同社Webサイト（https://developers.sprinklr.com/）を参照してください。

Sprinklrコネクターは「クラウドApp」コネクターであるため、クラウドに保管されたデータの取得が可能です。Data Centerでウィンドウ上部のツールバーで [クラウドアプリ] をクリックすると、これを含む他のクラウドアプリコネクターのページにアクセスできます。   

Sprinklrアカウントには、Data Centerから接続します。このトピックでは、Sprinklrコネクターユーザーインターフェースに固有のフィールドとメニューについて説明します。DataSetの追加や更新スケジュールの設定、DataSet情報の編集に関する一般的な情報については「データコネクターを使用してDataSetを追加する」を参照してください。

ベストプラクティス

レポートオプションの多くは、手動での設定が必要です。これらオプションの詳細は、APIのドキュメントに記載されています。例えば、「アカウントインサイト」、「投稿インサイト」、「有料広告統計インサイト」のレポートでは、groupbyフィールドへの入力が必要です。このフィールドに入力した内容すべてが、レポートのディメンションとなります。APIドキュメントには、groupbyで使用可能な列の一覧があります。コネクターツールのヒントは、それぞれの設定手順に必要となる適切なフォーマットを示したものです。

必要条件

Sprinklrアカウントに接続してDataSetを作成するには、SprinklrクライアントIDとクライアントシークレットが必要です。

APIへのアクセスには、アプリケーションを提出した上でSprinklrによる承認が必要です。 https://developer.sprinklr.com/apps/myappsに申請プロセス完了までのすべてのステップが掲載されています。

また、APIキー作成の際は、https://oauth.domo.com/api/data/v1/oauth/providers/sprinklr/exchangeへのredirect_uri設定が必要です。

アクセス確認後、クライアントIDとクライアントシークレットでの認証が可能になります。

Sprinklrアカウントに接続する

このセクションでは、Sprinklrコネクターページの［認証情報］ および［詳細］ペインのオプションについて説明します。このページ内のほかのペインに含まれるコンポーネントである［スケジュール設定］や［DataSetに名前を付けて説明を入力］に関しては、ほとんどのタイプのコネクターで共通しています。詳細については「データコネクターを使ってDataSetを追加する」を参照してください。

認証情報ペイン

このペインには、Sprinklrアカウントに接続する認証情報の入力フィールドが含まれています。下表では、各フィールドに必要な内容を説明しています。

認証の詳細については、上記「必要条件」をご覧ください。

有効なSprinklr認証情報を一度入力しておくと、随時同じアカウントを使用して新しいSprinklr DataSetを作成できます。コネクターのアカウントはData Centerのアカウントタブで管理することができます。このタブの詳細については、「コネクターのユーザーアカウントを管理する」を参照してください。

詳細ペイン

このペインには、レポートタイプを選択するメインの［レポート］メニューをはじめ、選択したレポートタイプに応じて表示されるその他様々なメニューがあります。

以下のスクリーンショットは、「投稿インサイト」レポートの構成例を示したものです。

その他のペイン

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

トラブルシューティング

このコネクターで最も多いのが、フィルターに関連した問題です。Sprinklrでは、各レポートをフィルター処理した上で、Sprinklrウェブサイトのレポートに表示されるSprinklrデータを消去する個別のクエリで実行します。コネクターの設定時には、これらと同じフィルターの使用が必須で、それらが使用されていない場合、データが複製されるまたは失われるといったトラブルが発生します。これを行うためには、SprinklrレポートのバックエンドにあるAPI呼び出しの使用が必要となります。 

このコードにアクセスする、またはコネクターからプルするフィルターとバックエンドレポートを見つけるには、次の手順を実行します。

1. Chromeブラウザを開きます。

2. ブラウザーを右クリックして、［検証］を選択します。

3. デベロッパー用画面で [Network] タブに移動します。

4. Sprinklrレポートページで画面を再読み込みします。
   再読み込みすると［Name］列の下に要素が複数表示されます。

5. クエリを検索し、対応するレポートまたは複製するデータを見つけます。

6. クエリを選択し、requestsの下を対象に検索を行い、Demoコネクターへの入力が必要なデータをすべて特定します。
   
   

7. 認証情報を使いDomoのSprinklrコネクターに接続します。 

8. Sprinklrレポートに使用されるレポートを選択します。
   Sprinklrでは、requests > parameterの下にこのレポートがあります。この例では、「Post Insights」という名称です。

9. ［集計関数］には、Sprinklrレポートに使用される関数を選択します。
   Sprinklrでは、groupBys > projectionsの下にこの関数があります。この例では、SUMとなっています。

10. ［測定名］には、Sprinklrレポートに使用される関数を選択します。
    Sprinklrでは、groupbys > projections > measurementの下にこの関数があります。この例では、TOTAL_ENGAGEMENTがこれにあたります。

11. [Group By Options] には、構文 (columnName,dimensionName,groupType,detail=value) を使い [Network] タブの [Requests] ドロップダウンメニューの下のSprinklrレポートで、groupbyフィールドを入力します。
    
    例えば、グループに「Client_ID」フィールドがリストされている場合であれば、[Group By Options] には、(Client_ID,Client_ID, field) の構文を使用します。
    
    また、Domoカードで必要な形式でのデータレンダリングを行えるよう、Sprinklrレポートに含まれていなくとも、日付グループのご使用をお薦めいたします。例： (date,DATE_HISTOGRAM,interval=1h) または (POST_PUBLISHED_DATE,FIELD)

12. ［フィルター］には、Sprinklrレポートに使用されるフィルターを入力します。
    Sprinklrでは、requests > filtersの下にこれにあたるフィルターがあります。［フィルター］ボックスにある?の下の構文を使用します。

13. （条件付き）Sprinklrレポートのクエリコードで、［展開列］と［測定オプション］の適用が示されている場合は、「request」データに含まれる情報を入力します。 

14. 時間枠の設定時は、実際のSprinklrレポート/グラフに記載の時間枠、またはカードのビジュアル化に必要な時間枠を使用します。DomoのSprinklrレポートの大半で、実際には時間枠がありません。［時間］フィルターで指定の時間が、データベースに非対応であるか、また日付として認識不可能な形式であるかは、バックエンドで確認可能です。

ドリルダウンの構築

Sprinklrデータにドリルダウンを作成するには、カードに表示するドリルダウンの種類を設計または検索し、そのデータを表示するSprinklrのDataSetを新規作成します。ドリルダウンを使うには、最上位のSprinklrデータソースに対応するDataFlowの同じフィールド名をプルするか、名前の変更を行う必要があります。

よくある質問

データはどれくらいの頻度で更新できますか？

DataSetは、1日に1回の更新がかかる設定にする必要があります。

注意すべきAPI制限はありますか？

Sprinklrでは、実稼働インスタンスへの呼び出しに、5回/秒、500回/時の制限があります。Sandboxインスタンスへの呼び出しは、2回/秒、100回/時の制限となります。1回のDataSet実行に複数の呼び出しが必要になる場合があるので注意してください。