UI での Zendesk ソース接続の作成
このチュートリアルでは、Adobe Experience Platform ユーザーインターフェイスを使用して Zendesk ソース接続を作成する手順について説明します。
はじめに
このチュートリアルは、Adobe Experience Platform の次のコンポーネントを実際に利用および理解しているユーザーを対象としています。
-
Experience Data Model (XDM) システム:Experience Platform が顧客体験データの整理に使用する標準化されたフレームワーク。
- スキーマ構成の基本:スキーマ構成の主要な原則やベストプラクティスなど、XDM スキーマの基本的な構成要素について学びます。
- スキーマエディターのチュートリアル:スキーマエディター UI を使用してカスタムスキーマを作成する方法を説明します。
-
Real-Time Customer Profile:複数のソースからの集計データに基づいて、統合されたリアルタイムの顧客プロファイルを提供します。
必要な資格情報の収集
Platform で Zendesk アカウントにアクセスするには、次の資格情報の値を指定する必要があります。
yoursubdomain
0lZnClEvkJSTQ7olGLl7PMhVq99gu26GTbJtf
Zendesk ソースの認証について詳しくは、Zendesk ソースの概要を参照してください。
Zendesk 用の Platform スキーマの作成
また、Zendesk ソース接続を作成する前に、まずソースに使用する Platform スキーマを作成する必要があります。 スキーマの作成方法に関する包括的な手順については、Platform スキーマの作成に関するチュートリアルを参照してください。
Zendesk Search API に必要な Zendesk スキーマに関する追加のガイダンスについては、以下の limits の節を参照してください。
Zendesk アカウントの接続
Platform UI の左側のナビゲーションバーで「ソース」を選択し、ソースワークスペースにアクセスします。カタログ画面には、アカウントを作成できる様々なソースが表示されます。
画面の左側にあるカタログから適切なカテゴリを選択することができます。または、使用する特定のソースを検索オプションを使用して探すこともできます。
カスタマーサクセス カテゴリで、「Zendesk」を選択し、次に「データを追加」を選択します。
Zendesk アカウントを接続 ページが表示されます。 このページでは、新しい資格情報または既存の資格情報を使用できます。
既存のアカウント
既存のアカウントを使用するには、新しいデータフローの作成に使用する Zendesk アカウントを選択し、「次へ」を選択して続行します。
新しいアカウント
新しいアカウントを作成する場合は、「新しいアカウント」を選択し、続けて名前、説明(オプション)、の認証情報を指定します。 終了したら「ソースに接続」を選択し、新しい接続が確立されるまでしばらく待ちます。
データの選択
ソースが認証されると、ページが更新されてインタラクティブスキーマツリーに変わり、データの階層を調べることができます。 「次へ」を選択して次に進みます。
次の手順
このチュートリアルでは、認証を行い、お使いの Zendesk アカウントと Platform とのソース接続を作成しました。次のチュートリアルに進み、 カスタマーサクセスデータを Platform に取り込むためのデータフローの作成を行いましょう。
その他のリソース
以下の節では、Zendesk ソースを使用する際に参照できるその他のリソースを示します。
検証 validation
次に、Zendesk ソースに正常に接続したことと、Zendesk のプロファイルが Platform に取り込まれていることを検証する手順の概要を説明します。
Platform の UI で、左側のナビゲーションから データセット を選択し、 データセット ワークスペースにアクセスします。 データセットアクティビティ 画面には、実行の詳細が表示されます。
次に、表示するデータフローのデータフロー実行 ID を選択して、そのデータフロー実行に関する特定の詳細を確認します。
最後に、「データセットをプレビュー」を選択して、取り込まれたデータを表示します。
また、Zendesk / Customers ページのデータに対して Platform データを検証することもできます。
Zendesk スキーマ
次の表に、Zendesk 用に設定する必要がある、サポートされるマッピングを示します。
results.active
results.alias
results.created_at
results.custom_role_id
results.default_group_id
results.details
results.email
results.external_id
results.iana_time_zone
results.id
results.last_login_at
results.locale
results.locale_id
results.moderator
results.name
results.notes
results.only_private_comments
results.organization_id
results.phone
results.photo
results.report_csv
results.restricted_agent
results.result_type
results.role
results.role_type
results.shared
results.shared_agent
results.shared_phone_number
results.signature
results.suspended
results.ticket_restriction
results.time_zone
results.two_factor_auth_enabled
results.updated_at
results.url
results.verified
制限 limits
-
Zendesk Search API/検索結果の書き出しは、1 ページあたり最大 1000 レコードを返します。
filter[type]
パラメーターの値はuser
に設定されているので、Zendesk 接続はユーザーのみを返します。- ページごとの結果の数は、
page[size]
パラメーターで管理されます。 値は100
に設定されます。 これは、Zendesk によって設定された速度低下制約の影響を軽減するために行われます。 - 制限および ページネーションを参照してください。
- また、 カーソルのページネーションを使用したリスト内のページ分割も参照してください。