機械翻訳について

レシピのインストールおよび構成

Oracle Integrationインスタンスに、統合および関連リソースをデプロイおよび構成するレシピをインストールします。

Oracle Integrationインスタンスにレシピをインストールします。 「レシピまたはアクセラレータのインストール」を参照してください。

レシピをインストールしたら、次のリソースを構成します:

Oracle Unity接続の構成

  1. 「接続」セクションで、接続名をクリックします。
  2. 「Oracle Unity URL」フィールドに、Oracle Unityに接続するためのURLを入力します。 たとえば、 https://XXXXXX.cxunity.ocs.oraclecloud.comです。

    URLは、Oracle Unityをサブスクライブするときに提供されます。

  3. セキュリティ・セクションで、次の詳細を入力します:
    フィールド 入力する情報
    Security Policy 「リソース所有者のパスワード資格証明」を選択します。
    アクセス・トークンURI

    アクセス・トークンを生成する認可サーバーを入力します:

    https://IDCS_URL/oauth2/v1/token
    クライアントID APIコンソール・プロジェクトに一致する一意のランダム文字列を入力します。 Oracle Unityの構成を参照してください。
    クライアント・シークレット APIコンソール・プロジェクトに一致する一意のランダム文字列を入力します。
    ユーザー名 OAuthトークン・リクエストのOracle Identity Cloud Serviceユーザー名を入力します。
    Password OAuthトークン・リクエストのOracle Identity Cloud Serviceパスワードを入力します。
    スコープ ターゲット・アプリケーションの認可権限のリストを入力します。 たとえば、read writeです。
  4. 「OK」をクリックします。
  5. 「保存」をクリックします プロンプトが表示されたら、「保存」を再度クリックします。
  6. 「テスト」をクリックして、接続が正常に構成されていることを確認します。 表示されたダイアログで、「テスト」を再度クリックします。

    テストが成功したかどうかを確認するメッセージが表示されます。

  7. プロジェクト・ワークスペースに戻るには、「戻る」 「戻る」アイコンをクリックします。

FTP接続の構成

  1. 「接続」セクションで、接続名をクリックします。
  2. プロパティ・セクションで、次の詳細を入力します:
    フィールド 入力する情報
    FTPサーバーのホスト・アドレス sFTPサーバーのホスト・アドレスを入力します。
    FTPサーバー・ポート 22を入力します。
    SFTP接続 リストからYesを選択します。
  3. セキュリティ・セクションで、次の詳細を入力します:
    フィールド 入力する情報
    Security Policy 「FTPサーバー・アクセス・ポリシー」を選択します。
    User Name sFTPサーバーに接続するためのユーザー名を入力します。
    Password sFTPサーバーに接続するためのパスワードを入力します。
  4. 「保存」をクリックします プロンプトが表示されたら、「保存」を再度クリックします。
  5. 「テスト」をクリックして、接続が正常に構成されていることを確認します。 表示されたダイアログで、「テスト」を再度クリックします。

    テストが成功したかどうかを確認するメッセージが表示されます。

  6. プロジェクト・ワークスペースに戻るには、「戻る」 「戻る」アイコンをクリックします。

REST Salesforce Marketing Cloud接続の構成

  1. 「接続」セクションで、接続名をクリックします。
  2. プロパティ・セクションで、次の詳細を入力します:
    フィールド 入力する情報
    接続タイプ 「REST APIのベースURL」を選択します。
    接続URL Salesforce Marketing Cloudからコピーした末尾(/)なしでURLを貼り付けます。 「Salesforce Marketingクラウドの構成」を参照してください。
  3. セキュリティ・セクションで、次の詳細を入力します:
    フィールド 入力する情報
    Security Policy OAuth「カスタム・ツーレッグ・フロー」を選択します。
    アクセス・トークン・リクエスト

    Salesforce Marketing CloudからコピーされたクライアントID、クライアント・シークレット、アカウントIDおよび認証URLを次の形式で入力します。 認証URLにv2/tokenを追加します。 クライアントIDおよびシークレットを生成するには、Salesforce Marketing Cloudの構成を参照してください。

    -X POST -H 'Content-Type:application/json' -d '{ "grant_type": "client_credentials", "client_id": "<client id>", "client_secret": "<client secret>", "account_id": "<account id>" }' 'https://mc4nwk3rs1n1tm8lm4qgd1g448hm.auth.marketingcloudapis.com/v2/token'
  4. 「保存」をクリックします プロンプトが表示されたら、「保存」を再度クリックします。
  5. 「テスト」をクリックして、接続が正常に構成されていることを確認します。 表示されたダイアログで、「テスト」を再度クリックします。

    テストが成功したかどうかを確認するメッセージが表示されます。

  6. プロジェクト・ワークスペースに戻るには、「戻る」 「戻る」アイコンをクリックします。

