サンドボックスツール

NOTE
サンドボックスツールは、開発サイクルの効率と設定精度を向上させるために、Real-Time Customer Data Platform と Journey Optimizer の両方をサポートする基本機能です。

サンドボックスツール機能を使用するには、次の 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 オブジェクトを次の表に示します。

Platform
オブジェクト
詳細
顧客データプラットフォーム
ソース
ソースアカウント資格情報は、セキュリティ上の理由から、ターゲットサンドボックスでレプリケートされず、手動で更新する必要があります。 デフォルトでは、ソースデータフローはドラフトステータスでコピーされます。
顧客データプラットフォーム
オーディエンス
顧客オーディエンス タイプ セグメント化サービス のみがサポートされます。 同意およびガバナンス用の既存のラベルは、同じインポートジョブでコピーされます。 システムは、結合ポリシーの依存関係を確認する際に、同じ XDM クラスを持つターゲットサンドボックスのデフォルトの結合ポリシーを自動的に選択します。
顧客データプラットフォーム
ID
ターゲットサンドボックスでを作成する場合、Adobeの標準 ID 名前空間の重複が自動的に排除されます。 オーディエンスは、オーディエンスルールのすべての属性が結合スキーマで有効になっている場合にのみコピーできます。 最初に、必要なスキーマを移動し、統合プロファイルを有効にする必要があります。
顧客データプラットフォーム
スキーマ
同意およびガバナンス用の既存のラベルは、同じインポートジョブでコピーされます。 「統合プロファイル」オプションが有効になっていないスキーマを柔軟にインポートできます。 スキーマ関係のエッジケースはパッケージには含まれていません。
顧客データプラットフォーム
データセット
データセットは、統合プロファイル設定がデフォルトで無効の状態でコピーされます。
顧客データプラットフォーム
同意およびガバナンスポリシー
ユーザーが作成したカスタムポリシーをパッケージに追加し、サンドボックス間で移動します。

次のオブジェクトが読み込まれますが、ステータスがドラフトまたは無効です。

機能
オブジェクト
ステータス
インポートステータス
Sourceのデータフロー
ドラフト
インポートステータス
ジャーニー
ドラフト
統合プロファイル
データセット
統合プロファイルが無効
ポリシー
データガバナンスポリシー
無効

Adobe Journey Optimizer オブジェクト abobe-journey-optimizer-objects

サンドボックスツール Adobe Journey Optimizer 制限で現在サポートされているオブジェクトを次の表に示します。

Platform
オブジェクト
詳細
Adobe Journey Optimizer
オーディエンス
オーディエンスは、ジャーニーオブジェクトの依存オブジェクトとしてコピーできます。 ターゲットサンドボックスで、「新しいオーディエンスを作成」を選択するか、既存のオーディエンスを再利用できます。
Adobe Journey Optimizer
スキーマ
ジャーニーで使用されるスキーマは、依存オブジェクトとしてコピーできます。 ターゲットサンドボックスで「新しいスキーマを作成」を選択するか、既存のスキーマを再利用できます。
Adobe Journey Optimizer
結合ポリシー
ジャーニーで使用される結合ポリシーは、依存オブジェクトとしてコピーできます。 ターゲットサンドボックスでは、新しい結合ポリシーを作成 できません 既存の結合ポリシーのみを利用できます。
Adobe Journey Optimizer
ジャーニー - キャンバスの詳細
キャンバス上のジャーニーの表示域には、条件、アクション、イベント、オーディエンスを読み取りなど、コピーされたジャーニー内のオブジェクトが含まれます。 ジャンプアクティビティは、コピーから除外されます。
Adobe Journey Optimizer
イベント
ジャーニーで使用されるイベントとイベントの詳細がコピーされます。 ターゲットサンドボックスに新しいバージョンが常に作成されます。
Adobe Journey Optimizer
アクション
ジャーニーで使用されるメールおよびプッシュメッセージは、依存オブジェクトとしてコピーできます。 ジャーニーフィールドで使用されるチャネルアクションアクティビティ(メッセージ内のパーソナライゼーションに使用される)が完全かどうかはチェックされません。 コンテンツブロックはコピーされません。

