別のサンドボックスへのオブジェクトのエクスポート copy-to-sandbox

パッケージのエクスポート機能とインポート機能を使用して、複数のサンドボックス間でジャーニー、カスタムアクション、コンテンツテンプレート、フラグメントなどのオブジェクトをコピーできます。パッケージは、1 つのオブジェクトまたは複数のオブジェクトで構成できます。パッケージに含まれるオブジェクトは、同じサンドボックスからのものである必要があります。

このページでは、Journey Optimizer のコンテキストにおけるサンドボックスツールのユースケースについて説明します。機能自体について詳しくは、Adobe Experience Platform サンドボックスツールガイドを参照してください。

NOTE
この機能には、サンドボックス管理 ​機能の権限(サンドボックスの管理(またはサンドボックスの表示)とパッケージの管理)が必要です。詳細情報

コピープロセスは、ソースサンドボックスとターゲットサンドボックス間のパッケージの書き出しおよび読み込みを介して実行されます。1 つのサンドボックスから別のサンドボックスにジャーニーをコピーする一般的な手順を以下に示します。

書き出したオブジェクトとベストプラクティス objects

Journey Optimizer では、ジャーニー、カスタムアクション、コンテンツテンプレート、フラグメントおよび他のオブジェクトを別のサンドボックスに書き出すことができます。次の節では、各タイプのオブジェクトに関する情報とベストプラクティスについて説明します。

一般的なベストプラクティス global

  • オブジェクトをコピーすると、依存関係(ネストされたフラグメント、ジャーニーオーディエンス、アクションなど)が親オブジェクトで正しく更新され、ターゲットサンドボックスに適切にマッピングされます。

  • 書き出したオブジェクトにプロファイルのパーソナライゼーションが含まれている場合は、パーソナライゼーションの問題を回避するのに、適切なスキーマがターゲットサンドボックスに存在することを確認します。

  • ランディングページは現在、サンドボックス間の移行ではサポートされていません。ジャーニーを別のサンドボックスにコピーすると、ジャーニーまたはメールコンテンツ内のランディングページへの参照は、引き続き元の(ソース)サンドボックスランディングページ ID を指します。移行後、ターゲット(宛先)サンドボックスの正しいランディングページ ID を使用するには、ジャーニーとメールコンテンツ内のすべてのランディングページ参照を手動で更新する必要があります。ランディングページの作成と公開を参照してください。

ジャーニー
  • コピーされた依存関係 - ジャーニーを書き出すと、Journey Optimizer では、ジャーニー自体に加えて、ジャーニーに必要なほとんどのオブジェクト(オーディエンス、カスタムアクション、スキーマ、イベントおよびアクション)もコピーします。コピーされたオブジェクトについて詳しくは、Adobe Experience Platform サンドボックスツールガイドを参照してください。

  • 推奨された手動検証 - リンクされたすべての要素が宛先サンドボックスにコピーされるとは限りません。例えば、ジャーニーを公開する前に、徹底的に確認することを強くお勧めします。これにより、欠けている可能性のあるオブジェクトを特定できます。

  • ドラフトモードと一意性 - ターゲットサンドボックスにコピーされたオブジェクトは一意で、既存の要素が上書きされるリスクはありません。ジャーニーとジャーニー内のあらゆるメッセージは、両方ともドラフトモードで引き継がれます。これにより、ターゲットサンドボックスで公開する前に、徹底的な検証を実行できます。

  • メタデータ - コピープロセスでは、ジャーニーとそのジャーニー内のオブジェクトに関するメタデータのみをコピーします。プロファイルまたはデータセットのデータは、このプロセスの一環としてコピーされません。

  • カスタムアクション

    • カスタムアクションをエクスポートすると、URL 設定とペイロードパラメーターがコピーされます。ただし、セキュリティ上の理由から、認証パラメーターはコピーされず、「INSERT SECRET HERE」に置き換えられます。また、定数リクエストヘッダーとクエリパラメーター値も「INSERT SECRET HERE」に置き換えられます。

      これには、特別な目的のカスタムアクション(Adobe Campaign Standard、Campaign Classic、Marketo Engage)が含まれます。

    • ジャーニーを別のサンドボックスにコピーする際に、インポートプロセス中にカスタムアクションに対して「既存を使用」を選択した場合、選択する既存のカスタムアクションはソースカスタムアクションと同じにする必要があります(例:同じ設定、パラメーターなど)。それ以外の場合は、新しいジャーニーのコピーにキャンバスで解決できないエラーが発生します。

  • データソース、フィールドグループ、イベント - イベント、データソース、フィールドグループを使用するジャーニーをコピーする際、読み込みプロセスによって、同じ名前とタイプのコンポーネントがターゲットサンドボックスに既に存在するかどうかが自動的に確認されます。例えば、単一イベントは、ターゲットサンドボックス内の同じ名前の単一イベントに置き換えられます。 同じことが、ビジネスイベント、カスタムデータソース、ジャーニーで使用される API ベースとスキーマベースの両方のフィールドグループに当てはまります。ソースサンドボックスからの単一イベントの名前がビジネスイベントの宛先サンドボックスと同じ場合、そのイベントはコピーも作成もされません。これは、他のすべてのコンポーネントにも適用されます。

