はじめに
Sprinklr社は、大企業向けにソーシャルメディアマーケティング、ソーシャル広告、コンテンツ管理、コラボレーション、アドボカシー、ソーシャルメディアモニタリングを提供する、ソーシャルソフトウェアプラットフォーム（Sprinklrという名称で呼ばれる）の開発および販売を行う企業です。DomoのSprinklrコネクターを使用して、投稿インサイト、ブートストラップ情報、プロフィールなどに関する情報を取得します。Sprinklr APIの詳細については、同社ウェブサイト（ https://developer.sprinklr.com/ ）を参照してください。 Sprinklrコネクターは「クラウドApp」コネクターであるため、クラウドに保管されたデータの取得が可能です。Data Centerでウィンドウ上部のツールバーの ［クラウドApp］ をクリックすると、これを含むほかのクラウドAppコネクターのページにアクセスできます。 Sprinklrアカウントには、Data Centerから接続します。このトピックでは、Sprinklrコネクターユーザーインターフェースに固有のフィールドとメニューについて説明します。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とクライアントシークレットが必要です。ステップごとのプロセスについては、「 Getting Started 」を参照してください。 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アカウントに接続する認証情報の入力フィールドが含まれています。下表では、各フィールドに必要な内容を説明しています。フィールド | 説明 |
|---|---|
Environment | データの取得元のSprinklr環境として実稼働環境またはサンドボックスのいずれかを選択します。 developer.sprinklr.com ポータルの ［MY ACCOUNTS］ で環境を入力します。 |
Client ID | SprinklrクライアントIDを入力します。 developer.sprinklr.com ポータルの ［MY ACCOUNTS］ でAPIキーを入力します。 |
Client Secret | developer.sprinklr.com ポータルの ［MY ACCOUNTS］ でSprinklrクライアントシークレットを入力します。 |
［詳細］ペイン
このペインには、レポートタイプを選択するメインの ［Report］ メニューをはじめ、選択したレポートタイプに応じて表示されるその他様々なメニューがあります。メニュー | Description | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
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で単一の投稿に対し複数行が含まれる場合があります。 |
その他のペイン
スケジュール設定、再試行、更新に関するオプションなど、コネクターインターフェースのその他のペインに表示されるオプションについては、「 コネクターを使用してDataSetを追加する 」を参照してください。トラブルシューティング
このコネクターで最も多いのが、フィルターに関連した問題です。Sprinklrでは、各レポートをフィルター処理した上で、Sprinklrウェブサイトのレポートに表示されるSprinklrデータを消去する個別のクエリで実行します。コネクターの設定時には、これらと同じフィルターの使用が 必須 で、それらが使用されていない場合、データが複製されるまたは失われるといったトラブルが発生します。これを行うためには、SprinklrレポートのバックエンドにあるAPIコールの使用が必要となります。 このコードにアクセスする、またはコネクターから取得するフィルターとバックエンドレポートを見つけるには、次の手順を実行します。- Chromeブラウザーを開きます。
- ブラウザーを右クリックして、 ［検証］ を選択します。
- デベロッパー用画面で ［Network］ タブに移動します。
- Sprinklrレポートページで画面を再読み込みします。 再読み込みすると ［Name］ 列の下に要素が複数表示されます。
- クエリを検索し、対応するレポートまたは複製するデータを見つけます。
-
クエリを選択し、
［requests］ の下を対象に検索を行い、Demoコネクターへの入力が必要なデータをすべて特定します。
- 認証情報を使いDomoのSprinklrコネクターに接続します。
- Sprinklrレポートに使用されるレポートを選択します。 Sprinklrでは、 ［requests］> ［parameter］ の下にこのレポートがあります。この例では、「Post Insights」という名称です。
- ［Aggregation Function］ には、Sprinklrレポートに使用される関数を選択します。 Sprinklrでは、 ［groupBys］> ［p rojections］ の下にこの関数があります。この例では、「 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制限はありますか？