1. XP(xDB)からCDPへの顧客データの移行

xDBからCDPへの移行ツールを使用する

Version:
日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

このトピックでは、Sitecore ConnectでのxDBからCDPへの移行ツールのインストール、設定、実行に関連する手順の概要を説明します。

始める前に

次のものがあることを確認してください。

  • Sitecore Experience Platform (XP) ライセンスと、顧客データを含むXPインスタンス バージョン9.0以降。

  • Sitecore CDPライセンスとCDPインスタンス。

  • アクティブなSitecore Connectインスタンス。

このチュートリアルでは、次の方法について説明します。

Sitecore Connectにパッケージをインストールする

パッケージをインストールするには、パッケージをxConnectアカウントにインポートする必要があります。

Sitecore Connectにパッケージをインストールするには:

  1. 移行パッケージをダウンロードします。

  2. Sitecore Connectポータルに移動します。

  3. Tools > Recipe lifecycle managementに移動します。

    Recipe lifecycle management in Sitecore Connect

  4. 「 Import 」タブをクリックし、「 Import」をクリックします。

    The Import tab under Recipe lifecycle management in Sitecore Connect

  5. 手順1でダウンロードしたパッケージを選択します。次の レシピ が表示されます。

    An example of imported recipes in Sitecore Connect

    • 【XCM】レック001 |レシピ処理トリガー

    • 【XCM】レック002 |xDBからの連絡先の読み込みと変換

    • 【XCM】レック003 |CDPへの連絡先のアップロード

    • 【XCM】レック004 |IDによる連絡先の移行

    メモ

    また、Sitecore XP Connection接続とSitecore CDP Connection接続も表示されます。インスタンスに接続するには、まずインスタンスの設定を更新する必要があります。

これで、移行パッケージがSitecore Connectアカウントに正常にインポートされました。

xConnectによるXPインスタンスへの接続の確立

パッケージをインポートしたら、xConnectを使用してXPインスタンスのxDBへの接続を確立します。

接続を確立する前に、.pfxファイルから証明書とキーを取得する必要があります。

証明書とキーを取得するには:

  1. OpenSSLを起動します。Gitがインストールされている場合は、次のフォルダにGit openssl見つけることができます。

    cd 'C:\Program Files\Git\mingw64\bin\'

  2. Powershellで次のコマンドを実行します。

    .\openssl.exe pkcs12 -info -in C:\Users\{:placeholder-token:}<YOUR_CERTIFICATE_LOCATION>{/:placeholder-token:}\Downloads\myCert.pfx

接続を確立するには:

  1. Sitecore ConnectでAssets > Connectionsに移動します。

  2. 以前にインポートしたSitecore XP Connectionを開きます。

  3. xConnectに接続するには、次の情報を入力します。

    • Connection Name - xConnectへの接続用に定義する名前。

      このパラメータは、Workatoアカウント内の複数の接続を識別して管理するのに役立ちます。

    • Certificate - xConnect証明書の値を使用します。

      大事な

      -----BEGIN CERTIFICATE-----行と-----END CERTIFICATE-----行を含める必要があります。

      これは、xConnectサービスとの安全な通信に必要なSSL証明書です。この証明書は、WorkatoとxConnect間で交換されるデータの機密性と整合性を保証します。

    • Key - xConnect証明書の値を使用します。

      大事な

      ----- ENCRYPTED PRIVATE KEY -----行と----- END ENCRYPTED PRIVATE KEY -----行を含める必要があります。

      これは、SSL証明書に関連付けられた秘密キーです。このキーは、SSLハンドシェイク プロセス中の暗号化と復号化のために使用されます。

    • Passphrase - xConnect証明書の値を使用します。

    • URL - xConnectサービスのURLエンドポイントを入力します。

      このパラメーターは、xConnectサービスがホストされ、アクセス可能な場所を指定します。

      • XPのオンプレミスインスタンスをお持ちの場合: {:placeholder-token:}<ROOT>{/:placeholder-token:}\App_Configフォルダーに移動し、ConnectionStrings.configファイルを開き、xconnect.collectionフィールドの値をコピーしてURLフィールドに貼り付けます。

      • XPのインスタンスがAzureで実行されており、XP0インスタンスがある場合は、xc-single App ServiceのURLを使用します。URLの形式は次のとおりです。

        https://{:placeholder-token:}<YOUR_INSTANCE>{/:placeholder-token:}-xc-single.azurewebsites.net

      • XPのインスタンスがAzureで実行されており、XP1インスタンスがある場合は、xc-search App ServiceのURLを使用します。URLの形式は次のとおりです。

        https://{:placeholder-token:}<YOUR_INSTANCE>{/:placeholder-token:}-xc-search.azurewebsites.net

  4. 「 Connect」をクリックします。接続が成功すると、画面は次のようになります。

    When connecting to XP (xDB) in Sitecore Connect is successful