キャンペーン

キャンペーンは、プロファイル、オーディエンス、スキーマ、インラインメッセージおよび依存オブジェクトに関連するすべての項目と共にコピーされます。ただし、次の項目はコピーされ​ ません

  • 多言語バリアントと言語設定、
  • ビジネスルール、
  • タグ、
  • データ使用のラベル付けと適用(DULE)ラベル。

キャンペーンをコピーする際は、誤った設定を回避するために、以下にリストされているオブジェクトがターゲットサンドボックスで検証されていることを確認します。

  • チャネル設定:チャネル設定は、キャンペーンと共にコピーされます。キャンペーンをコピーしたら、ターゲットサンドボックスでチャネル設定を手動で選択する必要があります。
  • 実験のバリアントと設定:実験のバリアントと設定は、キャンペーンのコピープロセスに含まれます。インポート後、ターゲットサンドボックスでこれらの設定を検証します。
  • 統合決定:決定ポリシーと決定項目は、エクスポートとインポートでサポートされています。決定関連の依存関係がターゲットサンドボックスで正しくマッピングされていることを確認します。
決定
  • 決定オブジェクトをコピーする前に、以下のオブジェクトが宛先サンドボックスに存在している必要があります。

    • 決定オブジェクト全体で使用されるプロファイル属性、
    • カスタムオファー属性のフィールドグループ、
    • ルール、ランキングまたはキャップをまたいだコンテキスト属性に使用されるデータストリームのスキーマ。
  • AI モデルを使用したランキング式のサンドボックスコピーは、現在サポートされていません。

  • キャンペーンをコピーする際、決定項目(オファー項目)は自動的にはコピーされません。「パッケージに追加」オプションを使用して、個別にコピーします。

  • 決定ポリシーに選択戦略がある場合は、決定項目を別途追加する必要があります。手動/フォールバック決定項目がある場合は、直接依存関係として自動的に追加されます。

  • 決定エンティティをコピーする際は、他のオブジェクトの​ ​に決定項目をコピーします。例えば、最初にコレクションをコピーし、新しいサンドボックスにオファーがない場合、その新しいコレクションは空のままになります。

  • 依存関係のあるエンティティ(スキーマ、セグメントなど)をコピーする際、エンティティに対して「新規作成」をクリックして選択解除し、依存アーティファクトの「既存を使用」オプションを表示します。追加の依存関係がある場合は、階層の下でこの手順を繰り返す必要があります。

    例:キャンペーンの読み込み中に、ルール内のデータストリームスキーマを再利用するには、DECISIONING_STRATEGY に対して「新規作成」をクリックし、次に DECISIONING_RULES に対してもう一度クリックして、データストリームスキーマの「既存を使用」オプションを表示します。

  • データストリームコンテキストスキーマに依存するエンティティの場合は、データストリームが事前に作成されていることを確認し、そのデータストリームの既存のスキーマを選択します。

  • 読み込み中に「終了」を直接クリックすると、すべての依存関係が新たに作成されます。

