UIでカスタムアクティビティデータ用のMarketo Engage ソース接続とデータフローを作成します
標準アクティビティ に加えて、Marketo ソースを使用して、カスタムアクティビティデータをAdobe Experience Platformに取り込むこともできます。 このドキュメントでは、UIでMarketo ソースを使用して、カスタムアクティビティデータのソース接続とデータフローを作成する手順について説明します。
はじめに
このチュートリアルは、Adobe Experience Platform の次のコンポーネントを実際に利用および理解しているユーザーを対象としています。
- B2B名前空間とスキーマ自動生成ユーティリティ : B2B名前空間とスキーマ自動生成ユーティリティを使用すると、Postmanを使用して、B2B名前空間とスキーマの値を自動生成できます。 Marketo ソース接続とデータフローを作成する前に、まずB2B名前空間とスキーマを完了する必要があります。
- ソース : Experience Platformを使用すると、様々なソースからデータを取り込むことができますが、Experience Platform サービスを使用して着信データを構造化、ラベル付け、強化することができます。
- エクスペリエンスデータモデル（XDM）：Adobe Experience Platform が顧客体験データの整理に使用する標準化されたフレームワーク。
- UI でのスキーマの作成と編集：UI でスキーマを作成および編集する方法について説明します。
- ID 名前空間：ID 名前空間は Identity Service のコンポーネントで、ID の関連先コンテキストのインジケーターとして機能します。 完全修飾 ID には、ID 値と名前空間が含まれます。
- Real-Time Customer Profile：複数のソースからの集計データに基づいて、統合されたリアルタイムの顧客プロファイルを提供します。
- サンドボックス : Experience Platformは、1つのExperience Platform インスタンスを個別のバーチャル環境に分割して、デジタルエクスペリエンスアプリケーションの開発と進化に役立つバーチャルサンドボックスを提供します。
カスタムアクティビティの詳細を取得する
MarketoからExperience Platformにカスタムアクティビティデータを取り込む最初の手順は、カスタムアクティビティのAPI名と表示名を取得することです。
Marketo インターフェイスを使用してアカウントにログインします。 左側のナビゲーションのDatabase Managementで、Marketo カスタムアクティビティを選択します。
インターフェイスは、それぞれの表示名とAPI名に関する情報を含め、カスタムアクティビティの表示に更新されます。 右側のパネルを使用して、アカウントから他のカスタムアクティビティを選択して表示することもできます。
上部ヘッダーから「フィールド」を選択して、カスタムアクティビティに関連付けられているフィールドを表示します。 このページでは、カスタムアクティビティのフィールドの名前、API名、説明、データタイプを表示できます。 個々のフィールドに関する詳細は、後でスキーマを作成する際に使用します。
B2B アクティビティスキーマでのカスタムアクティビティのフィールドグループの設定
Experience Platform UIのスキーマ ダッシュボードで、参照を選択し、スキーマのリストから B2B アクティビティ を選択します。
カスタムアクティビティ用の新しいフィールドグループの作成
次に、新しいフィールドグループをB2B Activity スキーマに追加します。 このフィールドグループは、取り込むカスタムアクティビティに対応し、以前に取得したカスタムアクティビティの表示名を使用する必要があります。
新しいフィールドグループを追加するには、コンポジションの下のフィールドグループ パネルの横にある 以上の追加 を選択します。
「フィールドグループを追加」ウィンドウが表示されます。 「新しいフィールドグループを作成」を選択し、前の手順で取得したカスタムアクティビティと同じ表示名を指定し、新しいフィールドグループの説明をオプションで指定します。 完了したら、フィールドグループを追加を選択します。
作成したカスタムアクティビティの新しいフィールドグループは、 フィールドグループ カタログに表示されます。
スキーマ構造に新しいフィールドを追加します
次に、スキーマに新しいフィールドを追加します。 この新しいフィールドはtype: objectに設定する必要があり、カスタムアクティビティの個々のフィールドが含まれます。
新しいフィールドを追加するには、スキーマ名の横にあるプラス記号（+）を選択します。 名称未設定フィールド | タイプのエントリが表示されます。 次に、フィールドプロパティ パネルを使用して、フィールドのプロパティを設定します。 フィールド名をカスタムアクティビティのAPI名に、表示名をカスタムアクティビティの表示名に設定します。 次に、タイプをobjectに設定し、フィールドグループを前の手順で作成したカスタムアクティビティフィールドグループに割り当てます。 完了したら、適用を選択します。
スキーマに新しいフィールドが表示されます。
オブジェクトフィールドにサブフィールドを追加する add-sub-fields-to-the-object-field
スキーマを準備する最後の手順は、前の手順で作成したフィールド内に個々のフィールドを追加することです。
データフローの作成
スキーマの設定が完了したら、カスタムアクティビティデータのデータフローの作成に進みます。
Experience Platform UIで、左側のナビゲーションバーから「ソース」を選択して、 ソース ワークスペースにアクセスします。 カタログ 画面には、アカウントを作成するための様々なソースが表示されます。
画面の左側にあるカタログから適切なカテゴリを選択することができます。 または、検索バーを使用して、利用したい特定のソースを見つけることもできます。
Adobe アプリケーション カテゴリで、Marketo Engageを選択します。 次に、データを追加を選択して、新しいMarketo データフローを作成します。
データの選択
Marketo個のデータセットのリストから アクティビティ を選択し、次へを選択します。
データフローの詳細
次に、 データセットとデータフローの名前と説明、使用するスキーマ、Profileの取り込み、エラー診断、部分取り込みの設定など、データフローに関する情報を提供します。
マッピング
標準アクティビティフィールドのマッピングは自動入力されますが、カスタムアクティビティフィールドは対応するターゲットフィールドに手動でマッピングする必要があります。
カスタムアクティビティフィールドのマッピングを開始するには、新しいフィールドタイプを選択し、新しいフィールドを追加を選択します。
ソースデータ構造を移動し、取り込むカスタムアクティビティフィールドを見つけます。 完了したら、選択を選択します。
ターゲットフィールドを追加するには、スキーマアイコン
手順を繰り返して、カスタムアクティビティマッピングフィールドの残りの部分を追加します。 完了したら、次へを選択します。
レビュー
レビュー手順が表示され、新しいデータフローを作成する前に確認できます。 詳細は、次のカテゴリに分類されます。
- 接続: ソースタイプ、選択したソースエンティティの関連パス、そのソースエンティティ内の列の量を表示します。
- データセットの割り当てとフィールドのマッピング：ソースデータがどのデータセットに取り込まれるかを、そのデータセットが準拠するスキーマを含めて表示します。
データフローをレビューしたら、保存と取り込みを選択し、データフローの作成に時間を割いてください。
既存のアクティビティデータフローへのカスタムアクティビティの追加 add-to-existing-dataflows
カスタムアクティビティデータを既存のデータフローに追加するには、取り込むカスタムアクティビティデータを使用して、既存のアクティビティデータフローのマッピングを変更します。 これにより、カスタムアクティビティを同じ既存のアクティビティデータセットに取り込むことができます。 既存のデータフローのマッピングを更新する方法について詳しくは、UIでのデータフローの更新に関するガイドを参照してください。
Query Serviceを使用してカスタムアクティビティのアクティビティをフィルタリング query-service-filter
データフローが完了したら、 クエリサービス を使用して、カスタムアクティビティデータのアクティビティをフィルタリングできます。
カスタムアクティビティがExperience Platformに取り込まれると、カスタムアクティビティのAPI名が自動的にeventTypeになります。 カスタムアクティビティデータをフィルタリングするには、eventType={API_NAME}を使用します。
SELECT * FROM with_custom_activities_ds_today WHERE eventType='aepCustomActivityDemo1'
IN句を使用して、複数のカスタムアクティビティをフィルタリングします。
SELECT * FROM $datasetName WHERE eventType='{API_NAME}'
SELECT * FROM $datasetName WHERE eventType IN ('aepCustomActivityDemo1', 'aepCustomActivityDemo2')
次の画像は、カスタムアクティビティデータをフィルタリングする クエリエディターのSQL ステートメントの例を示しています。
カスタムアクティビティのクエリ例を表示する
次の手順
このチュートリアルでは、Marketo カスタムアクティビティデータに対してExperience Platform スキーマを設定し、そのデータをExperience Platformに取り込むためのデータフローを作成しました。 Marketo ソースに関する一般的な情報については、Marketo ソースの概要を参照してください。