UI での Marketo Engage ソース接続とデータフローの作成
このチュートリアルでは、UI で Marketo Engage(以下「Marketo」)ソースコネクタを作成し、B2B データを Adobe Experience Platform に取り込む手順について説明します。
基本を学ぶ
このチュートリアルは、Adobe Experience Platform の次のコンポーネントを実際に利用および理解しているユーザーを対象としています。
- B2B 名前空間とスキーマ自動生成ユーティリティ: B2B 名前空間とスキーマ自動生成ユーティリティを使用すると、Postman を使用して B2B 名前空間とスキーマの値を自動生成できます。 Marketo ソース接続とデータフローを作成する前に、まず B2B 名前空間とスキーマを完了する必要があります。
- ソース:Experience Platform を使用すると、データを様々なソースから取得しながら、Platform サービスを使用して受信データの構造化、ラベル付け、拡張を行うことができます。
- Experience Data Model(XDM):Adobe Experience Platform が顧客体験データの整理に使用する標準化されたフレームワーク。
- UI でのスキーマの作成と編集:UI でスキーマを作成および編集する方法について説明します。
- ID 名前空間:ID 名前空間は Identity Service のコンポーネントで、ID の関連先コンテキストのインジケーターとして機能します。完全修飾 ID には、ID 値と名前空間が含まれます。
- Real-Time Customer Profile:複数のソースからの集計データに基づいて、統合されたリアルタイムの顧客プロファイルを提供します。
- サンドボックス:Experience Platform は、単一の Platform インスタンスを個別の仮想環境に分割する仮想サンドボックスを提供し、デジタル体験アプリケーションの開発および進化を支援します。
必要な資格情報の収集
Experience Platformで Marketo アカウントにアクセスするには、次の値を指定する必要があります。
munchkinId
clientId
clientSecret
これらの値の取得について詳しくは、Marketo 認証ガイドを参照してください。
必要な資格情報を収集したら、次の節の手順に従います。
Marketo アカウントの接続
Platform UI の左側のナビゲーションバーで「ソース」を選択して、ソースワークスペースにアクセスします。画面の左側にあるカタログから適切なカテゴリを選択することができます。または、使用する特定のソースを検索オプションを使用して探すこともできます。
Adobeアプリケーション カテゴリで、「Marketo Engage」を選択し、「データを追加」を選択します。
Marketo Engage アカウントの接続 ページが表示されます。このページでは、新しいアカウントを使用するか、既存のアカウントにアクセスできます。
新しいアカウントを作成するには、「新しいアカウント」を選択し、名前、説明(オプション)、の資格情報を入力します。
終了したら「ソースに接続」を選択し、新しい接続が確立されるまでしばらく待ちます。
既存のアカウントを使用するには、「既存のアカウント」を選択し、既存のアカウントカタログから使用するアカウントを選択します。
「次へ」を選択して次に進みます。
データセットの選択
Marketo アカウントを作成したら、次の手順では Marketo のデータセットを調べるためのインターフェースを利用できます。
インターフェイスの左半分はディレクトリブラウザーで、Marketo データセットが 10 種類表示されています。Marketo ソース接続を完全に機能させるには、9 種類の異なるデータセットを取り込む必要があります。また、 Marketo Account-Based Marketing(ABM)機能を使用する場合は、10 個目のデータフローを作成して指定顧客のデータセットを取り込む必要があります。
取得するデータセットを選択します。 これにより、インターフェイスが更新され、データセットのプレビューが表示されます。 終了したら、「次へ」を選択します。
データセットとデータフローの詳細の指定 provide-dataset-and-dataflow-details
次に、データセットとデータフローに関する情報を指定する必要があります。
データセットの詳細 dataset-details
データセットは、スキーマ(列)とフィールド(行)で構成されるデータコレクション(通常はテーブル)を格納し管理するための構造です。Experience Platformに正常に取り込まれたデータは、データセットとしてデータレイク内に保存されます。 この手順では、新しいデータセットを作成するか、既存のデータセットを使用します。
新しいデータセットを使用するには、「新しいデータセット」を選択し、データセットの名前とオプションの説明を入力します。 また、データセットが準拠するエクスペリエンスデータモデル(XDM)スキーマを選択する必要があります。
既存のデータセットがある場合は、「既存のデータセット」を選択し、「詳細検索」オプションを使用すると、組織内のすべてのデータセットのウィンドウが表示されます。これには、リアルタイム顧客プロファイルへの取り込みが有効になっているかどうかなど、それぞれの詳細が含まれます。
データフロー設定 dataflow-configurations
データセットがリアルタイム顧客プロファイルに対して有効になっている場合、この手順の間に プロファイルデータセット を切り替えて、プロファイル取り込み用のデータを有効にすることができます。 また、この手順を使用して、エラー診断 および 部分取り込み を有効にすることもできます。
- エラー診断: エラー診断 を選択して、データセットアクティビティとデータフローステータスを監視する際に後で参照できるエラー診断を生成するようにソースに指示します。
- 部分取り込み: 部分バッチ取り込みとは、設定可能な特定のしきい値まで、エラーを含んだデータを取り込む機能です。 この機能を使用すると、正確なデータをすべてExperience Platformに正常に取り込みながら、不正なデータがすべて無効な理由に関する情報と共に個別にバッチ処理されます。
この手順では、サンプルデータフロー を有効にして、データの取り込みを制限し、人物 ID を含むすべての履歴データの取り込みに伴う追加コストを回避できます。
サンプルデータフローの使用に関するクイックガイド
サンプルデータフローは、Marketo データフローに設定して取り込み率を制限し、大量のデータを取り込まずにExperience Platform機能を試すことができる設定です。
- サンプルデータフローを有効にして、最大 100,000 件(最大レコード ID から)のレコードまたはバックフィルジョブ中の最後の 10 日間のアクティビティを取り込むことで、履歴データを制限します。
- すべての B2B エンティティにサンプルデータフロー設定を使用する場合、ソースデータの履歴全体が取り込まれないので、関連するレコードの一部が欠落している可能性があることを考慮する必要があります。
さらに、会社データセットからデータを取り込む場合、未要求のアカウントを除外 を有効にして、未要求のアカウントを取り込みから除外できます。
個人がフォームに入力すると、Marketo は、他のデータを含まない会社名に基づいて幻のアカウントレコードを作成します。 新しいデータフローの場合、未要求アカウントを除外する切替スイッチはデフォルトで有効になっています。 既存のデータフローの場合、この機能を有効または無効にして、既存のデータではなく、新しく取り込んだデータに変更を適用できます。
Marketo データセットのソースフィールドをターゲットの XDM フィールドにマッピング
マッピング手順が表示され、ソーススキーマのソースフィールドを、ターゲットスキーマの適切なターゲット XDM フィールドにマッピングするためのインターフェイスが提供されます。
各 Marketo データセットには、従うべき固有のマッピングルールがあります。Marketo データセットを XDM にマッピングする方法について詳しくは、次を参照してください。
必要に応じて、フィールドを直接マッピングするか、データ準備機能を使用してソースデータを変換して計算値を導き出すかを選択できます。マッピングインターフェイスの使用に関する包括的な手順については、データ準備 UI ガイドを参照してください。
マッピングセットの準備が整ったら「 次へ」を選択し、新しいデータフローが作成されるまでしばらく待ちます。
データフローのレビュー
レビュー 手順が表示され、新しいデータフローを作成する前に確認できます。詳細は、次のカテゴリに分類されます。
- 接続:ソースのタイプ、選択したソースエンティティの関連パス、およびそのソースエンティティ内の列の数を表示します。
- データセットの割り当てとフィールドのマッピング:ソースデータがどのデータセットに取り込まれるかを、そのデータセットが準拠するスキーマを含めて表示します。
データフローをレビューしたら、「保存して取り込み」を選択し、データフローが作成されるまでしばらく待ちます。
データフローの監視
データフローを作成したら、そのデータフローを通じて取り込まれるデータをモニターすると、取り込み速度、成功、エラーに関する情報を確認できます。データフローのモニター方法について詳しくは、UI でのデータフローのモニタリングを参照してください。
属性の削除
データセット内のカスタム属性は、過去にさかのぼって非表示にしたり削除したりすることはできません。既存のデータセットのカスタム属性を非表示または削除する場合は、そのカスタム属性がない新しいデータセットと、新しい XDM スキーマを作成し、作成した新しいデータセット用に新しいデータフローを構成する必要があります。また、非表示または削除するカスタム属性があるデータセットを含む、元のデータフローを無効または削除する必要があります。
データフローの削除
不要になったデータフローや誤って作成されたデータフローは、データフローワークスペース内にある 削除 機能で削除できます。データフローの削除方法について詳しくは、UI でのデータフローの削除のチュートリアルを参照してください。
次の手順
このチュートリアルでは、Marketo Engage ソースからExperience Platformに B2B データを取り込むデータフローを正常に作成しました。
付録 appendix
次の節では、Marketo ソースを使用する際に従う可能性のある追加のガイドラインを示します。
UI のエラーメッセージ error-messages
Platform が設定の問題を検出すると、次のエラーメッセージが UI に表示されます。
Munchkin ID は適切な組織にマッピングされていません
Munchkin ID が使用している Platform 組織にマッピングされていない場合、認証は拒否されます。 Marketo インターフェイスを使用して、Munchkin ID と組織の間のマッピングを設定します。
プライマリ ID がありません
プライマリ ID がない場合、データフローは保存に失敗し、取り込まれません。 データフローを設定する前に、 プライマリ ID が XDM スキーマ内に存在することを確認してください。