SOAP Salesforce Marketing Cloud接続の構成

  1. 「接続」セクションで、接続名をクリックします。
  2. 「プロパティ」セクションで、「WSDL URL」フィールドにSOAP WSDL URLを入力します。 Salesforce Marketing Cloudの構成を参照してください。
  3. セキュリティ・セクションで、次の詳細を入力します:
    フィールド 入力する情報
    Security Policy 「ユーザー名パスワード・トークン」を選択します。
    ユーザー名

    ユーザー名を入力します。 「Salesforce Marketingクラウドの構成」を参照してください。

    Password パスワードを入力します。
  4. 「保存」をクリックします プロンプトが表示されたら、「保存」を再度クリックします。
  5. 「テスト」をクリックして、接続が正常に構成されていることを確認します。 表示されたダイアログで、「テスト」を再度クリックします。

    テストが成功したかどうかを確認するメッセージが表示されます。

  6. プロジェクト・ワークスペースに戻るには、「戻る」 「戻る」アイコンをクリックします。

REST OIC呼出し接続の構成

  1. 「接続」セクションで、接続名をクリックします。
  2. プロパティ・セクションで、次の詳細を入力します:
    フィールド 入力する情報
    接続タイプ 「REST APIのベースURL」を選択します。
    接続URL Oracle IntegrationインスタンスのURLを次の形式で貼り付けます。
  3. セキュリティ・セクションで、次の詳細を入力します:
    フィールド 入力する情報
    Security Policy 「基本認証」を選択します。
    ユーザー名 Oracle Integrationインスタンスのユーザー名を入力します。
    Password Oracle Integrationインスタンスのパスワードを入力します。
  4. 「保存」をクリックします プロンプトが表示されたら、「保存」を再度クリックします。
  5. 「テスト」をクリックして、接続が正常に構成されていることを確認します。 表示されたダイアログで、「テスト」を再度クリックします。

    テストが成功したかどうかを確認するメッセージが表示されます。

  6. プロジェクト・ワークスペースに戻るには、「戻る」 「戻る」アイコンをクリックします。

REST OICトリガー接続の構成

  1. 「接続」セクションで、接続名をクリックします。
  2. 「セキュリティ」セクションで、「セキュリティ・ポリシー」としてOAuth 2.0または基本認証を選択します。
  3. 「保存」をクリックします プロンプトが表示されたら、「保存」を再度クリックします。
  4. 「テスト」をクリックして、接続が正常に構成されていることを確認します。 表示されたダイアログで、「テスト」を再度クリックします。

    テストが成功したかどうかを確認するメッセージが表示されます。

  5. プロジェクト・ワークスペースに戻るには、「戻る」 「戻る」アイコンをクリックします。

ルックアップ表の構成

