UI での Zendesk ソース接続の作成

このチュートリアルでは、Adobe Experience Platform ユーザーインターフェイスを使用してZendesk ソース接続を作成する手順を説明します。

はじめに

このチュートリアルは、Adobe Experience Platform の次のコンポーネントを実際に利用および理解しているユーザーを対象としています。

必要な資格情報の収集

Experience PlatformでZendesk アカウントにアクセスするには、次の資格情報の値を指定する必要があります。

資格情報
説明
サブドメイン
登録プロセス中に作成されたアカウントに固有の一意のドメイン。
yoursubdomain
アクセストークン
Zendesk API トークン:
0lZnClEvkJSTQ7olGLl7PMhVq99gu26GTbJtf

Zendesk ソースの認証について詳しくは、Zendesk ソースの概要を参照してください。

Zendesk API トークン ​

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​を選択してください。

select-data

次の手順

このチュートリアルでは、Zendesk アカウントとExperience Platformの間のソース接続を認証して作成しました。 次のチュートリアルに進み、​ カスタマーサクセスデータをExperience Platformに取り込むためのデータフローを作成できるようになりました

その他のリソース

以下の節では、Zendesk ソースを使用する際に参照できる追加のリソースについて説明します。

検証 validation

次の手順では、Zendesk ソースが正常に接続されたこと、およびZendesk プロファイルがExperience Platformに取り込まれていることを検証するために実行できる手順の概要を示します。

Experience Platform UIで、左側のナビゲーションから「Datasets」を選択して、Datasets ワークスペースにアクセスします。 Dataset Activity画面には、実行の詳細が表示されます。

​ アクティビティページ ​

次に、表示するデータフローのデータフロー実行IDを選択して、そのデータフロー実行に関する特定の詳細を表示します。

​ データフローページ ​

最後に、Preview dataset​を選択して、取り込まれたデータを表示します。

Zendesk データセット ​

また、Zendesk > Customers ページのデータに対してExperience Platform データを検証することもできます。

zendesk-customers

Zendesk スキーマ

次の表に、Zendeskに設定する必要があるサポートされているマッピングを示します。

TIP
APIについて詳しくは、Zendesk Search API / 検索結果を書き出しを参照してください。
ソース
タイプ
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によって設定された速度低下の制約の影響を軽減するために行われます。
    • 制限および​ ページネーション ​を参照してください。
    • カーソルのページネーション を使用して、 リストを介したページネーションを参照することもできます。
recommendation-more-help
experience-platform-help-sources