Skip to content
/
SAP Marketing Cloud Impor...
Last updated

SAP Marketing Cloud Import Integration

SAP Marketing Cloud（旧 Hybris Marketing）は、個々の顧客と匿名訪問者に関するリアルタイムのコンテキストベースのデータを、ユーザーデータを一元化されたハブに統合することで提供するマーケティングソリューションです。

これにより、ブランドはマーケティングチャネルやデバイスに関係なく、カスタマージャーニー全体を通じて一貫性のある、コンテキストに即した、関連性の高いエクスペリエンスを提供できます。

  • Data Management: ブランドと接触する人々の360度ビューを提供し、リアルタイムで適切なコンテキスト内でターゲティングを可能にします。
  • Recommendation: 顧客にタイムリーで高度に関連性の高いレコメンデーションを提供し、関心をコンバージョンに変換するのに役立ちます。
  • Segmentation: リアルタイムで高性能なオーディエンスセグメンテーションを提供し、複数のチャネルにわたってキャンペーンをパーソナライズすることを可能にします。

Prerequisites

  • Treasure Dataの基礎知識
  • Communication user

増分データ読み込みについて

  • 増分読み込みが有効な場合、SAP Marketing Cloudに発行されるクエリには$filterステートメントが含まれます。$filterは目的の基準に基づいてデータをクエリします
    • $filterは、filter_column、start_time、end_timeの設定に基づいて生成されます。
  • 受信した最初の値は、次のジョブフィルターの参照として保持されます。次のジョブの$filterは前のジョブのデータを除外し、新しいデータのみを取得します。
  • このプロセスは後続の実行で繰り返されます。

  • 増分読み込みが有効な場合にend_timeの値が空の場合、ジョブが実行された時刻に自動的に設定されます。
  • filter_columnは、メタデータで以下の条件を満たす必要があります：
    • Type Edm.DateTimeOffsetまたはEdm.DateTimeを含む
    • Nullable="false"を含む
    • sap:sortable="false"を含まない
    • sap:filterable="false"を含まない
  • 増分読み込みは、Timestampカラム（Edm.DateTimeOffsetおよびEdm.DateTime）のみをサポートします。
  • filter_columnフィールドに空の値を含むすべてのレコードは無視されます。

Communication Userの取得

  • Communication Userは、SAP Marketing Cloudシステムで定義されます（例：INTEGRATION_TREASURE_DATAがユーザー名、パスワードはxxxx）。ここでのユーザー名とパスワードは、x-csrf-tokenを取得するための基本認証として使用されます。

  • Communication SystemはこのCommunication User用に作成され、セットアップされます。SAPのCommunication Systemセットアップの詳細については、こちらをご覧ください。

TD Consoleを使用して接続を作成する

新しい接続を作成する

Treasure Dataでは、クエリを実行する前にデータ接続を作成して設定する必要があります。データ接続の一部として、統合にアクセスするための認証を提供します。

  1. TD Consoleを開きます。
  2. Integrations Hub > Catalogに移動します。
  3. SAP Marketing Cloudを検索して選択します。

4. Create Authenticationを選択します。

  1. 認証データを入力します：

  2. Username: SAP Marketing CloudのCommunicationユーザー名

  3. Password: SAP Marketing CloudのCommunicationユーザーのパスワード

  4. Tenant ID: SAP Marketing CloudのTenant ID

  5. Continueをクリックします。

  6. この認証の名前を入力します。

  7. Doneをクリックします。

Treasure Dataへのデータ転送

認証済み接続を作成すると、自動的にAuthenticationsページに移動します。

  1. 作成した接続を検索します。
  2. New Sourceを選択します。
  3. Data TransferフィールドにSourceの名前を入力します。
  4. Nextを選択すると、Source Tableダイアログが開きます。
  5. 以下のパラメータを編集します。
Configuration NameTypeDescription
Service NameStringターゲットSAP Marketing Cloudサービス名
API VersionString使用するサービスのバージョン
Entity NameStringデータを取得する対象のエンティティ
IncrementalBoolean繰り返し実行する場合、最後のインポート以降の新しいデータのみをインポートしようとします
Filter ColumnString増分読み込みまたはフィルタリングのためのDateTime/DateTimeOffsetカラム（大文字小文字を区別）
Start TimeDateTimeこの時刻以降のデータをインポートします
End TimeDateTimeこの時刻までのデータをインポートします
  1. Nextを選択すると、Data Settingsページが表示されます。ニーズに合わせて変更するか、ページをスキップできます。
  2. オプションで、以下のパラメータを編集します：
ParameterDescription
Batch SizeAPI呼び出しごとに取り込むレコード数
Retry Limit各API呼び出しの最大リトライ回数
Initial retry time wait in millis最初のリトライの待機時間（ミリ秒）
Max retry wait in millsAPI呼び出しが諦めるまでの最大待機時間

  1. Nextをクリックすると、Data Previewダイアログが開きます

  2. Generate Previewをクリックしてデータをプレビューするか、Skip this stepをクリックして次のページに進みます。

  3. Nextをクリックすると、Data Placementダイアログが開きます。

  4. Create & Run NowまたはCreateをクリックします。

Workflowを使用したインポート

ワークフローのtd_load>: オペレーターを使用して、MS Dynamics 365 Saleからデータをインポートできます。既にSOURCEを作成している場合は、それを実行できます。

  1. Sourceを特定します。
  2. 一意のIDを取得するには、Sourceリストを開き、SAP Marketing Cloudでフィルタリングします。
  3. メニューを開き、Copy Unique IDを選択します。
  4. td_load> オペレーターを使用してワークフロータスクを定義します。
+load:
  td_load>: unique_id_of_your_source
  database: ${td.dest_db}
  Table: ${td.dest_table}
  1. ワークフローを実行します。
Previous page
Next page