1월 29일 오전 10시(EST)에 Google 광고 및 측정 커뮤니티 서버의 Discord와 YouTube에서 라이브로 참여하세요. Google Ads API v23에 추가된 새로운 기능에 대해 설명합니다.

세로형 광고의 관리 및 인벤토리 필터링

분야별 광고는 호텔과 같은 분야 피드에 연결된 AI Max 지원 검색 캠페인을 위한 전문 기능을 제공합니다. 광고 그룹 수준에서 게재되는 업종 광고 형식을 관리할 수 있으며, 업종 광고 항목 그룹 규칙을 사용하여 타겟팅되는 피드 항목을 관리할 수 있습니다.

개요

이 가이드에서는 세로형 광고 관리를 위한 두 가지 주요 기능을 다룹니다.

형식 관리: 광고 그룹 수준에서 특정 광고 형식 (텍스트 광고, 예약 링크, 세로형 프로모션 광고)을 선택하거나 선택 해제합니다.
세로형 광고 항목 관리: SharedSet andSharedCriterion`이 포함된 규칙 기반 시스템을 사용하여 연결된 세로형 (이전 명칭: 여행) 피드의 특정 인벤토리를 필터링하고 타겟팅합니다.

기본 요건

이러한 기능을 구현하기 전에 캠페인이 다음 요구사항을 충족하는지 확인하세요.

캠페인 유형: 검색 캠페인이어야 합니다.
업종 피드: 사용 중인 업종 데이터 피드가 캠페인에 연결되어 있어야 합니다.
AI Max: 캠페인에서 'AI Max' 설정을 사용 설정해야 합니다.

광고 그룹 형식 관리

이제 특정 광고 그룹에 대해 활성화할 카테고리 광고 형식을 구성할 수 있습니다. 이 값은 AdGroup 리소스의 vertical_ads_format_setting 필드를 통해 관리됩니다.

사용 가능한 형식

텍스트 광고: 기본적으로 사용 설정됩니다. 사용 중지할 수 있습니다.
예약 링크: 선택이 필요합니다.
업종별 프로모션 광고: 선택이 필요합니다.

유효성 검사 규칙

하나의 광고 그룹에 대해 세 가지 형식을 동시에 선택 해제할 수는 없습니다.
이 설정은 STANDARD 및 SEARCH_DYNAMIC_ADS 광고 그룹 유형에만 적용됩니다.

예: 형식 설정 업데이트

다음 예에서는 기존 광고 그룹에 대해 텍스트 광고를 사용 중지하고 세로 프로모션 광고를 사용 설정하는 방법을 보여줍니다.

자바

// Assuming 'adGroup' is an existing AdGroup object.
AdGroup adGroupToUpdate = AdGroup.newBuilder()
    .setResourceName(adGroup.getResourceName()) // Example: "customers/{id}/adGroups/{id}"
    .setVerticalAdsFormatSetting(
     
   VerticalAdsFormatSetting.newBuilder()
            .setDisableTextAds(true)
            .setEnableBookingLinks(false)
            .setEnableVerticalPromotionAds(true)
    )
    .build();

AdGroupOperation operation = AdGroupOperation.newBuilder()
    .setUpdate(adGroupToUpdate)
    .setUpdateMask(FieldMasks.allSetFieldsOf(adGroupToUpdate))
    .build();

// Submit the operation using AdGroupService...

카테고리 광고 항목 관리

'보스턴의 호텔' 또는 '1성 호텔 제외'과 같은 피드 인벤토리의 특정 하위 집합을 타겟팅하려면 카테고리 광고 항목 그룹 규칙을 사용해야 합니다.

데이터 모델의 작동 방식

데이터 모델은 공유 기준 접근 방식을 사용합니다.

SharedSet: 유형이 VERTICAL_ADS_ITEM_GROUP_RULE_LIST인 SharedSet를 만듭니다.
SharedCriterion: 이 세트에 규칙 (기준)을 추가합니다. 각 규칙은 도시 또는 호텔 등급과 같은 측정기준과 값을 지정합니다. 제외할 항목을 지정하는 제외 기준을 만들 수도 있습니다.
AdGroupCriterion: AdGroupCriterion을 사용하여 SharedSet을 AdGroup에 연결합니다.

지원되는 측정기준

SharedCriterion에서 다음 측정기준을 기준으로 항목을 필터링할 수 있습니다.

item_code: 특정 등록정보 ID입니다.
city_criterion_id, region_criterion_id, country_criterion_id: 지역 타겟팅 상수입니다.
brand_text: 브랜드 이름입니다.
hotel_class: 별표 평점 (1~5)
vertical_ads_item_category: 카테고리(예: CONCERT)

코드 예시: 규칙 만들기 및 연결

이 예에서는 '보스턴' 또는 '샌프란시스코'에 있는 항목을 포함하고 '1성' 및 '2성' 호텔을 제외하는 규칙을 만듭니다.

Python

# 1. Create the SharedSet
shared_set_operation = client.get_type("SharedSetOperation")
shared_set = shared_set_operation.create
shared_set.name = "Boston/SF Premium Hotels"
shared_set.type_ = client.enums.SharedSetTypeEnum.VERTICAL_ADS_ITEM_GROUP_RULE_LISTshared_set.vertical_ads_item_vertical_type = client.enums.VerticalAdsItemVerticalTypeEnum.HOTELS
# Submit SharedSetOperation...

# 2. Add Criteria (Rules) to the SharedSet
shared_criteria_operations = []

# Rule A: Include Boston and SF
included_city_ids = [1006543, 1014221] # Geo Target Constant IDs
for city_id in included_city_ids:
    op = client.get_type("SharedCriterionOperation")
    criterion = op.create
    criterion.shared_set = shared_set_resource_name
    criterion.vertical_ads_item_group_rule.city_criterion_id = city_id
    shared_criteria_operations.append(op)

# Rule B: Exclude 1 and 2 Star Hotels
excluded_stars = [1, 2]
for star_rating in excluded_stars:
    op = client.get_type("SharedCriterionOperation")
    criterion = op.create
    criterion.shared_set = shared_set_resource_name
    criterion.vertical_ads_item_group_rule.hotel_class = star_rating
    criterion.negative = True # Mark as exclusion
    shared_criteria_operations.append(op)

# Submit SharedCriterionOperations...

# 3. Link to AdGroup
agc_operation = client.get_type("AdGroupCriterionOperation")
agc = agc_operation.create
agc.ad_group = ad_group_resource_name
agc.status = client.enums.AdGroupCriterionStatusEnum.ENABLED
agc.vertical_ads_item_group_rule_list.shared_set = shared_set_resource_name

# Submit AdGroupCriterionOperation...

보고

GoogleAdsService.SearchStream 또는 GoogleAdsService.Search 메서드를 사용하여 카테고리 광고의 실적 측정항목을 가져올 수 있습니다. Google Ads API의 경우 v23에서는 세부적인 보고를 위한 특정 세그먼트가 추가됩니다.

새 세그먼트

segments.vertical_ads_listing_city: 등록정보와 연결된 도시입니다.
segments.vertical_ads_vertical_type: 업종 유형(예: 호텔 또는 렌터카)입니다.

샘플 GAQL 쿼리

SQL

SELECT
  segments.vertical_ads_listing_city,
  metrics.clicks,
  metrics.all_conversions_value,
  metrics.impressions
FROM
  ad_group
WHERE
  segments.date DURING LAST_30_DAYS

오류 처리

다음은 세로형 광고를 구성할 때 발생할 수 있는 일반적인 오류입니다.

오류 코드	원인	권장 조치
`INVALID_VERTICAL_ADS_FORMAT_SETTING`	세 가지 광고 형식 (텍스트, 예약 링크, 프로모션 광고)이 동시에 사용 중지되었습니다.	`VerticalAdsFormatSetting`에서 하나 이상의 형식이 사용 설정 (true로 설정)되어 있는지 확인합니다.
`VERTICAL_ADS_FORMAT_SETTING_NOT_SUPPORTED_...`	캠페인에 AI Max가 사용 설정되어 있지 않거나 활성 업종 피드가 없습니다.	캠페인 설정에서 AI Max를 사용 설정하고 유효한 업종 피드가 연결되어 있는지 확인합니다.
`VERTICAL_ADS_ITEM_GROUP_RULE_LIST_DOES_NOT_EXIST`	AdGroupCriterion에 제공된 SharedSet 리소스 이름이 존재하지 않습니다.	shared_set 리소스 이름이 생성된 세트와 일치하는지 확인합니다.
`VERTICAL_ADS_ITEM_GROUP_RULE_IS_NOT_SUPPORTED...`	사용된 기준 유형이 특정 카테고리(예: 렌터카의 호텔 등급)에 지원되지 않습니다.	`vertical_ads_item_group_rule` 측정기준이 업종 유형과 일치하는지 확인합니다.