검색 광고의 여행 피드

호텔, 공유숙박 또는 여행지 정보 제품 피드를 Google Ads 계정에 연결하면 Google Ads에서 피드에서 가져온 가격과 이미지를 사용하여 기존 검색 캠페인을 자동으로 보강합니다. 이 기능을 검색 광고의 여행 피드라고 합니다.

고객 설정과 캠페인 설정의 상호작용 방식

기본적으로 캠페인은 여행 피드 링크 (TRAVEL_FEED 애셋 모음)를 CustomerAssetSet 연결을 통해 고객 수준에서 상속합니다. 특정 캠페인의 고객 수준 설정을 재정의하려면 캠페인의 excluded_parent_asset_set_types 필드에 TRAVEL_FEED를 추가하고 CampaignAssetSet을 사용하여 캠페인별 링크를 관리해야 합니다.

  • 고객 피드 상속 (기본값): 고객 수준 CustomerAssetSet을 연결된 상태로 유지하고 Campaign.excluded_parent_asset_set_types에 TRAVEL_FEED가 포함되지 않도록 합니다.
  • 고객 수준에서 선택 해제: 고객 수준 CustomerAssetSet 연결을 삭제하고 캠페인 수준 CampaignAssetSet을 연결하지 않습니다.
  • 특정 캠페인 선택 해제: TRAVEL_FEED를 Campaign.excluded_parent_asset_set_types에 추가하고 캠페인 수준 CampaignAssetSet 연결을 삭제합니다.
  • 특정 캠페인만 선택: 고객 수준 CustomerAssetSet 연결을 삭제한 다음 해당 캠페인의 캠페인 수준 CampaignAssetSet 링크를 만듭니다.
  • 다른 캠페인이 계속 상속하는 동안 캠페인별 피드 사용: 캠페인의 Campaign.excluded_parent_asset_set_types에 TRAVEL_FEED를 추가하고 캠페인 수준 CampaignAssetSet 링크를 만듭니다.

검색 광고의 여행 피드 선택 해제

이 기능을 사용하지 않으려면 Google Ads API를 사용하여 고객 및 캠페인 수준에서 검색 광고의 여행 피드를 선택 해제할 수 있습니다.

고객 수준에서 선택 해제

고객 수준에서 검색 광고의 여행 피드를 선택 해제하려면 다음 단계를 따르세요.

  1. customer_asset_set 보고서를 사용하여 유형이 TRAVEL_FEED인 모든 CustomerAssetSet 링크의 customer_asset_set.resource_name과 asset_set.resource_name을 모두 가져옵니다.

    SELECT
  customer_asset_set.resource_name,
  asset_set.resource_name,
  asset_set.name
FROM customer_asset_set
WHERE asset_set.type = 'TRAVEL_FEED'

  2. 각 customer_asset_set.resource_name에 대해 CustomerAssetSetOperation을 만들고 remove을 이전 단계에서 가져온 customer_asset_set.resource_name으로 설정합니다.

  3. 만든 CustomerAssetSetOperation 객체를 사용하여 CustomerAssetSetService.MutateCustomerAssetSets 에 요청을 제출합니다.

고객 수준에서 이 기능을 다시 선택하려면 다음 단계를 따르세요.

  1. 연결할 각 기본 AssetSet (asset_set.resource_name) 에 대해 asset_set이 asset_set.resource_name으로 설정되고 customer이 고객의 리소스 이름으로 설정된 새 CustomerAssetSet을 만듭니다.
  2. 이전 단계에서 만든 각 CustomerAssetSet에 대해 CustomerAssetSetOperation가 create으로 설정된 CustomerAssetSet를 만듭니다.
  3. 만든 CustomerAssetSetOperation 객체를 사용하여 CustomerAssetSetService.MutateCustomerAssetSets 에 요청을 제출합니다.

캠페인 수준에서 선택 해제

캠페인 수준에서 검색 광고의 여행 피드를 선택 해제하려면 먼저 고객 수준에서 상속된 선택 상태를 제외해야 합니다.

  1. campaign 보고서를 사용하여 excluded_parent_asset_set_types를 가져옵니다.

    SELECT
  campaign.excluded_parent_asset_set_types
FROM campaign
WHERE campaign.id = 'INSERT_YOUR_CAMPAIGN_ID'

  2. 새 Campaign 객체를 만듭니다. 여기서 excluded_parent_asset_set_types는 이전 값 더하기 TRAVEL_FEED로 설정되고 resource_name는 캠페인의 리소스 이름으로 설정됩니다.

  3. CampaignOperation을 만들고 update를 이전에 만든 Campaign으로 설정하고 update_mask를 적절하게 설정합니다.

  4. 이전 단계에서 만든 CampaignOperation을 사용하여 CampaignService.MutateCampaigns 에 요청을 제출합니다.