ジャーニーで使用される「プロファイルを更新」アクションをコピーできます。 ジャーニーで使用されるカスタムアクションとアクションの詳細もコピーされます。 ターゲットサンドボックスに新しいバージョンが常に作成されます。
Adobe Journey Optimizer
ジャーニー
ジャーニー全体をパッケージに追加すると、オーディエンス、スキーマ、イベント、アクションなど、ジャーニーが依存するオブジェクトの大部分がコピーされます。
Adobe Journey Optimizer
コンテンツテンプレート
コンテンツテンプレートは、ジャーニーオブジェクトの依存オブジェクトとしてコピーできます。 スタンドアロンテンプレートを使用すると、Journey Optimizer キャンペーンおよびジャーニー全体でカスタムコンテンツを簡単に再利用できます。
Adobe Journey Optimizer
フラグメント
フラグメントは、ジャーニーオブジェクトの依存オブジェクトとしてコピーできます。 フラグメントは、Journey Optimizer キャンペーンおよびジャーニー全体で 1 つ以上のメールで参照できる再利用可能なコンポーネントです。

サーフェス(プリセットなど)はコピーされません。 メッセージタイプとサーフェス名に基づいて、最も近いものが宛先サンドボックスで自動的に選択されます。 ターゲットのサンドボックスでサーフェスが見つからない場合、サーフェスのコピーが失敗します。その結果、メッセージを設定するためにサーフェスを使用する必要があるので、メッセージのコピーが失敗します。 この場合、コピーを機能させるには、メッセージの適切なチャネル用に少なくとも 1 つのサーフェスを作成する必要があります。

カスタム ID タイプは、ジャーニーを書き出す際に依存オブジェクトとしてサポートされません。

パッケージへのオブジェクトの書き出し export-objects

NOTE
すべてのエクスポートアクションが監査ログに記録されます。
NOTE
オブジェクトにアクセスする権限がある場合にのみ、パッケージを読み込むことができます。

この例では、スキーマを書き出してパッケージに追加するプロセスを説明します。 データセットやジャーニーなど、他のオブジェクトも同じ手順で書き出すことができます。

新しいパッケージにオブジェクトを追加 add-object-to-new-package

左側のナビゲーションから スキーマ を選択し、「参照」タブを選択すると、使用可能なスキーマが一覧表示されます。 次に、選択したスキーマの横にある省略記号(...)を選択すると、ドロップダウンにコントロールが表示されます。 ドロップダウンから パッケージに追加 を選択します。

「パッケージに追加 コントロールをハイライト表示したドロップダウンメニューを表示するスキーマ リスト。

パッケージに追加 ダイアログで 新しいパッケージを作成 オプションを選択します。 パッケージの ​ 名前 ​ とオプションの ​ 説明 ​ を入力し、「追加」を選択します。

パッケージに追加 ダイアログで 新規パッケージを作成 が選択され、 追加 がハイライト表示されている様子

スキーマ 環境に戻ります。 次の手順に従って、作成したパッケージにオブジェクトを追加できるようになりました。

既存のパッケージにオブジェクトを追加して公開 add-object-to-existing-package

使用可能なスキーマのリストを表示するには、左側のナビゲーションから スキーマ を選択し、「参照 タブを選択します。 次に、選択したスキーマの横にある省略記号(...)を選択して、ドロップダウンメニューにコントロールオプションを表示します。 ドロップダウンから パッケージに追加 を選択します。

「パッケージに追加 コントロールをハイライト表示したドロップダウンメニューを表示するスキーマ リスト。

パッケージに追加 ダイアログが表示されます。 「既存のパッケージ」オプションを選択し、「パッケージ名」ドロップダウンを選択して、必要なパッケージを選択します。 最後に「追加」をクリックして、選択を確定します。

パッケージに追加 ダイアログに、ドロップダウンから選択したパッケージが表示されます。

パッケージに追加されたオブジェクトのリストが表示されます。 パッケージを公開し、サンドボックスに読み込めるようにするには、「Publish」を選択します。

パッケージ内のオブジェクトのリスト。「Publish」オプションがハイライト表示されています。

Publish」を選択して、パッケージの公開を確定します。

Publish パッケージの確認ダイアログ、「Publish」オプションがハイライト表示されます。

