Kontrol dan pemfilteran inventaris untuk iklan vertikal

Iklan vertikal menyediakan fitur khusus untuk kampanye Penelusuran yang diaktifkan dengan AI Maksimal untuk kampanye Penelusuran yang ditautkan ke feed vertikal, seperti hotel. Anda dapat mengontrol format iklan vertikal yang ditayangkan di tingkat grup iklan, dan Anda dapat mengontrol entitas feed yang ditargetkan menggunakan aturan grup item iklan vertikal.

Ringkasan

Panduan ini mencakup dua fitur utama untuk mengelola iklan vertikal:

1. Kontrol format: Pilih untuk menggunakan atau tidak menggunakan format iklan tertentu (iklan teks, link pemesanan, dan iklan promosi vertikal) di tingkat grup iklan.
2. Pengelolaan item iklan vertikal: Filter dan targetkan inventaris tertentu dari feed vertikal (sebelumnya disebut perjalanan) tertaut menggunakan sistem berbasis aturan yang melibatkan SharedSet dan SharedCriterion.

Prasyarat

Sebelum Anda menerapkan fitur ini, pastikan kampanye Anda memenuhi persyaratan berikut:

• Jenis kampanye: Harus berupa kampanye Penelusuran.
• Feed vertikal: Feed data vertikal aktif harus ditautkan di tingkat pelanggan atau kampanye. Lihat Menautkan feed data vertikal di tingkat kampanye untuk menautkan feed di tingkat kampanye. Menautkan feed data vertikal akan mengaktifkan Feed Perjalanan di Iklan Penelusuran (TFSA) dan mengaktifkan kontrol iklan vertikal untuk kampanye.
• AI Maksimal untuk kampanye Penelusuran: Setelan AI Maksimal untuk kampanye Penelusuran harus diaktifkan di kampanye.

Menautkan feed data vertikal di tingkat kampanye

Untuk mengaktifkan Feed Perjalanan di Iklan Penelusuran (TFSA) dan mengaktifkan kontrol iklan vertikal dalam kampanye, Anda dapat menautkan set aset feed data vertikal di tingkat kampanye menggunakan langkah-langkah berikut. Atau, untuk mengaktifkan fitur ini untuk semua kampanye di akun Anda, Anda dapat menautkan feed di tingkat pelanggan dengan mengikuti petunjuk penautan tingkat pelanggan di panduan Feed Perjalanan di Iklan Penelusuran.

1. Buat objek CampaignAssetSet, tetapkan asset_set ke nama resource set aset feed vertikal dan campaign ke nama resource kampanye Anda.
2. Buat CampaignAssetSetOperation dengan create yang ditetapkan ke CampaignAssetSet.
3. Kirimkan operasi menggunakan CampaignAssetSetService.MutateCampaignAssetSets.

Untuk mengetahui detail selengkapnya tentang cara mengelola feed perjalanan dalam skala besar, lihat dokumentasi Feed Perjalanan di Iklan Penelusuran.

Kontrol format grup iklan

Anda dapat mengonfigurasi format iklan vertikal yang aktif untuk grup iklan tertentu. Hal ini dikelola melalui kolom vertical_ads_format_setting (VerticalAdsFormatSetting) pada resource AdGroup.

Format yang tersedia

• Iklan teks (disable_text_ads): Diaktifkan secara default. Dapat dinonaktifkan.
• Link pemesanan (enable_booking_links): Perlu memilih untuk mengaktifkan.
• Iklan promosi vertikal (enable_vertical_promotion_ads): Perlu memilih untuk mengaktifkan.

Aturan validasi

• Anda tidak dapat memilih tidak ikut serta untuk ketiga format secara bersamaan untuk satu grup iklan.
• Setelan ini hanya berlaku untuk jenis grup iklan SEARCH_STANDARD dan SEARCH_DYNAMIC_ADS.

Contoh: Memperbarui setelan format

Contoh Java berikut menunjukkan cara menonaktifkan iklan teks dan mengaktifkan iklan promosi vertikal untuk grup iklan yang ada:

// 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...

Pengelolaan item iklan vertikal

Untuk menargetkan subset tertentu dari inventaris feed Anda, seperti "Hotel di Boston" atau "Kecualikan hotel bintang 1", Anda harus menggunakan aturan kelompok item iklan vertikal.

Cara kerja model data

Model data menggunakan pendekatan kriteria bersama:

