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 宛先に対して認証を行う前に、以下の項目をメモしておきます。

資格情報
説明
メール
Outreach アカウントのメール
パスワード
Outreach アカウントのパスワード

カスタムフィールドラベルの設定 prerequisites-custom-fields

Outreach では、 見込み客のカスタムフィールドをサポートしています。 詳しくは、 アウトリーチでカスタムフィールドを追加する方法を参照してください。 識別を容易にするために、デフォルト値を維持するのではなく、対応するオーディエンス名に手動でラベルを更新することをお勧めします。 以下に例を示します。

カ Outreach タムフィールドを表示している見込み客の設定ページ
設定ページのカスタムフィールドを示すアウトリーチ UI のスクリーンショット。

オーディエンス名に一致する ユーザーにとってわかりやすい ラベルを持つカスタムフィールドを表示する見込み客の Outreach 設定ページ。 これらのラベルに対して、見込み客ページでオーディエンスステータスを表示できます。
設定ページの関連するラベルを持つカスタムフィールドを示すアウトリーチ UI のスクリーンショット。

NOTE
ラベル名は識別を容易にするためにのみ使用されます。 見込み客の更新時には使用されません。

ガードレール

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 についての詳細情報。

ターゲット ID
説明
注意点
OutreachId
  • Outreach 識別子。 これは、見込み客プロファイルに対応する数値です。
  • ID は、更新する見込み客の Outreach URL 内の ID と一致する必要があります。
  • 詳しくは、Outreach ドキュメントを参照してください。
必須

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

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

項目
タイプ
メモ
書き出しタイプ
プロファイルベース
  • セグメントのすべてのメンバーを、フィールドマッピングに従って、必要なスキーマフィールドと共に書き出します​ (例:メールアドレス、電話番号、姓)
  • Outreach の各セグメントのステータスは、 オーディエンススケジュール手順で提供された ​ マッピング ID 値に基づいて、Platform の対応するオーディエンスステータスとともに更新されます。
書き出し頻度
ストリーミング
  • ストリーミングの宛先は常に、API ベースの接続です。オーディエンス評価に基づいて Experience Platform 内でプロファイルが更新されるとすぐに、コネクタは更新を宛先プラットフォームに送信します。詳しくは、ストリーミングの宛先を参照してください。

宛先への接続 connect

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

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

宛先カタログ ​内で Outreach を検索します。または、CRM カテゴリの下に配置することもできます。

宛先に対する認証 authenticate

宛先を認証するには、「宛先に接続」を選択します。

アウトリーチへの認証方法を示す Platform UI のスクリーンショット。

Outreach ログインページが表示されます。 メールを入力します。

アウトリーチ UI のスクリーンショットで、アウトリーチを認証するメールを入力するフィールドを示す

次に、パスワードを入力します。

アウトリーチ UI のスクリーンショットで、アウトリーチに対する認証を行うためのパスワード入力ステップのフィールドを示している

  • ユーザー名:Outreach アカウントのメールアドレス。
  • パスワード:Outreach アカウントのパスワード。

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

宛先の詳細を入力 destination-details

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

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

アラートの有効化 enable-alerts

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

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

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

IMPORTANT
  • データをアクティブ化するには、宛先の表示宛先のアクティブ化プロファイルの表示 および セグメントの表示 アクセス制御権限が必要です。 アクセス制御の概要を参照するか、製品管理者に問い合わせて必要な権限を取得してください。
  • ID を書き出すには、ID グラフの表示 アクセス制御権限が必要です。
    宛先に対してオーディエンスをアクティブ化するために、ワークフローでハイライト表示されている ID 名前空間を選択します。 {width="100" modal="regular"}

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

マッピングの考慮事項と例 mapping-considerations-example

Adobe Experience Platform から Outreach 宛先にオーディエンスデータを正しく送信するには、フィールドマッピングの手順を実行する必要があります。マッピングは、Platform アカウント内の Experience Data Model(XDM)スキーマフィールドと、ターゲット宛先から対応する同等のスキーマフィールドとの間にリンクを作成して構成されます。 XDM フィールドを Outreach 宛先フィールドに正しくマッピングするには、次の手順に従います。

  1. ​ マッピング ​ 手順で、「新しいマッピングを追加」をクリックします。 画面に新しいマッピング行が表示されます。
    新しいマッピングの追加方法を示す Platform UI のスクリーンショット

  2. ​ ソースフィールドを選択 ​ ウィンドウで、ID 名前空間を選択 カテゴリを選択して、目的のマッピングを追加します。
    Sourceのマッピングを示す Platform UI のスクリーンショット

  3. ターゲットフィールドを選択ウィンドウで、ソースフィールドにマッピングするターゲットフィールドのタイプを選択します。

    • ID 名前空間を選択:このオプションを選択して、ソースフィールドをリストから ID 名前空間にマッピングします。

      OutreachId を使用したターゲットマッピングを示す Platform UI のスクリーンショット。

    • XDM プロファイルスキーマと Outreach インスタンスの間の次のマッピングを追加:
      |XDM プロファイルスキーマ|Outreach インスタンス| 必須|
      |—|—|—|
      |Oid|OutreachId| はい |

    • カスタム属性を選択:このオプションを選択して、「属性名」フィールドに定義するカスタム属性にマッピングするソースフィールドを選択します。サポートされる属性の包括的なリストについては、Outreach 見込み客ドキュメントを参照してください。

      LastName を使用したターゲットマッピングを示す Platform UI のスクリーンショット。

    • 例えば、更新する値に応じて、XDM プロファイルスキーマと Outreach インスタンスの間に次のようなマッピングを追加します。
      |XDM プロファイルスキーマ|Outreach インスタンス|
      |—|—|
      |person.name.firstName|firstName|
      |person.name.lastName|lastName|

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

      ターゲットマッピングを示した Platform UI のスクリーンショットの例。

オーディエンスの書き出しのスケジュールと例 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 の例を示す Platform UI のスクリーンショット。

データの書き出しを検証する exported-data

宛先が正しく設定されていることを検証するには、次の手順に従います。

  1. 宛先参照 を選択して、宛先のリストに移動します。
    宛先の参照を示す Platform UI のスクリーンショット。

  2. 宛先を選択し、ステータスが「 有効」であることを確認します。
    選択した宛先の宛先データフロー実行を示した Platform UI のスクリーンショット。

  3. Activation data」タブに切り替えて、オーディエンス名を選択します。
    宛先のアクティベーションデータを示した Platform UI のスクリーンショット。

  4. オーディエンスの概要を監視し、プロファイルの数がセグメント内で作成された数と一致していることを確認します。
    セグメントの概要を示す Platform UI のスクリーンショット。

  5. Outreach web サイトににログインして、Apps / Contacts ページに移動し、オーディエンスのプロファイルが追加されたかどうかを確認します。 Outreach の各オーディエンスステータスが、 オーディエンススケジュール手順で提供された ​ マッピング ID 値に基づいて、Platform から対応するオーディエンスステータスに更新されたことがわかります。

更新されたオーディエンスステータスを含むアウトリーチ見込み客ページを示すアウトリーチ UI のスクリーンショット。

データの使用とガバナンス 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 UI のスクリーンショット。

このエラーを修正するには、Platform で Outreach オーディエンスに指定した ​ マッピング ID が有効であり、Outreach に存在することを確認します。

その他のリソース additional-resources

Outreach ドキュメントには、問題のデバッグに使用できる エラー応答に関する詳細があります。

recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6