일괄 처리는 작업이 완료될 때까지 동기식으로 대기하지 않고도 상호 종속될 수 있는 일련의 작업을 여러 서비스에 전달하는 방법을 제공합니다. 일괄 처리를 사용하여 실적 최대화 캠페인을 만들고 관리할 수 있습니다.
이 가이드에서는 일괄 처리를 사용할 때 실적 최대화 캠페인과 관련된 세부정보를 제공합니다. 일반 일괄 처리 가이드에서는 일괄 처리에 관한 일반적인 정보를 제공하며, 요청 구조 가이드에는 실적 최대화 캠페인을 만들거나 관리하기 위한 요청 구성에 관한 자세한 정보가 포함되어 있습니다.
일괄 처리를 사용하여 실적 최대화 캠페인을 만드는 방법은 다음과 같습니다.
새 일괄 작업 만들기
BatchJob 리소스를 만들려면 일반적인 일괄 처리 작업 생성 단계를 따르세요.
변형 작업 목록 준비
실적 최대화 캠페인을 운영하려면 여러 관련 리소스를 만들어야 합니다. 요청 구조 가이드에서 자세히 알아보세요. 일괄 작업에 포함해야 하는 각 리소스에 대해 MutateOperation를 만듭니다.
CampaignOperation 및 CampaignAssetOperation 요구사항
캠페인에 브랜드 가이드라인이 사용 설정된 경우 (브랜드 가이드라인 참고) CampaignAsset 리소스를 사용하여 브랜드 애셋을 캠페인에 연결해야 합니다. 또한 일괄 작업에서 이러한 CampaignAsset 리소스는 Campaign 리소스 자체가 생성된 직후에 생성되어야 합니다. CampaignAsset 리소스가 Campaign 리소스 직후에 즉시 생성되지 않으면 (브랜드 가이드라인이 사용 설정된 경우 - 문제 해결 참고) 요청이 실패하고 누락된 애셋을 나타내는 CampaignError이 반환됩니다.
나중에 동일한 작업 목록에 CampaignAsset 생성 작업을 포함해도 이 오류가 방지되지 않습니다.
AssetGroupOperation 및 AssetGroupAssetOperation 요구사항
배치 작업에서 AssetGroup 및 AssetGroupAsset 리소스를 만드는 MutateOperation 유형의 작업은 처리될 때 이러한 작업이 함께 그룹화되는 방식으로 인해 그 사이에 다른 작업이 없어야 합니다. 그러지 않으면 최소 애셋 요구사항을 충족하는 데 필요한 작업이 나중에 작업 목록에 포함되더라도 요청에서 AssetGroupError 일부 애셋이 누락되었음을 나타내는 오류가 발생합니다.
AssetGroupListingGroupFilterOperation 권장사항
AssetGroupListingGroupFilter 컨텍스트에서 등록정보 그룹 필터를 사용할 때는 동일한 AssetGroup를 타겟팅하는 AssetGroupListingGroupFilterOperation 작업을 일괄 작업에 연속으로 추가하여 일괄 분할 중에 작업 집합이 원자적으로 처리되도록 하는 것이 좋습니다. 일괄 분할 및 등록정보 그룹에 영향을 미치는 기타 요인에 관한 자세한 내용은 등록정보 그룹 일괄 처리 가이드를 참고하세요.
작업에 변형 작업 추가
2단계의 변경 작업을 목록에 추가하고 AddBatchJobOperations를 호출하여 1단계에서 만든 일괄 작업에 변경 목록을 추가합니다.
일반 일괄 처리 가이드의 작업 추가 단계에 따라 변형 작업 목록을 추가합니다.
일괄 작업 실행
RunBatchJob를 호출하여 업로드된 작업이 실행되도록 허용합니다. 예시는 일반적인 일괄 처리 가이드의 일괄 작업 실행 단계를 참고하세요.
작업 상태 검색
일괄 작업은 장기 실행 작업으로 시작되며 일반적으로 완료하는 데 시간이 걸립니다.
작업을 시작한 후 장기 실행 작업의 GetOperation 메서드를 사용하여 작업이 완료될 때까지 작업 상태를 폴링합니다.
모든 일괄 작업이 완료되면 일반 일괄 처리 가이드의 모든 일괄 작업 결과 나열 단계에 따라 ListBatchJobResults를 호출하여 상태와 응답을 출력합니다.