レシピには、次の4つの参照表が含まれます。 参照表を編集して、参照キーに適切な値を入力します。

  • ORACLE-BRT-UNITY_SFMC_PROPERTIES: 顧客セグメントが格納されるFTPファイル詳細を構成するために使用されます。

    キー 説明 例
    FileDirectory 顧客セグメントを持つFTPファイル ディレクトリの場所を格納します。 /home/users/org-name /customers/inbound
    RetryCount 一時的なエラーが発生した場合の再試行回数を格納します。 3
    ArchiveEnabled 正常に処理された後にファイルをアーカイブする必要があるかどうかを識別するフラグを格納します。 Y
    ArchiveDirectory 顧客セグメントを含むアーカイブ・ファイルを格納するFTPディレクトリの場所を格納します。 /home/users/org-name /customers/archive
    CustomerDataExtensionKey Salesforce Marketing Cloudに顧客データ拡張のIDを格納します。 データ拡張を識別する一意の値であり、APIコールでデータ拡張を識別するために使用されます。 5C2EF345-4A12-405C-BDCE-BE358139DC44
    SFMCPageSize Oracle FTP SFMC DataExtensionインポート統合の理想的なページ区切り値を格納します。 250
    EmailFrom_Success Oracle UnityからSalesforce Marketing Cloudへの顧客インポートが成功したときにメッセージが送信されるEメール・アドレスを格納します。 no-reply@company.com
    EmailTo_Success Oracle UnityからSalesforce Marketing Cloudへの顧客のインポートが成功したときにメッセージが送信されるEメール・アドレスを格納します。 xyz@company.com
    EmailSubject_Success Oracle UnityからSalesforce Marketing Cloudへの顧客インポートが成功したときに送信されるEメールの件名を格納します。 UnityからSFMCへの顧客のインポートに成功しました
    EmailFrom_Failure Oracle UnityからSalesforce Marketing Cloudへのカスタマ・インポートが失敗したときにメッセージが送信されるEメール・アドレスを格納します。 no-reply@company.com
    EmailTo_Failure Oracle UnityからSalesforce Marketing Cloudへのカスタマ・インポートが失敗したときにメッセージが送信されるEメール・アドレスを格納します。 xyz@company.com
    EmailSubject_Failure Oracle UnityからSalesforce Marketing Cloudへの顧客インポートが失敗したときに送信されるEメールの件名を格納します。 UnityからSFMCへの顧客インポート失敗
    MaxFileCount 1つのインスタンスで処理できるファイルの最大数を格納します。 スケジュール済インスタンスの処理時間が6時間の制限を超えないようにしてください。 指定可能な最大値は100です。 100
    MaxInstanceCount

    処理が1つのインスタンスで完了しない場合、実行がまたがるインスタンスの最大数を格納します。

    ノート:

    次のスケジュール済実行の前に処理が完了していることを確認してください。
    		10
    ClearBeforeImport 顧客インポート・データ拡張に新規データをインポートする前に、レシピが古いデータをクリアするかどうかを識別するフラグを格納します。 Y
    CustomerSegmentName 顧客セグメント名が格納されます。 Unity_SFMC_MasterCustomer
    UnityTenantId UnityテナントIDを格納します。 100046

  • ORACLE-BRT-SFMC_UNITY_PROPERTIES: キャンペーン結果をSalesforce Marketing Cloudに格納するデータ拡張を構成するために使用されます。

    キー 説明 例
    ResultsDataExtensionKey 結果データ拡張の外部キーをSalesforce Marketing Cloudに格納します。 この値は、[自動設定]インテグレーションで渡されます。 ResultsDataExtensionName
    ResultsDataExtensionName 結果データ拡張の名前をSalesforce Marketing Cloudに格納します。 この値は、[自動設定]インテグレーションで渡されます。 Unity_CampaignResults_DE
    マーケティング媒体 マーケティング・キャンペーンの媒体を格納します。 電子メール
    MarkeingSource マーケティング・キャンペーンのソース・アプリケーションを格納します。 Salesforce Marketing Cloud
    EmailFrom_Success Salesforce Marketing CloudクラウドからOracle Unityへのキャンペーン結果のインポートが成功したときにメッセージが送信されるEメール・アドレスを格納します。 no-reply@company.com
    EmailTo_Success Oracle UnityからSalesforce Marketing Cloudへの顧客のインポートが成功したときにメッセージが送信されるEメール・アドレスを格納します。 xyz@company.com
    EmailSubject_Success Oracle UnityからSalesforce Marketing Cloudへの顧客インポートが成功したときに送信されるEメールの件名を格納します。 UnityからSFMCへの顧客のインポートに成功しました
    EmailFrom_Failure Oracle UnityからSalesforce Marketing Cloudへの顧客インポートが失敗したときにメッセージが送信されるEメール・アドレスを格納します。 no-reply@company.com
    EmailTo_Failure Oracle UnityからSalesforce Marketing Cloudへのカスタマ・インポートが失敗したときにメッセージが送信されるEメール・アドレスを格納します。 xyz@company.com
    EmailSubject_Failure Oracle UnityからSalesforce Marketing Cloudへの顧客インポートが失敗したときに送信されるEメールの件名を格納します。 UnityからSFMCへの顧客インポート失敗
    UnityPageSize 呼出しリクエストでOracle Unityに渡すことができるレコードの最大数を格納します。 500
    UnityRetryCount

    Oracle Unityの呼出しリクエストが失敗した場合の再試行の最大数を格納します。

    		3
    MaxIterationCount 繰返しサイズが2500レコードであるSalesforce Marketing Cloudの繰返しの最大数を格納します。 スケジュール済インスタンスの処理時間が6時間の制限を超えないようにしてください。 100
    MaxInstanceCount

    1つのインスタンスで処理が不完全の場合に実行がまたがるインスタンスの最大数を格納します。

    ノート:

    次のスケジュール済実行の前に処理が完了していることを確認します。
    		20

  • ORACLE-BRT-SFMC_UNITY_EVENT_TYPE: インスタンス内のイベント・タイプ間のマッピングを表します。 たとえば、SentEventは「送信済」にマップされます。

    Salesforce Marketing Cloudのイベント・タイプ Oracle Unityのイベント・タイプ
    SentEvent 送付済
    OpenEvent オープン
    ClickEvent クリック数
    BounceEvent 宛先不明で戻されたメッセージ

  • ORACLE-BRT-SFMC_UNITY_MONTH_OF_YEAR: インスタンス間のカレンダ月をマップするために使用されます。

  1. 「参照」セクションで、参照名をクリックします。
  2. 必要に応じて参照表を編集します。
  3. 「保存」をクリックします プロンプトが表示されたら、「保存」を再度クリックします。
  4. プロジェクト・ワークスペースに戻るには、「戻る」 「戻る」アイコンをクリックします。

