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

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

일괄 분할

핵심 사항: 동일한 AssetGroup을 타겟팅하는 AssetGroupListingGroupFilterOperation 작업(create, update, remove)과 동일한 AdGroup을 타겟팅하는 LISTING_GROUP 기준 (AdGroupCriterion.listing_group)의 AdGroupCriterionOperation 작업 (create, update, remove)을 일괄 작업에 연속적으로 추가하여 일괄 분할 중에 작업 집합이 원자적으로 처리되도록 하는 것이 좋습니다.

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

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

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

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

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

참고: 동일한 일괄 작업에서 AssetGroup도 만드는 경우 새 Asset 리소스의 필수 AssetOperation (create) 작업을 AssetGroupOperation (create) 앞에 배치하고 바로 뒤에 AssetGroupAssetOperation (create) 작업 (이전 원자적 하위 일괄에서 함께 실행됨)을 배치한 다음 연속 AssetGroupListingGroupFilterOperation 작업 (다음 원자적 하위 일괄에서 실행됨)을 배치합니다. 이러한 항목은 두 개의 별도 하위 일괄 처리를 형성하므로 AssetGroupListingGroupFilterOperation 하위 일괄 처리의 실패로 인해 새로 생성된 AssetGroup 및 AssetGroupAsset 리소스가 롤백되지 않고 상품 그룹 필터가 롤백됩니다.

주요 용어: 연속은 일괄 작업의 작업 순서를 나타냅니다. 동일한 AdGroup 또는 AssetGroup을 타겟팅하는 작업이 다른 그룹을 타겟팅하는 작업과 인터리브되면 별도의 하위 배치로 분할되어 더 이상 단일 원자 트랜잭션으로 처리되지 않습니다.

이 개념에 대해서는 다음 다이어그램을 참조하세요. 회색 상자는 각각 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 요청 2개 이상에 걸쳐 업로드해야 합니다.
• 동일한 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로 인해 실패할 수 있습니다.

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