コンテンツテンプレート
  • コンテンツテンプレートを書き出す際、ネストされたすべてのフラグメントも一緒にコピーされます。

  • コンテンツテンプレートを書き出すと、フラグメントが重複する場合があります。例えば、2 つのテンプレートが同じフラグメントを共有し、別々のパッケージにコピーされた場合、両方のテンプレートはターゲットサンドボックスで同じフラグメントを再利用する必要があります。重複を回避するには、読み込みプロセス中に「既存のものを使用」オプションを選択します。詳しくは、パッケージの読み込み方法を参照してください。

  • 重複をさらに回避するには、コンテンツテンプレートを 1 つのパッケージで書き出すことをお勧めします。こうすることで、システムでは重複排除を効率的に管理できます。

フラグメント
  • フラグメントには、ライブ、ドラフト、ドラフトが進行中のライブなど、複数のステータスがあります。フラグメントを書き出す際、最新のドラフト状態がターゲットサンドボックスにコピーされます。

  • フラグメントを書き出す際、ネストされたすべてのフラグメントも一緒にコピーされます。

パッケージとしてのオブジェクトの追加 export

オブジェクトを別のサンドボックスにコピーするには、まずオブジェクトをパッケージとしてソースサンドボックスに追加する必要があります。次の手順に従います。

  1. ジャーニーリストなど、コピーする最初のオブジェクトが保存されているインベントリに移動します。その他のアクション ​アイコン(オブジェクト名の横にある 3 つのドット)をクリックし、「パッケージに追加」をクリックします。

  2. パッケージに追加 ​ウィンドウで、オブジェクトを既存のパッケージに追加するか、新しいパッケージを作成するかを選択します。

    • 既存のパッケージ:ドロップダウンメニューからパッケージを選択します。
    • 新しいパッケージを作成:パッケージ名を入力します。説明を追加することもできます。
  3. これらの手順を繰り返して、パッケージと共に書き出すすべてのオブジェクトを追加します。

書き出すパッケージの公開 publish

パッケージを書き出す準備が整ったら、次の手順に従って公開します。

  1. 管理サンドボックス ​メニューに移動し、「パッケージ」タブを選択します。

  2. 書き出すパッケージを開き、書き出すオブジェクトを選択して、「公開」をクリックします。

    この例では、ジャーニー、コンテンツテンプレートおよびフラグメントを書き出します。

  3. ジョブ」タブからパッケージの公開ステータスを追跡します。ジョブについて詳しくは、リストからジョブを選択し、「読み込みの詳細を表示」ボタンをクリックします。

ターゲットサンドボックスへのパッケージの読み込み import

パッケージを公開したら、ターゲットサンドボックスに読み込む必要があります。次の手順に従います。

  1. サンドボックス ​メニューに移動し、「参照」タブを選択します。

  2. パッケージを読み込むサンドボックスを検索し、名前の横にある「+」アイコンをクリックします。

    note note
    NOTE
    組織内のサンドボックスのみ使用できます。
  3. ターゲットサンドボックス」フィールドで、正しいターゲットサンドボックスが選択されていることを確認し、パッケージ名 ​ドロップダウンリストから読み込むパッケージを選択します。「次へ」をクリックします。

  4. パッケージオブジェクトと依存関係を確認します。これは、パッケージに追加したオブジェクトと、オーディエンス、スキーマ、イベント、アクションなど、ジャーニーが依存するその他のオブジェクトのリストです。

    各オブジェクトに対して、新しいオブジェクトを作成するか、ターゲットサンドボックス内の既存のオブジェクトを使用するかを選択できます。これにより、例えば、共通のフラグメントを使用してコンテンツテンプレートを読み込む際に発生する場合があるフラグメントの重複を回避できます。

  5. 右上隅の「終了」ボタンをクリックして、ターゲットサンドボックスへのパッケージのコピーを開始します。コピー処理は、オブジェクトの複雑さや、コピーする必要のあるオブジェクトの数によって異なります。

  6. 読み込みジョブをクリックして、コピー結果を確認します。

    • 読み込み済みオブジェクトを表示」ボタンをクリックし、コピーした個々のオブジェクトを表示します。
    • 読み込みの詳細を表示」ボタンをクリックして、各オブジェクトの読み込み結果を確認します。

  7. ターゲットサンドボックスにアクセスし、コピーしたすべてのオブジェクトを徹底的に確認します。

recommendation-more-help
b22c9c5d-9208-48f4-b874-1cefb8df4d76