サンドボックスツール
サンドボックスツール機能を使用するには、次の 2 つの役割ベースのアクセス制御権限が必要です：
-
manage-sandbox または view-sandbox-
manage-packageサンドボックス間の設定精度を向上させ、サンドボックスツール機能を使用して、サンドボックス間でサンドボックス設定をシームレスに書き出し、読み込みます。 サンドボックスツールを使用すると、実装プロセスの価値創出までの時間を短縮し、複数のサンドボックスをまたいで正常な設定を移行できます。
サンドボックスツール機能を使用して、様々なオブジェクトを選択し、それらをパッケージに書き出すことができます。 パッケージは、1 つのオブジェクトまたは複数のオブジェクトで構成できます。 パッケージに含まれるオブジェクトは、同じサンドボックスからのオブジェクトである必要があります。
サンドボックスツールでサポートされるオブジェクト supported-objects
サンドボックス ツール機能を使用すると、 Adobe Real-Time Customer Data Platform オブジェクトと Adobe Journey Optimizer オブジェクトをパッケージにエクスポートできます。
リアルタイムの顧客データPlatformオブジェクト real-time-cdp-objects
複数エンティティオーディエンスインポートの変更
B2B アーキテクチャのアップグレードにより、B2B属性とエクスペリエンスイベントを含むパッケージがアップグレード前に公開された場合、複数エンティティオーディエンスをインポートできなくなります。これらのオーディエンスはインポートに失敗し、新しいアーキテクチャに自動的に変換されません。
この制限を回避するには、更新されたオーディエンスを含む新しいパッケージを作成し、サンドボックスツールを使用してそれぞれのターゲットサンドボックスにインポートする必要があります。
次の表に Adobe Real-Time Customer Data Platform サンドボックス ツールで現在サポートされているオブジェクトを示します。
- ソースアカウント資格情報は、セキュリティ上の理由から、ターゲットサンドボックスでレプリケートされず、手動で更新する必要があります。
- デフォルトでは、ソースデータフローはドラフトステータスでコピーされます。
メモ： 現在、サンドボックスツールは、バッチベースのソースデータフローのみをサポートしています。 ストリーミングベースのソースデータフローはサポートされていません。
- Customer Audience タイプの Segmentation service のみがサポートされます。
- 同意およびガバナンス用の既存のラベルは、同じインポートジョブでコピーされます。
- システムは、結合ポリシーの依存関係を確認する際に、同じ XDM クラスを持つターゲットサンドボックスのデフォルトの結合ポリシーを自動的に選択します。
- オーディエンスの読み込み時に同じ名前の既存のオブジェクトが検出された場合、オブジェクトの拡散を避けるために、サンドボックスツールは常に既存のオブジェクトを再利用します。
- ターゲットサンドボックスでを作成する場合、Adobeの標準 ID 名前空間の重複が自動的に排除されます。
- オーディエンスは、オーディエンスルールのすべての属性が結合スキーマで有効になっている場合にのみコピーできます。 最初に、必要なスキーマを移動し、統合プロファイルを有効にする必要があります。
- 同意およびガバナンス用の既存のラベルは、同じインポートジョブでコピーされます。
- 「統合プロファイル」オプションを有効にせずに、スキーマを柔軟にインポートできます。 スキーマ関係のエッジケースはパッケージには含まれていません。
- スキーマ/フィールドグループの読み込み時に同じ名前の既存のオブジェクトが検出された場合、オブジェクトの拡散を避けるために、サンドボックスツールは常に既存のオブジェクトを再利用します。
次のオブジェクトが読み込まれますが、ステータスがドラフトまたは無効です。
Adobe Systems Journey Optimizer オブジェクト abobe-journey-optimizer-objects
次の表に Adobe Journey Optimizer サンドボックス ツールで現在サポートされているオブジェクトと制限事項を示します。
ジャーニーで使用される次のオブジェクトは、依存オブジェクトとしてコピーされます。 読み込みワークフロー時に、それぞれについて Create new または Use existing を選択できます。
- オーディエンス
- キャンバスの詳細
- コンテンツテンプレート
- カスタムアクション
- データソース
- イベント
- フィールドグループ
- フラグメント
- スキーマ
システムは、ジャーニーで使用されるイベントとイベントの詳細をコピーし、ターゲットサンドボックスに新しいバージョンを作成します。
ジャーニーで使用される「プロファイルを更新」アクションをコピーできます。 カスタムアクションは、パッケージに個別に追加できます。 ジャーニーで使用されるアクションの詳細もコピーされます。 ターゲットサンドボックスに新しいバージョンが常に作成されます。
カスタムアクションは、パッケージに個別に追加できます。 カスタムアクションをジャーニーに割り当てると、そのカスタムアクションを編集できなくなります。 カスタムアクションを更新するには、次の手順を実行します。
- ジャーニーの移行前にカスタムアクションを移動
- 移行投稿カスタムアクションの設定(リクエストヘッダー、クエリパラメーター、認証など)を更新する
- 最初の手順で追加したカスタムアクションを使用して、ジャーニーオブジェクトを移行します
キャンペーンで使用される以下のオブジェクトは、従属オブジェクトとしてコピーされます。
- キャンペーン
- オーディエンス
- スキーマ
- コンテンツテンプレート
- フラグメント
- メッセージ / コンテンツ
- チャネル設定
- 統合決定オブジェクト
- 実験の設定/バリアント
- キャンペーンは、プロファイル、オーディエンス、スキーマ、インラインメッセージおよび依存オブジェクトに関連するすべての項目と共にコピーできます。 データ使用ラベルや言語設定など、一部の項目はコピーされません。 コピーできないオブジェクトの完全なリストについては、 別のサンドボックスへのオブジェクトの書き出し ガイドを参照してください。
- 同じ設定が存在する場合、システムはターゲットサンドボックスで既存のチャネル設定オブジェクトを自動的に検出して再利用します。 一致する設定が見つからない場合、チャネル設定は読み込み時にスキップされ、ユーザーはこのジャーニーのターゲットサンドボックスのチャネル設定を手動で更新する必要があります。
- ユーザーは、ターゲットサンドボックス内の既存の実験とオーディエンスを、選択したキャンペーンの依存オブジェクトとして再利用できます。
Decisioning オブジェクトをコピーする前に、以下のオブジェクトがコピー先サンドボックスに存在する必要があります。
- プロフィール属性Decisioning オブジェクト全体で使用される
- カスタムオファー属性のフィールドグループ
- ルール、ランキングまたはキャップをまたいだコンテキスト属性に使用されるデータストリームのスキーマ。
- AI モデルを使用するランキング式のコピーは、現在サポートされていません。
- 決定項目（オファー項目）は、自動的には含まれません。 確実に転送されるようにするには、「パッケージに追加 オプションを使用して手動で追加し す。
- 選択戦略を使用するポリシーでは、関連する決定項目をコピープロセス中に手動で追加する必要があります。 手動またはフォールバックの決定項目を使用するポリシーでは、これらの項目が直接依存関係として自動的に含まれます。
- 決定アイテムは、他の関連オブジェクトの前に最初にコピーする必要があります。
プロフィール属性Decisioning オブジェクト全体で使用されます。
カスタムオファー属性のフィールドグループ
ルール、ランキング、またはキャッピングにわたるコンテキスト属性に使用されるデータストリームのスキーマ。
サーフェス(プリセットなど)はコピーされません。 システムは、メッセージの種類とサーフェス名に基づいて、宛先サンドボックスで可能な限り最も近い一致を自動的に選択します。 ターゲット サンドボックスにサーフェスが見つからない場合、サーフェスのコピーは失敗し、メッセージではセットアップに使用できるサーフェスが必要であるため、メッセージのコピーが失敗します。 この場合、コピーが機能するには、メッセージの右チャネル用に少なくとも 1 つのサーフェスを作成する必要があります。
特例文字 ID タイプは、ジャーニーをエクスポートするときに依存オブジェクトとしてサポートされません。
パッケージへのオブジェクトの書き出し export-objects
この例では、スキーマを書き出してパッケージに追加するプロセスを説明します。 データセットやジャーニーなど、他のオブジェクトも同じ手順で書き出すことができます。
新しいパッケージにオブジェクトを追加 add-object-to-new-package
左側のナビゲーションから「Schemas」を選択し、「Browse」タブを選択すると、使用可能なスキーマが一覧表示されます。 次に、選択したスキーマの横にある省略記号（...）を選択すると、ドロップダウンにコントロールが表示されます。 ドロップダウンから「Add to package」を選択します。
Add to package ダイアログで、「Create new package」オプションを選択します。 パッケージの Name とオプションの Description を指定し、「Add」を選択します。
Schemas 環境に戻ります。 次の手順に従って、作成したパッケージにオブジェクトを追加できるようになりました。
既存のパッケージにオブジェクトを追加して公開 add-object-to-existing-package
使用可能なスキーマのリスト表示には、左側のナビゲーションから [ Schemas ] を選択し、 Browse タブを選択します。 次へ、選択したスキーマの横にある省略記号(...)を選択して、ドロップダウンメニューにコントロールオプションを表示します。 ドロップダウンから Add to package を選択します。
Add to packageダイアログが表示されます。[ Existing package ] オプションを選択し、 Package name ドロップダウンを選択して、必要なパッケージを選択します。 最後に、[ Add ] を選択して選択内容を確認します。
パッケージに追加されたオブジェクトのリストが表示されます。 パッケージを公開するしてサンドボックスにインポートできるようにするには、[ Publish] を選択します。
パッケージの公開を確定する Publish を選択します。
Packages 環境の「Sandboxes」タブに戻ると、新しく公開されたパッケージを確認できます。
ターゲットサンドボックスへのパッケージの読み込み import-package-to-target-sandbox
パッケージをターゲットサンドボックスに読み込むには、「サンドボックス Browse」タブに移動し、サンドボックス名の横にあるプラス（+） オプションを選択します。
ドロップダウンメニューを使用して、ターゲットサンドボックスに読み込む Package name を選択します。 Job name を追加します。これは、今後の監視に使用されます。 デフォルトでは、パッケージのスキーマが読み込まれると、統合プロファイルは無効になります。 プロファイルのスキーマを有効にする を切り替えて有効にし、Next を選択します。
Package object and dependencies ページ は、このパッケージに含まれるすべてのアセットリストを提供します。選択した親オブジェクトのインポートに必要な依存オブジェクトが自動的に検出されます。 不足している属性は、ページの上部に表示されます。 View detailsを選択すると、より詳細な分類が表示されます。
既存のオブジェクトを使用するには、依存オブジェクトの横にある鉛筆アイコンを選択します。
新規作成または既存のものを使用するためのオプションが表示されます。 Use existing を選択します。
Field groupダイアログには、オブジェクトで使用可能な項目グループのリストが表示されます。必要なフィールド グループを選択し、[ Save] を選択します。
Package object and dependenciesページに戻ります。ここから、[ Finish ] を選択してパッケージのインポートを完了します。
サンドボックス全体の書き出しおよびインポート
サポートされているすべてのオブジェクトタイプを完全なサンドボックスパッケージに書き出し、様々なサンドボックスからこのパッケージを読み込んでオブジェクト設定をレプリケートできます。 例えば、この機能を使用すると、次のことが可能です。
- サンドボックスをリセットする必要がある場合は、サンドボックスを再読み込みして、オブジェクトのすべての設定を再現します
- パッケージを他のサンドボックスに読み込み、ブループリントサンドボックスとして使用して、開発プロセスを高速化します。
サンドボックス全体の書き出し export-entire-sandbox
サンドボックス全体を書き出すには、「Sandboxes Packages」タブに移動し、「Create package」を選択します。
Entire sandbox ダイアログで、Type of package の Create package を選択します。 新しいパッケージの Package name を指定し、ドロップダウンから Sandbox を選択します。 最後に、「Create」を選択してエントリを確認します。
パッケージが正常に作成されたら、「Publish」を選択してパッケージを公開します。
Packages 環境の「Sandboxes」タブに戻ると、新しく公開されたパッケージを確認できます。
サンドボックスパッケージ全体を読み込みます import-entire-sandbox-package
パッケージをターゲットサンドボックスに読み込むには、「Sandboxes Browse」タブに移動し、サンドボックス名の横にあるプラス（+） オプションを選択します。
ドロップダウンメニューを使用し、「Package name」ドロップダウンを使用して「完全なサンドボックス」を選択します。 今後の監視に使用する Job name とオプションの Job description を追加し、「Next」を選択します。
Package object and dependenciesページが表示され、インポートされたオブジェクトと除外されたオブジェクトの数と依存関係を確認できます。ここから、[ Import ] を選択してパッケージのインポートを完了します。
インポートが完了するまでしばらく待ちます。 完了までの時間は、パッケージ内のオブジェクトの数によって異なります。 読み込みジョブは Sandboxes Jobs タブから監視できます。
インポートの詳細の監視 view-import-details
インポートした詳細表示には、 Sandboxes Jobs タブに移動し、リストからパッケージを選択します。 または、検索バーを使用してパッケージを検索します。
サンドボックス環境の「View import summary」タブで、右側の詳細パネルから「Jobs」を選択します。
Import summary ダイアログには、読み込みの分類が進行状況とともにパーセンテージで表示されます。
読み込みが完了すると、Experience Platform UI に通知が届きます。 これらの通知には、アラート アイコンからアクセスできます。 ジョブが失敗した場合は、ここからトラブルシューティングに移動できます。
サンドボックスツールを使用して、サンドボックス間で反復的なオブジェクト設定の更新を転送する move-configs
サンドボックスツールを使用して、異なるサンドボックス間でオブジェクト設定を転送できます。 以前は、オブジェクト（スキーマ、フィールドグループ、データタイプなど）の設定の更新を他のサンドボックスに転送するために、手動で再作成または再読み込みする必要がありました。 この機能を使用すると、サンドボックスツールを使用して、異なるサンドボックス間で設定の更新をシームレスに転送することで、ワークフローを高速化し、潜在的なエラーを減らすことができます。
- サンドボックス ツールにアクセスするための適切なアクセス許可。
- ソースサンドボックスで新しく作成または更新されたオブジェクト (スキーマ など)。
更新操作でサポートされているオブジェクトタイプ
更新でサポートされているオブジェクトの種類は次のとおりです。
- スキーマ
- フィールドグループ
- データタイプ
- 新しいフィールド/フィールドグループをリソースに追加します。
- 必須フィールドをオプションにします。
- 新しい必須フィールドの導入。
- 新しい関係フィールドの導入
- 新しい ID フィールドの導入
- リソースの表示名と説明を変更する。
- 以前定義したフィールドを削除しています。
- リアルタイム顧客プロファイルに対してスキーマが有効な場合の既存フィールドの再定義。
- 以前サポートされていたフィールド値を削除または制限しています。
- 既存のフィールドをスキーマツリーの別の場所に移動する – これにより、ターゲットサンドボックスに新しいフィールドが作成されますが、以前のフィールドは削除されません。
- プロファイルに参加するスキーマを有効または無効にする – この操作は差分比較でスキップされます。
- アクセス制御ラベル
次の手順に従って、サンドボックスツールを使用して、異なるサンドボックス間でオブジェクト設定を転送する方法を学習します。
以前インポートしたオブジェクト
既にパッケージ化されて他のサンドボックスに読み込まれた後、設定の更新が必要なソースサンドボックス内の既存のオブジェクトがユースケースに含まれている場合は、次の手順に従います。
まず、ソースサンドボックスのオブジェクトを更新します。 例えば、Schemas ワークスペースに移動し、スキーマを選択して、新しいフィールドグループを追加します。
スキーマを更新したら、Sandboxes に移動し、Packages を選択して、既存のパッケージを見つけます。
パッケージインターフェイスを使用して、変更を検証します。 「Check for updates」を選択すると、パッケージ内のアーティファクトに対する変更が表示されます。 次に、「View diff」を選択して、アーティファクトに対して実行されたすべての変更の詳細な概要を受け取ります。
View diff インターフェイスが表示されます。 ソースアーティファクトとターゲットアーティファクト、およびそれらに適用される変更については、この料金を参照してください。
この手順では、Summarize with AI を選択して、すべての変更の概要を段階的に確認することもできます。
準備ができたら、「Update package」を選択し、表示されるポップアップウィンドウで「Confirm」を選択します。 ジョブが完了したら、ページを更新し、「View history」を選択してパッケージのバージョンを確認できます。
変更をインポートするには、 Packages ディレクトリに戻り、パッケージの横にある省略記号 (...) を選択して、[ Import package] を選択します。 Experience Platformは Update existing objectsを自動選択します。 変更を確認し、[ Finish] を選択します。
インポートプロセスをさらに検証するには、ターゲット サンドボックスに移動し、そのサンドボックス内から更新されたオブジェクトを手動で表示します。
サンドボックスに手動で作成されたオブジェクト ターゲット
ユースケースで、個別のサンドボックスに手動で作成されたオブジェクトに設定変更を適用する場合は、次の手順に従います。
まず、更新したオブジェクトで新しいパッケージを作成し、公開するします。
次へ、更新するオブジェクトを含む ターゲット サンドボックスにパッケージをインポートします。 読み込みプロセス中に、[ Update existing objects ] を選択し、オブジェクト ナビゲーターを使用して、更新を適用するターゲットオブジェクトを手動で選択します。
- 依存オブジェクト用に別のサンドボックス内のターゲットマッピングを選択するのはオプションです。 何も選択されていない場合は、新しく作成されます。
- ID 名前空間の場合、既存の ID をターゲットサンドボックスで再利用する必要がある場合、システムは新しい ID を作成する必要があるかどうかを自動検出します。
更新するターゲット・オブジェクトを特定したら、「Finish」を選択します。
ビデオチュートリアル
次のビデオは、サンドボックス ツールの理解をサポートすることを目的としており、新しいパッケージの作成、パッケージ公開する、およびパッケージのインポート方法の概要を説明しています。
次の手順
このドキュメントでは、Experience Platform UI 内でサンドボックスツール機能を使用する方法について説明しました。 サンドボックスについて詳しくは、『 サンドボックスユーザーガイド 』を参照してください。
サンドボックス API を使用して様々な操作を実行する手順については、サンドボックス開発者ガイドを参照してください。Experience Platformのサンドボックスの概要については、 概要ドキュメント を参照してください。