Dikey reklamlar için kontroller ve envanter filtreleme

Dikey reklamlar, oteller gibi bir dikey feed'e bağlı, Arama Ağı kampanyaları için AI Max'in etkinleştirildiği Arama Ağı kampanyaları için özel özellikler sunar. Reklam grubu düzeyinde hangi dikey reklam biçimlerinin yayınlanacağını ve dikey reklam öğesi grubu kuralları kullanılarak hangi feed öğelerinin hedefleneceğini kontrol edebilirsiniz.

Genel Bakış

Bu kılavuzda, dikey reklamları yönetmeye yönelik iki temel özellik ele alınmaktadır:

1. Biçim kontrolleri: Belirli reklam biçimlerini (metin reklamlar, rezervasyon bağlantıları ve dikey tanıtım reklamları) reklam grubu düzeyinde etkinleştirin veya devre dışı bırakın.
2. Dikey reklam öğeleri yönetimi: SharedSet ve SharedCriterion içeren kural tabanlı bir sistem kullanarak, bağlı dikey feed'inizdeki (eski adıyla seyahat) belirli envanteri filtreleyin ve hedefleyin.

Ön koşullar

Bu özellikleri uygulamadan önce kampanyanızın aşağıdaki koşulları karşıladığından emin olun:

• Kampanya türü: Arama Ağı kampanyası olmalıdır.
• Dikey feed: Müşteri veya kampanya düzeyinde etkin bir dikey veri feed'i bağlı olmalıdır. Feed'i kampanya düzeyinde bağlamak için Dikey feed'leri kampanya düzeyinde bağlama başlıklı makaleyi inceleyin. Bir dikey veri feed'inin bağlanması, arama ağı reklamlarındaki seyahat feed'lerini (TFSA) etkinleştirir ve kampanya için dikey reklam kontrollerini sağlar.
• Arama Ağı kampanyaları için AI Max: Kampanyada Arama Ağı kampanyaları için AI Max ayarı etkinleştirilmelidir.

Dikey veri feed'lerini kampanya düzeyinde bağlama

Arama ağı reklamlarında seyahat feed'lerini (TFSA) etkinleştirmek ve kampanyanızda dikey reklam kontrollerini etkinleştirmek için aşağıdaki adımları uygulayarak dikey veri feed'i öğe kümenizi kampanya düzeyinde bağlayabilirsiniz. Alternatif olarak, hesabınızdaki tüm kampanyalar için bu özellikleri etkinleştirmek istiyorsanız arama ağı reklamlarındaki Seyahat feed'leri kılavuzunda yer alan müşteri düzeyinde bağlama talimatlarını uygulayarak feed'i müşteri düzeyinde bağlayabilirsiniz.

1. CampaignAssetSet nesnesi oluşturun. asset_set değerini dikey feed öğe grubunuzun kaynak adına, campaign değerini ise kampanyanızın kaynak adına ayarlayın.
2. create değeri CampaignAssetSet olarak ayarlanmış bir CampaignAssetSetOperation oluşturun.
3. CampaignAssetSetService.MutateCampaignAssetSets kullanarak işlemi gönderin.

Seyahat feed'lerini ölçekli olarak yönetme hakkında daha fazla bilgi için Arama ağı reklamlarındaki seyahat feed'leri dokümanına bakın.

Reklam grubu biçimi kontrolleri

Belirli bir reklam grubu için hangi dikey reklam biçimlerinin etkin olduğunu yapılandırabilirsiniz. Bu, AdGroup kaynağındaki vertical_ads_format_setting (VerticalAdsFormatSetting) alanı üzerinden yönetilir.

Kullanılabilir biçimler

• Metin reklamlar (disable_text_ads): Varsayılan olarak etkindir. Devre dışı bırakılabilir.
• Rezervasyon bağlantıları (enable_booking_links): Etkinleştirme gerektirir.
• Dikey tanıtım reklamları (enable_vertical_promotion_ads): Etkinleştirme gerektirir.

Doğrulama kuralları

• Tek bir reklam grubu için üç biçimi de aynı anda devre dışı bırakamazsınız.
• Bu ayarlar yalnızca SEARCH_STANDARD ve SEARCH_DYNAMIC_ADS reklam grubu türleri için geçerlidir.

Örnek: Biçim ayarlarını güncelleme

Aşağıdaki Java örneğinde, mevcut bir reklam grubu için metin reklamların nasıl devre dışı bırakılacağı ve dikey tanıtım reklamlarının nasıl etkinleştirileceği gösterilmektedir:

// Assuming 'adGroup' is an existing AdGroup object.
// Example resource name: "customers/{customer_id}/adGroups/{ad_group_id}"
AdGroup adGroupToUpdate = AdGroup.newBuilder()
    .setResourceName(adGroup.getResourceName())
    .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...

Dikey reklam öğeleri yönetimi

Feed envanterinizin belirli bir alt kümesini (ör. "Boston'daki oteller" veya "1 yıldızlı otelleri hariç tut") hedeflemek için sektörel reklam öğesi grubu kurallarını kullanmanız gerekir.

Veri modelinin işleyiş şekli

Veri modeli, paylaşılan ölçüt yaklaşımını kullanır:

1. SharedSet: VERTICAL_ADS_ITEM_GROUP_RULE_LIST türünde bir SharedSet oluşturun.
2. SharedCriterion: Bu kümeye kurallar (ölçütler) ekleyin. Her kuralda Şehir veya Otel Sınıfı gibi bir boyut ve bir değer belirtilir. Öğeleri hariç tutmak için negatif ölçütler de oluşturabilirsiniz.
3. AdGroupCriterion: AdGroupCriterion (vertical_ads_item_group_rule_list) kullanarak SharedSet ile AdGroup arasında bağlantı oluşturun.

