サンドボックスツール
サンドボックスツール機能を使用するには、次の 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
サンドボックスツールで現在サポートされている Adobe Real-Time Customer Data Platform オブジェクトを次の表に示します。
次のオブジェクトが読み込まれますが、ステータスがドラフトまたは無効です。
Adobe Journey Optimizer オブジェクト abobe-journey-optimizer-objects
サンドボックスツール Adobe Journey Optimizer 制限で現在サポートされているオブジェクトを次の表に示します。
ジャーニーで使用される「プロファイルを更新」アクションをコピーできます。 ジャーニーで使用されるカスタムアクションとアクションの詳細もコピーされます。 ターゲットサンドボックスに新しいバージョンが常に作成されます。
サーフェス(プリセットなど)はコピーされません。 メッセージタイプとサーフェス名に基づいて、最も近いものが宛先サンドボックスで自動的に選択されます。 ターゲットのサンドボックスでサーフェスが見つからない場合、サーフェスのコピーが失敗します。その結果、メッセージを設定するためにサーフェスを使用する必要があるので、メッセージのコピーが失敗します。 この場合、コピーを機能させるには、メッセージの適切なチャネル用に少なくとも 1 つのサーフェスを作成する必要があります。
カスタム ID タイプは、ジャーニーを書き出す際に依存オブジェクトとしてサポートされません。
パッケージへのオブジェクトの書き出し export-objects
この例では、スキーマを書き出してパッケージに追加するプロセスを説明します。 データセットやジャーニーなど、他のオブジェクトも同じ手順で書き出すことができます。
新しいパッケージにオブジェクトを追加 add-object-to-new-package
左側のナビゲーションから スキーマ を選択し、「参照」タブを選択すると、使用可能なスキーマが一覧表示されます。 次に、選択したスキーマの横にある省略記号(...
)を選択すると、ドロップダウンにコントロールが表示されます。 ドロップダウンから パッケージに追加 を選択します。
パッケージに追加 ダイアログで 新しいパッケージを作成 オプションを選択します。 パッケージの 名前 とオプションの 説明 を入力し、「追加」を選択します。
スキーマ 環境に戻ります。 次の手順に従って、作成したパッケージにオブジェクトを追加できるようになりました。
既存のパッケージにオブジェクトを追加して公開 add-object-to-existing-package
使用可能なスキーマのリストを表示するには、左側のナビゲーションから スキーマ を選択し、「参照 タブを選択します。 次に、選択したスキーマの横にある省略記号(...
)を選択して、ドロップダウンメニューにコントロールオプションを表示します。 ドロップダウンから パッケージに追加 を選択します。
パッケージに追加 ダイアログが表示されます。 「既存のパッケージ」オプションを選択し、「パッケージ名」ドロップダウンを選択して、必要なパッケージを選択します。 最後に「追加」をクリックして、選択を確定します。
パッケージに追加されたオブジェクトのリストが表示されます。 パッケージを公開し、サンドボックスに読み込めるようにするには、「Publish」を選択します。
「Publish」を選択して、パッケージの公開を確定します。
サンドボックス 環境の「パッケージ」タブに戻ると、新しく公開されたパッケージを確認できます。
ターゲットサンドボックスへのパッケージの読み込み import-package-to-target-sandbox
パッケージをターゲットサンドボックスに読み込むには、「サンドボックス 参照」タブに移動し、サンドボックス名の横にあるプラス(+)オプションを選択します。
ドロップダウンメニューを使用して、ターゲットサンドボックスに読み込む パッケージ名 を選択します。 今後の監視に使用される ジョブ名 を追加します。 デフォルトでは、パッケージのスキーマが読み込まれると、統合プロファイルは無効になります。 プロファイルのスキーマを有効にする を切り替えて有効にし、「次へ を選択します。
パッケージオブジェクトと依存関係 ページには、このパッケージに含まれるすべてのアセットのリストが表示されます。 選択した親オブジェクトのインポートに必要な依存オブジェクトが自動的に検出されます。 見つからない属性は、ページの上部に表示されます。 詳細な分類を表示するには、「詳細を表示」を選択します。
既存のオブジェクトを使用するには、依存オブジェクトの横にある鉛筆アイコンを選択します。
。
新規作成または既存のものを使用するためのオプションが表示されます。 既存のものを使用 を選択します。
![ 依存オブジェクトオプション ] 新規作成 および 既存のものを使用 を表示する パッケージオブジェクトと依存関係 ページ
フィールドグループ ダイアログには、オブジェクトで使用可能なフィールドグループのリストが表示されます。 必要なフィールドグループを選択し、「保存」を選択します。
「 パッケージオブジェクトと依存関係 」ページに戻ります。 ここから「完了」を選択して、パッケージの読み込みを完了します。
サンドボックス全体の書き出しと読み込み
サポートされているすべてのオブジェクトタイプを完全なサンドボックスパッケージに書き出し、様々なサンドボックスからこのパッケージを読み込んでオブジェクト設定をレプリケートできます。 例えば、この機能を使用すると、次のことが可能です。
- サンドボックスをリセットする必要がある場合は、サンドボックスを再読み込みして、オブジェクトのすべての設定を再現します
- パッケージを他のサンドボックスに読み込み、ブループリントサンドボックスとして使用して、開発プロセスを高速化します。
サンドボックス全体の書き出し export-entire-sandbox
サンドボックス全体を書き出すには、「 サンドボックス パッケージ」タブに移動し、「パッケージを作成」を選択します。
パッケージを作成 ダイアログで、 パッケージのタイプ に対して サンドボックス全体 を選択します。 新しいパッケージの パッケージ名 を指定し、ドロップダウンから サンドボックス を選択します。 最後に、「作成 を選択して、エントリを確認します。
![ 完了したフィールドとハイライト表示された ] 作成 を示す パッケージを作成 ダイアログ
パッケージが正常に作成されたら、「Publish」を選択してパッケージを公開します。
サンドボックス 環境の「パッケージ」タブに戻ると、新しく公開されたパッケージを確認できます。
サンドボックスパッケージ全体を読み込みます import-entire-sandbox-package
パッケージをターゲットサンドボックスに読み込むには、「 サンドボックス 参照」タブに移動し、サンドボックス名の横にあるプラス(+) オプションを選択します。
ドロップダウンメニューを使用し、「パッケージ名 ドロップダウンを使用して、完全なサンドボックスを選択します。 今後の監視に使用する ジョブ名 とオプションの ジョブの説明 を追加し、「次へ」を選択します。
パッケージオブジェクトと依存関係 ページが開き、インポートされたオブジェクトと除外されたオブジェクトの数と依存関係を確認できます。 ここから 読み込み を選択して、パッケージの読み込みを完了します。
読み込みが完了するまでしばらく待ちます。 完了までの時間は、パッケージ内のオブジェクトの数によって異なる場合があります。 「 サンドボックス ジョブ」タブで読み込みジョブを監視できます。
読み込みの詳細を監視 view-import-details
読み込んだ詳細を表示するには、「 サンドボックス ジョブ」タブに移動し、リストからパッケージを選択します。 または、検索バーを使用してパッケージを検索します。
サンドボックス環境の ジョブ タブにある右側の詳細パネルから 読み込みの概要を表示 を選択します。
読み込みの概要 ダイアログには、読み込みの分類が進行状況とともにパーセンテージで表示されます。
読み込みが完了すると、Platform UI に通知が届きます。 これらの通知には、アラート アイコンからアクセスできます。 ジョブが失敗した場合は、ここからトラブルシューティングに移動できます。
ビデオチュートリアル
次のビデオは、サンドボックスツールに関する理解を深めるために、新しいパッケージの作成、パッケージの公開、パッケージの読み込み方法の概要を説明しています。
次の手順
このドキュメントでは、Experience PlatformUI 内でサンドボックスツール機能を使用する方法について説明しました。 サンドボックスについて詳しくは、『 サンドボックスユーザーガイド』を参照してください。
サンドボックス API を使用して様々な操作を実行する手順については、サンドボックス開発者ガイドを参照してください。Experience Platformのサンドボックスの概要については、 概要ドキュメントを参照してください。