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