Arama Ağı Reklamlarındaki Seyahat Feed'leri

Google Ads hesabınıza bağlı Oteller, kiralık yer veya Aktivite Önerileri ürün feed'lerinizle Google Ads, mevcut Arama Ağı kampanyalarını feed'lerinizden alınan fiyatlar ve resimlerle otomatik olarak zenginleştirir. Bu özellik Arama ağı reklamlarındaki Seyahat feed'leri olarak bilinir.

Müşteri ayarları ve kampanya ayarları arasındaki etkileşim

Kampanyalar, varsayılan olarak CustomerAssetSet ilişkilendirmeleri aracılığıyla seyahat feed'i bağlantılarını (TRAVEL_FEED öğe kümeleri) müşteri düzeyinden devralır. Müşteri düzeyindeki ayarları belirli bir kampanya için geçersiz kılmak istiyorsanız kampanyanın excluded_parent_asset_set_types alanına TRAVEL_FEED eklemeniz ve CampaignAssetSet kullanarak kampanyaya özel bağlantıları yönetmeniz gerekir.

  • Müşteri feed'lerini devral (varsayılan): Müşteri düzeyindeki CustomerAssetSet bağlantısını koruyun ve Campaign.excluded_parent_asset_set_types öğesinin TRAVEL_FEED içermediğinden emin olun.
  • Müşteri düzeyinde devre dışı bırakma: Müşteri düzeyindeki CustomerAssetSet ilişkilendirmeyi kaldırın ve kampanya düzeyinde CampaignAssetSet bağlantı oluşturmayın.
  • Belirli bir kampanyayı hariç tutma: TRAVEL_FEED öğesini Campaign.excluded_parent_asset_set_types öğesine ekleyin ve kampanya düzeyindeki tüm CampaignAssetSet ilişkilendirmelerini kaldırın.
  • Yalnızca belirli bir kampanyayı etkinleştirme: Müşteri düzeyindeki CustomerAssetSet ilişkilendirmeyi kaldırın, ardından söz konusu kampanya için kampanya düzeyinde CampaignAssetSet bir bağlantı oluşturun.
  • Diğer kampanyalar devralmaya devam ederken kampanyaya özel feed'ler kullanma: Kampanyanın Campaign.excluded_parent_asset_set_types öğesine TRAVEL_FEED ekleyin ve kampanyaya özel bir CampaignAssetSet bağlantısı oluşturun.

Arama ağı reklamlarındaki seyahat feed'lerini devre dışı bırakma

Bu özelliği kullanmak istemiyorsanız müşteri ve kampanya düzeylerinde Arama Ağı reklamlarındaki Seyahat feed'lerini devre dışı bırakmak için Google Ads API'yi kullanabilirsiniz.

Müşteri düzeyinde devre dışı bırakma

Müşteri düzeyinde arama ağı reklamlarındaki Seyahat feed'lerini devre dışı bırakmak için aşağıdakileri yapın:

  1. customer_asset_set raporunu kullanarak türü TRAVEL_FEED olan tüm CustomerAssetSet bağlantıları için hem customer_asset_set.resource_name hem de asset_set.resource_name değerlerini alın:

    SELECT
      customer_asset_set.resource_name,
      asset_set.resource_name,
      asset_set.name
    FROM customer_asset_set
    WHERE asset_set.type = 'TRAVEL_FEED'
    
  2. Her customer_asset_set.resource_name için bir CustomerAssetSetOperation oluşturun ve remove değerini önceki adımda alınan customer_asset_set.resource_name olarak ayarlayın.

  3. Oluşturulan CustomerAssetSetOperation nesnelerini kullanarak CustomerAssetSetService.MutateCustomerAssetSets adresine istek gönderin.

Bu özelliği müşteri düzeyinde tekrar etkinleştirmek istiyorsanız:

  1. Bağlamak istediğiniz her temel AssetSet (asset_set.resource_name) için asset_set değeri asset_set.resource_name, customer değeri ise müşterinizin kaynak adı olarak ayarlanmış yeni bir CustomerAssetSet oluşturun.
  2. Önceki adımda oluşturulan her CustomerAssetSet için create değeri CustomerAssetSet olarak ayarlanmış bir CustomerAssetSetOperation oluşturun.
  3. Oluşturulan CustomerAssetSetOperation nesnelerini kullanarak CustomerAssetSetService.MutateCustomerAssetSets adresine istek gönderin.