그런 다음 캠페인 수준 여행 피드 연결을 삭제합니다.

  1. 선택 해제할 캠페인의 경우 campaign_asset_set.resource_name과 asset_set.resource_name을 모두 가져옵니다. 유형이 TRAVEL_FEED인 모든 CampaignAssetSet 링크의 경우 campaign_asset_set 보고서를 사용합니다.

    SELECT
  campaign_asset_set.resource_name,
  asset_set.resource_name,
  asset_set.name
FROM campaign_asset_set
WHERE campaign_asset_set.campaign =
    'INSERT_YOUR_CAMPAIGN_RESOURCE_NAME'
  AND asset_set.type = 'TRAVEL_FEED'

  2. 각 campaign_asset_set.resource_name에 대해 CampaignAssetSetOperation을 만들고 remove을 이전 단계에서 가져온 campaign_asset_set.resource_name으로 설정합니다.

  3. 만든 CampaignAssetSetOperation 객체를 사용하여 CampaignAssetSetService.MutateCampaignAssetSets 에 요청을 제출합니다.

캠페인 수준에서 이 기능을 다시 선택하려면 다음 단계를 따르세요.

  1. 선택할 각 기본 AssetSet (asset_set.resource_name) 에 대해 asset_set이 asset_set.resource_name으로 설정되고 campaign이 캠페인의 리소스 이름으로 설정된 새 CampaignAssetSet을 만듭니다.
  2. 이전 단계에서 만든 각 CampaignAssetSet에 대해 CampaignAssetSetOperation가 create로 설정된 CampaignAssetSet을 만듭니다.
  3. 만든 CampaignAssetSetOperation 객체를 사용하여 CampaignAssetSetService.MutateCampaignAssetSets 에 요청을 제출합니다.

캠페인의 고객 수준 선택 상태 복원

캠페인의 선택 상태가 고객 수준 설정을 다시 상속하도록 하려면 다음 단계를 따르세요.

  1. 목록에 excluded_parent_asset_set_types 없는 TRAVEL_FEED Campaign 객체를 만들고 resource_name을(를) 캠페인의 리소스 이름으로 설정합니다.
  2. CampaignOperation을 만들고 update를 이전에 만든 Campaign으로 설정하고 update_mask를 적절하게 설정합니다.
  3. 이전 단계에서 만든 CampaignOperation을 사용하여 CampaignService.MutateCampaigns 에 요청을 제출합니다.

항목별 수동 CPC 입찰

Google Ads API v25부터 기준 유형 CriterionType.VERTICAL_ADS_ITEM_BID (ad_group_criterion.entity_bid)가 있는 AdGroupCriterion 리소스를 사용하여 여행용 검색 캠페인의 호텔에 대해 항목별 수동 CPC 입찰 재정의를 구성할 수 있습니다.

기본 요건 및 호환성 요구사항

VERTICAL_ADS_ITEM_BID 기준을 만들고 관리하려면 다음 조건을 충족해야 합니다.

  • 캠페인 유형: 여행용 검색 캠페인 (검색 캠페인, AdvertisingChannelType.SEARCH, 검색 캠페인용 AI 최대화 사용 설정 Campaign.ai_max_setting.enable_ai_max, 연결된 호텔 피드 [TRAVEL_FEED 애셋 모음], 호텔 피드만 지원됨)
  • 입찰 전략: 수동 CPC (BiddingStrategyType.MANUAL_CPC)만 해당
    • 자동 또는 스마트 자동 입찰 전략 (예: 전환수 최대화, 전환 가치 극대화, 타겟 CPA 또는 타겟 ROAS)에서는 지원되지 않습니다.
  • 양수 기준만 해당: negative을(를) false로 설정해야 합니다. 음수 항목 입찰은 지원되지 않습니다.
  • 필수 항목 식별자 및 입찰가: entity_bid.item_code 및 cpc_bid_micros는 항목 입찰 기준을 만들 때 필요합니다.

스키마 및 필드 정의

필드 유형 행동 설명
entity_bid EntityBid IMMUTABLE 단일 항목의 수동 입찰 재정의를 나타내는 기준입니다.
entity_bid.item_code string IMMUTABLE(필수) 파트너 호텔 피드와 일치하는 특정 호텔 항목 (호텔 등록정보 ID) 을 지정하는 ID 또는 코드입니다 (1~256자, 잘림).
cpc_bid_micros int64 읽기/쓰기 마이크로 단위의 수동 CPC 입찰가입니다 (예: 1000000은 $1.00과 같음).
negative bool IMMUTABLE false여야 합니다.

