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

インタラクティブデモ

要件

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

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

詳細については、Salesforce: Connect an ingestion sourceを参照してください。

API情報

このコネクタは以下のベンダーAPIを使用します：

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

構成

コネクタマーケットプレイスにアクセスし、新しいコネクタを追加します。コネクタの追加方法については、About Connectorsを参照してください。

コネクタを追加した後、以下の構成を構成します：

• 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。
  • アプリはクライアント資格情報フローを有効にし、Run Asユーザーを構成し、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を返した場合、Run Asユーザーが構成されているか確認してください。このエラーはクライアントシークレットが間違っていることを示すものではありません。
• クライアントシークレット
  • （必須）Salesforce Connected AppまたはExternal Client AppからのConsumer Secret。
• ソースAPI名
  • （必須）Salesforce Data 360のIngestion APIソースのソースAPI名。

アクション

Send Ingestion API Records

バッチ制限

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

リクエストは、次のいずれかの閾値に達するか、プロファイルが公開されるまでキューに入れられます：

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

パラメータ

Record Data

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

• フィールドがネストされたオブジェクトまたは配列を必要とする場合は、Templatesタブでテンプレートを定義し、マップされた値としてテンプレート名を入力します。
• Data Streamの主キーおよびSalesforce摂取スキーマで必須とされている他のフィールドを含めます。
• 部分更新の場合は、構成されたRecord Modifiedフィールドを含めます。エンゲージメントオブジェクトの場合は、構成されたEvent Timeフィールドも含めます。
• マップされた値がSalesforceによって期待されるデータタイプとフォーマット、例えばISO 8601タイムスタンプ、数字、およびブール値と一致することを確認します。
• ソースに複数のオブジェクトが含まれている場合、例えばSalesCustomerとOrderの場合、各Object API Nameに対して別のアクションを作成し、各Record Dataマッピングが単一のオブジェクトスキーマに対応するようにします。

Salesforceは摂取リクエストを非同期で処理します。成功したレスポンスはSalesforceが処理のためにリクエストを受け入れたことを確認しますが、すべてのレコードが摂取されたことを確認するものではありません。必要な値が欠けている、データタイプが無効である、または他のスキーマの不一致が原因で、下流の処理中にレコードが失敗する可能性がありますが、Tealiumにエラーが返されることはありません。

Templates