Salesforce Marketing Cloudでの属性の追加または編集(オプション)

Salesforce Marketing Cloud (このレシピで事前構成されているもの以外)で属性を追加または編集するには、以前に作成したデータ拡張を更新し、Oracle FTP SFMC DataExtensionインポート統合フローのRESTエンドポイント構成でスキーマを更新する必要があります。

Salesforce Marketing Cloudでのデータ拡張の更新

  1. Salesforce Marketing Cloudにログインします。
  2. 「オーディエンス・ビルダー」で、「コンタクト・ビルダー」を選択します。
  3. 「コンタクト・ビルダー」ウィンドウで、「データ拡張」タブにナビゲートします。
  4. 以前に作成したデータ拡張子をリストから選択し、「開く」をクリックします。
  5. 新しい属性を追加するには、「属性の作成」をクリックします。
  6. 属性を編集するには、属性の横にある「編集」アイコンをクリックします。

    ノート:

    属性の編集中にデータ型を選択することはできません。
  7. 「保存」をクリックします。

RESTエンドポイント構成でのスキーマの更新

  1. 「統合」セクションで、「Oracle FTP SFMC DataExtensionインポート」統合フローをクリックします。
  2. 統合キャンバスで、FileScopeを開き、PageScopeを展開します。
  3. PageScopeで、UpsertInSFMCDataExtension要素を選択し、「アクション」「アクション」アイコンをクリックして「編集」を選択します。
  4. 「リクエスト」ページで、新しいフィールドでJSONスキーマを更新します。
  5. Summaryページで「Done」をクリックします。
  6. 表示されたウィンドウで、「更新」をクリックします。

    更新された属性は、マッピング・キャンバスに別のフィールドとして表示されます。

RESTエンドポイントのマッパーの更新