Desteklenen detaylar

SharedCriterion (VerticalAdsItemGroupRuleInfo) bölümünde, öğeleri aşağıdaki boyutlara göre filtreleyebilirsiniz:

• item_code: Belirli listeleme kimliği.
• city_criterion_id, region_criterion_id, country_criterion_id: Coğrafi hedef sabit kaynak adları (geoTargetConstants/{id}).
• hotel_class: Yıldız puanı (1-5).
• user_rating, venue, event_participant_display_name (v24 itibarıyla): Etkinlik ve dikey listeleme puanı, mekan ve katılımcı adı filtreleri.

Kod örneği: Kural oluşturma ve bağlama

Bu Python örneğinde, "Boston" veya "San Francisco"daki öğeleri dahil eden, "1 yıldızlı" ve "2 yıldızlı" otelleri hariç tutan bir kural oluşturuluyor:

# 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_LIST
)
shared_set.vertical_ads_item_vertical_type = (
    client.enums.VerticalAdsItemVerticalTypeEnum.HOTELS
)
shared_set_service = client.get_service("SharedSetService")
shared_set_response = shared_set_service.mutate_shared_sets(
    customer_id=customer_id, operations=[shared_set_operation]
)
shared_set_resource_name = shared_set_response.results[0].resource_name

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

# Rule A: Include Boston and SF
geo_target_constant_service = client.get_service("GeoTargetConstantService")
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 = (
      geo_target_constant_service.geo_target_constant_path(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
ad_group_service = client.get_service("AdGroupService")
ad_group_resource_name = ad_group_service.ad_group_path(
    customer_id, ad_group_id
)
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...

Performans raporları

GoogleAdsService.SearchStream veya GoogleAdsService.Search yöntemlerini kullanarak dikey reklamlarla ilgili performans metriklerini alabilirsiniz.

Dikey reklam segmentleri

• segments.vertical_ads_hotel_class: Bir otel listelemesinin sınıf puanını belirten tam sayı değeri (1 ila 5 yıldız).
• segments.vertical_ads_listing: Belirli bir sektöre ait reklam listelemesinin tanımlayıcısı.
• segments.vertical_ads_listing_brand: Bir dikey reklam listelemeyle ilişkili marka.
• segments.vertical_ads_listing_city: Listelemeyle ilişkili şehir.
• segments.vertical_ads_listing_country: Listelemeyle ilişkili ülke.
• segments.vertical_ads_listing_region: Girişle ilişkili bölge.
• segments.vertical_ads_partner_account: Envanter feed'i verileri sağlayan bir İş Ortağı Merkezi'ndeki (ör. Hotel Center) iş ortağı hesabı.
• segments.vertical_ads_vertical: Otel veya kiralık araç gibi dikey türü.
• segments.vertical_ads_event_participant_display_names (v24 itibarıyla): Etkinlik listelemesindeki katılımcıların (ör. sanatçılar, konuşmacılar veya takımlar) görünen adları.
• segments.vertical_ads_listing_user_rating (v24 itibarıyla): Dikey reklam listelemesinin kullanıcı puanını belirten tam sayı değeri (1-5).
• segments.vertical_ads_listing_venue (v24 itibarıyla): Dikey reklam listelemesi için mekanın adı (örneğin, konser mekanı).
• segments.vertical_ads_price_tier (v25 itibarıyla): Otel listelemeleri için göreli fiyat rekabetçiliği grubu.
• segments.vertical_ads_rate_rule_id (v25 itibarıyla): Teklife veya gösterime uygulanan özel ya da koşullu ücret kurallarına karşılık gelen dize tanımlayıcısı.
• segments.vertical_ads_rate_type (v25 itibarıyla): Herkese açık, özel veya koşullu fiyat türünün kategorilendirilmesi.

Seyahat planı boyutu segmentleri

v25 tarihinden itibaren, seyahat ve konaklama feed'lerine bağlı dikey reklamlar için performans raporlarını seyahat planı boyutlarını kullanarak 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 başladığı gün.
• segments.user_set_dates: Kullanıcı tarafından belirtilen tarihler seçilip seçilmediğini gösterir (USER_SELECTED veya DEFAULT_SELECTION).

Dikey reklam metrikleri

v25 itibarıyla aşağıdaki dikey reklam metriklerini alabilirsiniz:

• metrics.vertical_ads_potential_impressions: Sorgu bağlamında kullanılabilen, toplam görüntüleme sınırı uygulanmış uygun gösterimleri temsil eden potansiyel gösterimler.
• metrics.vertical_ads_average_booking_value_micros: Konaklama süresinin toplamı boyunca vergiler ve ücretler dahil olmak üzere, tıklama ağırlıklı ortalama günlük ücret (mikro cinsinden).
• metrics.vertical_ads_price_difference_percentage: Reklamverenin teklif ettiği fiyatın aynı mülk için en düşük rakip fiyatla karşılaştırıldığında yüzde olarak farkı.

Örnek GAQL sorgusu

SELECT
  campaign.id,
  ad_group.id,
  segments.vertical_ads_listing_city,
  segments.advance_booking_window,
  segments.length_of_booking,
  segments.start_date,
  metrics.impressions,
  metrics.vertical_ads_potential_impressions,
  metrics.clicks,
  metrics.all_conversions_value,
  metrics.vertical_ads_average_booking_value_micros,
  metrics.vertical_ads_price_difference_percentage
FROM
  ad_group
WHERE
  segments.date DURING LAST_30_DAYS

Hata işleme

Dikey reklamları yapılandırırken karşılaşabileceğiniz yaygın hatalar şunlardır: