Kontrol dan pemfilteran inventaris untuk iklan vertikal

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

Ringkasan

Panduan ini membahas dua fitur utama untuk mengelola iklan vertikal:

1. Kontrol format: Memilih 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) yang ditautkan menggunakan sistem berbasis aturan yang melibatkan SharedSet dan SharedCriterion.

Prasyarat

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

• Jenis kampanye: Harus berupa kampanye Penelusuran.
• Feed vertical: Feed data vertical yang 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 vertical akan mengaktifkan Feed Perjalanan di Iklan Penelusuran (TFSA) dan mengaktifkan kontrol iklan vertical 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 kumpulan 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 dalam panduan Feed Perjalanan di Iklan Penelusuran.

1. Buat objek CampaignAssetSet, dengan menetapkan asset_set ke nama resource kumpulan aset feed vertikal dan campaign ke nama resource kampanye Anda.
2. Buat CampaignAssetSetOperation dengan create ditetapkan ke CampaignAssetSet.
3. Kirim 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 mana 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. Hanya didukung untuk feed vertikal HOTELS dan THINGS_TO_DO.
• Iklan promosi vertical (enable_vertical_promotion_ads): Perlu memilih untuk mengaktifkan.

Aturan validasi

• Anda tidak dapat memilih untuk tidak menggunakan ketiga format tersebut secara bersamaan untuk satu grup iklan.
• enable_booking_links hanya dapat ditetapkan ke true jika feed vertical aktif kampanye adalah HOTELS atau THINGS_TO_DO.
• 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(
        AdGroup.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 vertical

Untuk menargetkan sebagian inventaris feed tertentu, seperti "Hotel di Jakarta" atau "Kecualikan hotel bintang 1", Anda harus menggunakan aturan kelompok item iklan vertical.

Cara kerja model data

Model data menggunakan pendekatan kriteria bersama:

1. SharedSet: Buat SharedSet dengan jenis VERTICAL_ADS_ITEM_GROUP_RULE_LIST.
2. SharedCriterion: Menambahkan 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 menggunakan AdGroupCriterion (vertical_ads_item_group_rule_list).

Dimensi yang didukung

Anda dapat memfilter entitas berdasarkan dimensi berikut di SharedCriterion (VerticalAdsItemGroupRuleInfo), bergantung pada vertical_ads_item_vertical_type SharedSet:

• item_code: ID listingan tertentu (didukung untuk semua jenis vertical).
• city_criterion_id, region_criterion_id, country_criterion_id: Nama resource Geo Target Constant (geoTargetConstants/{id}; didukung untuk semua jenis vertical kecuali FLIGHTS).
• hotel_class: Rating bintang dari 1 hingga 5 (khusus HOTELS).
• user_rating (mulai v24): Rating pengguna yang dibulatkan ke bawah dari 1 hingga 5 (khusus THINGS_TO_DO).
• venue, event_participant_display_name (mulai v24): Filter nama tampilan peserta dan tempat acara (khusus EVENTS).

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

Bidding CPC manual per entitas

Mulai v25, untuk Kampanye Penelusuran untuk Perjalanan (kampanye Penelusuran dengan AI Maksimal untuk kampanye Penelusuran diaktifkan dan feed hotel tertaut) yang menggunakan strategi bidding CPC Manual (BiddingStrategyType.MANUAL_CPC), Anda dapat menetapkan penggantian bid CPC manual (cpc_bid_micros) untuk setiap item feed hotel menggunakan kriteria EntityBid (ad_group_criterion.entity_bid) dengan CriterionType.VERTICAL_ADS_ITEM_BID dan entity_bid.item_code.

Kriteria negatif (negative = true), kampanye non-Penelusuran, dan strategi bidding otomatis atau strategi Smart Bidding tidak didukung untuk VERTICAL_ADS_ITEM_BID dan menampilkan ContextError.OPERATION_NOT_PERMITTED_FOR_CONTEXT. Metrik performa tidak diisi pada kriteria VERTICAL_ADS_ITEM_BID. Untuk mengetahui detail skema lengkap, kueri GAQL, dan contoh payload mutasi, lihat Bidding CPC manual per entitas di panduan Feed Perjalanan di Iklan Penelusuran. Untuk menetapkan penyesuaian bid grup iklan multiplikatif di seluruh dimensi itinerari perjalanan untuk iklan Hotel menggunakan AdGroupBidModifier, lihat Menyesuaikan bid dengan pengubah bid.

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 bilangan bulat (bintang 1 hingga 5) 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: Region yang terkait dengan listingan.
• segments.vertical_ads_partner_account: Akun partner dalam Pusat Partner (misalnya, Pusat Pengelolaan Hotel) yang menyediakan data feed inventaris.
• segments.vertical_ads_vertical: Jenis vertikal, seperti hotel atau mobil sewaan.
• segments.vertical_ads_event_participant_display_names: Nama tampilan peserta dalam listingan acara, seperti penampil, pembicara, atau tim.
• segments.vertical_ads_listing_user_rating (mulai v24): Nilai bilangan bulat (1 hingga 5) yang menentukan rating pengguna untuk listingan iklan vertical.
• segments.vertical_ads_listing_venue (mulai v24): Nama tempat untuk listingan iklan vertical (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 v25): ID string yang sesuai dengan aturan tarif pribadi atau bersyarat yang diterapkan ke bid atau tayangan iklan.
• 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 yang 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 iklan potensial yang mewakili total tayangan iklan valid yang dibatasi jumlah penayangannya yang tersedia di seluruh konteks kueri.
• metrics.vertical_ads_average_booking_value_micros: Tarif harian rata-rata berbobot klik dalam mikro, termasuk pajak dan biaya, selama total panjang masa inap.
• metrics.vertical_ads_price_difference_percentage: Selisih persentase yang membandingkan harga yang ditawarkan pengiklan dengan harga bersaing terendah untuk properti yang sama.

Contoh kueri GAQL

Kueri ini mengambil metrik kompetitif dan pemesanan iklan vertikal yang disegmentasikan menurut kota listingan, tingkat harga, dan jenis tarif:

SELECT
  campaign.id,
  ad_group.id,
  segments.vertical_ads_listing_city,
  segments.vertical_ads_price_tier,
  segments.vertical_ads_rate_type,
  metrics.vertical_ads_potential_impressions,
  metrics.vertical_ads_average_booking_value_micros,
  metrics.vertical_ads_price_difference_percentage
FROM
  ad_group
WHERE
  segments.date DURING LAST_30_DAYS

Kueri ini menyegmentasikan metrik performa standar menurut dimensi pemesanan itinerari:

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.clicks,
  metrics.all_conversions_value
FROM
  ad_group
WHERE
  segments.date DURING LAST_30_DAYS

Penanganan error

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