Zendesk Events API 拡張機能の概要
Zendesk は、カスタマーサービスソリューションおよびセールスツールです。 Zendesk イベント転送拡張機能は、Zendesk Events API を活用して、イベントを Adobe Experience Platform Edge Network から Zendesk に送信して、さらに処理できるようにします。 拡張機能を使用して、ダウンストリームの分析やアクションで使用する顧客プロファイルインタラクションを収集できます。
このドキュメントでは、UI で 拡張機能をインストールおよび設定する方法について説明します。
前提条件
この拡張機能を使用するには、Zendesk アカウントが必要です。 Zendesk アカウントは、Zendesk web サイトで登録できます。
また、Zendesk の設定に関して、次の詳細を収集する必要があります。
xxxxx.zendesk.com
(xxxxx
は、アカウントの作成時に指定された値です)cwWyOtHAv12w4dhpiulfe9BdZFTz3OKaTSzn2QvV
最後に、API トークンのイベント転送の秘密鍵を作成する必要があります。 秘密鍵タイプを「トークン」に設定し、その値を Zendesk 設定から収集した API トークンに設定します。 秘密鍵の設定に関する詳細については、イベント転送での秘密鍵に関するドキュメントを参照してください。
拡張機能のインストール install
UI で Zendesk 拡張機能をインストールするには、イベント転送 に移動し、拡張機能を追加するプロパティを選択するか、代わりに新しいプロパティを作成します。
目的のプロパティを選択または作成したら、拡張機能/カタログ に移動します。「Zendesk」を検索し、Zendesk 拡張機能で Install を選択します。
拡張機能の設定 configure
左側のナビゲーションの「拡張機能」を選択します。 インストール済み で、Zendesk 拡張機能の「設定」を選択します。
Zendesk ドメイン で、Zendesk サブドメインの値を入力します。Zendesk トークン で、API トークンを含む、以前に作成した秘密鍵を選択します。
イベント転送ルールの設定
新しいイベント転送ルールのルールの作成を開始し、 必要に応じて条件を設定します。 ルールのアクションを選択する場合は、Zendesk 拡張機能を選択してから、「イベントを作成」アクションタイプを選択します。
アクション設定を設定する際に、Zendesk に送信される様々なプロパティにデータ要素を割り当てるように求められます。
これらのデータ要素は、以下に示すようにマッピングする必要があります。
event
キー
event
は、ユーザーによってトリガーされたイベントを表す JSON オブジェクトです。event
オブジェクトが取得するプロパティについて詳しくは、イベントの詳細に関する Zendesk のドキュメントを参照してください。
次のキーは、event
オブジェクト内でデータ要素にマッピングするときに参照されます。
event
キーsource
arc.event.xdm._extconndev.event_source
Zendesk
は、Zendesk 標準イベントのソース名として保護されているため、値として使用しないでください。使用を試みると、エラーが発生します。値の長さは 40 文字を超えないようにします。
type
arc.event.xdm._extconndev.event_type
description
arc.event.xdm._extconndev.description
created_at
arc.event.xdm.timestamp
properties
arc.event.xdm._extconndev.EventProperties
profile
キー
profile
は、イベントをトリガーしたユーザーを表す JSON オブジェクトです。 profile
オブジェクトによって取り込まれるプロパティについて詳しくは、Zendesk のドキュメントにあるプロファイルの詳細を参照してください。
データ要素へのマッピングの際、次のキーは profile
オブジェクト内で参照できます。
profile
キーsource
arc.event.xdm._extconndev.profile_source
Support
、CompanyName
、または Chat
)。type
arc.event.xdm._extconndev.profile_type
name
arc.event.xdm._extconndev.name
user_id
arc.event.xdm._extconndev.user_id
identifiers
arc.event.xdm._extconndev.identifiers
identifiers
配列について詳しくは、Zendesk ドキュメントを参照してください。すべてのフィールドと値は一意である必要があります。attributes
arc.event.xdm._extconndev.attrbutes
Zendesk 内のデータの検証 validate
イベントの収集と Adobe Experience Platform の統合が成功した場合は、Zendesk コンソール内のイベントが以下のように表示されます。これは、統合が成功したことを示します。
プロファイル:
イベント:
リクエストの制限 limits
アカウントのタイプに基づいて、Zendesk Events API は、1 分あたりに次のリクエスト数を処理できます。
これらの制限の詳細については、Zendesk のドキュメントを参照してください。
エラーとトラブルシューティング errors-and-troubleshooting
拡張機能の使用中または設定中に、以下のエラーが Zendesk Events API から返される場合があります。
{"error": [{"code":"InvalidProfileTypeLength","title": "Profile type length > 40 chars"}]}
{subdomain}.zendesk.com
で指定されていることを確認します。{"error": [{"description": "No route found for host {subdomain}.zendesk.com","title": "RouteNotFound"}]}
{"error": [{"code":"MissingOrInvalidAuthentication","title": "Invalid or Missing Authentication"}]}
{"error": [{"code":"PermissionDenied","title": "Insufficient permisssions to perform operation"}]}
{"error": [{"code":"TooManyRequests","title": "Too Many Requests"}]}
次の手順
このドキュメントでは、UI で Zendesk イベント転送拡張機能をインストールおよび設定する方法について説明しました。 Zendesk でのイベントデータの収集について詳しくは、次の公式ドキュメントを参照してください。