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

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

はじめに

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

必要な資格情報の収集

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

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

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

Zendesk API トークン

Zendesk 用の Platform スキーマの作成

また、Zendesk ソース接続を作成する前に、まずソースに使用する Platform スキーマを作成する必要があります。 スキーマの作成方法に関する包括的な手順については、Platform スキーマの作成に関するチュートリアルを参照してください。

Zendesk Search API に必要な Zendesk スキーマに関する追加のガイダンスについては、以下の limits の節を参照してください。

スキーマを作成

Zendesk アカウントの接続

Platform UI の左側のナビゲーションバーで「ソース」を選択し、ソースワークスペースにアクセスします。カタログ画面には、アカウントを作成できる様々なソースが表示されます。

画面の左側にあるカタログから適切なカテゴリを選択することができます。または、使用する特定のソースを検索オプションを使用して探すこともできます。

カスタマーサクセス カテゴリで、「Zendesk」を選択し、次に「データを追加」を選択します。

カタログ

Zendesk アカウントを接続 ページが表示されます。 このページでは、新しい資格情報または既存の資格情報を使用できます。

既存のアカウント

既存のアカウントを使用するには、新しいデータフローの作成に使用する Zendesk アカウントを選択し、「次へ」を選択して続行します。

既存

新しいアカウント

新しいアカウントを作成する場合は、「新しいアカウント」を選択し、続けて名前、説明(オプション)、の認証情報を指定します。 終了したら「ソースに接続」を選択し、新しい接続が確立されるまでしばらく待ちます。

新規

データの選択

ソースが認証されると、ページが更新されてインタラクティブスキーマツリーに変わり、データの階層を調べることができます。 「次へ」を選択して次に進みます。

select-data

次の手順

このチュートリアルでは、認証を行い、お使いの Zendesk アカウントと Platform とのソース接続を作成しました。次のチュートリアルに進み、 カスタマーサクセスデータを Platform に取り込むためのデータフローの作成を行いましょう。

その他のリソース

以下の節では、Zendesk ソースを使用する際に参照できるその他のリソースを示します。

検証 validation

次に、Zendesk ソースに正常に接続したことと、Zendesk のプロファイルが Platform に取り込まれていることを検証する手順の概要を説明します。

Platform の UI で、左側のナビゲーションから データセット を選択し、​ データセット ​ ワークスペースにアクセスします。 ​ データセットアクティビティ ​ 画面には、実行の詳細が表示されます。

アクティビティページ

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

データフローページ

最後に、「データセットをプレビュー」を選択して、取り込まれたデータを表示します。

Zendesk データセット

また、Zendesk / Customers ページのデータに対して 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
Integer
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

recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089