Zendesk 接続
Zendeskは、カスタマーサービス ソリューションおよびセールス ツールです。
このAdobe Experience Platform 宛先は、Zendesk 連絡先APIを活用して、オーディエンス内の 作成および更新ID をZendesk内の連絡先として作成します。
Zendeskは、ベアラートークンをZendesk連絡先APIと通信するための認証メカニズムとして使用します。 Zendesk インスタンスを認証する手順は、さらに下の宛先に対する認証の節にあります。
ユースケース use-cases
マルチチャネル B2C プラットフォームのカスタマーサービス部門では、顧客にシームレスなパーソナライズされた体験を提供したいと考えています。 同部門は、独自のオフラインデータからオーディエンスを構築して、新しいユーザープロファイルを作成したり、様々なインタラクション（購入、返品など）から既存のプロファイル情報を更新したりして、これらのオーディエンスをAdobe Experience PlatformからZendeskまで送信することができます。 Zendeskに更新された情報を持つことで、カスタマーサービス担当者は顧客の最新情報をすぐに利用できるようになり、迅速な応答と解決が可能になります。
前提条件 prerequisites
Experience Platform の前提条件 prerequisites-in-experience-platform
Zendesk 宛先へのデータをアクティブ化する前に、スキーマ、データセットおよびセグメントを Experience Platform で作成する必要があります。
オーディエンスのステータスに関するガイダンスが必要な場合は、 オーディエンスメンバーシップの詳細スキーマフィールドグループ のExperience Platform ドキュメントを参照してください。
Zendesk 前提条件 prerequisites-destination
Experience PlatformからZendesk アカウントにデータをエクスポートするには、Zendesk アカウントが必要です。
Zendesk 資格情報の収集 gather-credentials
Zendesk宛先に対する認証を行う前に、以下の項目をメモしてください。
Bearer tokenドキュメントに従って、 アクセストークンを生成 Zendesk します（お持ちでない場合）。
a0b1c2d3e4...v20w21x22y23zガードレール guardrails
価格設定とレート制限 ページには、アカウントに関連付けられているZendesk API制限の詳細が表示されます。 データとペイロードがこれらの制約内にあることを確認する必要があります。
サポートされる ID supported-identities
Zendesk では、以下の表で説明する ID の更新をサポートしています。ID についての詳細情報。
emailtest@test.comサポートされるオーディエンス supported-audiences
この節では、この宛先に書き出すことができるオーディエンスのタイプについて説明します。
このカテゴリには、Segmentation Serviceを通じて生成されたオーディエンス以外のすべてのオーディエンスのオリジンが含まれます。 様々なオーディエンスの起源について読みます。 次に例を示します。
- カスタムアップロードオーディエンス がCSV ファイルからExperience Platformにをインポートしました。
- 類似オーディエンス，
- 連合オーディエンス，
- Adobe Journey Optimizerなどの他のExperience Platform アプリで生成されたオーディエンス
- その他。
オーディエンスのデータタイプ別にサポートされるオーディエンス：
書き出しのタイプと頻度 export-type-frequency
宛先の書き出しタイプと頻度については、次の表を参照してください。
- セグメントのすべてのメンバーを、フィールドマッピングに従って、必要なスキーマフィールドと共に書き出します（例：メールアドレス、電話番号、姓）。
- Zendeskの各セグメントステータスは、Mapping ID オーディエンススケジュール 手順で指定した値に基づいて、Experience Platformからの対応するオーディエンスステータスで更新されます。
- ストリーミングの宛先は常に、API ベースの接続です。オーディエンス評価に基づいて Experience Platform 内でプロファイルが更新されるとすぐに、コネクタは更新を宛先プラットフォームに送信します。詳しくは、ストリーミングの宛先を参照してください。
宛先への接続 connect
この宛先に接続するには、宛先設定のチュートリアルの手順に従ってください。宛先の設定ワークフローで、以下の 2 つのセクションにリストされているフィールドに入力します。
Destinations > Catalog内でZendeskを検索します。 または、CRM カテゴリの下に配置することもできます。
宛先に対する認証 authenticate
以下の必須のフィールドに入力します。ガイダンスについては、収集 Zendesk 資格情報 セクションを参照してください。
- Bearer Token: Zendesk アカウントで生成したアクセストークン。
宛先に対する認証を行うには、Connect to destinationを選択します。
認証方法を示す
指定された詳細が有効な場合、UIには緑色のチェックマークが付いたConnected ステータスが表示されます。 その後、次の手順に進むことができます。
宛先の詳細を入力 destination-details
宛先の詳細を設定するには、以下の必須フィールドとオプションフィールドに入力します。UI のフィールドの横にアスタリスクが表示される場合は、そのフィールドが必須であることを示します。
宛先の詳細を示す
- Name：今後この宛先を認識する際に使用する名前。
- Description：今後この宛先を特定するのに役立つ説明です。
アラートの有効化 enable-alerts
アラートを有効にすると、宛先へのデータフローのステータスに関する通知を受け取ることができます。リストからアラートを選択して、データフローのステータスに関する通知を受け取るよう登録します。アラートについて詳しくは、UI を使用した宛先アラートの購読についてのガイドを参照してください。
宛先接続の詳細の提供が完了したら、Nextを選択します。
この宛先に対してオーディエンスをアクティブ化 activate
- データをアクティブ化するには、View Destinations、Activate Destinations、View ProfilesおよびView Segments アクセス制御権限が必要です。 アクセス制御の概要を参照するか、製品管理者に問い合わせて必要な権限を取得してください。
- IDをエクスポートするには、View Identity Graph アクセス制御権限が必要です。
この宛先にオーディエンスをアクティベートする手順は、ストリーミングオーディエンスの書き出し宛先へのプロファイルとオーディエンスのアクティベートを参照してください。
マッピングの考慮事項と例 mapping-considerations-example
オーディエンスデータをAdobe Experience PlatformからZendesk宛先に正しく送信するには、フィールドマッピング手順を実行する必要があります。 マッピングでは、Experience Platform アカウントのExperience Data Model （XDM）スキーマフィールドと、ターゲット先の対応するスキーマフィールドとの間にリンクを作成します。
Target fieldで指定された属性には、属性マッピング テーブルで説明されているとおりの名前を付ける必要があります。これらの属性はリクエスト本文を形成します。
Source fieldで指定された属性は、そのような制限に従っていません。 必要に応じてマッピングできますが、Zendeskにプッシュしたときにデータ形式が正しくない場合は、エラーが発生します。
XDM フィールドを Zendesk 宛先フィールドに正しくマッピングするには、次の手順に従います。
-
Mapping ステップで、Add new mappingを選択します。 画面に新しいマッピング行が表示されます。
-
Select source field ウィンドウで、Select attributes カテゴリを選択してXDM属性を選択するか、Select identity namespaceを選択してIDを選択します。
-
Select target field ウィンドウで、Select identity namespace カテゴリを選択してターゲット IDを選択するか、Select attributes カテゴリを選択して、サポートされているスキーマ属性のいずれかを選択します。
-
これらの手順を繰り返して、次の必須マッピングを追加します。XDM プロファイルスキーマとZendesk インスタンスの間で更新するその他の属性を追加することもできます。
table 0-row-3 1-row-3 2-row-3 3-row-3 ソースフィールド ターゲットフィールド 必須 xdm: person.name.lastNamexdm: last_name○ IdentityMap: EmailIdentity: email○ xdm: person.name.firstNamexdm: first_name -
これらのマッピングの使用例を次に示します。
-
Attribute: last_nameとIdentity: emailのターゲットマッピングが必須です。 これらのマッピングが見つからない場合、他のマッピングは無視され、Zendeskには送信されません。宛先接続のマッピングの提供が完了したら、Nextを選択します。
オーディエンスの書き出しのスケジュールと例 schedule-segment-export-example
アクティベーション ワークフローのSchedule audience export ステップでは、Experience Platform オーディエンスをZendeskのカスタム フィールド属性に手動でマッピングする必要があります。
これを行うには、各セグメントを選択し、Zendesk フィールドに Mapping ID から対応するカスタムフィールド属性を入力します。
例を次に示します。
データの書き出しを検証する exported-data
宛先が正しく設定されていることを検証するには、次の手順に従います。
-
Destinations > Browseを選択し、宛先のリストに移動します。
-
次に、宛先を選択してActivation data タブに切り替え、オーディエンス名を選択します。
宛先アクティベーションデータを示す
-
オーディエンスの概要を監視し、プロファイルの数がセグメント内の数に対応していることを確認します。
セグメントを示す
-
Zendesk web サイトに移動し、Contacts ページに移動して、オーディエンスのプロファイルが追加されたかどうかを確認します。 このリストは、オーディエンス Mapping ID およびオーディエンスステータスで作成された追加フィールドの列を表示するように設定できます。
オーディエンス名で作成された追加フィールドを含む連絡先ページを示す
-
または、個々のPerson ページにドリルダウンして、オーディエンス名とオーディエンスのステータスを表示するAdditional fields セクションを確認することもできます。
オーディエンス名とオーディエンスのステータスを表示する追加フィールドセクションを含む人物ページを示す
データの使用とガバナンス data-usage-governance
Adobe Experience Platform のすべての宛先は、データを処理する際のデータ使用ポリシーに準拠しています。Adobe Experience Platform がどのようにデータガバナンスを実施するかについて詳しくは、データガバナンスの概要を参照してください。
その他のリソース additional-resources
Zendesk ドキュメントのその他の有用な情報は次のとおりです。
変更ログ changelog
この節では、この宛先コネクタに対する機能の概要と重要なドキュメントの更新について説明します。
| table 0-row-3 1-row-3 2-row-3 layout-auto | ||
|---|---|---|
| リリース月 | 更新タイプ | 説明 |
| 2023年4月 | ドキュメントの更新 |
|
| 2023年3月 | 初回リリース | 最初の宛先リリースとドキュメントの公開。 |