NOTE
公開すると、パッケージのコンテンツを変更できなくなります。 互換性の問題を回避するには、必要なアセットがすべて選択されていることを確認します。 変更が必要な場合は、新規パッケージを作成する必要があります。

​ サンドボックス ​ 環境の「パッケージ」タブに戻ると、新しく公開されたパッケージを確認できます。

新しく公開されたパッケージを強調表示したサンドボックスパッケージのリスト。

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

NOTE
すべてのインポートアクションは監査ログに記録されます。

パッケージをターゲットサンドボックスに読み込むには、「サンドボックス 参照」タブに移動し、サンドボックス名の横にあるプラス(+)オプションを選択します。

読み込みパッケージの選択がハイライト表示されたサンドボックス 「参照 タブ

ドロップダウンメニューを使用して、ターゲットサンドボックスに読み込む パッケージ名 を選択します。 今後の監視に使用される ジョブ名 を追加します。 デフォルトでは、パッケージのスキーマが読み込まれると、統合プロファイルは無効になります。 プロファイルのスキーマを有効にする を切り替えて有効にし、「次へ を選択します。

パッケージ名 ドロップダウン選択を表示する読み込みの詳細ページ

​ パッケージオブジェクトと依存関係 ​ ページには、このパッケージに含まれるすべてのアセットのリストが表示されます。 選択した親オブジェクトのインポートに必要な依存オブジェクトが自動的に検出されます。 見つからない属性は、ページの上部に表示されます。 詳細な分類を表示するには、「詳細を表示」を選択します。

パッケージオブジェクトと依存関係 ページに属性が見つかりません。

NOTE
依存オブジェクトは、ターゲットサンドボックス内の既存のオブジェクトに置き換えることができます。これにより、新しいバージョンを作成するのではなく、既存のオブジェクトを再利用できます。 例えば、スキーマを含むパッケージを読み込む場合、既存のカスタムフィールドグループと ID 名前空間をターゲットサンドボックスで再利用できます。 または、ジャーニーを含むパッケージを読み込む際に、ターゲットサンドボックス内の既存のセグメントを再利用できます。
サンドボックスツールは、現在、既存のオブジェクトの更新または上書きをサポートしていません。 新しいオブジェクトを作成するか、変更せずに既存のオブジェクトを使用し続けることができます。

既存のオブジェクトを使用するには、依存オブジェクトの横にある鉛筆アイコンを選択します。

パッケージオブジェクトと依存関係 ページには、パッケージに含まれるアセットのリストが表示されます

新規作成または既存のものを使用するためのオプションが表示されます。 既存のものを使用 を選択します。

![ 依存オブジェクトオプション ] 新規作成 ​ および ​ 既存のものを使用 ​ を表示する ​ パッケージオブジェクトと依存関係 ​ ページ ​

フィールドグループ ダイアログには、オブジェクトで使用可能なフィールドグループのリストが表示されます。 必要なフィールドグループを選択し、「保存」を選択します。

フィールドグループ ダイアログに表示される、 保存 選択をハイライト表示したフィールドのリスト。

「​ パッケージオブジェクトと依存関係 ​」ページに戻ります。 ここから「完了」を選択して、パッケージの読み込みを完了します。

パッケージオブジェクトと依存関係 ページには、パッケージに含まれるアセットのリストが表示され、 完了 が強調表示されます。

サンドボックス全体の書き出しと読み込み

NOTE
現在、サンドボックス全体の書き出しまたは読み込みを行う場合は、Real-time Customer Data Platform オブジェクトのみがサポートされています。 ジャーニーなどのAdobe Journey Optimizer オブジェクトは現時点ではサポートされていません。

サポートされているすべてのオブジェクトタイプを完全なサンドボックスパッケージに書き出し、様々なサンドボックスからこのパッケージを読み込んでオブジェクト設定をレプリケートできます。 例えば、この機能を使用すると、次のことが可能です。

  • サンドボックスをリセットする必要がある場合は、サンドボックスを再読み込みして、オブジェクトのすべての設定を再現します
  • パッケージを他のサンドボックスに読み込み、ブループリントサンドボックスとして使用して、開発プロセスを高速化します。

サンドボックス全体の書き出し export-entire-sandbox

サンドボックス全体を書き出すには、「​ サンドボックス ​ パッケージ」タブに移動し、「パッケージを作成」を選択します。

