샌드박스 도구
샌드박스 도구 기능을 사용하려면 다음 두 가지 역할 기반 액세스 제어 권한이 필요합니다.
-
manage-sandbox
또는 view-sandbox
-
manage-package
샌드박스 간 구성 정확도를 높이고 샌드박스 도구 기능을 사용하여 샌드박스 간에 샌드박스 구성을 원활하게 내보내고 가져올 수 있습니다. 샌드박스 도구를 사용하여 구현 프로세스에 대한 가치 창출 시간을 줄이고 샌드박스 간에 성공적인 구성을 이동할 수 있습니다.
샌드박스 도구 기능을 사용하여 다른 개체를 선택하고 패키지로 내보낼 수 있습니다. 패키지는 단일 개체 또는 여러 개체로 구성될 수 있습니다. 패키지에 포함된 개체는 같은 샌드박스에 있어야 합니다.
샌드박스 도구에 지원되는 오브젝트 supported-objects
샌드박스 도구 기능을 사용하면 Adobe Real-Time Customer Data Platform 및 Adobe Journey Optimizer 개체를 패키지로 내보낼 수 있습니다.
실시간 고객 데이터 플랫폼 개체 real-time-cdp-objects
다중 엔티티 대상자 가져오기 변경 사항
B2B 아키텍처 업그레이드를 통해 B2B 특성 및 Experience 이벤트를 사용하는 다중 엔터티 대상자를 업그레이드 전에 이러한 대상자를 포함한 패키지가 게시되면 더 이상 가져올 수 없습니다. 이러한 대상은 가져오지 못하며 자동으로 새 아키텍처로 변환될 수 없습니다.
이 제한을 해결하려면 업데이트된 대상으로 새 패키지를 만든 다음 샌드박스 도구를 사용하여 해당 대상 샌드박스로 가져와야 합니다.
아래 표에는 현재 샌드박스 도구에 지원되는 Adobe Real-Time Customer Data Platform개 개체가 나열되어 있습니다.
- 소스 계정 자격 증명은 보안상의 이유로 타겟 샌드박스에서 복제되지 않으며 수동으로 업데이트해야 합니다.
- 소스 데이터 흐름은 기본적으로 초안 상태로 복사됩니다.
- 고객 대상 유형 세그먼테이션 서비스 만 지원됩니다.
- 동의 및 거버넌스에 대한 기존 레이블은 동일한 가져오기 작업에서 복사됩니다.
- 병합 정책 종속성을 확인할 때 시스템에서 동일한 XDM 클래스가 있는 대상 샌드박스의 기본 병합 정책을 자동으로 선택합니다.
- 대상을 가져올 때 이름이 같은 기존 개체가 검색되는 경우 샌드박스 툴은 개체 증식을 방지하기 위해 항상 기존 개체를 재사용합니다.
- 타겟 샌드박스에서 을(를) 만들 때 Adobe 표준 ID 네임스페이스에 대한 자동 중복 제거가 수행됩니다.
- 대상 규칙의 모든 속성이 유니온 스키마에서 활성화된 경우에만 대상을 복사할 수 있습니다. 통합 프로필에 대해 필요한 스키마를 먼저 이동하고 활성화해야 합니다.
- 동의 및 거버넌스에 대한 기존 레이블은 동일한 가져오기 작업에서 복사됩니다.
- 통합 프로필 옵션을 활성화하지 않고도 스키마를 유연하게 가져올 수 있습니다. 스키마 관계 에지 케이스는 패키지에 포함되지 않습니다.
- 스키마/필드 그룹을 가져올 때 이름이 동일한 기존 객체가 검색되는 경우 샌드박스 툴은 객체 확산을 방지하기 위해 항상 기존 객체를 재사용합니다.
다음 객체를 가져오지만 초안 또는 비활성화 상태입니다.
Adobe Journey Optimizer 개체 abobe-journey-optimizer-objects
아래 표에는 현재 샌드박스 도구 및 제한 사항에 지원되는 Adobe Journey Optimizer개 개체가 나열되어 있습니다.
여정에 사용된 다음 객체는 종속 객체로 복사됩니다. 가져오기 작업 과정에서 각각에 대해 새로 만들기 또는 기존 항목 사용 을 선택할 수 있습니다.
- 대상자
- 캔버스 세부 정보
- 콘텐츠 템플릿
- 사용자 정의 액션
- 데이터 소스
- 이벤트
- 필드 그룹
- 조각
- 스키마
여정에 사용된 이벤트와 이벤트 세부 정보를 복사하고 대상 샌드박스에 새 버전을 만듭니다.
여정에 사용된 프로필 업데이트 작업을 복사할 수 있습니다. 사용자 지정 작업은 패키지에 개별적으로 추가할 수 있습니다. 여정에 사용된 작업 세부 정보도 복사됩니다. 대상 샌드박스에서 항상 새 버전이 생성됩니다.
사용자 지정 작업은 패키지에 개별적으로 추가할 수 있습니다. 사용자 지정 작업이 여정에 할당되면 더 이상 편집할 수 없습니다. 사용자 지정 작업을 업데이트하려면 다음을 수행해야 합니다.
- 여정 마이그레이션 전에 사용자 지정 작업 이동
- 마이그레이션 후 사용자 지정 작업에 대한 구성(예: 요청 헤더, 쿼리 매개 변수 및 인증) 업데이트
- 첫 번째 단계에서 추가한 사용자 지정 작업으로 여정 개체 마이그레이션
캠페인에 사용된 다음 객체는 종속 객체로 복사됩니다.
- 캠페인
- 대상자
- 스키마
- 콘텐츠 템플릿
- 조각
- 메시지/컨텐츠
- 채널 구성
- 통합 의사 결정 개체
- 실험 설정/변형
- 프로필, 대상자, 스키마, 인라인 메시지 및 종속 오브젝트와 관련된 모든 항목과 함께 캠페인을 복사할 수 있습니다. 데이터 사용 레이블 및 언어 설정과 같은 일부 항목은 복사되지 않습니다. 복사할 수 없는 전체 개체 목록은 다른 샌드박스로 개체 내보내기 안내서를 참조하십시오.
- 시스템은 동일한 구성이 존재하는 경우 타겟 샌드박스에서 기존 채널 구성 객체를 자동으로 감지하고 재사용합니다. 일치하는 구성을 찾을 수 없으면 가져오는 동안 채널 구성을 건너뛰며 사용자가 이 여정에 대한 대상 샌드박스의 채널 설정을 수동으로 업데이트해야 합니다.
- 사용자는 Target 샌드박스의 기존 실험 및 대상을 선택한 캠페인의 종속 오브젝트로 재사용할 수 있습니다.
Decisioning 객체를 복사하기 전에 다음 객체가 대상 샌드박스에 있어야 합니다.
- Decisioning 개체 전체에 사용된 프로필 속성
- 사용자 정의 오퍼 속성의 필드 그룹
- 규칙, 등급 또는 캡핑에 대한 컨텍스트 속성에 사용되는 데이터 스트림의 스키마.
- AI 모델을 사용하는 등급 수식 복사는 현재 지원되지 않습니다.
- 결정 항목(오퍼 항목)은 자동으로 포함되지 않습니다. 전송되었는지 확인하려면 패키지에 추가 옵션을 사용하여 수동으로 추가하십시오.
- 선택 전략을 사용하는 정책에서는 복사 프로세스 중에 관련 결정 항목을 수동으로 추가해야 합니다. 수동 또는 대체 결정 항목을 사용하는 정책에는 해당 항목이 직접 종속성으로 자동으로 포함됩니다.
- 의사 결정 항목을 다른 관련 객체 앞에 먼저 복사해야 합니다.
Decisioning 객체 전체에 사용된 프로필 속성
사용자 정의 오퍼 속성의 필드 그룹,
규칙, 등급 또는 캡핑에 대한 컨텍스트 속성에 사용되는 데이터 스트림의 스키마.
서피스(예: 사전 설정)는 복사되지 않습니다. 시스템은 메시지 유형 및 표면 이름을 기반으로 대상 샌드박스에서 가장 가까운 일치 항목을 자동으로 선택합니다. 대상 샌드박스에 서피스가 없는 경우 서피스 복사가 실패하여 메시지에 설정할 수 있는 서피스가 필요하므로 메시지 복사가 실패합니다. 이 경우 복사가 작동하려면 메시지의 오른쪽 채널에 대해 적어도 하나의 서피스를 만들어야 합니다.
사용자 지정 ID 유형은 여정을 내보낼 때 종속 개체로 지원되지 않습니다.
패키지로 오브젝트 내보내기 export-objects
이 예제에서는 스키마를 내보내고 패키지에 추가하는 프로세스를 설명합니다. 동일한 프로세스를 사용하여 데이터 세트, 여정 등과 같은 다른 객체를 내보낼 수 있습니다.
새 패키지에 개체 추가 add-object-to-new-package
왼쪽 탐색에서 스키마 을(를) 선택한 다음 사용 가능한 스키마를 나열하는 찾아보기 탭을 선택합니다. 선택한 스키마 옆의 생략 부호(...
)를 선택하면 드롭다운에 컨트롤이 표시됩니다. 드롭다운에서 패키지에 추가 를 선택합니다.
패키지에 추가 대화 상자에서 새 패키지 만들기 옵션을 선택합니다. 패키지의 이름과(와) 선택적 설명을(를) 입력한 다음 추가 를 선택하십시오.
스키마 환경으로 돌아갔습니다. 이제 아래 나열된 다음 단계를 수행하여 만든 패키지에 개체를 추가할 수 있습니다.
기존 패키지에 개체 추가 및 게시 add-object-to-existing-package
사용 가능한 스키마 목록을 보려면 왼쪽 탐색에서 스키마 을(를) 선택한 다음 찾아보기 탭을 선택하십시오. 그런 다음 선택한 스키마 옆의 생략 부호(...
)를 선택하여 드롭다운 메뉴에서 제어 옵션을 확인합니다. 드롭다운에서 패키지에 추가 를 선택합니다.
패키지에 추가 대화 상자가 나타납니다. 기존 패키지 옵션을 선택한 다음 패키지 이름 드롭다운을 선택하고 필요한 패키지를 선택합니다. 마지막으로 추가 를 선택하여 선택 항목을 확인합니다.
드롭다운에서 선택한 패키지를 표시하는
패키지에 추가된 오브젝트 목록이 나열됩니다. 패키지를 게시하여 샌드박스로 가져올 수 있도록 하려면 게시 를 선택하십시오.
패키지 게시를 확인하려면 게시 를 선택하십시오.
샌드박스 환경의 패키지 탭으로 돌아가서 새로 게시된 패키지를 볼 수 있습니다.
대상 샌드박스로 패키지 가져오기 import-package-to-target-sandbox
패키지를 대상 샌드박스로 가져오려면 샌드박스 찾아보기 탭으로 이동하여 샌드박스 이름 옆에 있는 더하기(+) 옵션을 선택합니다.
드롭다운 메뉴를 사용하여 타겟팅된 샌드박스로 가져올 패키지 이름 을(를) 선택합니다. 향후 모니터링에 사용할 작업 이름 을(를) 추가합니다. 기본적으로 통합 프로필은 패키지의 스키마를 가져올 때 비활성화됩니다. 프로필에 대해 스키마 활성화 를 전환하여 활성화한 다음 다음 을 선택합니다.
패키지 개체 및 종속성 페이지에서 이 패키지에 포함된 모든 자산의 목록을 제공합니다. 시스템은 선택한 상위 객체를 성공적으로 가져오는 데 필요한 종속 객체를 자동으로 검색합니다. 누락된 속성은 페이지 맨 위에 표시됩니다. 자세한 분류를 보려면 세부 정보 보기 를 선택하십시오.
기존 개체를 사용하려면 종속 개체 옆에 있는 연필 아이콘을 선택합니다.
새로 만들거나 기존 항목을 사용하는 옵션이 표시됩니다. 기존 사용 을 선택합니다.
필드 그룹 대화 상자에 개체에 사용할 수 있는 필드 그룹 목록이 표시됩니다. 필요한 필드 그룹을 선택한 다음 저장 을 선택합니다.
패키지 개체 및 종속성 페이지로 돌아왔습니다. 여기에서 완료 를 선택하여 패키지 가져오기를 완료합니다.
전체 샌드박스 내보내기 및 가져오기
지원되는 모든 오브젝트 유형을 전체 샌드박스 패키지로 내보낸 다음 다양한 샌드박스에서 패키지를 가져와 오브젝트 구성을 복제할 수 있습니다. 예를 들어 이 기능을 사용하여 다음을 수행할 수 있습니다.
- 샌드박스를 재가져와서 샌드박스를 재설정해야 하는 경우 객체의 모든 구성을 재현합니다
- 패키지를 다른 샌드박스로 가져와 블루프린트 샌드박스로 활용하여 개발 프로세스를 가속화합니다.
전체 샌드박스 내보내기 export-entire-sandbox
전체 샌드박스를 내보내려면 샌드박스 패키지 탭으로 이동하여 패키지 만들기 를 선택합니다.
패키지 만들기 대화 상자에서 패키지 유형에 대한 전체 샌드박스를 선택합니다. 새 패키지에 패키지 이름을 제공하고 드롭다운에서 샌드박스 를 선택합니다. 마지막으로 만들기 를 선택하여 항목을 확인합니다.
패키지가 생성되었습니다. 패키지를 게시하려면 게시 를 선택하십시오.
샌드박스 환경의 패키지 탭으로 돌아가서 새로 게시된 패키지를 볼 수 있습니다.
전체 샌드박스 패키지 가져오기 import-entire-sandbox-package
패키지를 대상 샌드박스로 가져오려면 샌드박스 찾아보기 탭으로 이동하여 샌드박스 이름 옆에 있는 더하기(+) 옵션을 선택합니다.
드롭다운 메뉴를 사용하여 패키지 이름 드롭다운을 사용하여 전체 샌드박스를 선택합니다. 향후 모니터링에 사용할 작업 이름 과(와) 선택적 작업 설명 을(를) 추가한 다음 다음 을(를) 선택하십시오.
가져온 개체와 제외된 개체의 수를 볼 수 있는 패키지 개체 및 종속성 페이지로 이동합니다. 여기에서 가져오기 를 선택하여 패키지 가져오기를 완료합니다.
가져오기가 완료될 때까지 잠시 기다립니다. 완료 시간은 패키지에 있는 객체의 수에 따라 달라질 수 있습니다. 샌드박스 작업 탭에서 가져오기 작업을 모니터링할 수 있습니다.
가져오기 세부 정보 모니터링 view-import-details
가져온 세부 정보를 보려면 샌드박스 작업 탭으로 이동하여 목록에서 패키지를 선택하십시오. 또는 검색 창을 사용하여 패키지를 검색합니다.
샌드박스 환경의 작업 탭에 있는 오른쪽 세부 정보 창에서 가져오기 요약 보기 를 선택합니다.
가져오기 요약 대화 상자에 진행 중인 가져오기의 분류가 백분율로 표시됩니다.
가져오기가 완료되면 Experience Platform UI에서 알림이 수신됩니다. 경고 아이콘에서 이러한 알림에 액세스할 수 있습니다. 작업이 실패한 경우 여기에서 문제 해결로 이동할 수 있습니다.
샌드박스 도구 를 통해 샌드박스 간에 반복적인 오브젝트 구성 업데이트 전송 move-configs
샌드박스 도구 를 사용하여 다른 샌드박스 간에 개체 구성을 전송할 수 있습니다. 이전에는 개체(예: 스키마, 필드 그룹 및 데이터 유형)에 대한 구성 업데이트를 수동으로 다시 만들거나 다시 가져와야 다른 샌드박스로 전송할 수 있었습니다. 이 기능을 사용하면 샌드박스 도구 를 사용하여 여러 샌드박스 간에 구성 업데이트를 원활하게 전송하여 워크플로를 가속화하고 잠재적인 오류를 줄일 수 있습니다.
- 샌드박스 도구에 액세스하기 위한 적절한 권한.
- 소스 샌드박스에서 새로 생성되거나 업데이트된 객체(예: 스키마)입니다.
업데이트 작업에 지원되는 개체 유형
다음은 업데이트에 지원되는 개체 유형입니다.
- 스키마
- 필드 그룹
- 데이터 유형
- 리소스에 새 필드/필드 그룹 추가.
- 필수 필드를 선택 사항으로 설정.
- 새 필수 필드를 도입합니다.
- 새 관계 필드 소개.
- 새 ID 필드를 도입합니다.
- 리소스의 표시 이름 및 설명 변경.
- 이전에 정의한 필드를 제거하는 중입니다.
- 실시간 고객 프로필에 대해 스키마가 활성화된 경우 기존 필드를 재정의합니다.
- 이전에 지원되는 필드 값을 제거하거나 제한합니다.
- 기존 필드를 스키마 트리의 다른 위치로 이동 - 대상 샌드박스에 새 필드가 생성되지만 이전 필드는 제거되지 않습니다.
- 프로필에 참여할 스키마를 활성화하거나 비활성화합니다. 비교 시 이 작업은 건너뜁니다.
- 액세스 제어 레이블.
샌드박스 도구를 사용하여 다양한 샌드박스 간에 개체 구성을 전송하는 방법을 배우려면 아래 단계를 따르십시오.
이전에 가져온 오브젝트
사용 사례에 구성 업데이트가 필요한 소스 샌드박스의 기존 오브젝트가 포함되어 있는 경우, 이미 다른 샌드박스로 패키지화되어 가져온 다음 다음 단계를 따릅니다.
먼저 소스 샌드박스에서 객체를 업데이트합니다. 예를 들어 스키마 작업 영역으로 이동하여 스키마를 선택하고 새 필드 그룹을 추가합니다.
스키마를 업데이트했으면 샌드박스(으)로 이동하여 패키지 를 선택한 다음 기존 패키지를 찾습니다.
패키지 인터페이스를 사용하여 변경 사항을 확인합니다. 패키지에 있는 아티팩트에 대한 변경 내용을 보려면 업데이트 확인 을 선택하세요. 그런 다음 차이점 보기 를 선택하여 아티팩트에 대해 수행된 모든 변경 내용에 대한 자세한 요약을 받습니다.
차이점 보기 인터페이스가 나타납니다. 소스 및 타겟 아티팩트에 대한 정보와 해당 아티팩트에 적용할 변경 사항에 대해서는 이 요금을 참조하십시오.
이 단계에서는 모든 변경 사항에 대한 단계별 요약을 위해 AI로 요약을 선택할 수도 있습니다.
준비가 되면 패키지 업데이트 를 선택한 다음 표시되는 팝업 창에서 확인 을 선택합니다. 작업이 완료되면 페이지를 새로 고치고 내역 보기 를 선택하여 패키지 버전을 확인할 수 있습니다.
변경 사항을 가져오려면 패키지 디렉터리로 돌아가서 패키지 옆의 생략 부호(...
)를 선택한 다음 패키지 가져오기 를 선택합니다. Experience Platform이 기존 개체 업데이트를 자동으로 선택합니다. 변경 내용을 확인한 다음 마침 을 선택합니다.
가져오기 프로세스의 유효성을 추가로 검사하려면 대상 샌드박스로 이동하고 해당 샌드박스 내에서 업데이트된 개체를 수동으로 확인합니다.
Target 샌드박스에서 수동으로 생성된 오브젝트
사용 사례에 별도의 샌드박스에서 수동으로 만든 객체에 구성 변경 사항을 적용하는 것이 포함된 경우 다음 단계를 수행합니다.
먼저 업데이트된 오브젝트로 새 패키지를 만들어 게시합니다.
그런 다음 업데이트하려는 개체가 포함된 대상 샌드박스로 패키지를 가져옵니다. 가져오기 프로세스 중에 기존 개체 업데이트 를 선택한 다음 개체 탐색기를 사용하여 업데이트를 적용할 대상 개체를 수동으로 선택합니다.
- 종속 객체에 대해 다른 샌드박스에서 대상 매핑을 선택하는 것은 선택 사항입니다. 아무 것도 선택하지 않으면 새 항목이 만들어집니다.
- ID 네임스페이스의 경우 시스템은 기존 ID를 대상 샌드박스에서 재사용해야 하는 경우 새 ID를 만들어야 하는지 자동으로 감지합니다.
업데이트할 대상 개체를 식별했으면 마침 을 선택합니다.
비디오 튜토리얼
다음 비디오에서는 샌드박스 도구에 대한 이해를 돕기 위해 새 패키지를 만들고, 패키지를 게시하고, 패키지를 가져오는 방법을 간략하게 설명합니다.
다음 단계
이 문서에서는 Experience Platform UI 내에서 샌드박스 도구 기능을 사용하는 방법을 보여 줍니다. 샌드박스에 대한 자세한 내용은 샌드박스 사용 안내서를 참조하십시오.
샌드박스 API를 사용하여 다른 작업을 수행하는 단계는 샌드박스 개발자 안내서를 참조하십시오. Experience Platform의 샌드박스에 대한 높은 수준의 개요는 개요 설명서를 참조하십시오.