AdGroupCriterion.listing_group
또는
AssetGroupListingGroupFilter의 컨텍스트에서 등록정보 그룹 필터로 작업할 때는 통합을 설계할 때 다음 사항을 고려하세요.
일괄 분할
광고그룹 기준 또는 애셋 그룹 등록정보 그룹 필터가 포함된 일괄 작업이 있는 경우 Google Ads API 서버에서 수신할 때 일괄 작업의 작업이 여러 하위 일괄 로 분할됩니다. 일괄 작업의 표준 작업과 달리 등록정보 그룹 필터 작업이 포함된 각 하위 일괄은 원자적으로 처리됩니다.
등록정보 그룹 필터가 포함된 일괄 작업이 하위 일괄로 분할되는 방식은 다음 요소에 따라 결정됩니다.
- 등록정보 그룹 필터 유형
AdGroupCriterion또는AssetGroup등록정보 그룹 필터가 타겟팅하는- 작업 순서
작업이 그룹화되는 방식을 고려하세요.
- 동일한
AssetGroup을 타겟팅하는 모든 연속AssetGroupListingGroupFilterOperation작업은 원자적 하위 일괄로 그룹화됩니다 (부분 실패 동작 없음). - 동일한
AdGroup을 타겟팅하는listing_group이 포함된 모든 연속AdGroupCriterionOperation작업은 원자적 하위 일괄로 그룹화됩니다 (부분 실패 동작 없음). - 기타 모든 연속 작업은 비원자적 하위 일괄로 그룹화됩니다 (부분 실패 동작).
이 개념에 대해서는 다음 다이어그램을 참조하세요. 각 회색 상자는 Google Ads API를 사용하여 제출된 일괄 작업을 나타냅니다. 회색 상자 내에서 개별 작업은 Google Ads API 서버에서 만드는 하위 일괄을 나타내기 위해 색상별로 그룹화됩니다. 각 회색 상자의 작업 순서는 작업이 일괄 작업에 추가되었을 순서에 해당합니다.
제한사항
일괄 작업의 컨텍스트에서 등록정보 그룹 필터로 작업할 때는 다음 제한사항이 적용됩니다.
-
listing_group이 포함되고 동일한AdGroup을 타겟팅하는AdGroupCriterionOperation작업의 단일 일괄은 길이가 20,000 작업을 초과할 수 없습니다. 하지만 10,000개의 작업을 초과하지 않는 것이 좋습니다. - 동일한
AssetGroup을 타겟팅하는AssetGroupListingGroupFilterOperation작업의 단일 일괄은 10,000개의 작업을 초과할 수 없습니다. - 이러한 조건을 위반하면 전체 일괄 작업이 실패합니다.
문제 해결
일괄 작업의 등록정보 그룹 필터 작업은 하나의 트랜잭션으로 처리되므로 소수의 잘못된 작업으로 인해 많은 작업이 실패하는 시나리오가 발생할 수 있습니다. 또한 BatchJob 작업이 처리되는 방식 때문에 실패의 근본 원인이 다운스트림 실패 전후의 색인에 나타날 수 있습니다.
예를 들어 ListBatchJobResults의 응답을 처리할 때 여러
작업이 상태 메시지 Ad group is invalid due to the listing
groups it contains와 함께 실패하는 것을 확인할 수 있습니다. 이 메시지는 일반적으로 다른 색인에서 작업이 실패했기 때문에 이 색인의 작업이 취소되었음을 나타냅니다. 문제의 근본 원인을 파악하려면 추가 오류 정보를 검색하기 위해 Ad group is invalid 오류 메시지의 색인 전후에 있는 BatchJobResult의 모든 상태
메시지를 반복하는 것이 좋습니다.