Outreach 接続
概要 overview
Outreach は、世界で最も B2B のバイヤーとセラーのインタラクションデータを扱う Sales Execution Platform で、販売データをインテリジェンスに変換するための独自の AI テクノロジーへの大量の投資を行っています。Outreach は、組織がセールスエンゲージメントを自動化、収益インテリジェンスに基づいて行動し、効率、予測可能性、成長を向上させるのに役立ちます。
この Adobe Experience Platform 宛先は、Outreach Update Resource API を活用しており、Outreach の見込み客に対応する、オーディエンス内の ID を更新できます。
Outreach は、認証付与を使用する OAuth 2 を認証メカニズムとして使用して、Outreach Update Resource API と通信します。 Outreach インスタンスを認証する手順は、さらに下の 宛先に対する認証の節にあります。
ユースケース use-cases
マーケターは、Adobe Experience Platform プロファイルの属性に基づいて、パーソナライズされたエクスペリエンスを見込み客に提供できます。 オフラインデータからオーディエンスを作成し、それらのオーディエンスを Outreach に送信して、Adobe Experience Platformでオーディエンスとプロファイルが更新されるとすぐに見込み客のフィードに表示することができます。
前提条件 prerequisites
Experience Platform の前提条件 prerequisites-in-experience-platform
Outreach 宛先へのデータをアクティブ化する前に、スキーマ、データセットおよびセグメントを Experience Platform で作成する必要があります。
オーディエンスのステータスに関するガイダンスが必要な場合は、 オーディエンスメンバーシップの詳細スキーマフィールドグループに関するAdobeのドキュメントを参照してください。
アウトリーチの前提条件 prerequisites-destination
Platform から Outreach アカウントにデータを書き出すには、Outreach で次の前提条件に注意してください。
アウトリーチアカウントが必要です prerequisites-account
アカウントをまだお持ちでない場合は、Outreach ログインページに移動し、アカウントを登録して作成してください。 詳しくは、Outreach サポート ページも参照してください。
Outreach CRM 宛先に対して認証を行う前に、以下の項目をメモしておきます。
カスタムフィールドラベルの設定 prerequisites-custom-fields
Outreach では、 見込み客のカスタムフィールドをサポートしています。 詳しくは、 アウトリーチでカスタムフィールドを追加する方法を参照してください。 識別を容易にするために、デフォルト値を維持するのではなく、対応するオーディエンス名に手動でラベルを更新することをお勧めします。 以下に例を示します。
カ Outreach タムフィールドを表示している見込み客の設定ページ
オーディエンス名に一致する ユーザーにとってわかりやすい ラベルを持つカスタムフィールドを表示する見込み客の Outreach 設定ページ。 これらのラベルに対して、見込み客ページでオーディエンスステータスを表示できます。
ガードレール
Outreach API のレート制限は、ユーザーごとに 1 時間あたり 10,000 リクエストです。 この制限に達すると、次のメッセージを含む 429
応答が返されます:You have exceeded your permitted rate limit of 10,000; please try again at 2017-01-01T00:00:00.
。
このメッセージが表示された場合は、レートしきい値に準拠するようにオーディエンスの書き出しスケジュールを更新する必要があります。
詳しくは、Outreach ドキュメントを参照してください。
サポートされる ID supported-identities
Outreach では、以下の表で説明する ID の更新をサポートしています。ID についての詳細情報。
OutreachId
- Outreach 識別子。 これは、見込み客プロファイルに対応する数値です。
- ID は、更新する見込み客の Outreach URL 内の ID と一致する必要があります。
- 詳しくは、Outreach ドキュメントを参照してください。
書き出しのタイプと頻度 export-type-frequency
宛先の書き出しのタイプと頻度について詳しくは、以下の表を参照してください。
- セグメントのすべてのメンバーを、フィールドマッピングに従って、必要なスキーマフィールドと共に書き出します (例:メールアドレス、電話番号、姓)。
- Outreach の各セグメントのステータスは、 オーディエンススケジュール手順で提供された マッピング ID 値に基づいて、Platform の対応するオーディエンスステータスとともに更新されます。
- ストリーミングの宛先は常に、API ベースの接続です。オーディエンス評価に基づいて Experience Platform 内でプロファイルが更新されるとすぐに、コネクタは更新を宛先プラットフォームに送信します。詳しくは、ストリーミングの宛先を参照してください。
宛先への接続 connect
この宛先に接続するには、宛先設定のチュートリアルの手順に従ってください。宛先の設定ワークフローで、以下の 2 つのセクションにリストされているフィールドに入力します。
宛先/カタログ 内で Outreach を検索します。または、CRM カテゴリの下に配置することもできます。
宛先に対する認証 authenticate
宛先を認証するには、「宛先に接続」を選択します。
Outreach ログインページが表示されます。 メールを入力します。
次に、パスワードを入力します。
- ユーザー名:Outreach アカウントのメールアドレス。
- パスワード:Outreach アカウントのパスワード。
指定した詳細が有効な場合、UI で 接続済み ステータスに緑色のチェックマークが付きます。その後、次の手順に進むことができます。
宛先の詳細を入力 destination-details
宛先の詳細を設定するには、以下の必須フィールドとオプションフィールドに入力します。UI のフィールドの横にアスタリスクが表示される場合は、そのフィールドが必須であることを示します。
- 名前:今後この宛先を認識するための名前。
- 説明:今後この宛先を識別するのに役立つ説明。
アラートの有効化 enable-alerts
アラートを有効にすると、宛先へのデータフローのステータスに関する通知を受け取ることができます。リストからアラートを選択して、データフローのステータスに関する通知を受け取るよう登録します。アラートについて詳しくは、UI を使用した宛先アラートの購読についてのガイドを参照してください。
宛先接続の詳細の入力を終えたら「次へ」を選択します。
この宛先に対してオーディエンスをアクティブ化 activate
この宛先にオーディエンスをアクティベートする手順は、ストリーミングオーディエンスの書き出し宛先へのプロファイルとオーディエンスのアクティベートを参照してください。
マッピングの考慮事項と例 mapping-considerations-example
Adobe Experience Platform から Outreach 宛先にオーディエンスデータを正しく送信するには、フィールドマッピングの手順を実行する必要があります。マッピングは、Platform アカウント内の Experience Data Model(XDM)スキーマフィールドと、ターゲット宛先から対応する同等のスキーマフィールドとの間にリンクを作成して構成されます。 XDM フィールドを Outreach 宛先フィールドに正しくマッピングするには、次の手順に従います。
-
マッピング 手順で、「新しいマッピングを追加」をクリックします。 画面に新しいマッピング行が表示されます。
-
ソースフィールドを選択 ウィンドウで、ID 名前空間を選択 カテゴリを選択して、目的のマッピングを追加します。
-
ターゲットフィールドを選択ウィンドウで、ソースフィールドにマッピングするターゲットフィールドのタイプを選択します。
-
ID 名前空間を選択:このオプションを選択して、ソースフィールドをリストから ID 名前空間にマッピングします。
-
XDM プロファイルスキーマと Outreach インスタンスの間の次のマッピングを追加:
|XDM プロファイルスキーマ|Outreach インスタンス| 必須|
|—|—|—|
|Oid
|OutreachId
| はい | -
カスタム属性を選択:このオプションを選択して、「属性名」フィールドに定義するカスタム属性にマッピングするソースフィールドを選択します。サポートされる属性の包括的なリストについては、Outreach 見込み客ドキュメントを参照してください。
-
例えば、更新する値に応じて、XDM プロファイルスキーマと Outreach インスタンスの間に次のようなマッピングを追加します。
|XDM プロファイルスキーマ|Outreach インスタンス|
|—|—|
|person.name.firstName
|firstName
|
|person.name.lastName
|lastName
| -
これらのマッピングの使用例を次に示します。
-
オーディエンスの書き出しのスケジュールと例 schedule-segment-export-example
-
オーディエンスの書き出しをスケジュール手順を実行する場合は、Platform オーディエンスを Outreach のカスタムフィールド属性に手動でマッピングする必要があります。
-
これを行うには、各セグメントを選択し、「マッピング ID」フィールドの Outreach にある カスタムフィールド
N
ラベル フィールドに対応する数値を入力します。note important IMPORTANT - マッピング ID 内で使用される数値 (
N
) は、Outreach 内の数値でサフィックス付きのカスタム属性キーと一致する必要があります。 例:ラベルN
カスタムフィールド。 - 指定する必要があるのは数値だけで、カスタムフィールドラベル全体は指定できません。
- Outreach では、最大 150 個のカスタムラベルフィールドをサポートしています。
- 詳しくは、Outreach 見込み客ドキュメントを参照してください。
-
例:
table 0-row-2 1-row-2 Outreach フィールド プラットフォームマッピング ID ラベル 4
カスタムフィールド4
- マッピング ID 内で使用される数値 (
データの書き出しを検証する exported-data
宛先が正しく設定されていることを検証するには、次の手順に従います。
-
宛先/参照 を選択して、宛先のリストに移動します。
-
宛先を選択し、ステータスが「 有効」であることを確認します。
-
「Activation data」タブに切り替えて、オーディエンス名を選択します。
-
オーディエンスの概要を監視し、プロファイルの数がセグメント内で作成された数と一致していることを確認します。
-
Outreach web サイトににログインして、Apps / Contacts ページに移動し、オーディエンスのプロファイルが追加されたかどうかを確認します。 Outreach の各オーディエンスステータスが、 オーディエンススケジュール手順で提供された マッピング ID 値に基づいて、Platform から対応するオーディエンスステータスに更新されたことがわかります。
データの使用とガバナンス data-usage-governance
Adobe Experience Platform のすべての宛先は、データを処理する際のデータ使用ポリシーに準拠しています。Adobe Experience Platform がどのようにデータガバナンスを実施するかについて詳しくは、データガバナンスの概要を参照してください。
エラーとトラブルシューティング errors-and-troubleshooting
データフローの実行を確認すると、次のエラーメッセージが表示される場合があります。Bad request reported while pushing events to the destination. Please contact the administrator and try again.
このエラーを修正するには、Platform で Outreach オーディエンスに指定した マッピング ID が有効であり、Outreach に存在することを確認します。
その他のリソース additional-resources
Outreach ドキュメントには、問題のデバッグに使用できる エラー応答に関する詳細があります。