실적 최대화 캠페인의 일괄 처리

일괄 처리는 작업이 완료될 때까지 동기식으로 기다리지 않고 상호 종속될 수 있는 작업 집합을 여러 서비스에 디스패치하는 방법을 제공합니다. 일괄 처리를 사용하여 실적 최대화 캠페인을 만들고 관리할 수 있습니다.

이 가이드에서는 일괄 처리 작업을 할 때 실적 최대화 캠페인에 적용되는 세부정보를 제공합니다. 일반 일괄 처리 가이드에서는 일괄 처리에 관한 일반 정보를 제공하고 요청 구조 가이드에는 실적 최대화 캠페인을 만들거나 관리하기 위한 요청 구성에 관한 자세한 정보가 포함되어 있습니다.

일괄 처리를 사용하여 실적 최대화 캠페인을 만들려면 다음 단계를 따르세요.

새 일괄 작업 만들기

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를 호출하여 상태와 응답을 출력합니다.