Kampanya düzeyinde devre dışı bırakma

Arama ağı reklamlarındaki Seyahat Feed'lerini kampanya düzeyinde devre dışı bırakmak için öncelikle devralınan etkinleştirme durumunu müşteri düzeyinde hariç tutmanız gerekir:

  1. campaign raporunu kullanarak excluded_parent_asset_set_types değerini alma:

    SELECT
      campaign.excluded_parent_asset_set_types
    FROM campaign
    WHERE campaign.id = 'INSERT_YOUR_CAMPAIGN_ID'
    
  2. Campaign ile yeni bir nesne oluşturun. excluded_parent_asset_set_types, önceki değerler artı TRAVEL_FEED olarak, resource_name ise kampanyanızın kaynak adı olarak ayarlanmalıdır.

  3. Bir CampaignOperation oluşturun ve update ile update_mask değerlerini daha önce oluşturulan Campaign değerine göre ayarlayın.

  4. Önceki adımda oluşturulan CampaignOperation kullanarak CampaignService.MutateCampaigns adresine istek gönderin.

Ardından, kampanya düzeyindeki seyahat feed'i ilişkilendirmelerini kaldırın:

  1. Kapsam dışında bırakmak istediğiniz kampanya için, türü TRAVEL_FEED olan tüm CampaignAssetSet bağlantılar için campaign_asset_set raporunu kullanarak hem campaign_asset_set.resource_name hem de asset_set.resource_name değerlerini alın:

    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. Her campaign_asset_set.resource_name için bir CampaignAssetSetOperation oluşturun ve remove değerini önceki adımda alınan campaign_asset_set.resource_name olarak ayarlayın.

  3. Oluşturulan CampaignAssetSetOperation nesnelerini kullanarak CampaignAssetSetService.MutateCampaignAssetSets adresine istek gönderin.

Bu özelliği kampanya düzeyinde tekrar etkinleştirmek istiyorsanız:

  1. Etkinleştirmek istediğiniz her temel AssetSet (asset_set.resource_name) için asset_set, asset_set.resource_name olarak, campaign ise kampanyanızın kaynak adı olarak ayarlanmış yeni bir CampaignAssetSet oluşturun.
  2. Önceki adımda oluşturulan her CampaignAssetSet için create değeri CampaignAssetSet olarak ayarlanmış bir CampaignAssetSetOperation oluşturun.
  3. Oluşturulan CampaignAssetSetOperation nesnelerini kullanarak CampaignAssetSetService.MutateCampaignAssetSets adresine istek gönderin.

Bir kampanya için müşteri düzeyinde izin verme durumunu geri yükleme

Bir kampanyanın kayıt durumunun tekrar müşteri düzeyindeki ayarı devralmasını sağlamak için:

  1. Listede excluded_parent_asset_set_types olmadan TRAVEL_FEED ve resource_name değeri kampanya kaynağınızın adı olarak ayarlanmış yeni bir Campaign nesnesi oluşturun.
  2. Bir CampaignOperation oluşturun ve update ile update_mask değerlerini daha önce oluşturulan Campaign değerine göre ayarlayın.
  3. Önceki adımda oluşturulan CampaignOperation kullanarak CampaignService.MutateCampaigns adresine istek gönderin.

Öğe başına manuel TBM teklifi verme

Google Ads API v25 sürümünden itibaren, seyahat için arama ağı kampanyalarındaki oteller için CriterionType.VERTICAL_ADS_ITEM_BID ölçüt türüne sahip AdGroupCriterion kaynağını kullanarak öğe başına manuel TBM teklifi geçersiz kılma işlemleri yapılandırabilirsiniz (ad_group_criterion.entity_bid).

Ön koşullar ve uyumluluk koşulları

VERTICAL_ADS_ITEM_BID ölçütleri oluşturmak ve yönetmek için aşağıdaki koşulların karşılanması gerekir:

  • Kampanya türü: Seyahat için Arama Ağı kampanyaları (Arama Ağı kampanyaları, AdvertisingChannelType.SEARCH, Arama Ağı Kampanyaları İçin AI Max etkinleştirilmiş Campaign.ai_max_setting.enable_ai_max ve ilişkili bir otel feed'i [TRAVEL_FEED öğe kümesi]; yalnızca otel feed'leri desteklenir).
  • Teklif stratejisi: Yalnızca manuel TBM (BiddingStrategyType.MANUAL_CPC).
    • Otomatik veya Akıllı Teklif stratejilerinde (ör. dönüşümleri artırma, dönüşüm değerini artırma, hedef EBM veya hedef ROAS) desteklenmez.
  • Yalnızca pozitif ölçütler: negative, false olarak ayarlanmalıdır. Negatif öğe teklifleri desteklenmez.
  • Zorunlu öğe tanımlayıcısı ve teklif: entity_bid.item_code ve cpc_bid_micros, öğe teklifi ölçütü oluştururken zorunludur.

