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.

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ı 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ı

• Kaynak: AdGroupCriterion (ad_group_criterion)
• Kaynak adı biçimi: customers/{customer_id}/adGroupCriteria/{ad_group_id}~{criterion_id}
• Ölçüt türü numaralandırması: 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 teklifi tutarı (örneğin, 1000000, $1.00'ye 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çütlerinde 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

ö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:

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"
      }
    }
  ]
}

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:

• segments.advance_booking_window: Seyahat planı için erken rezervasyon dönemi (gün cinsinden).
• segments.length_of_booking: Seyahat planının rezervasyon süresi (gün cinsinden).
• segments.start_date: Rezervasyonun başlangıç tarihi, yyyy-MM-dd biçiminde.
• segments.start_day_of_week: Rezervasyonun yapıldığı haftanın başlangıç günü.
• segments.user_set_dates: Kullanıcı tarafından belirtilen tarihler seçildiyse (USER_SELECTED veya DEFAULT_SELECTION) bunu gösterir.

Ö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