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