Şema ve alan tanımları

Alan Tür Davranış Açıklama
entity_bid EntityBid IMMUTABLE Tek bir öğe için manuel teklif geçersiz kılmayı temsil eden ölçüt.
entity_bid.item_code string IMMUTABLE, zorunlu İş ortağı otel feed'iyle eşleşen belirli bir otel varlığını (otel listeleme kimliği) belirten kimlik veya kod (1-256 karakter, kırpılmış).
cpc_bid_micros int64 Okuma/Yazma Mikro cinsinden manuel TBM teklifi tutarı (örneğin, 1000000, $1.00'ye eşittir).
negative bool IMMUTABLE false olmalıdır.

Desteklenen hizmetler ve işlemler

Hizmet Yöntem Desteklenen işlemler
AdGroupCriterionService MutateAdGroupCriteria create, update (cpc_bid_micros), remove
GoogleAdsService Search / SearchStream Sorgu ölçütü özellikleri, ürün kodları ve teklif değerleri

Kod ve yük örnekleri

Aşağıdaki örneklerde, ölçütlerin nasıl okunacağı, oluşturulacağı, güncelleneceği ve kaldırılacağı VERTICAL_ADS_ITEM_BID gösterilmektedir.

GAQL kullanarak varlık tekliflerini okuma

ölçütlerini sorgulamak için GoogleAdsService.Search veya GoogleAdsService.SearchStream kullanın: VERTICAL_ADS_ITEM_BID ölçütlerini sorgulamak için:

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'

Varlık teklifi oluşturma

AdGroupCriterionService.MutateAdGroupCriteria adresine create işlemi gönderme:

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

Mevcut bir öğenin teklif tutarını güncelleme

AdGroupCriterionService.MutateAdGroupCriteria adresine updateMask içeren bir update işlemi gönderin:

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

Bir öğe teklifini kaldırma

AdGroupCriterionService.MutateAdGroupCriteria adresine remove işlemi gönderme:

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

Doğrulama kuralları ve hata işleme

Senaryo Tetikleyici / koşul Döndürülen hata kodu
Manuel olmayan TBM kampanyası Otomatik teklif veya Akıllı Teklif kullanılan bir kampanyada öğe teklifi oluşturmaya çalışıyorsanız. ContextError.OPERATION_NOT_PERMITTED_FOR_CONTEXT
Geçersiz kampanya türü Arama Ağı kampanyası olmayan bir kampanyaya (örneğin, Görüntülü Reklam Ağı kampanyası) öğe teklifi ekleme. ContextError.OPERATION_NOT_PERMITTED_FOR_CONTEXT
Negatif ölçüt negative = true için VERTICAL_ADS_ITEM_BID ayarlanıyor. ContextError.OPERATION_NOT_PERMITTED_FOR_CONTEXT
Öğe kodu veya teklif eksik item_code veya cpc_bid_micros sağlamadan entity_bid oluşturmaya çalışmak. RequestError.REQUIRED_FIELD_MISSING / FieldError.REQUIRED
Öğe kodunu değiştirme Mevcut bir ölçütte entity_bid.item_code değerini güncellemeye çalışıyorsunuz. RequestError.IMMUTABLE_FIELD / FieldError.IMMUTABLE_FIELD

Performans raporları

ClickType.TRAVEL_ASSETS simgesini kullanarak arama ağı reklamlarındaki seyahat feed'leri olarak yayınlanan reklamların performans verilerini belirleyebilir, örneğin tüm kampanyalarınızdaki reklamların performans verilerini getirebilirsiniz:

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

Seyahat planı boyutu segmentleri

Bağlı seyahat feed'leri içeren kampanyaların performans raporlarını seyahat planı boyutlarına göre de segmentlere ayırabilirsiniz:

Örnek sorgu

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