기준

타겟팅 기준은 다음 세 가지 수준에서 설정할 수 있습니다.

• 캠페인 수준
• 광고 그룹 수준
• 고객 수준

일부 기준 유형은 모든 수준에서 설정할 수 없습니다. 예를 들어 일부는 캠페인 수준에서만 설정할 수 있습니다. 또한 일부 기준은 제외 타겟팅에만 사용할 수 있고 일부는 포함 타겟팅에만 사용할 수 있습니다.

수준별 지원되는 기준

다음 표에서는 모든 기준 유형의 허용된 사용량을 설명합니다.

버전 차이

지원되는 Google Ads API 버전 간에 여러 기준 유형과 유효성 검사 동작이 다릅니다.

• v25 이상: AdGroupCriterion에서 EntityBid (entity_bid) 기준을 지원하며, 기준 유형 VERTICAL_ADS_ITEM_BID을 사용하여 세로형 광고의 여행 항목에 대한 항목 수준 입찰가를 설정합니다.
• v24 이상:
  • 태그 기반 제품 필터링(허용 목록에 추가된 계정만 해당)을 위해 RetailFilterBundle (AdGroupCriterion.retail_filter_bundle 및 AssetGroupListingGroupFilter.Dimension.retail_filter_bundle) 및 RetailFilter (SharedCriterion.retail_filter)을 지원합니다.
  • SharedCriterion에서 VerticalAdsItemGroupRuleInfo의 user_rating, venue, event_participant_display_name 규칙 측정기준을 지원합니다.
  • 실적 최대화 캠페인 애셋 그룹 신호에 AssetGroupSignal.local_services_id 및 AssetGroupSignal.vertical_ads_item_group_rule_list (허용 목록에 추가됨)를 지원합니다.
  • 인구통계 측정기준 (AgeRangeInfo, GenderInfo, IncomeRangeInfo 또는 ParentalStatusInfo) 내의 모든 타겟을 제외하려고 하면 CriterionError.CANNOT_EXCLUDE_ALL_TARGETS이 반환됩니다.
  • 허용되지 않는 언어를 타겟팅하려고 하면 CriterionError.CANNOT_TARGET_LANGUAGE를 반환합니다.
  • 지역 서비스 실적 최대화 캠페인에서 모든 위치를 삭제하려고 할 때 CampaignCriterionError.CANNOT_REMOVE_ALL_LOCATIONS_FROM_LOCAL_SERVICES_PMAX_CAMPAIGN를 반환합니다.

잠재고객 정보 타겟팅 기준

AdGroupCriterion.audience에서 AudienceInfo 기준을 사용하여 광고 그룹 수준에서 잠재고객을 타겟팅할 수 있습니다. ad_group_criterion.audience.audience을 타겟팅하려는 Audience의 리소스 이름으로 설정합니다. AdGroupCriterion에서 AudienceInfo 기준을 사용하려면 광고 그룹을 만들 때 ad_group.audience_setting.use_audience_grouped = true를 설정해야 합니다 (이 설정은 생성 후 변경할 수 없음). 캠페인을 만들 때 선택적으로 campaign.audience_setting.use_audience_grouped = true를 설정하여 캠페인 수준에서 세그먼트 및 인구통계 제외를 방지할 수도 있습니다.

audience_id에 대해 MutateAudienceResult 검사

AudienceService.MutateAudiences로 잠재고객을 만들면 각 작업에서 MutateAudienceResult이 반환됩니다. MutateAudienceResult를 검사하여 반환된 resource_name를 파싱하여 audience_id를 가져올 수 있으며, response_content_type가 MUTABLE_RESOURCE로 설정된 경우 반환된 audience 객체에서 변경 가능한 필드 (예: name)를 검사할 수 있습니다.

# Inspect MutateAudienceResult to get audience_id.
for result in response.results:
    resource_name = result.resource_name
    # Format: customers/{customer_id}/audiences/{audience_id}
    audience_id = audience_service.parse_audience_path(resource_name)[
        "audience_id"
    ]
    print(f"Created audience '{resource_name}' with ID '{audience_id}'.")

    # Access mutable fields on result.audience when MUTABLE_RESOURCE is requested.
    if result.audience.resource_name:
        print(f"Audience name from mutable resource: {result.audience.name}")