マッピング・キャンバスの関連ソース属性に新規属性をマップします。

  1. 統合キャンバスのPageScopeで、「UpsertInSFMCDataExtensionにマップ」要素を選択し、「アクション」「アクション」アイコンをクリックして、「編集」を選択してマッパーを開きます。
  2. マッピング・キャンバスの関連ソース属性に新規属性をマップします。

Oracle Unityでの属性の追加または削除(オプション)

Oracle Unity (このレシピで事前構成されているもの以外)で属性を追加または削除するには、次のタスクを実行する必要があります:

  1. Oracle Unityでパーソナライズ属性を追加または削除します。
  2. レシピのOracle FTP SFMC DataExtensionインポート統合フローで、次の手順を実行します。
    1. 新しいファイル・スキーマでFTPアダプタを更新します。
    2. FTPアダプタに対応するマッパー要素を更新します。
    3. ステージ・ファイル要素を新しいファイル・スキーマで更新します。
    4. ステージ・ファイル要素に対応するマッパー要素を更新します。
    5. フォルト・ハンドラのステージ・ファイル要素を新しいファイル・スキーマで更新します。
    6. フォルト・ハンドラのステージ・ファイル要素に対応するマッパー要素を更新します。

Oracle Unityでのパーソナライズ属性の追加または削除

ベース・オブジェクトからセグメントにパーソナライズ属性(このレシピで事前構成されているもの以外)を追加または削除するには、Oracle Unityドキュメントのパーソナライズ属性の管理を参照してください。

新しいスキーマを使用したFTPアダプタの更新

ノート:

Oracle Unity FTPマスター顧客エクスポート統合フローを実行すると、更新されたファイル・スキーマが取得されます。

  1. 「統合」セクションで、「Oracle FTP SFMC DataExtensionインポート」統合フローをクリックします。
  2. 統合キャンバスで、FileScope要素を展開し、ReadFileFromFTP要素を選択し、「アクション」「アクション」アイコンをクリックして「編集」を選択します。
  3. 更新されたスキーマをアップロードします。
  4. Summaryページで「Done」をクリックします。
  5. 表示されたウィンドウで、「更新」をクリックします。

    更新された属性は、マッピング・キャンバスに別のフィールドとして表示されます。

FTPアダプタのマッパーの更新

  1. 統合キャンバスのFileScopeで、「ReadFileFromFTPにマップ」要素を選択し、「アクション」「アクション」アイコンをクリックして「編集」を選択してマッパーを開きます。
  2. マッピング・キャンバスの関連するターゲット属性に新しい属性をマップします。
新しいスキーマを使用したステージ・ファイル要素の更新
  1. 統合キャンバスのFileScopeで、InitializeStageErrorFile要素を選択し、「アクション」「アクション」アイコンをクリックして「編集」を選択します。
  2. 更新されたスキーマをアップロードします。
  3. Summaryページで「Done」をクリックします。
  4. 表示されたウィンドウで、「更新」をクリックします。

    更新された属性は、マッピング・キャンバスに別のフィールドとして表示されます。

    ステージ・ファイル・アクティビティの構成の詳細は、Oracle Integration 3での統合の使用のステージ・ファイル・アクションの構成を参照してください。

ステージ・ファイル要素のマッパーの更新
  1. 統合キャンバスのFileScopeで、「InitializeStageErrorFileにマップ」要素を選択し、「アクション」「アクション」アイコンをクリックして「編集」を選択してマッパーを開きます。
  2. マッピング・キャンバスの関連するターゲット属性に新しい属性をマップします。
新しいスキーマを使用したフォルト・ハンドラのステージ・ファイル要素の更新
  1. 統合キャンバスで、FileScopeを展開し、PageScopeを展開します。
  2. PageScopeで、「フォルト・ハンドラ」要素をクリックし、「デフォルト・ハンドラ」を選択します。
  3. AppendToStageErrorFile要素を選択し、「アクション」「アクション」アイコンをクリックして「編集」を選択します。
  4. フォーマット定義ページで、更新されたスキーマをアップロードします。
  5. Summaryページで「Done」をクリックします。
  6. 表示されたウィンドウで、「更新」をクリックします。

    更新された属性は、マッピング・キャンバスに別のフィールドとして表示されます。

    ステージ・ファイル・アクティビティの構成の詳細は、Oracle Integration 3での統合の使用のステージ・ファイル・アクションの構成を参照してください。

