はじめに
Sprinklr社は、大企業向けにソーシャルメディアマーケティング、ソーシャル広告、コンテンツ管理、コラボレーション、アドボカシー、ソーシャルメディアモニタリングを提供する、ソーシャルソフトウェアプラットフォーム（Sprinklrという名称で呼ばれる）の開発および販売を行う企業です。DomoのSprinklr Advancedコネクターを使用して、投稿インサイト、ブートストラップ情報、プロフィールなどに関する情報を取得するとともに、カスタムクエリを作成します。Sprinklr APIの詳細については、同社ウェブサイト（ https://developers.sprinklr.com/ ）を参照してください。 Sprinklr Advancedコネクターは、「Custom Query」というレポートタイプが追加されていることを除けば、 標準のSprinklrコネクター とまったく同じです。このレポートでは、Sprinklr UIのクエリ定義を入力してSprinklrでレポートの動作を再現することができます。 Sprinklr Advancedコネクターは「クラウドApp」であるため、クラウドに保管されたデータを取得できます。Data Centerでウィンドウ上部のツールバーで ［クラウドApp］ をクリックすると、このコネクターのほか様々なクラウドAppコネクターのページにアクセスできます。 Sprinklrアカウントには、Data Centerから接続します。このトピックでは、Sprinklr Advancedコネクターのユーザーインターフェースに固有のフィールドとメニューについて説明します。DataSetの追加や更新スケジュールの設定、DataSet情報の編集に関する一般的な情報については、「 コネクターを使用してDataSetを追加する 」を参照してください。主な使用事例 | Sprinklrでは、組織が様々なソーシャルプラットフォームアカウントを1ヶ所に集約し、各種ソーシャルメディアのKPI追跡を行うことが可能です。 |
主なメトリクス |
|
社内における主な権限 | ソーシャルマーケティング担当者 |
平均導入時間 | APIにアクセスする申請プロセスに2週間を要します。認証後、実際導入にかかる時間は5時間ほどです。 |
使いやすさ（1～10の段階。1が「最も使いやすい」） | 7 |
ベストプラクティス
レポートオプションの多くは、手動での設定が必要です。これらオプションの詳細は、APIのドキュメントに記載されています。例えば、「Account Insights」、「Post Insights」、「Paid Ad Stats Insights」のレポートでは、 groupby フィールドへの入力が必要です。このフィールドに入力した内容すべてが、レポートのディメンションとなります。APIのドキュメントには、 groupby で使用可能な列の一覧があります。コネクターツールのヒントは、それぞれの設定手順に必要となる適切なフォーマットを示したものです。必要条件
Sprinklrアカウントに接続してDataSetを作成するには、SprinklrクライアントIDとクライアントシークレットが必要です。 APIへのアクセスには、申請書を提出した上でSprinklrによる承認が必要です。 https://developers.sprinklr.com/page/Create_an_APP に申請プロセス完了までのすべてのステップが掲載されています。 また、APIキー作成の際は、 https://oauth.domo.com/api/data/v1/oauth/providers/sprinklr/exchange へのredirect_uri設定が必要です。 アクセス確認後、クライアントIDとクライアントシークレットでの認証が可能になります。Sprinklrアカウントに接続する
このセクションでは、Sprinklrコネクターページの ［認証情報］ および ［詳細］ ペインのオプションについて説明します。このページのほかのペインの項目である ［スケジュール設定］ や ［DataSetに名前を付け、説明を入力］ に関しては、ほとんどのタイプのコネクターで共通しています。詳細については、「 コネクターを使用してDataSetを追加する 」を参照してください。［認証情報］ペイン
このペインには、Sprinklrアカウントに接続する認証情報の入力フィールドが含まれています。下表では、各フィールドに必要な内容を説明しています。フィールド | 説明 |
|---|---|
Environment | 接続先のSprinklr環境として、［Sandbox］または［Production］を選択します。 |
Client ID | SprinklrクライアントIDを入力します。 |
Client Secret | Sprinklrクライアントシークレットを入力します。 |
［詳細］ペイン
このペインには、レポートタイプを選択するメインの ［Report］ メニューをはじめ、選択したレポートタイプに応じて表示されるその他様々なメニューがあります。メニュー | 説明 | ||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Report | Sprinklrレポートを選択します。以下のレポートが利用できます。
| ||||||||||||||||||||||||||
Aggregate Function | レポート内のデータ集計方法を選択します。 | ||||||||||||||||||||||||||
| Measurement Names | データを取得する測定値をすべて選択します。 | ||||||||||||||||||||||||||
| Group By Options | 希望する groupby オプションを (columnName,dimensionName,groupType,detail=value) のフォーマットで入力します。 例： (“MyAccountId”,ACCOUNT_ID,FIELD),(date,DATE_HISTOGRAM,interval=1w) | ||||||||||||||||||||||||||
| Filter Options | 希望するフィルターオプションを (dimensionName,filterType,[value1,value2],detail=value) のフォーマットで入力します。 例： (SN_TYPE,IN,[FACEBOOK]),(CLIENT_ID,IN,[62]),(ACCOUNT_ID,IN,[3051,553,565]) | ||||||||||||||||||||||||||
| Measurement Options | 追加で行う結果計算の測定オプションを選択します。 | ||||||||||||||||||||||||||
Duration | データを特定の日付について取得するか、日付範囲について取得するかを選択します。 | ||||||||||||||||||||||||||
Report Date | レポートのデータが特定の日付か、今日から何日前までのものかを選択します。 | ||||||||||||||||||||||||||
Select Specific Date | レポートの日付を選択します。 | ||||||||||||||||||||||||||
Days Back | レポートに表示する過去日数を入力します。 | ||||||||||||||||||||||||||
Start Date | 日付範囲の最初の日付が特定の日付なのか、相対的な日付なのかを指定します。範囲の最後の日付は、 ［End Date］ で選択します。 | ||||||||||||||||||||||||||
End Date | 日付範囲の2番目の日付が特定の日付なのか、相対的な日付なのかを指定します。日付範囲の最初の日付は ［Start Date］ で選択します。 | ||||||||||||||||||||||||||
Select Specific Start Date | 日付範囲の最初の日付を選択します。 | ||||||||||||||||||||||||||
Select Specific End Date | 日付範囲の2番目の日付を選択します。 | ||||||||||||||||||||||||||
Days Back to Start From | レポートで表示する過去の日のうち、現在から最も遠い日までの日数を入力します。 ［Days Back to End At］ と組み合わせることによって、表示日数の範囲を指定できます。 例えば、 ［Days Back to Start From］ に「 10 」、 ［Days Back to End At］ に「 5 」を入力した場合、レポートには、今日から数えて10日前から5日前のデータが含まれます。 | ||||||||||||||||||||||||||
Days Back to End At | レポートで表示する過去の日のうち、現在から最も近い日までの日数を入力します。 ［Days Back to Start From］ と組み合わせることによって、表示日数の範囲を指定できます。 例えば、 ［Days Back to Start From］ に「 10 」、 ［Days Back to End At］ に「 5 」を入力した場合、レポートには、今日から数えて10日前から5日前のデータが含まれます。 | ||||||||||||||||||||||||||
| Select Resources | データを取得するリソースをすべて選択します。 | ||||||||||||||||||||||||||
| Select Reports | 情報を取得するカスタムメトリクスをすべて選択します。 | ||||||||||||||||||||||||||
| Dashboard Name | ダッシュボード名を入力します（例： AutoDashboard ）。 | ||||||||||||||||||||||||||
| Column Name | 列名を入力します（例： fbinbox ）。 | ||||||||||||||||||||||||||
| Channel Type for the Profile | プロフィールのチャネルタイプを入力します（例： FACEBOOK ）。 | ||||||||||||||||||||||||||
| Profile ID of Social Channel | ソーシャルチャネルの一意のプロフィールIDを入力します（例： 215244391952058 ）。 | ||||||||||||||||||||||||||
| Stream | データを取得するストリームのIDを入力します。 | ||||||||||||||||||||||||||
| Widget Type | データを取得するリスニングウィジェットタイプ（分布、トレンドなど）を選択します。 | ||||||||||||||||||||||||||
| Columns to Expand（オプション） | 複数列に展開する列のカンマ区切りリストを入力します。通常は、「リスト」または「オブジェクト」として返される列です。 | ||||||||||||||||||||||||||
| Dimension | 「Listening Widget」レポートに表示する最初のディメンションを選択します。 | ||||||||||||||||||||||||||
| Custom Field Name | 選択したディメンションのカスタムフィールド名を入力します。 | ||||||||||||||||||||||||||
| Other Dimension | 「Listening Widget」レポートに表示する2番目のディメンションを選択します。 | ||||||||||||||||||||||||||
| Subtype | 「Listening Widget」レポートでデータを取得するユーザーのサブタイプを選択します。 | ||||||||||||||||||||||||||
Expand Lists | リストを含む列を展開するか否かを選択します。このオプションを選択すると、DataSetで単一の投稿に対し複数行が含まれる場合があります。 | ||||||||||||||||||||||||||
Query | SprinklrレポートをDomoに取得するためのカスタムクエリを入力します。 |
その他のペイン
スケジュール設定、再試行、更新に関するオプションなど、コネクターインターフェースのその他のペインに表示されるオプションについては、「 コネクターを使用してDataSetを追加する 」を参照してください。トラブルシューティング
このコネクターで最も多いのが、フィルターに関連した問題です。Sprinklrでは、各レポートをフィルター処理した上で、Sprinklrウェブサイトのレポートに表示されるSprinklrデータを消去する個別のクエリで実行します。コネクターの設定時には、これらと同じフィルターの使用が 必須 で、それらが使用されていない場合、データが複製されるまたは失われるといったトラブルが発生します。これを行うためには、SprinklrレポートのバックエンドにあるAPIコールの使用が必要となります。 このコードにアクセスする、またはコネクターから取得するフィルターとバックエンドレポートを見つけるには、次の手順を実行します。- Chromeブラウザーを開きます。
- ブラウザーを右クリックして、 ［検証］ を選択します。
- デベロッパー用画面で ［Network］ タブに移動します。
- Sprinklrレポートページで画面を再読み込みします。 再読み込みすると ［Name］ 列の下に要素が複数表示されます。
- クエリを検索し、対応するレポートまたは複製するデータを見つけます。
-
クエリを選択し、
［requests］ の下を対象に検索を行い、Domoコネクターへの入力が必要なデータをすべて特定します。
- 認証情報を使いDomoのSprinklrコネクターに接続します。
- Sprinklrレポートに使用されるレポートを選択します。 Sprinklrでは、 ［requests］> ［parameter］ の下にこのレポートがあります。この例では、「Post Insights」という名称です。
- ［Aggregation Function］ には、Sprinklrレポートに使用される関数を選択します。 Sprinklrでは、 ［groupBys］> ［projections］ の下にこの関数があります。この例では、「 SUM 」となっています。
- ［Measurement Name］ には、Sprinklrレポートに使用される関数を選択します。 Sprinklrでは、 ［groupbys］>［projections］>［measurement］ の下にこの関数があります。この例では、「 TOTAL_ENGAGEMENT 」がこれに当たります。
- ［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)
- ［Filters］ には、Sprinklrレポートに使用されるフィルターを入力します。 Sprinklrでは、 ［requests］>［filters］ の下にこれに当たるフィルターがあります。 ［Filters］ ボックスにある「?」の下の構文を使用します。
- （条件付き）Sprinklrレポートのクエリコードで、 ［Columns to Expand］ と ［Measurement Options］ の適用が示されている場合は、「request」データに含まれる情報を入力します。
- 期間の設定時は、実際のSprinklrレポート/グラフに記載の期間、またはカードの可視化に必要な期間を使用します。DomoのSprinklrレポートの大半で、実際には期間がありません。 ［Time］ フィルターで指定の時間が、データベースに非対応であるか、また日付として認識不可能なフォーマットであるかは、バックエンドで確認可能です。
ドリルダウンの構築
Sprinklrデータにドリルダウンを作成するには、カードに表示するドリルダウンの種類を設計または検索し、そのデータを表示するSprinklrのDataSetを新規作成します。ドリルダウンを使うには、最上位のSprinklrデータソースに対応するDataFlowの同じフィールド名を取得するか、名前の変更を行う必要があります。よくある質問
データはどれくらいの頻度で更新できますか？
データはどれくらいの頻度で更新できますか？
注意すべきAPI制限はありますか？
注意すべきAPI制限はありますか？