일괄 작업에서 등록정보 그룹 필터 사용하기

등록정보 그룹 필터로 작업할 때는 AdGroupCriterion.listing_group 또는 AssetGroupListingGroupFilter의 컨텍스트에서 통합을 설계할 때 다음 사항을 고려하세요.

일괄 분할

일괄 작업에 광고 그룹 기준 또는 애셋 그룹 목록 그룹 필터가 포함된 작업이 있는 경우 일괄 작업의 작업은 Google Ads API 서버에서 수신될 때 여러 하위 일괄 작업 으로 분할됩니다. 일괄 작업의 표준 작업과 달리 목록 그룹 필터 작업이 포함된 각 하위 일괄 작업은 원자적으로 처리됩니다.

등록정보 그룹 필터가 포함된 일괄 작업이 하위 일괄 작업으로 분할되는 방식은 다음 요소에 따라 결정됩니다.

1. 등록정보 그룹 필터 유형
2. 목록 그룹 필터가 타겟팅하는 AdGroup 또는 AssetGroup
3. 작업 순서

작업이 그룹화되는 방식을 고려하세요.

• 동일한 AssetGroup을 타겟팅하는 모든 연속 AssetGroupListingGroupFilterOperation 작업 (create, update, remove)은 원자적 하위 일괄 작업으로 함께 그룹화됩니다 (부분 실패 동작 없음).
• 동일한 AdGroup을 타겟팅하는 LISTING_GROUP 기준 (AdGroupCriterion.listing_group) 의 모든 연속 AdGroupCriterionOperation 작업 (create, update, remove)은 원자적 하위 일괄 작업으로 함께 그룹화됩니다 (부분 실패 동작 없음).
• 기타 모든 연속 작업은 비원자적 하위 일괄 작업으로 함께 그룹화됩니다 (부분 실패 동작).

이 개념에 대해서는 다음 다이어그램을 참조하세요. 각 회색 상자는 Google Ads API를 사용하여 제출된 일괄 작업을 나타냅니다. 회색 상자 내에서 개별 작업은 Google Ads API 서버에서 만드는 하위 일괄 작업을 나타내기 위해 색상별로 그룹화됩니다. 각 회색 상자의 작업 순서는 작업이 일괄 작업에 추가되었을 순서에 해당합니다.

제한사항

일괄 작업의 컨텍스트에서 등록정보 그룹 필터로 작업할 때는 다음 제한사항이 적용됩니다.

• 동일한 AdGroup을 타겟팅하는 LISTING_GROUP 기준 (AdGroupCriterion.listing_group)의 연속 AdGroupCriterionOperation 작업(create, update, remove)의 단일 원자적 하위 일괄 작업은 길이가 20,000개의 작업을 초과할 수 없습니다. 하지만 10,000개의 작업을 초과하지 않는 것이 좋습니다. 각 AddBatchJobOperationsRequest는 10,000개의 작업으로 제한되므로 10,001~20,000개의 작업으로 구성된 AdGroup 하위 일괄 작업은 연속된 AddBatchJobOperations 요청을 두 개 이상에 걸쳐 업로드해야 합니다.
• 동일한 AssetGroup을 타겟팅하는 연속 AssetGroupListingGroupFilterOperation 작업 (create, update, remove)의 단일 원자적 하위 일괄 작업은 10,000개의 작업을 초과할 수 없습니다.
• 이러한 작업 수 제한 중 하나를 위반하거나 단일 하위 일괄 작업의 서버 내부 직렬화된 바이트 크기 제한을 초과하면 해당 하위 일괄 작업에서 일괄 작업이 중단됩니다. 이미 완료된 이전 하위 일괄 작업은 커밋된 상태로 유지되는 반면 문제가 있는 하위 일괄 작업과 후속 하위 일괄 작업의 모든 작업은 InternalError.INTERNAL_ERROR로 실패합니다.

문제 해결

일괄 작업의 등록정보 그룹 필터 작업은 하나의 트랜잭션으로 처리되므로 소수의 잘못된 작업으로 인해 많은 작업이 실패하는 시나리오가 발생할 수 있습니다. 또한 BatchJob 작업이 처리되는 방식 때문에 실패의 근본 원인이 색인 전후의 다운스트림 실패에 표시될 수 있습니다.

예를 들어 ListBatchJobResults의 응답을 처리할 때 다음을 수행합니다.

• AdGroupCriterionOperation 등록정보 그룹의 경우 동일한 AdGroup을 타겟팅하는 연속 작업이 CriterionError.LISTING_GROUP_ERROR_IN_ANOTHER_OPERATION (Product group operations are atomic within the same ad group. This operation failed because another operation targeting the same ad group ID was invalid.)으로 실패할 수 있습니다.
• AssetGroupListingGroupFilterOperation 작업의 경우 동일한 AssetGroup을 타겟팅하는 연속 작업이 BatchJobError.ASSET_GROUP_LISTING_GROUP_FILTER_TRANSACTION_FAILURE로 실패할 수 있습니다.

이러한 오류는 동일한 원자적 하위 일괄 작업의 다른 작업이 실패했기 때문에 해당 색인의 작업이 롤백되었음을 나타냅니다. 문제의 근본 원인을 파악하려면 트랜잭션 오류의 operation_index 전후에 각 BatchJobResult의 status 메시지를 동일한 AdGroup 또는 AssetGroup ID를 공유하는 작업에 대해 반복합니다.