UI でカスタムアクティビティデータの Marketo Engage ソース接続とデータフローを作成

標準のアクティビティに加えて、Marketo ソースを使用して、カスタムアクティビティデータをAdobe Experience Platformに取り込むこともできます。 このドキュメントでは、UI の Marketo ソースを使用して、カスタムアクティビティデータのソース接続とデータフローを作成する手順を説明します。

はじめに

このチュートリアルは、Adobe Experience Platform の次のコンポーネントを実際に利用および理解しているユーザーを対象としています。

カスタムアクティビティの詳細の取得

カスタムアクティビティデータを Marketo からExperience Platformに取り込むための最初の手順は、カスタムアクティビティの API 名と表示名を取得することです。

Marketo インターフェイスを使用してアカウントにログインします。 左側のナビゲーションの Database Management の下の「Marketoカスタムアクティビティ」を選択します。

インターフェイスは、それぞれの表示名や API 名などのカスタムアクティビティの表示に更新されます。 また、右側のパネルを使用して、アカウントから他のカスタムアクティビティを選択および表示することもできます。

上部ヘッダーから フィールド を選択して、カスタムアクティビティに関連付けられているフィールドを表示します。 このページでは、カスタムアクティビティのフィールドの名前、API 名、説明およびデータタイプを確認できます。 個々のフィールドに関する詳細は、後の手順でスキーマを作成する際に使用します。

B2B アクティビティスキーマのカスタムアクティビティ用のフィールドグループを設定します

Experience PlatformUI の スキーマ ダッシュボードで、「参照 を選択したあと、スキーマのリストから「B2B アクティビティ」を選択します。

カスタムアクティビティ用の新しいフィールドグループの作成

次に、新しいフィールドグループを B2B Activity スキーマに追加します。 このフィールドグループは、取り込むカスタムアクティビティに対応している必要があり、以前に取得したカスタムアクティビティの表示名を使用する必要があります。

新しいフィールドグループを追加するには、「構成 の下の フィールドグループ パネルの横にある「+追加」を選択します。

フィールドグループを追加 ウィンドウが表示されます。 新しいフィールドグループを作成 を選択して、前の手順で取得したカスタムアクティビティと同じ表示名を入力し、新しいフィールドグループのオプション説明を入力します。 完了したら、「フィールドグループを追加」を選択します。

作成すると、カスタムアクティビティの新しいフィールドグループが ​ フィールドグループ ​ カタログに表示されます。

スキーマ構造に新しいフィールドを追加します

次に、スキーマに新しいフィールドを追加します。 この新しいフィールドは type: object に設定する必要があり、カスタムアクティビティの個々のフィールドを含みます。

新しいフィールドを追加するには、スキーマ名の横にあるプラス記号（+）を選択します。 無題フィールドのエントリ | タイプ が表示されます。 次に、フィールドプロパティ パネルを使用してフィールドのプロパティを設定します。 フィールド名をカスタムアクティビティの API 名に設定し、表示名をカスタムアクティビティの表示名に設定します。 次に、タイプを object に設定し、フィールドグループを前の手順で作成したカスタムアクティビティフィールドグループに割り当てます。 完了したら、「適用」を選択します。

新しいフィールドがスキーマに表示されます。

サブフィールドをオブジェクトフィールドに追加します add-sub-fields-to-the-object-field

スキーマを準備するための最後の手順は、前の手順で作成したフィールド内に個々のフィールドを追加することです。

データフローの作成

スキーマの設定が完了したので、カスタムアクティビティデータのデータフローの作成に進むことができます。

Platform UI の左側のナビゲーションバーで「ソース」を選択し、ソースワークスペースにアクセスします。カタログ画面には、アカウントを作成できる様々なソースが表示されます。

画面の左側にあるカタログから適切なカテゴリを選択することができます。または、検索バーを使用して、利用したい特定のソースを見つけることもできます。

アドビアプリケーションカテゴリ内で「Marketo Engage」を選択します。次に「データの追加」を選択して、新しい Marketo データフローを作成します。

データの選択

Marketo のデータセットのリストから アクティビティ を選択し、「次へ」を選択します。

データフローの詳細

次に、 データフローの情報を指定します。これには、データセットとデータフローの名前と説明、使用するスキーマ、Profile ータ取り込み、エラー診断、部分取り込みの設定が含まれます。

マッピング

標準アクティビティフィールドのマッピングは自動入力されますが、カスタムアクティビティフィールドは、対応するターゲットフィールドに手動でマッピングする必要があります。

カスタムアクティビティフィールドのマッピングを開始するには、「新しいフィールドタイプ」を選択したあと、「新しいフィールドを追加」を選択します。

ソースデータ構造内を移動し、取り込むカスタムアクティビティフィールドを見つけます。 終了したら、「選択」を選択します。

ターゲットフィールドを追加するには、スキーマアイコン を選択し、ターゲットスキーマからカスタムアクティビティフィールドを選択します。

手順を繰り返して、残りのカスタムアクティビティマッピングフィールドを追加します。 終了したら、「次へ」を選択します。

レビュー

レビュー ​手順が表示され、新しいデータフローを作成する前に確認できます。詳細は、次のカテゴリに分類されます。

データフローをレビューしたら、「保存して取り込み」を選択し、データフローが作成されるまでしばらく待ちます。

既存のアクティビティデータフローへのカスタムアクティビティの追加 add-to-existing-dataflows

既存のデータフローにカスタムアクティビティデータを追加するには、取り込むカスタムアクティビティデータで既存のアクティビティデータフローのマッピングを変更します。 これにより、カスタムアクティビティを、同じ既存のアクティビティデータセットに取り込むことができます。 既存のデータフローのマッピングを更新する方法について詳しくは、UI でのデータフローの更新に関するガイドを参照してください。

Query Service を使用して、カスタムアクティビティのアクティビティをフィルタリングします query-service-filter

データフローが完了したら、 クエリサービスを使用して、カスタムアクティビティデータのアクティビティをフィルタリングできます。

カスタムアクティビティが 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 文の例を示しています。

次の手順

このチュートリアルでは、カスタムアクティビティデータの Platform スキーマ Marketo 設定し、そのデータを Platform に取り込むためのデータフローを作成しました。 Marketo ソースの一般的な情報については、Marketo ソースの概要を参照してください。