ステージ・ファイル要素のマッパーの更新

  1. 統合キャンバスのDefaultHandlerで、「AppendToStageErrorFileにマップ」要素を選択し、「アクション」「アクション」アイコンをクリックして、「編集」を選択してマッパーを開きます。
  2. マッピング・キャンバスの関連するターゲット属性に新しい属性をマップします。

新規Eメール・キャンペーン・イベントの追加(オプション)

このレシピでは、次のEメール・キャンペーン・イベントが事前構成されています。
  • 送信済イベント
  • バウンス・イベント
  • クリック・イベント
  • 有害事象を開く
レシピで事前構成されたもの以外の新しいEメール・キャンペーン・イベントを追加するには、次の操作を行う必要があります。
  1. 参照表ORACLE-BRT-SFMC_UNITY_EVENT_TYPEに新しいイベントを追加します。 参照表の構成を参照してください。
  2. 「統合」セクションで、「Oracle SFMC自動化設定」統合フローをクリックし、統合キャンバスで次のタスクを実行します。
    1. 新しいイベントにグローバル変数を割り当てます。
      1. 統合キャンバスで、AssignGlobalVariables要素を選択し、「アクション」「アクション」アイコンをクリックして「編集」を選択します。
      2. イベントに新しい変数を追加します。
    2. 新しいイベントのSOAPアダプタ・エンドポイントおよびマッパーを追加します。
      1. 「メイン・スコープ」で、DataExtensions「スコープ」を展開します。
      2. SOAPアダプタ・エンドポイントをマッパー要素とともに追加します。
      3. 新しいイベントに固有の詳細でマッパーを更新します。
    3. 作成されたデータ拡張のステータス・チェックを追加します。
      1. DataExtensionsスコープで、スイッチ・ケース(IF DataExtensionsCreated)要素を選択し、「アクション」「アクション」アイコンをクリックして「編集」を選択します。
      2. 作成した新しいデータ拡張のStatusCodeを追加します。
    4. イベントのクエリー定義を追加します。
      1. 「メイン・スコープ」で、QueryDefinitions「スコープ」を展開します。
      2. SOAPアダプタ・エンドポイントおよび問合せ定義のマッパーを追加して、Salesforce Marketing Cloudデータ・ビューからイベント・データを問い合せ、イベントに対して作成されたデータ拡張に同じデータをインポートします。
      3. クエリー定義マッパーを詳細で更新し、新しいイベントに固有のクエリーを実行します。
      4. 別のSOAPアダプタ・エンドポイントおよび問合せ定義のマッパーを追加して、イベント固有のデータ拡張から結果データ拡張にデータをコピーします。
      5. クエリー定義マッパーを詳細で更新し、新しいイベントに固有のクエリーを実行します。
      6. switch case条件を追加し、作成したデータ拡張に変数を割り当てます。
        1. QueryDefinitionsスコープで、スイッチ・ケース(IF QueryDefinitionsCreated)要素を選択し、「アクション」「アクション」アイコンをクリックして「編集」を選択します。
        2. 作成した新しいデータ拡張のStatusCheckを追加します。
        3. 変数を割り当てるには、AssignQueryDefinition要素を選択し、「アクション」「アクション」アイコンをクリックして「編集」を選択します。
        4. 他のイベントに追加した同様の形式で新しい変数を追加します。
    5. 「自動化スコープ」で、作成された問合せ定義でマッパーを更新します。
      1. 「メイン・スコープ」で、AutomationScopeを展開します。
      2. 「createAutomationにマップ」要素を選択し、「アクション」「アクション」アイコンをクリックして「編集」を選択します。
      3. マッピング・キャンバスで、新しいAutomationTaskを追加し、関連するターゲット属性で作成された新しい問合せ定義をマップします。