手記

設定によっては、ファイアウォールによってSitecore ConnectがXPインスタンスに接続できない場合があります。この問題を解決するには、Workatoで許可されているIPをホワイトリストに追加して、IPホワイトリストの使用を検討してください。

これで、XPインスタンスに正常に接続されました。

xConnectによるCDPへの接続を確立

XPインスタンスに接続した後、xConnectを介してCDPインスタンスへの接続を確立します。

  1. Sitecore Connectで、Assets > Connectionsに移動します。

  2. 以前にインポートしたSitecore CDP Connectionを開きます。

  3. Locationフィールドで、接続を保存するプロジェクトまたはフォルダーを選択し、ページの指示に従って残りのフィールドに入力します。

  4. Client IDとClient secretをスキップできます。

  5. 「 Connect」をクリックします。接続が成功すると、画面は次のようになります。

    When connecting to CDP in Sitecore Connect is successful

これで、CDPインスタンスに正常に接続されました。

XCM REC002の設定 |xDBレシピから連絡先をロードして変換する

XCM REC002 | Load And Transform Contacts From xDBレシピには、既知の連絡先のみが移行されるように、すでにフィルターが組み込まれています。フィルターを1つ追加できます。

カスタムファセットを移行する場合は、レシピの設定beforeカスタムファセットのマッピングを手動で作成する必要があります。

レシピにフィルターを追加するには:

  1. Sitecore Connectで、XCM REC002 | Load and Transform Contacts From xDBレシピを開きます。

    Example of a recipe in Sitecore Connect

  2. レシピのステップ5で、Get all contacts from xConnect that contain at least one known contact identifierをクリックします。

    Example of a step in a recipe in Sitecore Connect

  3. 右上隅のEditをクリックします。

    Example of a recipe step in edit mode in Sitecore Connect

  4. Enable Filtersリストで、「Yes」を選択します。

  5. Filter Propertyリストで、ファセット、演算子、および値を選択します。

    Set filter properties for a recipe in Sitecore Connect

  6. 右上隅にあるSaveをクリックして変更を保存します。

これで、レシピが設定されました。

移行ツールを実行する

フィルターを使用するオプションを使用して連絡先を移行するには、最初の3つのレシピを以下に示す順序で実行する必要があります。

IDに基づいて連絡先を移行するには、4番目のレシピのみを実行します。

始める前に

カスタムファセットがある場合は、レシピの実行beforeマッピングを設定する必要があります。組み込みファセットのみがCDPのゲストデータエクステンションにマッピングされます。

CDPテナントのデフォルトのIDルールを変更した場合、または新しいルールを追加した場合は、レシピを実行する前に ゲストIDを設定する必要があります 。

フィルタリングオプションを使用して連絡先を移行するには:

  1. Sitecore ConnectでXCM REC002 | Load and Transform Contacts From xDBレシピを開き、Start Recipeをクリックします。

  2. XCM REC003 | Upload Contacts to CDPレシピを開き、「Start Recipe」をクリックします。

  3. XCM REC001 | Processing Recipe Triggerを開き、Test Recipeをクリックします。

IDに基づいて特定の連絡先を移行するには:

  • Sitecore ConnectでXCM REC004 | Migrate Contacts by IDレシピを開き、Test Recipeをクリックします。

先端

Workatoは、各ステップのステータスに関するリアルタイムのフィードバックを提供し、成功したか、失敗したか、警告が発生したかを示します。ジョブの実行を監視するには、Jobsタブをクリックし、個々のジョブをクリックします。

In Sitecore Connect, monitor the execution of a job.

連絡先と連絡先情報をXPインスタンスからCDPインスタンスに正常に移行しました。

この記事を改善するための提案がある場合は、 お知らせください!