サンドボックスツール
サンドボックスツール機能を使用するには、次の2つの役割ベースのアクセス制御権限が必要です：
-
manage-sandboxまたはview-sandbox-
manage-packageサンドボックスツール機能を使用して、サンドボックスをまたいで設定の精度を向上させ、サンドボックス間でサンドボックス設定をシームレスに書き出しおよび読み込むことができます。 サンドボックスツールを利用して、実装プロセスの価値実現までの時間を短縮し、設定をサンドボックスをまたいで適切に移動できます。
サンドボックスツール機能を使用して、様々なオブジェクトを選択し、パッケージに書き出すことができます。 パッケージは、1 つのオブジェクトまたは複数のオブジェクトで構成できます。 パッケージに含まれているオブジェクトはすべて、同じサンドボックスから取得する必要があります。
サンドボックスツールでサポートされるオブジェクト supported-objects
サンドボックスツール機能を使用すると、Adobe Real-Time Customer Data PlatformおよびAdobe Journey Optimizer オブジェクトをパッケージに書き出すことができます。
Real-Time Customer Data Platform オブジェクト real-time-cdp-objects
マルチエンティティオーディエンスのインポートの変更
B2B アーキテクチャのアップグレード を使用すると、これらのオーディエンスを含むパッケージがアップグレード前に公開された場合、B2B属性とエクスペリエンスイベントを含むマルチエンティティオーディエンスを読み込むことができなくなります。 これらのオーディエンスは読み込みに失敗し、新しいアーキテクチャに自動的に変換できません。
この制限を回避するには、更新されたオーディエンスを含む新しいパッケージを作成し、サンドボックスツールを使用してそれぞれのターゲットサンドボックスに読み込む必要があります。
次の表に、サンドボックスツールで現在サポートされているAdobe Real-Time Customer Data Platform オブジェクトを示します。
- セキュリティ上の理由から、ソースアカウントの資格情報はターゲットサンドボックスにレプリケートされないので、手動で更新する必要があります。
- ソースデータフローは、デフォルトではドラフトステータスでコピーされます。
メモ：現在、サンドボックスツールはバッチベースのソースデータフローのみをサポートしています。 ストリーミングベースのソースデータフローはサポートされていません。
- 顧客オーディエンス タイプ セグメント化サービスのみがサポートされています。
- 同意とガバナンスの既存のラベルは、同じインポートジョブにコピーされます。
- 結合ポリシーの依存関係を確認する際に、同じXDM クラスのターゲットサンドボックスでデフォルトの結合ポリシーが自動的に選択されます。
- オーディエンスの読み込み時に同じ名前の既存のオブジェクトが検出された場合、サンドボックスツールは常に既存のオブジェクトを再利用して、オブジェクトの拡散を回避します。
- ターゲットサンドボックスでの作成時に、Adobe標準ID名前空間が自動的に重複排除されます。
- オーディエンスは、結合スキーマでオーディエンスルールのすべての属性が有効になっている場合にのみコピーできます。 最初に、統合プロファイルに必要なスキーマを移動して有効にする必要があります。
- 同意とガバナンスの既存のラベルは、同じインポートジョブにコピーされます。
- 統合プロファイル オプションを有効にせずにスキーマを柔軟に読み込むことができます。 スキーマ関係のエッジケースは、パッケージに含まれていません。
- スキーマまたはフィールドグループの読み込み時に同じ名前の既存のオブジェクトが検出された場合、サンドボックスツールは常に既存のオブジェクトを再利用して、オブジェクトの拡散を回避します。
次のオブジェクトは読み込まれますが、ドラフトまたは無効ステータスです。
Adobe Journey Optimizer オブジェクト abobe-journey-optimizer-objects
次の表は、サンドボックスツールと制限で現在サポートされているAdobe Journey Optimizer オブジェクトを示しています。 ベストプラクティスの一覧については、Journey Optimizerの一般的なベストプラクティス ガイドを参照してください。
ジャーニーで使用される次のオブジェクトは、依存オブジェクトとしてコピーされます。 読み込みワークフローでは、次のそれぞれに 新しい を作成するか、既存のを使用するかを選択できます。
- オーディエンス
- キャンバスの詳細
- コンテンツテンプレート
- カスタムアクション
- データソース
- イベント
- フィールドグループ
- フラグメント
- スキーマ
システムは、ジャーニーで使用されるイベントとイベントの詳細をコピーし、ターゲットサンドボックスに新しいバージョンを作成します。
ジャーニーで使用されているプロファイルの更新アクションをコピーできます。 カスタムアクションは、パッケージに個別に追加できます。 ジャーニーで使用されるアクションの詳細もコピーされます。 常に新しいバージョンがターゲットサンドボックスに作成されます。
カスタムアクションは、パッケージに個別に追加できます。 カスタムアクションをジャーニーに割り当てると、そのアクションは編集できなくなります。 カスタムアクションを更新するには、次の操作を行う必要があります。
- ジャーニーを移行する前にカスタムアクションを移動する
- 移行後のカスタムアクションの設定（リクエストヘッダー、クエリパラメーター、認証など）を更新します
- 最初の手順で追加したカスタムアクションでジャーニーオブジェクトを移行する
キャンペーンで使用される次のオブジェクトは、依存オブジェクトとしてコピーされます。
- キャンペーン
- オーディエンス
- スキーマ
- コンテンツテンプレート
- フラグメント
- メッセージ/コンテンツ
- チャネル設定
- 統合された決定オブジェクト
- 実験の設定/バリアント
- キャンペーンは、プロファイル、オーディエンス、スキーマ、インラインメッセージ、依存オブジェクトに関連するすべてのアイテムとともにコピーできます。 データ使用ラベルや言語設定など、一部の項目はコピーされません。 コピーできないオブジェクトの完全なリストについては、別のサンドボックスへのオブジェクトの書き出し ガイドを参照してください。
- 同じ設定が存在する場合、システムはターゲットサンドボックス内の既存のチャネル設定オブジェクトを自動的に検出して再利用します。 一致する設定が見つからない場合、読み込み中にチャネル設定はスキップされ、ユーザーはこのジャーニーのターゲットサンドボックスのチャネル設定を手動で更新する必要があります。
- ユーザーは、ターゲットサンドボックス内の既存の実験とオーディエンスを、選択したキャンペーンの依存オブジェクトとして再利用できます。
Decisioning オブジェクトをコピーする前に、宛先サンドボックスに次のオブジェクトが存在する必要があります。
- Decisioning オブジェクト間で使用されるプロファイル属性
- カスタムオファー属性のフィールドグループ
- ルール、ランキングまたはキャップをまたいだコンテキスト属性に使用されるデータストリームのスキーマ。
- AI モデルを使用するランキング式のコピーは、現在サポートされていません。
- 決定項目（オファー項目）は自動的に含まれません。 転送されていることを確認するには、パッケージに追加 オプションを使用して手動で追加します。
- 選択戦略を使用するポリシーでは、関連する決定項目をコピープロセス中に手動で追加する必要があります。 手動またはフォールバックの決定項目を使用するポリシーでは、これらの項目が直接依存関係として自動的に含まれます。
- 決定項目は、他の関連オブジェクトよりも先にコピーする必要があります。
- サポートされているオブジェクトの完全なリストについては、別のサンドボックスへのオブジェクトの書き出し ガイドを参照してください。
パッケージへのオブジェクトの書き出し export-objects
この例では、スキーマをエクスポートしてパッケージに追加するプロセスについて説明します。 同じプロセスを使用して、データセットやジャーニーなどの他のオブジェクトを書き出すことができます。
新しいパッケージにオブジェクトを追加 add-object-to-new-package
左側のナビゲーションから「スキーマ」を選択し、使用可能なスキーマのリストを表示する「参照」タブを選択します。 次に、選択したスキーマの横にある省略記号（...）を選択すると、ドロップダウンにコントロールが表示されます。 ドロップダウンから「パッケージに追加」を選択します。
![ パッケージに追加] コントロールを強調表示するドロップダウンメニューを表示するスキーマのリスト。(…/images/ui/sandbox-tooling/add-to-package.png)
「パッケージに追加」ダイアログで、「新しいパッケージを作成」オプションを選択します。 パッケージの名前とオプションの説明を指定し、追加を選択します。
スキーマ環境に戻されました。 次の手順に従って、作成したパッケージにオブジェクトを追加できるようになりました。
既存のパッケージにオブジェクトを追加して公開する add-object-to-existing-package
使用可能なスキーマのリストを表示するには、左側のナビゲーションから「スキーマ」を選択し、「参照」タブを選択します。 次に、選択したスキーマの横にある省略記号（...）を選択して、ドロップダウンメニューにコントロールオプションを表示します。 ドロップダウンから「パッケージに追加」を選択します。
![ パッケージに追加] コントロールを強調表示するドロップダウンメニューを表示するスキーマのリスト。(…/images/ui/sandbox-tooling/add-to-package.png)
「パッケージに追加」ダイアログが表示されます。 「既存のパッケージ」オプションを選択し、「パッケージ名」ドロップダウンを選択して、必要なパッケージを選択します。 最後に、追加を選択して、選択を確定します。
パッケージに追加されたオブジェクトのリストが表示されます。 パッケージを公開してサンドボックスに読み込めるようにするには、Publishを選択します。
「公開」を選択して、パッケージの公開を確認します。
サンドボックス 環境の「パッケージ」タブに戻り、新しく公開されたパッケージを確認できます。
ターゲットサンドボックスへのパッケージのインポート import-package-to-target-sandbox
パッケージをターゲットサンドボックスに読み込むには、「参照」タブに移動し、サンドボックス名の横にある「+」 オプションを選択します。
ドロップダウンメニューを使用して、ターゲットサンドボックスに読み込む パッケージ名 を選択します。 今後の監視に使用する ジョブ名 を追加します。 デフォルトでは、パッケージのスキーマを読み込むと、統合プロファイルは無効になります。 「プロファイルのスキーマを有効にする」を切り替えてこれを有効にし、「次へ」を選択します。
パッケージオブジェクトと依存関係 ページには、このパッケージに含まれるすべてのアセットのリストが表示されます。 選択した親オブジェクトを正常に読み込むために必要な依存オブジェクトが自動的に検出されます。 欠けている属性は、ページの上部に表示されます。 詳細な内訳については、詳細を表示を選択してください。
既存のオブジェクトを使用するには、依存オブジェクトの横にある鉛筆アイコンを選択します。
![ パッケージ オブジェクトと依存関係] ページには、パッケージに含まれるアセットのリストが表示されます。(…/images/ui/sandbox-tooling/package-objects-and-dependencies.png)
新規作成または既存の使用のオプションが表示されます。 「既存のを使用」を選択します。
フィールドグループ ダイアログには、オブジェクトで使用可能なフィールドグループのリストが表示されます。 必要なフィールドグループを選択し、保存を選択します。
![ フィールドグループ ] ダイアログに表示されるフィールドのリスト（保存の選択を強調） (…/images/ui/sandbox-tooling/field-group-list.png)
パッケージオブジェクトと依存関係 ページに戻ります。 ここから、「完了」を選択して、パッケージの読み込みを完了します。
![ パッケージ オブジェクトと依存関係] ページには、パッケージに含まれるアセットのリストが表示され、完了が強調表示されます。(…/images/ui/sandbox-tooling/finish-object-dependencies.png)
サンドボックス全体の書き出しと読み込み
サポートされているすべてのオブジェクトタイプを完全なサンドボックスパッケージに書き出してから、パッケージをさまざまなサンドボックスに読み込んで、オブジェクト設定をレプリケートできます。 例えば、この機能を使用すると、次のことが可能になります。
- サンドボックスをリセットする必要がある場合は、サンドボックスを再インポートしてオブジェクトのすべての設定を再現します
- パッケージを他のサンドボックスにインポートし、ブループリントサンドボックスとして利用して、開発プロセスを加速します。
サンドボックス全体の書き出し export-entire-sandbox
サンドボックス全体を書き出すには、「 サンドボックス パッケージ」タブに移動し、「パッケージを作成」を選択します。
パッケージを作成 ダイアログで パッケージのタイプ の サンドボックス全体 を選択します。 新しいパッケージの パッケージ名を入力し、ドロップダウンから サンドボックス を選択します。 最後に、作成を選択して、エントリを確認します。
パッケージが正常に作成されました。公開を選択してパッケージを公開します。
サンドボックス 環境の「パッケージ」タブに戻り、新しく公開されたパッケージを確認できます。
サンドボックスパッケージ全体をインポートする import-entire-sandbox-package
パッケージをターゲットサンドボックスに読み込むには、 サンドボックス 参照 タブに移動し、サンドボックス名の横にある「+」オプションを選択します。
ドロップダウンメニューを使用して、パッケージ名 ドロップダウンを使用して完全なサンドボックスを選択します。 今後の監視に使用される ジョブ名 と、オプションの ジョブの説明 を追加し、次へを選択します。
パッケージ オブジェクトと依存関係 ページに移動し、読み込まれたオブジェクトと除外されたオブジェクトの数と依存関係を確認できます。 ここから、「インポート」を選択して、パッケージのインポートを完了します。
![ パッケージオブジェクトと依存関係] ページには、サポートされていないオブジェクトタイプのインラインメッセージが表示され、 インポート が強調表示されます。(…/images/ui/sandbox-tooling/finish-dependencies-entire-sandbox.png)
読み込みが完了するまでしばらく時間がかかります。 完了までの時間は、パッケージ内のオブジェクトの数によって異なります。 インポート ジョブは、 サンドボックス ジョブ タブから監視できます。
サンドボックスへのオブジェクトのエクスプレスコピー express-copy
オブジェクトの在庫ページからエクスプレスコピーにアクセスできます。 例えば、使用可能なスキーマのリストを表示するには、左側のナビゲーションから スキーマ を選択し、参照 タブを選択します。次に、選択したスキーマの横にある省略記号（...）を選択して、ドロップダウンメニューにコントロールオプションを表示します。 ドロップダウンから「パッケージに追加」を選択します。
![ パッケージに追加] コントロールを強調表示するドロップダウンメニューを表示するスキーマのリスト。(…/images/ui/sandbox-tooling/add-to-package-express.png)
「パッケージに追加」ダイアログが表示されます。 「Express copy」オプションを選択し、ドロップダウンから「Target sandbox」を選択します。 最後に、追加を選択して、選択を確定します。
Express コピー要求のステータスを確認するには、左側のナビゲーションから「サンドボックス」を選択し、「ジョブ」タブを選択します。 すべてのジョブと現在の処理ステータスのリストが表示されます。
インポートの詳細を監視 view-import-details
インポートした詳細を表示するには、「 サンドボックス ジョブ」タブに移動し、リストからパッケージを選択します。 または、検索バーを使用してパッケージを検索します。
サンドボックス環境の「ジョブ」タブの右側の詳細ペインから「インポートの概要を表示」を選択します。
インポートの概要 ダイアログには、インポートの内訳が表示され、進行状況がパーセントで示されます。
読み込みが完了すると、Experience Platform UIに通知が届きます。 これらの通知には、アラートアイコンからアクセスできます。 ジョブが失敗した場合は、ここからトラブルシューティングに移動できます。
サンドボックスツールを使用して、サンドボックス間で反復的にオブジェクト設定を更新します move-configs
サンドボックスツールを使用して、異なるサンドボックス間でオブジェクト設定を転送できます。 以前は、他のサンドボックスに転送するために、オブジェクト（スキーマ、フィールドグループ、データタイプなど）の設定更新を手動で再作成または再インポートする必要がありました。 この機能を利用すれば、サンドボックスツールを使用してワークフローを高速化し、設定更新をさまざまなサンドボックスにシームレスに転送して、潜在的なエラーを軽減できます。
- サンドボックスツールにアクセスするための適切な権限。
- ソースサンドボックスで新しく作成または更新されたオブジェクト（スキーマなど）。
更新操作でサポートされるオブジェクトタイプ
更新でサポートされるオブジェクトタイプは次のとおりです。
- スキーマ
- フィールドグループ
- データタイプ
- リソースに新しいフィールド/フィールドグループを追加します。
- 必須フィールドをオプションにする。
- 新しい必須フィールドの導入。
- 新しい関係フィールドの導入。
- 新しいID フィールドの導入。
- リソースの表示名と説明を変更します。
- 定義済みのフィールドの削除。
- リアルタイム顧客プロファイルでスキーマが有効になっている場合の既存フィールドの再定義。
- 以前サポートされていたフィールド値の削除または制限。
- 既存のフィールドをスキーマツリー内の別の場所に移動する – これにより、ターゲットサンドボックスに新しいフィールドが作成されますが、前のフィールドは削除されません。
- プロファイルに参加するスキーマを有効または無効にする – この操作は差分比較でスキップされます。
- アクセス制御ラベル：
サンドボックスツールを使用して、様々なサンドボックス間でオブジェクト設定を転送する方法について説明します。
以前に読み込んだオブジェクト
既にパッケージ化され、他のサンドボックスに読み込まれた後、ソースサンドボックス内の既存のオブジェクトで構成の更新が必要な場合は、次の手順に従います。
まず、ソースサンドボックス内のオブジェクトを更新します。 例えば、スキーマ ワークスペースに移動し、スキーマを選択して、新しいフィールドグループを追加します。
スキーマを更新したら、サンドボックスに移動し、パッケージを選択して、既存のパッケージを探します。
パッケージインターフェイスを使用して、変更を確認します。 更新を確認を選択して、パッケージ内のアーティファクトに対する変更を表示します。 次に、差分を表示を選択して、アーティファクトに対して実行されたすべての変更の詳細な概要を受け取ります。
View diff インターフェイスが表示されます。 ソースとターゲットのアーティファクト、およびそれらに適用される変更について詳しくは、このツールを参照してください。
この手順では、AIによる要約を選択して、すべての変更をステップバイステップで要約することもできます。
準備ができたら、パッケージの更新を選択し、表示されるポップアップウィンドウで 確認 を選択します。 ジョブが完了したら、ページを更新し、履歴を表示を選択して、パッケージのバージョンを確認できます。
変更を読み込むには、 パッケージ ディレクトリに戻り、パッケージの横にある省略記号（...）を選択してから、パッケージの読み込みを選択します。 Experience Platformは、既存のオブジェクトを更新を自動選択します。 変更を確認し、完了を選択します。
インポートプロセスをさらに検証するには、ターゲットサンドボックスに移動し、そのサンドボックス内から更新されたオブジェクトを手動で表示します。
ターゲットサンドボックスで手動で作成されたオブジェクト
個別のサンドボックスで手動で作成されたオブジェクトに設定変更を適用するユースケースで使用する場合は、次の手順に従います。
まず、更新したオブジェクトで新しいパッケージを作成して公開します。
次に、更新するオブジェクトを含むターゲットサンドボックスにパッケージを読み込みます。 読み込みプロセスで、既存のオブジェクトを更新を選択し、オブジェクトナビゲーターを使用して、更新を適用するターゲットオブジェクトを手動で選択します。
- 依存オブジェクトに対して別のサンドボックスでターゲットマッピングを選択することはオプションです。 何も選択しない場合は、新しいオブジェクトが作成されます。
- ID名前空間の場合、既存のIDをターゲットサンドボックスで再利用する必要がある場合に、新しいIDを作成する必要があるかどうかを自動的に検出します。
更新するターゲットオブジェクトを特定したら、終了を選択します。
ビデオチュートリアル
次のビデオは、サンドボックスツールの理解を支援することを目的としており、新しいパッケージの作成、パッケージの公開、パッケージのインポートの方法の概要を示しています。
次の手順
このドキュメントでは、Experience Platform UI内でサンドボックスツール機能を使用する方法を説明しました。 サンドボックスについて詳しくは、 サンドボックスユーザーガイド を参照してください。
サンドボックス API を使用して様々な操作を実行する手順については、サンドボックス開発者ガイドを参照してください。 Experience Platformのサンドボックスの概要については、概要ドキュメント を参照してください。