Outreach 接続
概要 overview
Outreach は、世界で最も B2B のバイヤーとセラーのインタラクションデータを扱う Sales Execution Platform で、販売データをインテリジェンスに変換するための独自の AI テクノロジーへの大量の投資を行っています。Outreach は、組織がセールスエンゲージメントを自動化、収益インテリジェンスに基づいて行動し、効率、予測可能性、成長を向上させるのに役立ちます。
このAdobe Experience Platform 宛先は、 アウトリーチ更新リソース APIを活用して、Outreachの見込み客に対応するオーディエンス内のIDを更新します。
Outreachは、Outreach Update Resource APIと通信するための認証メカニズムとして、承認付与を含むOAuth 2を使用しています。 Outreach インスタンスに対する認証手順は、宛先に対する認証 セクション内で、さらに下にあります。
ユースケース use-cases
マーケターは、見込み客のAdobe Experience Platform プロファイルの属性に基づいて、パーソナライズされたエクスペリエンスを見込み客に配信できます。 オフラインデータからオーディエンスを作成し、これらのオーディエンスをOutreachに送信すると、Adobe Experience Platformでオーディエンスとプロファイルが更新されるとすぐに、見込み客のフィードに表示されます。
前提条件 prerequisites
Experience Platform の前提条件 prerequisites-in-experience-platform
Outreach 宛先へのデータをアクティブ化する前に、スキーマ、データセットおよびセグメントを Experience Platform で作成する必要があります。
オーディエンスのステータスに関するガイダンスが必要な場合は、 オーディエンスメンバーシップの詳細スキーマフィールドグループ に関するAdobeのドキュメントを参照してください。
アウトリーチの前提条件 prerequisites-destination
Experience PlatformからOutreach アカウントにデータをエクスポートするには、Outreachの次の前提条件に注意してください。
Outreach アカウントも必要です prerequisites-account
アカウントを既にお持ちでない場合は、Outreach ログイン ページに移動して、アカウントを登録および作成します。 詳細については、Outreach サポート ページ も参照してください。
Outreach CRM 宛先に対して認証を行う前に、以下の項目をメモしておきます。
カスタムフィールドラベルの設定 prerequisites-custom-fields
Outreachは、見込客のカスタムフィールドをサポートしています。 追加のガイダンスについては、Outreachでカスタムフィールドを追加する方法を参照してください。 識別しやすいように、デフォルトを維持する代わりに、対応するオーディエンス名にラベルを手動で更新することをお勧めします。 例えば、次のように指定します。
カスタムフィールドを表示する見込客のOutreach設定ページ。
オーディエンス名に一致するOutreach ユーザーに適した ラベルのカスタムフィールドを表示する見込み顧客の 設定ページ。 これらのラベルに対する見込み客ページのオーディエンスステータスを表示できます。
ガードレール guardrails
Outreach APIのレート制限は、1 ユーザーあたり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 ドキュメントを参照してください。
サポートされるオーディエンス supported-audiences
この節では、この宛先に書き出すことができるオーディエンスのタイプについて説明します。
このカテゴリには、Segmentation Serviceを通じて生成されたオーディエンス以外のすべてのオーディエンスのオリジンが含まれます。 様々なオーディエンスの起源について読みます。 次に例を示します。
- カスタムアップロードオーディエンス がCSV ファイルからExperience Platformにをインポートしました。
- 類似オーディエンス，
- 連合オーディエンス，
- Adobe Journey Optimizerなどの他のExperience Platform アプリで生成されたオーディエンス
- その他。
オーディエンスのデータタイプ別にサポートされるオーディエンス：
書き出しのタイプと頻度 export-type-frequency
宛先の書き出しタイプと頻度については、次の表を参照してください。
- セグメントのすべてのメンバーを、フィールドマッピングに従って、必要なスキーマフィールドと共に書き出します（例：メールアドレス、電話番号、姓）。
- Outreachの各セグメントステータスは、Mapping ID オーディエンススケジュール 手順で指定した値に基づいて、Experience Platformからの対応するオーディエンスステータスで更新されます。
- ストリーミングの宛先は常に、API ベースの接続です。オーディエンス評価に基づいて Experience Platform 内でプロファイルが更新されるとすぐに、コネクタは更新を宛先プラットフォームに送信します。詳しくは、ストリーミングの宛先を参照してください。
宛先への接続 connect
この宛先に接続するには、宛先設定のチュートリアルの手順に従ってください。宛先の設定ワークフローで、以下の 2 つのセクションにリストされているフィールドに入力します。
Destinations > Catalog内でOutreachを検索します。 または、CRM カテゴリの下に配置することもできます。
宛先に対する認証 authenticate
宛先に対する認証を行うには、Connect to destinationを選択します。
Outreachへの認証方法を示す
Outreach ログインページが表示されます。 メールアドレスを入力してください。
次に、パスワードを入力します。
- Username: Outreach アカウントのメールアドレス。
- Password: Outreach アカウントのパスワード。
指定した詳細が有効な場合、UI には 接続済み ステータスに緑色のチェックマークが表示されます。その後、次の手順に進むことができます。
宛先の詳細を入力 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からOutreach宛先に正しく送信するには、フィールドマッピング手順を実行する必要があります。 マッピングでは、Experience Platform アカウントのExperience Data Model （XDM）スキーマフィールドと、ターゲット先の対応するスキーマフィールドとの間にリンクを作成します。 XDM フィールドを Outreach 宛先フィールドに正しくマッピングするには、次の手順に従います。
-
Mapping ステップで、Add new mappingを選択します。 画面に新しいマッピング行が表示されます。
新しいマッピングを追加する方法を示す
-
Select source field ウィンドウで、Select identity namespace カテゴリを選択し、目的のマッピングを追加します。
-
Select target field ウィンドウで、ソースフィールドをマッピングするターゲットフィールドのタイプを選択します。
-
Select identity namespace: ソースフィールドをリストからID名前空間にマッピングするには、このオプションを選択します。
OutreachIdを使用したTarget マッピングを示す
-
XDM プロファイルスキーマとOutreach インスタンスの間に次のマッピングを追加します。
table 0-row-3 1-row-3 XDM プロファイルスキーマ Outreach インスタンス 必須 OidOutreachId○ -
Select custom attributes: ソースフィールドをAttribute name フィールドで定義したカスタム属性にマッピングするには、このオプションを選択します。 サポートされる属性の包括的なリストについては、Outreach 見込み客ドキュメント を参照してください。
-
例えば、更新する値に応じて、XDM プロファイルスキーマとOutreach インスタンスの間に次のマッピングを追加します。
table 0-row-2 1-row-2 2-row-2 XDM プロファイルスキーマ Outreach インスタンス person.name.firstNamefirstNameperson.name.lastNamelastName -
これらのマッピングの使用例を次に示します。
-
オーディエンスの書き出しのスケジュールと例 schedule-segment-export-example
-
オーディエンスの書き出しをスケジュール する手順を実行する場合は、Experience Platform オーディエンスをOutreachのカスタムフィールド属性に手動でマッピングする必要があります。
-
これを行うには、各セグメントを選択し、フィールドの
Nから カスタムフィールド Outreach ラベル Mapping ID フィールドに対応する数値を入力します。note important IMPORTANT - 内で使用される数値
N（） Mapping IDは、Outreach内の数値に接尾辞が付いたカスタム属性キーと一致する必要があります。 例：カスタムフィールドNラベル。 - 数値を指定するだけで、カスタムフィールドラベル全体を指定する必要はありません。
- Outreachは、最大150個のカスタムラベルフィールドをサポートしています。
- 詳しくは、Outreach 見込み客ドキュメント を参照してください。
-
例：
table 0-row-2 1-row-2 Outreach フィールド Experience Platform マッピング ID カスタムフィールド 4ラベル4
- 内で使用される数値
データの書き出しを検証する exported-data
宛先が正しく設定されていることを検証するには、次の手順に従います。
-
宛先のリストに移動するには、Destinations > Browseを選択します。
-
宛先を選択し、ステータスが enabled であることを検証します。
-
「Activation data」タブに切り替えて、オーディエンス名を選択します。
宛先のアクティベーション データを示す
-
オーディエンスの概要を監視し、プロファイルの数がセグメント内で作成された数に対応していることを確認します。
セグメントの概要を示す
-
Outreach web サイトに移動し、Apps > Contacts ページに移動して、オーディエンスのプロファイルが追加されているかどうかを確認します。 Outreachの各オーディエンスステータスが、Mapping ID オーディエンススケジュール 手順で指定した値に基づいて、Experience 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.
不正なリクエストエラーを示す
このエラーを修正するには、Mapping ID オーディエンスに対してExperience Platformで指定したOutreachが有効であり、Outreachに存在することを確認してください。
その他のリソース additional-resources
Outreach ドキュメント には、 エラー応答の詳細が記載されており、問題のデバッグに使用できます。