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

API 情報

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

• API 名：Salesforce Data 360 取り込み API
• API バージョン：v1
• API エンドポイント：Salesforce Data Cloud 取り込み API

構成

コネクタマーケットプレイスにアクセスし、新しいコネクタを追加します。コネクタを追加する一般的な手順については、コネクタについてを参照してください。

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

• Salesforce ドメイン
  • （必須）Salesforce 組織の My Domain URL です。例：https://company.my.salesforce.com。クライアント認証フローには My Domain URL が必要です。他の Salesforce ホストでは このドメインではリクエストがサポートされていません エラーが返されます。
• クライアント ID
  • （必須）Salesforce Connected App または External Client App のコンシューマーキー。
  • アプリはクライアント認証フローが有効で、Run As ユーザーが構成されており、cdp_ingest_api および api の OAuth スコープが必要です。
  • Salesforce が クライアント認証ユーザーが有効ではありません と返した場合、Run As ユーザーが構成されているか確認してください。このエラーはクライアントシークレットが間違っていることを示すものではありません。
• クライアントシークレット
  • （必須）Salesforce Connected App または External Client App のコンシューマーシークレット。
• ソース API 名
  • （必須）Salesforce Data 360 の取り込み API ソースのソース API 名。

アクション

取り込み API レコード送信

バッチ制限

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

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

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

パラメータ

レコードデータ

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

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

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

テンプレート