サンドボックスツール

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 名前空間の重複が自動的に排除されます。 オーディエンスは、オーディエンスルールのすべての属性が結合スキーマで有効になっている場合にのみコピーできます。 最初に、必要なスキーマを移動し、統合プロファイルを有効にする必要があります。
顧客データプラットフォーム
スキーマ
同意およびガバナンス用の既存のラベルは、同じインポートジョブでコピーされます。 「統合プロファイル」オプションが有効になっていないスキーマを柔軟にインポートできます。 スキーマ関係のエッジケースはパッケージには含まれていません。
顧客データプラットフォーム
データセット
データセットは、統合プロファイル設定がデフォルトで無効の状態でコピーされます。
顧客データプラットフォーム
同意およびガバナンスポリシー
ユーザーが作成したカスタムポリシーをパッケージに追加し、サンドボックス間で移動します。

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

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

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
アクション
ジャーニーで使用されるメールおよびプッシュメッセージは、依存オブジェクトとしてコピーできます。 ジャーニーフィールドで使用されるチャネルアクションアクティビティ(メッセージ内のパーソナライゼーションに使用される)が完全かどうかはチェックされません。 コンテンツブロックはコピーされません。

ジャーニーで使用される「プロファイルを更新」アクションをコピーできます。 ジャーニーで使用されるカスタムアクションとアクションの詳細もコピーされます。 ターゲットサンドボックスに新しいバージョンが常に作成されます。

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

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

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

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

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

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

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

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

から パッケージに追加 ダイアログで、 新規パッケージを作成 オプション。 を指定 名前 (パッケージ用)とオプション 説明を選択してから、 追加.

この パッケージに追加 ~との対話 新規パッケージを作成 選択およびハイライト表示 追加.

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

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

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

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

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

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

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

パッケージ内のオブジェクトのリスト。ハイライト表示は 公開 オプション。

を選択 公開 パッケージの公開を確認します。

パッケージを公開する確認ダイアログ、ハイライト表示 公開 オプション。

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

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

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

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

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

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

サンドボックス 参照 「パッケージをインポート」の選択を強調表示するタブ。

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

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

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

この パッケージオブジェクトと依存関係 ページに、属性が見つからない問題が表示される。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

サンドボックス全体を書き出すには、に移動します サンドボックス パッケージ tab キーを押して選択 パッケージを作成.

この サンドボックス パッケージ タブのハイライト パッケージを作成.

を選択 サンドボックス全体 の場合 パッケージのタイプ が含まれる パッケージを作成 ダイアログ。 を指定 パッケージ名 新しいパッケージのを選択し、 Sandbox ドロップダウンから。 最後に、を選択します 作成 をクリックして入力を確認します。

この パッケージを作成 完了したフィールドとハイライト表示を示すダイアログ 作成.

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

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

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

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

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

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

サンドボックス 参照 「パッケージをインポート」の選択を強調表示するタブ。

ドロップダウンメニューを使用し、を使用して完全なサンドボックスを選択します パッケージ名 ドロップダウン。 を追加 ジョブ名(将来の監視に使用される)。オプション ジョブ説明 ​を選択してから、 .

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

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

に移動しました パッケージオブジェクトと依存関係 インポートおよび除外されたオブジェクトの数と依存関係を確認できるページ。 ここから選択 インポート パッケージの読み込みを完了します。

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

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

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

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

サンドボックス ジョブ タブで「パッケージをインポート」選択をハイライト表示します。

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

サンドボックス インポート タブは、 読み込みの詳細を表示 右側のペインで選択します。

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

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

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

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

ビデオチュートリアル

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

次の手順

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

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

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