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의 모든 상태 메시지를 반복하여 추가 오류 정보를 검색하는 것이 좋습니다.