UI での Zendesk ソース接続の作成
このチュートリアルでは、Adobe Experience Platform ユーザーインターフェイスを使用してZendesk ソース接続を作成する手順を説明します。
はじめに
このチュートリアルは、Adobe Experience Platform の次のコンポーネントを実際に利用および理解しているユーザーを対象としています。
-
Experience Data Model (XDM) システム:Experience Platform が顧客体験データの整理に使用する標準化されたフレームワーク。
- スキーマ構成の基本:スキーマ構成の主要な原則やベストプラクティスなど、XDM スキーマの基本的な構成要素について学びます。
- スキーマエディターのチュートリアル:スキーマエディター UI を使用してカスタムスキーマを作成する方法を説明します。
-
Real-Time Customer Profile:複数のソースからの集計データに基づいて、統合されたリアルタイムの顧客プロファイルを提供します。
必要な資格情報の収集
Experience PlatformでZendesk アカウントにアクセスするには、次の資格情報の値を指定する必要があります。
yoursubdomain0lZnClEvkJSTQ7olGLl7PMhVq99gu26GTbJtfZendesk ソースの認証について詳しくは、Zendesk ソースの概要を参照してください。
ZendeskのExperience Platform スキーマを作成
Zendesk ソース接続を作成する前に、まずソースに使用するExperience Platform スキーマを作成する必要があります。 スキーマの作成方法の包括的な手順については、Experience Platform スキーマの作成に関するチュートリアルを参照してください。
Zendeskに必要なZendesk Search API スキーマに関する追加のガイダンスについては、以下の制限 セクションを参照してください。
Zendesk アカウントを接続
Experience Platform UIで、左側のナビゲーションバーから「Sources」を選択して、Sources ワークスペースにアクセスします。 Catalog画面には、アカウントを作成できる様々なソースが表示されます。
画面の左側にあるカタログから適切なカテゴリを選択することができます。または、使用する特定のソースを検索オプションを使用して探すこともできます。
「カスタマーサクセス」カテゴリで、「Zendesk」を選択し、「Add data」を選択します。
Connect Zendesk account ページが表示されます。 このページでは、新しい資格情報または既存の資格情報を使用できます。
既存のアカウント
既存のアカウントを使用するには、新しいデータフローを作成するZendesk アカウントを選択し、Nextを選択して続行します。
新しいアカウント
新しいアカウントを作成する場合は、New accountを選択し、名前、オプションの説明、および資格情報を指定します。 完了したら、Connect to sourceを選択し、新しい接続が確立されるまでしばらく時間を空けます。
データの選択
ソースが認証されると、ページはインタラクティブなスキーマツリーに更新され、データの階層を探索および検査できるようになります。 続行するには、Nextを選択してください。
次の手順
このチュートリアルでは、Zendesk アカウントとExperience Platformの間のソース接続を認証して作成しました。 次のチュートリアルに進み、 カスタマーサクセスデータをExperience Platformに取り込むためのデータフローを作成できるようになりました。
その他のリソース
以下の節では、Zendesk ソースを使用する際に参照できる追加のリソースについて説明します。
検証 validation
次の手順では、Zendesk ソースが正常に接続されたこと、およびZendesk プロファイルがExperience Platformに取り込まれていることを検証するために実行できる手順の概要を示します。
Experience Platform UIで、左側のナビゲーションから「Datasets」を選択して、Datasets ワークスペースにアクセスします。 Dataset Activity画面には、実行の詳細が表示されます。
次に、表示するデータフローのデータフロー実行IDを選択して、そのデータフロー実行に関する特定の詳細を表示します。
最後に、Preview datasetを選択して、取り込まれたデータを表示します。
また、Zendesk > Customers ページのデータに対してExperience Platform データを検証することもできます。
Zendesk スキーマ
次の表に、Zendeskに設定する必要があるサポートされているマッピングを示します。
results.activeresults.aliasresults.created_atresults.custom_role_idresults.default_group_idresults.detailsresults.emailresults.external_idresults.iana_time_zoneresults.idresults.last_login_atresults.localeresults.locale_idresults.moderatorresults.nameresults.notesresults.only_private_commentsresults.organization_idresults.phoneresults.photoresults.report_csvresults.restricted_agentresults.result_typeresults.roleresults.role_typeresults.sharedresults.shared_agentresults.shared_phone_numberresults.signatureresults.suspendedresults.ticket_restrictionresults.time_zoneresults.two_factor_auth_enabledresults.updated_atresults.urlresults.verified制限 limits
-
Zendesk Search API/検索結果を書き出しは、1 ページにつき最大1000件のレコードを返します。
filter[type]パラメーターの値はuserに設定されているため、Zendesk接続はユーザーのみを返します。- ページあたりの結果の数は、
page[size]パラメーターによって管理されます。 値は100に設定されています。 これは、Zendeskによって設定された速度低下の制約の影響を軽減するために行われます。 - 制限および ページネーション を参照してください。
- カーソルのページネーション を使用して、 リストを介したページネーションを参照することもできます。