パッケージを作成 を強調表示した サンドボックス パッケージ タブ .

パッケージを作成 ダイアログで、​ パッケージのタイプ ​ に対して ​ サンドボックス全体 ​ を選択します。 新しいパッケージの ​ パッケージ名 ​ を指定し、ドロップダウンから サンドボックス を選択します。 最後に、「作成 を選択して、エントリを確認します。

![ 完了したフィールドとハイライト表示された ] 作成 ​ を示す ​ パッケージを作成 ​ ダイアログ ​

パッケージが正常に作成されたら、「Publish」を選択してパッケージを公開します。

新しく公開されたパッケージを強調表示したサンドボックスパッケージのリスト。

​ サンドボックス ​ 環境の「パッケージ」タブに戻ると、新しく公開されたパッケージを確認できます。

サンドボックスパッケージ全体を読み込みます import-entire-sandbox-package

NOTE
すべてのオブジェクトが、新しいオブジェクトとしてターゲットサンドボックスに読み込まれます。 完全なサンドボックスパッケージを空のサンドボックスに読み込むことをお勧めします。

パッケージをターゲットサンドボックスに読み込むには、「​ サンドボックス ​​ 参照」タブに移動し、サンドボックス名の横にあるプラス(+) オプションを選択します。

読み込みパッケージの選択がハイライト表示されたサンドボックス 「参照 タブ

ドロップダウンメニューを使用し、「パッケージ名 ドロップダウンを使用して、完全なサンドボックスを選択します。 今後の監視に使用する ジョブ名 とオプションの ジョブの説明 を追加し、「次へ」を選択します。

パッケージ名 ドロップダウン選択を表示する読み込みの詳細ページ

NOTE
パッケージに含まれるすべてのオブジェクトに対する完全な権限が必要です。 権限がない場合、読み込み操作は失敗し、エラーメッセージが表示されます。

​ パッケージオブジェクトと依存関係 ​ ページが開き、インポートされたオブジェクトと除外されたオブジェクトの数と依存関係を確認できます。 ここから 読み込み を選択して、パッケージの読み込みを完了します。

パッケージオブジェクトと依存関係 ページに、サポートされていないオブジェクトタイプのインラインメッセージが表示され、 インポート が強調表示されます。

読み込みが完了するまでしばらく待ちます。 完了までの時間は、パッケージ内のオブジェクトの数によって異なる場合があります。 「​ サンドボックス ​ ジョブ」タブで読み込みジョブを監視できます。

読み込みの詳細を監視 view-import-details

読み込んだ詳細を表示するには、「​ サンドボックス ​​ ジョブ」タブに移動し、リストからパッケージを選択します。 または、検索バーを使用してパッケージを検索します。

「サンドボックス ジョブ 」タブでは、読み込みパッケージの選択がハイライト表示されます。

サンドボックス環境の ジョブ タブにある右側の詳細パネルから 読み込みの概要を表示 を選択します。

サンドボックス 「インポート 」タブの右側のペインにある インポートの詳細を表示 選択がハイライト表示されます。

読み込みの概要 ダイアログには、読み込みの分類が進行状況とともにパーセンテージで表示されます。

NOTE
特定のインベントリページに移動すると、オブジェクトのリストを表示できます。

インポートの詳細な分類を表示する インポートの詳細 ダイアログ

読み込みが完了すると、Platform UI に通知が届きます。 これらの通知には、アラート アイコンからアクセスできます。 ジョブが失敗した場合は、ここからトラブルシューティングに移動できます。

ビデオチュートリアル

次のビデオは、サンドボックスツールに関する理解を深めるために、新しいパッケージの作成、パッケージの公開、パッケージの読み込み方法の概要を説明しています。

次の手順

このドキュメントでは、Experience PlatformUI 内でサンドボックスツール機能を使用する方法について説明しました。 サンドボックスについて詳しくは、『 サンドボックスユーザーガイド』を参照してください。

サンドボックス API を使用して様々な操作を実行する手順については、サンドボックス開発者ガイドを参照してください。Experience Platformのサンドボックスの概要については、 概要ドキュメントを参照してください。

recommendation-more-help
e243ad8f-a318-46b3-9930-159a80f82b42