Zendesk 接続

Last update: Wed Oct 29 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

トピック：
宛先

作成対象：

管理者
ユーザー

Zendesk は、カスタマーサービスソリューションおよびセールスツールです。

この Adobe Experience Platform 宛先は、Zendesk Contacts API を活用して、オーディエンス内の ID の作成と更新 を Zendesk 内の連絡先として実行します。

Zendesk は、Zendesk Contacts 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 アカウントで生成したアクセストークン。
アクセストークンがない場合は、ドキュメントに従ってアクセストークン Zendesk 生成します。

a0b1c2d3e4...v20w21x22y23z

ガードレール guardrails

価格とレート制限ページは、アカウントに関連する Zendesk API 制限の詳細を説明します。データとペイロードがこれらの制約内にあることを確認する必要があります。

サポートされる ID supported-identities

Zendesk では、以下の表で説明する ID の更新をサポートしています。ID についての詳細情報。

ターゲット ID

例

説明

必須

email

test@test.com

連絡先のメールアドレス。

○

書き出しのタイプと頻度 export-type-frequency

宛先の書き出しのタイプと頻度について詳しくは、以下の表を参照してください。

項目

タイプ

メモ

書き出しタイプ

Profile-based

セグメントのすべてのメンバーを、フィールドマッピングに従って、必要なスキーマフィールドと共に書き出します（例：メールアドレス、電話番号、姓）。
Zendesk の各セグメントのステータスは、Mapping ID オーディエンススケジュール手順で指定した値に基づいて、Experience Platformの対応するオーディエンスステータスとともに更新されます。

書き出し頻度

Streaming

ストリーミングの宛先は常に、API ベースの接続です。オーディエンス評価に基づいて Experience Platform 内でプロファイルが更新されるとすぐに、コネクタは更新を宛先プラットフォームに送信します。詳しくは、ストリーミングの宛先を参照してください。

宛先への接続 connect

IMPORTANT

宛先に接続するには、View Destinations および Manage Destinations アクセス制御権限が必要です。詳しくは、アクセス制御の概要または製品管理者に問い合わせて、必要な権限を取得してください。

この宛先に接続するには、宛先設定のチュートリアルの手順に従ってください。宛先の設定ワークフローで、以下の 2 つのセクションにリストされているフィールドに入力します。

Destinations > Catalog 内で Zendesk を検索します。または、CRM カテゴリの下に配置することもできます。

宛先に対する認証 authenticate

以下の必須のフィールドに入力します。詳しくは、Gather Zendesk credentials の節を参照してください。

Bearer Token:Zendesk アカウントで生成したアクセストークン。

宛先を認証するには、「Connect to destination」を選択します。
認証方法を示すExperience Platform UI のスクリーンショット。

指定した詳細が有効な場合、UI で Connected ステータスに緑色のチェックマークが付きます。その後、次の手順に進むことができます。

宛先の詳細を入力 destination-details

宛先の詳細を設定するには、以下の必須フィールドとオプションフィールドに入力します。UI のフィールドの横にアスタリスクが表示される場合は、そのフィールドが必須であることを示します。
宛先の詳細を示すExperience Platform UI のスクリーンショット。

Name：今後この宛先を認識するための名前。
Description：今後この宛先を識別するのに役立つ説明。

アラートの有効化 enable-alerts

アラートを有効にすると、宛先へのデータフローのステータスに関する通知を受け取ることができます。リストからアラートを選択して、データフローのステータスに関する通知を受け取るよう登録します。アラートについて詳しくは、UI を使用した宛先アラートの購読についてのガイドを参照してください。

宛先接続への詳細の入力を終えたら「Next」を選択します。

この宛先に対してオーディエンスをアクティブ化 activate

IMPORTANT

データをアクティブ化するには、View Destinations、Activate Destinations、View Profiles、View Segments アクセス制御権限が必要です。アクセス制御の概要を参照するか、製品管理者に問い合わせて必要な権限を取得してください。
ID を書き出すには、View Identity Graph アクセス制御権限が必要です。
{width="100" modal="regular"}

この宛先にオーディエンスをアクティベートする手順は、ストリーミングオーディエンスの書き出し宛先へのプロファイルとオーディエンスのアクティベートを参照してください。

マッピングの考慮事項と例 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 カテゴリを選択してサポートされているスキーマ属性の 1 つを選択します。

これらの手順を繰り返して、次の必須マッピングを追加します。また、XDM プロファイルスキーマと Zendesk インスタンスの間で更新したい他の属性を追加することもできます。

table 0-row-3 1-row-3 2-row-3 3-row-3
ソースフィールド	ターゲットフィールド	必須
`xdm: person.name.lastName`	`xdm: last_name`	○
`IdentityMap: Email`	`Identity: email`	○
`xdm: person.name.firstName`	`xdm: first_name`

これらのマッピングの使用例を次に示します。

IMPORTANT

この宛先には、Attribute: last_name と Identity: email のターゲットマッピングが必須です。これらのマッピングがない場合、他のマッピングは無視され、Zendesk に送信されません。

宛先接続のマッピングの指定を終えたら「Next」を選択します。

オーディエンスの書き出しのスケジュールと例 schedule-segment-export-example

アクティベーションワークフローの Schedule audience export の手順では、Experience Platform オーディエンスを Zendesk のカスタムフィールド属性に手動でマッピングする必要があります。

これを行うには、各セグメントを選択し、対応するカスタムフィールド属性を Zendesk から Mapping ID フィールドに入力します。

次に例を示します。
オーディエンスの書き出しのスケジュールを示したExperience Platform UI のスクリーンショットの例。

データの書き出しを検証する 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 ドキュメントからのその他の役に立つ情報は次のとおりです。

変更ログ

この節では、この宛先コネクタに対する機能の概要と重要なドキュメントの更新について説明します。

変更ログを表示

table 0-row-3 1-row-3 2-row-3 layout-auto
リリース月	更新タイプ	説明
2023年4月	ドキュメントの更新	ユースケースの節を更新し、この宛先を使用することで、お客様にメリットが得られるタイミングをより明確に例を示しました。 mapping の節を更新して、必要な正しいマッピングを反映させました。この宛先には、`Attribute: last_name` と `Identity: email` のターゲットマッピングが必須です。これらのマッピングがない場合、他のマッピングは無視され、Zendesk に送信されません。マッピングの節を更新し、必須マッピングとオプションマッピングの両方の明確な例を追加しました。
2023年3月	初回リリース	宛先の初回リリースとドキュメントの公開。

recommendation-more-help

7f4d1967-bf93-4dba-9789-bb6b505339d6