1. SharedSet: Buat SharedSet dengan jenis VERTICAL_ADS_ITEM_GROUP_RULE_LIST.
2. SharedCriterion: Tambahkan aturan (kriteria) ke set ini. Setiap aturan menentukan dimensi, seperti Kota atau Kelas Hotel, dan nilai. Anda juga dapat membuat kriteria negatif untuk mengecualikan item.
3. AdGroupCriterion: Tautkan SharedSet ke AdGroup Anda menggunakan AdGroupCriterion (vertical_ads_item_group_rule_list).

Dimensi yang didukung

Anda dapat memfilter entitas berdasarkan dimensi berikut di SharedCriterion (VerticalAdsItemGroupRuleInfo):

• item_code: ID listingan tertentu.
• city_criterion_id, region_criterion_id, country_criterion_id: Nama resource Geo Target Constant (geoTargetConstants/{id}).
• hotel_class: Rating bintang (1-5).
• user_rating, venue, event_participant_display_name (mulai di v24): Filter acara dan rating listingan vertikal, tempat, dan nama peserta.

Contoh kode: Membuat dan menautkan aturan

Contoh Python ini membuat aturan untuk menyertakan item di "Boston" atau "San Francisco" dan mengecualikan hotel "bintang 1" dan "bintang 2":

# 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...

Laporan performa

Anda dapat mengambil metrik performa untuk iklan vertikal menggunakan metode GoogleAdsService.SearchStream atau GoogleAdsService.Search.

Segmen iklan vertikal

• segments.vertical_ads_hotel_class: Nilai integer (1 hingga 5 bintang) yang menentukan rating kelas untuk listingan hotel.
• segments.vertical_ads_listing: ID untuk listingan iklan vertikal tertentu.
• segments.vertical_ads_listing_brand: Merek yang terkait dengan listingan iklan vertikal.
• segments.vertical_ads_listing_city: Kota yang terkait dengan listingan.
• segments.vertical_ads_listing_country: Negara yang terkait dengan listingan.
• segments.vertical_ads_listing_region: Wilayah yang terkait dengan listingan.
• segments.vertical_ads_partner_account: Akun partner dalam Partner Center (misalnya, Pusat Pengelolaan Hotel) yang menyediakan data feed inventaris.
• segments.vertical_ads_vertical: Kategori vertikal, seperti hotel atau mobil sewaan.
• segments.vertical_ads_event_participant_display_names (mulai v24): Nama tampilan peserta dalam daftar acara, seperti penampil, pembicara, atau tim.
• segments.vertical_ads_listing_user_rating (mulai v24): Nilai bilangan bulat (1 hingga 5) yang menentukan rating pengguna listingan iklan vertikal.
• segments.vertical_ads_listing_venue (mulai v24): Nama tempat untuk listingan iklan vertikal (misalnya, tempat konser).
• segments.vertical_ads_price_tier (mulai v25): Bucket daya saing harga relatif untuk listingan hotel.
• segments.vertical_ads_rate_rule_id (mulai di v25): ID string yang sesuai dengan aturan tarif pribadi atau bersyarat yang diterapkan pada bid atau tayangan.
• segments.vertical_ads_rate_type (mulai v25): Kategorisasi jenis tarif publik, pribadi, atau bersyarat.

Segmen dimensi itinerari

Mulai v25, untuk iklan vertikal yang ditautkan ke feed perjalanan dan akomodasi, Anda dapat menyegmentasikan laporan performa menggunakan dimensi itinerari:

• segments.advance_booking_window: Periode pemesanan di awal untuk itinerari dalam hari.
• segments.length_of_booking: Durasi pemesanan untuk itinerari dalam hari.
• segments.start_date: Tanggal mulai pemesanan diformat sebagai yyyy-MM-dd.
• segments.start_day_of_week: Hari mulai pemesanan.
• segments.user_set_dates: Menunjukkan apakah tanggal yang ditentukan pengguna dipilih (USER_SELECTED atau DEFAULT_SELECTION).

Metrik iklan vertikal

Mulai v25, Anda dapat mengambil metrik iklan vertical berikut:

• metrics.vertical_ads_potential_impressions: Tayangan potensial yang mewakili total tayangan valid yang dibatasi penayangan yang tersedia di seluruh konteks kueri.
• metrics.vertical_ads_average_booking_value_micros: Rata-rata tarif harian berbobot klik dalam mikro, termasuk pajak dan biaya, selama total panjang masa inap.
• metrics.vertical_ads_price_difference_percentage: Delta persentase yang membandingkan harga penawaran pengiklan dengan harga kompetitor terendah untuk properti yang sama.

Contoh kueri GAQL

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

Penanganan error

Berikut adalah error umum yang mungkin Anda alami saat mengonfigurasi iklan vertikal: