Salesforce Data 360コネクタ構成ガイド

インタラクティブデモ

要件

このコネクタには、次のSalesforce Data 360リソースが必要です。

• Tealiumから受信するオブジェクトとフィールドを構成した取り込みAPIソース
• 取り込みAPIソース用のデータストリーム
• Data 360 Ingestion APIへのアクセス権を持つConnected AppまたはExternal Client App

詳細については、Salesforce：取り込みソースの接続を参照してください。

API情報

このコネクタでは、次のベンダーAPIを使用します。

• API名：Salesforce Data 360 Ingestion API
• APIバージョン：v1
• APIエンドポイント：Salesforce Data Cloud Ingestion API

構成

コネクタマーケットプレイスに移動し、新しいコネクタを追加します。詳細については、コネクタについてを参照してください。

コネクタを追加したら、次の構成を構成します。

• Salesforceドメイン
  • （必須）Salesforce組織のMy Domain URL（例：https://company.my.salesforce.com）。クライアント資格情報フローには、My Domain URLが必要です。その他のSalesforceホストでは、request not supported on this domainエラーが返されます。
• クライアントID
  • （必須）Salesforce Connected AppまたはExternal Client AppのConsumer Key。
  • アプリでクライアント資格情報フローを有効にし、実行ユーザーを構成したうえで、cdp_ingest_apiおよびapi OAuthスコープを付与する必要があります。
  • Connected AppまたはExternal Client AppのコールバックURLをhttps://my.tealiumiq.com/oauth/salesforce/callback.htmlに構成します。
  • Salesforceからno client credentials user enabledが返された場合は、実行ユーザーが構成されていることを確認してください。このエラーは、Client Secretが正しくないことを示すものではありません。
• クライアントシークレット
  • （必須）Salesforce Connected AppまたはExternal Client AppのConsumer Secret。
• ソースAPI名
  • （必須）Salesforce Data 360の取り込みAPIソースのSource API Name。

コネクタを構成したら、完了をクリックします。

アクション

取り込みAPIレコードを送信

バッチ制限

このアクションは、ベンダーへの大容量データ転送に対応するため、バッチリクエストを使用します。並列処理により、イベントが順不同でベンダーに到達することがあります。イベントの順序が重要な場合は、イベントにシーケンス値を追加してください。詳細については、バッチアクションを参照してください。

次のいずれかのしきい値に達するか、プロファイルがパブリッシュされるまで、リクエストはキューに入れられます。

• リクエストの最大数：200
• 最も古いリクエストからの最大経過時間：10分

パラメータ

レコードデータ

Tealium属性を、選択したSalesforce Data 360オブジェクトの宛先フィールドにマッピングします。マッピングを構成する際は、次の要件に従ってください。

• フィールドにネストされたオブジェクトまたは配列が必要な場合は、テンプレートタブでテンプレートを定義し、そのテンプレート名をマッピング値として入力します。
• データストリームの主キーと、Salesforce取り込みスキーマで必須としてマークされているその他のフィールドを含めます。
• 部分更新の場合は、構成済みのレコード更新日時フィールドを含めます。エンゲージメントオブジェクトの場合は、構成済みのイベント時刻フィールドも含めます。
• マッピングされた値が、ISO 8601形式のタイムスタンプ、数値、ブール値など、Salesforceで想定されるデータ型および形式と一致していることを確認します。
• ソースにSalesCustomerやOrderなど複数のオブジェクトが含まれている場合は、各レコードデータマッピングが単一のオブジェクトスキーマに対応するように、Object API Nameごとに個別のアクションを作成します。

Salesforceは取り込みリクエストを非同期で処理します。成功レスポンスは、Salesforceが処理対象としてリクエストを受け付けたことを示しますが、すべてのレコードが取り込まれたことを保証するものではありません。必須値の欠落、無効なデータ型、その他のスキーマ不一致があると、Tealiumにエラーが返されることなく、後続の処理中にレコードの取り込みが失敗する可能性があります。

テンプレート