Zendesk 接続
- トピック:
- 宛先
作成対象:
- 管理者
- ユーザー
Zendesk は、カスタマーサービスソリューションおよびセールスツールです。
この Adobe Experience Platform 宛先は、Zendesk Contacts API を活用して、オーディエンス内の ID の作成と更新 を Zendesk 内の連絡先として実行します。
Zendesk は、Zendesk Contacts API と通信するための認証メカニズムとしてベアラートークンを使用します。 Zendesk インスタンスを認証する手順は、さらに下の宛先に対する認証の節にあります。
ユースケース
マルチチャネル B2C プラットフォームのカスタマーサービス部門は、顧客にシームレスでパーソナライズされたエクスペリエンスを提供したいと考えています。 部門は、独自のオフラインデータからオーディエンスを作成して、新しいユーザープロファイルを作成したり、様々なインタラクション(購入、返品など)から既存のプロファイル情報を更新したり、これらのオーディエンスをAdobe Experience Platformから Zendesk に送信したりできます。 最新情報を Zendesk に入手することで、カスタマー・サービス・エージェントが顧客の最新情報をすぐに入手できるようになり、迅速な対応と解決が可能になります。
前提条件
Experience Platform の前提条件
Zendesk 宛先へのデータをアクティブ化する前に、スキーマ、データセットおよびセグメントを Experience Platform で作成する必要があります。
オーディエンスのステータスに関するガイダンスが必要な場合は、 オーディエンスメンバーシップの詳細スキーマフィールドグループに関するExperience Platform ドキュメントを参照してください。
Zendesk 前提条件
Experience Platformから Zendesk アカウントにデータをエクスポートするには、Zendesk アカウントが必要です。
Zendesk 資格情報の収集
Zendesk の宛先に対して認証を行う前に、以下の項目をメモしておきます。
資格情報 | 説明 | 例 |
---|---|---|
Bearer token | Zendesk アカウントで生成したアクセストークン。 アクセストークンがない場合は、ドキュメントに従って アクセストークン Zendesk 生成します。 | a0b1c2d3e4...v20w21x22y23z |
ガードレール
価格とレート制限ページは、アカウントに関連する Zendesk API 制限の詳細を説明します。 データとペイロードがこれらの制約内にあることを確認する必要があります。
サポートされる ID
Zendesk では、以下の表で説明する ID の更新をサポートしています。ID についての詳細情報。
ターゲット ID | 例 | 説明 | 必須 |
---|---|---|---|
email | test@test.com | 連絡先のメールアドレス。 | ○ |
書き出しのタイプと頻度
宛先の書き出しのタイプと頻度について詳しくは、以下の表を参照してください。
項目 | タイプ | メモ |
---|---|---|
書き出しタイプ | プロファイルベース |
|
書き出し頻度 | ストリーミング |
|
宛先への接続
この宛先に接続するには、宛先設定のチュートリアルの手順に従ってください。宛先の設定ワークフローで、以下の 2 つのセクションにリストされているフィールドに入力します。
宛先/カタログ 内で Zendesk を検索します。または、CRM カテゴリの下に配置することもできます。
宛先に対する認証
以下の必須のフィールドに入力します。詳しくは、Gather Zendesk credentials の節を参照してください。
- ベアラートークン:Zendesk アカウントに生成したアクセストークンです。
宛先を認証するには、「 宛先に接続」を選択します。
指定した詳細が有効な場合、UI で 接続済み ステータスに緑色のチェックマークが付きます。その後、次の手順に進むことができます。
宛先の詳細を入力
宛先の詳細を設定するには、以下の必須フィールドとオプションフィールドに入力します。UI のフィールドの横にアスタリスクが表示される場合は、そのフィールドが必須であることを示します。
- 名前:今後この宛先を認識するための名前。
- 説明:今後この宛先を識別するのに役立つ説明。
アラートの有効化
アラートを有効にすると、宛先へのデータフローのステータスに関する通知を受け取ることができます。リストからアラートを選択して、データフローのステータスに関する通知を受け取るよう登録します。アラートについて詳しくは、UI を使用した宛先アラートの購読についてのガイドを参照してください。
宛先接続の詳細の入力を終えたら「次へ」を選択します。
この宛先に対してオーディエンスをアクティブ化
この宛先にオーディエンスをアクティベートする手順は、ストリーミングオーディエンスの書き出し宛先へのプロファイルとオーディエンスのアクティベートを参照してください。
マッピングの考慮事項と例
Adobe Experience Platform から Zendesk 宛先にオーディエンスデータを正しく送信するには、フィールドマッピングの手順を実行する必要があります。マッピングは、Experience Platform アカウント内の Experience Data Model (XDM)スキーマフィールドと、ターゲット宛先から対応する同等のスキーマフィールドとの間にリンクを作成して構成されます。
ターゲットフィールド で指定する属性には、属性マッピングテーブルで説明されているとおりに正確に名前を付ける必要があります。これらの属性はリクエスト本文を形成するからです。
Source フィールドで指定された属性は そのような制限には従いません。 必要に応じてマッピングできますが、Zendesk にプッシュした際にデータ形式が正しくない場合は、エラーが発生します。
XDM フィールドを Zendesk 宛先フィールドに正しくマッピングするには、次の手順に従います。
-
マッピング 手順で、「新しいマッピングを追加」を選択します。画面に新しいマッピング行が表示されます。
-
ソースフィールドを選択 ウィンドウで、属性を選択 カテゴリを選択して XDM 属性を選択するか、ID 名前空間を選択 を選択して ID を選択します。
-
ターゲットフィールドを選択 ウィンドウで、ID 名前空間を選択 カテゴリを選択してターゲット ID を選択するか、属性を選択 カテゴリを選択して、サポートされているスキーマ属性の 1 つを選択します。
-
これらの手順を繰り返して、次の必須マッピングを追加します。また、XDM プロファイルスキーマと Zendesk インスタンスの間で更新したい他の属性を追加することもできます。
ソースフィールドターゲットフィールド必須xdm: person.name.lastName
xdm: last_name
○IdentityMap: Email
Identity: email
○xdm: person.name.firstName
xdm: first_name
-
これらのマッピングの使用例を次に示します。
-
Attribute: last_name
と Identity: email
のターゲットマッピングが必須です。 これらのマッピングがない場合、他のマッピングは無視され、Zendesk に送信されません。宛先接続のマッピングの指定を終えたら「次へ」を選択します。
オーディエンスの書き出しのスケジュールと例
アクティベーションワークフローの オーディエンスの書き出しをスケジュール 手順では、Experience Platform オーディエンスを Zendesk のカスタムフィールド属性に手動でマッピングする必要があります。
これを行うには、各セグメントを選択し、対応するカスタムフィールド属性を Zendesk の「マッピング ID」フィールドから入力します。
次に例を示します。
データの書き出しを検証する
宛先が正しく設定されていることを検証するには、次の手順に従います。
-
宛先/参照 を選択し、宛先のリストに移動します。
-
次に、宛先を選択し、アクティベーションデータ タブに切り替えて、オーディエンス名を選択します。
-
オーディエンスの概要を監視し、プロファイルの数がセグメント内の数と一致していることを確認します。
-
Zendesk web サイトにログインし、連絡先 ページに移動して、オーディエンスのプロファイルが追加されたかどうかを確認します。 このリストは、オーディエンス マッピング ID およびオーディエンスステータスで作成された追加フィールドの列を表示するように設定できます。
-
または、個々の ユーザー ページにドリルダウンして、オーディエンス名とオーディエンスのステータスを表示する 追加フィールド セクションを確認することもできます。
データの使用とガバナンス
Adobe Experience Platform のすべての宛先は、データを処理する際のデータ使用ポリシーに準拠しています。Adobe Experience Platform がどのようにデータガバナンスを実施するかについて詳しくは、データガバナンスの概要を参照してください。
その他のリソース
Zendesk ドキュメントからのその他の役に立つ情報は次のとおりです。
変更ログ
この節では、この宛先コネクタに対する機能の概要と重要なドキュメントの更新について説明します。