Arama Ağı Reklamlarındaki Seyahat Feed'leri

Otel, kiralık yer veya Aktivite Önerileri ürün feed'leriniz Google Ads hesabınıza bağlıyken 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.

Not: Dikey veri feed'inizi müşteri veya kampanya düzeyinde bağladığınızda, Maksimum Yapay Zeka etkinleştirildiğinde kampanyanızın dikey reklamlar için kontrolleri ve envanter filtrelemeyi kullanmasına ya da manuel TBM teklifi kullanılırken Seyahat İçin Arama Ağı kampanyalarındaki otel feed'leri için varlık başına manuel TBM teklifi kullanmasına da olanak tanırsınız.

Müşteri ayarları ile 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. Belirli bir kampanyanın müşteri düzeyindeki ayarlarını geçersiz kılmak için kampanyanın excluded_parent_asset_set_types alanına TRAVEL_FEED eklemeniz ve kampanyaya özel bağlantıları CampaignAssetSet kullanarak 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 bir CampaignAssetSet bağlantı oluşturmayın.
• Belirli bir kampanyayı devre dışı bırakma: Campaign.excluded_parent_asset_set_types öğesine TRAVEL_FEED ekleyin ve kampanya düzeyindeki tüm CampaignAssetSet ilişkilendirmelerini kaldırın.
• Yalnızca belirli bir kampanyayı etkinleştirme: Müşteri düzeyindeki ilişkilendirmeyi kaldırın, ardından söz konusu kampanya için kampanya düzeyinde bir bağlantı oluşturun.CustomerAssetSetCampaignAssetSet
• Diğer kampanyalar devralmaya devam ederken kampanyaya özel feed'ler kullanma: Kampanyanın Campaign.excluded_parent_asset_set_types öğesine TRAVEL_FEED ekleyin ve kampanya için kampanya düzeyinde bir CampaignAssetSet bağlantısı oluşturun.

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

Bu özelliği kullanmak istemiyorsanız Google Ads API'yi kullanarak müşteri ve kampanya düzeylerinde arama ağı reklamlarındaki Seyahat feed'lerini devre dışı bırakabilirsiniz.

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 bir temel AssetSet (asset_set.resource_name) için asset_set, asset_set.resource_name olarak ve customer, müşterinizin kaynak adı olarak ayarlanmış yeni bir CustomerAssetSet oluşturun.
2. Önceki adımda oluşturulan her CustomerAssetSet için create, 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 campaign_asset_set raporunu kullanarak türü TRAVEL_FEED olan tüm CampaignAssetSet bağlantılarının hem campaign_asset_set.resource_name hem de asset_set.resource_name değerini 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, 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 etkinleştirme durumunu geri yükleme

Bir kampanyanın kaydolma 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 varlık başına manuel TBM teklifi geçersiz kılmalarını, CriterionType.VERTICAL_ADS_ITEM_BID (ad_group_criterion.entity_bid) ölçüt türüne sahip AdGroupCriterion kaynağını kullanarak yapılandırabilirsiniz.

Ö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.
• Gerekli varlık tanımlayıcısı ve teklif: Varlık teklif ölçütü oluşturulurken entity_bid.item_code ve cpc_bid_micros gereklidir.

Şema ve alan tanımları

• Kaynak: AdGroupCriterion (ad_group_criterion)
• Kaynak adı biçimi: customers/{customer_id}/adGroupCriteria/{ad_group_id}~{criterion_id}
• Ölçüt türü enum: CriterionType.VERTICAL_ADS_ITEM_BID
• Mesaj: EntityBid (ad_group_criterion.entity_bid)

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 teklif tutarı (ör. 1000000, $1.00 değerine eşittir).
negative	bool	IMMUTABLE	false olmalıdır.

Not: Performans metrikleri (ör. metrics.impressions, metrics.clicks ve metrics.cost_micros) VERTICAL_ADS_ITEM_BID ölçütleri için doldurulmaz veya desteklenmez. Giriş başına performans metriklerini almak için campaign veya ad_group kaynağını segments.vertical_ads_listing ile segmentlere ayırarak sorgulayın (Dikey reklamlar için kontrollerde ve envanter filtrelemede performans raporları bölümüne bakın).

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

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

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:

Not: entity_bid.item_code, IMMUTABLE. Teklif tutarını değiştirmek için cpc_bid_micros değerini güncelleyin. Varlık öğesi kodunu değiştirmek için ölçütü kaldırıp yeni bir ölçüt oluşturun.

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

Varlık teklifini kaldırma

AdGroupCriterionService.MutateAdGroupCriteria adresine bir remove işlemi gönderin:

{
  "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 TBM olmayan kampanya	Otomatik veya Akıllı Teklif stratejisi kullanan bir kampanyada varlık teklifi oluşturmaya çalışılıyor.	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	VERTICAL_ADS_ITEM_BID için negative = true 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 güncellenmeye çalışılıyor.	RequestError.IMMUTABLE_FIELD / FieldError.IMMUTABLE_FIELD

Performans raporları

Arama ağı reklamlarındaki Seyahat feed'leri olarak yayınlanan reklamların performans verilerini belirlemek için ClickType.TRAVEL_ASSETS kullanabilirsiniz. Ö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:

• segments.advance_booking_window: Seyahat planı için gün cinsinden erken rezervasyon dönemi.
• segments.length_of_booking: Seyahat planının gün cinsinden rezervasyon süresi.
• segments.start_date: Rezervasyonun başlangıç tarihi. yyyy-MM-dd biçiminde olmalıdır.
• segments.start_day_of_week: Rezervasyonun başladığı gün.
• segments.user_set_dates: Kullanıcı tarafından belirtilen tarihlerin seçilip seçilmediğini gösterir (USER_SELECTED veya DEFAULT_SELECTION).

Ö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