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