Dikey reklamlar için kontroller ve envanter filtreleme

Dikey reklamlar, oteller gibi bir dikey feed'e bağlı olan, Maksimum Yapay Zeka'nın etkinleştirildiği Arama Ağı kampanyaları için özel özellikler sunar. Hangi dikey reklam biçimlerinin reklam grubu düzeyinde 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: Reklam grubu düzeyinde belirli reklam biçimlerini (metin reklamlar, rezervasyon bağlantıları ve dikey tanıtım reklamları) etkinleştirin veya devre dışı bırakın.
2. Dikey reklam öğeleri yönetimi: SharedSet andSharedCriterion` içeren kural tabanlı bir sistem kullanarak bağlı dikey (eski adıyla seyahat) feed'inizdeki 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: Kampanyaya etkin bir dikey veri feed'i bağlanmalıdır.
• Maksimum Yapay Zeka: Kampanyada "Maksimum Yapay Zeka" ayarı etkinleştirilmelidir.

Not: Maksimum Yapay Zeka'nın veya etkin bir dikey veri feed'inin olmadığı kampanyalarda biçim kontrolü ayarlarını değiştirmeye çalışırsanız VERTICAL_ADS_FORMAT_SETTING_NOT_SUPPORTED hataları oluşur. Benzer şekilde, bu tür kampanyalarda öğe yönetimini değiştirmeye çalışırsanız VERTICAL_ADS_ITEM_GROUP_RULE_LIST_NOT_SUPPORTED hata oluşur.

Reklam grubu biçimi kontrolleri

Artık belirli bir reklam grubu için hangi dikey reklam biçimlerinin etkin olduğunu yapılandırabilirsiniz. Bu işlem, AdGroup kaynağındaki vertical_ads_format_setting alanı üzerinden yönetilir.

Kullanılabilir Biçimler

• Metin reklamlar: Varsayılan olarak etkindir. Devre dışı bırakılabilir.
• Rezervasyon bağlantıları: Etkinleştirilmesi gerekir.
• Dikey tanıtım reklamları: Etkinleştirme gereklidir.

Doğrulama kuralları

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

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

Aşağıdaki örnekte, 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.

Java

// Assuming 'adGroup' is an existing AdGroup object.
AdGroup adGroupToUpdate = AdGroup.newBuilder()
    .setResourceName(adGroup.getResourceName()) // Example: "customers/{id}/adGroups/{id}"
    .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ör reklamları öğe grubu kurallarını kullanmanız gerekir.

Veri modelinin işleyiş şekli

Veri modelinde ortak ölçüt yaklaşımı kullanılır:

1. SharedSet: Türü VERTICAL_ADS_ITEM_GROUP_RULE_LIST olan bir SharedSet oluşturun.
2. SharedCriterion: Bu kümeye kurallar (ölçütler) ekleyin. Her kural, Şehir veya Otel Sınıfı gibi bir boyut ve bir değer belirtir. Öğeleri hariç tutmak için negatif ölçütler de oluşturabilirsiniz.
3. AdGroupCriterion: SharedSet öğesini AdGroup hesabınıza AdGroupCriterion kullanarak bağlayın.

Desteklenen detaylar

SharedCriterion'daki aşağıdaki boyutlara göre filtre uygulayabilirsiniz:

• item_code: Belirli giriş kimliği.
• city_criterion_id, region_criterion_id, country_criterion_id: Coğrafi hedefleme sabitleri.
• brand_text: Marka adı.
• hotel_class: Yıldız puanı (1-5).
• vertical_ads_item_category: CONCERT gibi kategori.

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

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

Python

# 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_LISTshared_set.vertical_ads_item_vertical_type = client.enums.VerticalAdsItemVerticalTypeEnum.HOTELS
# Submit SharedSetOperation...

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

# Rule A: Include Boston and SF
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 = 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
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...

Raporlama

Dikey reklamlarla ilgili performans metriklerini GoogleAdsService.SearchStream veya GoogleAdsService.Search yöntemlerini kullanarak alabilirsiniz. Google Ads API'nin v23 sürümünde ayrıntılı raporlama için belirli segmentler eklenmiştir.

Yeni segmentler

• segments.vertical_ads_listing_city: Listelemeyle ilişkili şehir.
• segments.vertical_ads_vertical_type: Sektör türü (ör. otel veya kiralık araç).

Örnek GAQL sorgusu

SQL

SELECT
  segments.vertical_ads_listing_city,
  metrics.clicks,
  metrics.all_conversions_value,
  metrics.impressions
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:

Hata kodu	Neden	Önerilen işlem
INVALID_VERTICAL_ADS_FORMAT_SETTING	Üç reklam biçiminin (metin, rezervasyon bağlantısı, tanıtım reklamları) tümü aynı anda devre dışı bırakıldı.	VerticalAdsFormatSetting içinde en az bir biçimin etkinleştirildiğinden (true olarak ayarlandığından) emin olun.
VERTICAL_ADS_FORMAT_SETTING_NOT_SUPPORTED_...	Kampanyada Maksimum Yapay Zeka etkin değil veya etkin bir dikey feed yok.	Kampanya ayarlarında Maksimum Yapay Zeka'yı etkinleştirin ve geçerli bir dikey feed'in bağlı olduğundan emin olun.
VERTICAL_ADS_ITEM_GROUP_RULE_LIST_DOES_NOT_EXIST	AdGroupCriterion'da sağlanan SharedSet kaynak adı mevcut değil.	shared_set kaynak adının, oluşturulan bir kümeyle eşleştiğini doğrulayın.
VERTICAL_ADS_ITEM_GROUP_RULE_IS_NOT_SUPPORTED...	Kullanılan ölçüt türü, belirli bir sektör için desteklenmiyor (ör. kiralık araçlar için otel sınıfı).	vertical_ads_item_group_rule boyutunun sektör türünüzle eşleştiğinden emin olun.