지원되는 서비스 및 작업

서비스 메서드 지원되는 작업
AdGroupCriterionService MutateAdGroupCriteria create, update (cpc_bid_micros), remove
GoogleAdsService Search / SearchStream 기준 속성, 항목 코드, 입찰가 쿼리

코드 및 페이로드 예시

다음 예시에서는 VERTICAL_ADS_ITEM_BID 기준을 읽고, 만들고, 업데이트하고, 삭제하는 방법을 보여줍니다.

GAQL을 사용하여 항목 입찰가 읽기

GoogleAdsService.Search 또는 GoogleAdsService.SearchStream을 사용하여 VERTICAL_ADS_ITEM_BID 기준을 쿼리합니다.

SELECT
  ad_group_criterion.resource_name,
  ad_group_criterion.ad_group,
  ad_group_criterion.criterion_id,
  ad_group_criterion.type,
  ad_group_criterion.cpc_bid_micros,
  ad_group_criterion.entity_bid.item_code
FROM ad_group_criterion
WHERE ad_group_criterion.type = 'VERTICAL_ADS_ITEM_BID'

항목 입찰가 만들기

create 작업을 AdGroupCriterionService.MutateAdGroupCriteria로 전송합니다.

{
  "customerId": "1234567890",
  "operations": [
    {
      "create": {
        "adGroup": "customers/1234567890/adGroups/987654321",
        "negative": false,
        "cpcBidMicros": "1500000",
        "entityBid": {
          "itemCode": "hotel_nyc_12345"
        }
      }
    }
  ]
}

기존 항목 입찰가 업데이트

update 작업을 updateMask와 함께 AdGroupCriterionService.MutateAdGroupCriteria로 전송합니다.

{
  "customerId": "1234567890",
  "operations": [
    {
      "updateMask": "cpcBidMicros",
      "update": {
        "resourceName": "customers/1234567890/adGroupCriteria/987654321~555444333",
        "cpcBidMicros": "2000000"
      }
    }
  ]
}

항목 입찰가 삭제

remove 작업을 AdGroupCriterionService.MutateAdGroupCriteria로 전송합니다.

{
  "customerId": "1234567890",
  "operations": [
    {
      "remove": "customers/1234567890/adGroupCriteria/987654321~555444333"
    }
  ]
}

검사 규칙 및 오류 처리

시나리오 트리거 / 조건 반환된 오류 코드
수동 CPC 캠페인이 아닌 캠페인 자동 또는 스마트 자동 입찰이 있는 캠페인에서 항목 입찰가를 만들려고 시도합니다. ContextError.OPERATION_NOT_PERMITTED_FOR_CONTEXT
잘못된 캠페인 유형 검색 캠페인이 아닌 캠페인 (예: 디스플레이 캠페인)에 항목 입찰가를 추가합니다. ContextError.OPERATION_NOT_PERMITTED_FOR_CONTEXT
음수 기준 VERTICAL_ADS_ITEM_BID에 대해 negative = true을 설정합니다. ContextError.OPERATION_NOT_PERMITTED_FOR_CONTEXT
항목 코드 또는 입찰가 누락 entity_bid를 제공하지 않고 item_code 또는 cpc_bid_micros를 만들려고 시도합니다. RequestError.REQUIRED_FIELD_MISSING / FieldError.REQUIRED
항목 코드 변경 기존 기준에서 entity_bid.item_code를 업데이트하려고 시도합니다. RequestError.IMMUTABLE_FIELD / FieldError.IMMUTABLE_FIELD

실적 보고서

ClickType.TRAVEL_ASSETS를 사용하여 검색 광고의 여행 피드로 게재되는 광고의 실적 데이터를 식별할 수 있습니다(예: 모든 캠페인에서 광고의 실적 데이터 가져오기).

SELECT
  campaign.name,
  segments.click_type,
  metrics.impressions,
  metrics.clicks
FROM campaign
WHERE segments.click_type = 'TRAVEL_ASSETS'

숙박 일정 측정기준 세그먼트

연결된 여행 피드가 있는 캠페인의 실적 보고서를 숙박 일정 측정기준별로 분류할 수도 있습니다.

샘플 쿼리

SELECT
  campaign.name,
  segments.advance_booking_window,
  segments.length_of_booking,
  segments.start_date,
  segments.start_day_of_week,
  segments.user_set_dates,
  metrics.impressions,
  metrics.clicks
FROM campaign
WHERE segments.date DURING LAST_30_DAYS
이전
보고