Feed Perjalanan di Iklan Penelusuran

Dengan feed produk Hotel, Rental Akomodasi, atau Aktivitas yang ditautkan ke akun Google Ads, Google Ads akan otomatis melengkapi kampanye Penelusuran yang ada dengan harga dan gambar yang diambil dari feed Anda. Fitur ini dikenal sebagai Feed Perjalanan di Iklan Penelusuran.

Cara setelan pelanggan dan setelan kampanye berinteraksi

Secara default, kampanye mewarisi link feed perjalanan (kumpulan aset TRAVEL_FEED) dari tingkat pelanggan melalui pengaitan CustomerAssetSet. Untuk mengganti setelan tingkat pelanggan untuk kampanye tertentu, Anda harus menambahkan TRAVEL_FEED ke kolom excluded_parent_asset_set_types kampanye dan mengelola link spesifik per kampanye menggunakan CampaignAssetSet.

• Mewarisi feed pelanggan (default): Tetap menautkan CustomerAssetSet tingkat pelanggan, dan pastikan Campaign.excluded_parent_asset_set_types tidak berisi TRAVEL_FEED.
• Menonaktifkan di tingkat pelanggan: Hapus asosiasi CustomerAssetSet tingkat pelanggan, dan jangan tautkan CampaignAssetSet tingkat kampanye.
• Menonaktifkan kampanye tertentu: Tambahkan TRAVEL_FEED ke Campaign.excluded_parent_asset_set_types, dan hapus semua asosiasi CampaignAssetSet tingkat kampanye.
• Mengaktifkan hanya kampanye tertentu: Hapus asosiasi CustomerAssetSet tingkat pelanggan, lalu buat link CampaignAssetSet tingkat kampanye untuk kampanye tersebut.
• Gunakan feed spesifik per kampanye sementara kampanye lain tetap mewarisi: Tambahkan TRAVEL_FEED ke Campaign.excluded_parent_asset_set_types kampanye, dan buat link CampaignAssetSet tingkat kampanye untuknya.

Memilih tidak menggunakan Feed Perjalanan di Iklan Penelusuran

Jika tidak ingin menggunakan fitur ini, Anda dapat menggunakan Google Ads API untuk memilih tidak menggunakan Feed Perjalanan di Iklan Penelusuran di tingkat pelanggan dan kampanye.

Menonaktifkan feed perjalanan di tingkat pelanggan

Untuk menonaktifkan Feed Perjalanan di Iklan Penelusuran di tingkat pelanggan, lakukan tindakan berikut:

1. Ambil customer_asset_set.resource_name dan asset_set.resource_name untuk semua link CustomerAssetSet yang jenisnya adalah TRAVEL_FEED menggunakan laporan customer_asset_set:

   SELECT
     customer_asset_set.resource_name,
     asset_set.resource_name,
     asset_set.name
   FROM customer_asset_set
   WHERE asset_set.type = 'TRAVEL_FEED'
   

2. Untuk setiap customer_asset_set.resource_name, buat CustomerAssetSetOperation dan tetapkan remove ke customer_asset_set.resource_name yang diambil pada langkah sebelumnya.

3. Kirim permintaan ke CustomerAssetSetService.MutateCustomerAssetSets menggunakan objek CustomerAssetSetOperation yang dibuat.

Jika Anda ingin mengaktifkan fitur ini lagi di tingkat pelanggan:

1. Untuk setiap AssetSet (asset_set.resource_name) pokok yang ingin Anda tautkan, buat CustomerAssetSet baru dengan asset_set yang ditetapkan ke asset_set.resource_name dan customer yang ditetapkan ke nama resource pelanggan Anda.
2. Untuk setiap CustomerAssetSet yang dibuat di langkah sebelumnya, buat CustomerAssetSetOperation dengan create ditetapkan ke CustomerAssetSet.
3. Kirim permintaan ke CustomerAssetSetService.MutateCustomerAssetSets menggunakan objek CustomerAssetSetOperation yang dibuat.

Menonaktifkan feed perjalanan di tingkat kampanye

Untuk menonaktifkan Feed Perjalanan di Iklan Penelusuran pada tingkat kampanye, Anda harus terlebih dahulu mengecualikan status keikutsertaan yang diwariskan dari tingkat pelanggan:

1. Mengambil excluded_parent_asset_set_types menggunakan laporan campaign:

   SELECT
     campaign.excluded_parent_asset_set_types
   FROM campaign
   WHERE campaign.id = 'INSERT_YOUR_CAMPAIGN_ID'
   

2. Buat objek Campaign baru dengan excluded_parent_asset_set_types yang ditetapkan ke nilai sebelumnya plus TRAVEL_FEED dan resource_name yang ditetapkan ke nama resource kampanye Anda.

3. Buat CampaignOperation dan tetapkan update ke Campaign yang dibuat sebelumnya dan update_mask dengan tepat.

4. Kirim permintaan ke CampaignService.MutateCampaigns menggunakan CampaignOperation yang dibuat pada langkah sebelumnya.

Kemudian, hapus semua pengaitan feed perjalanan tingkat kampanye:

1. Untuk kampanye yang ingin Anda batalkan keikutsertaannya, ambil campaign_asset_set.resource_name dan asset_set.resource_name untuk semua link CampaignAssetSet yang jenisnya TRAVEL_FEED menggunakan laporan campaign_asset_set:

   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. Untuk setiap campaign_asset_set.resource_name, buat CampaignAssetSetOperation dan tetapkan remove ke campaign_asset_set.resource_name yang diambil pada langkah sebelumnya.

3. Kirim permintaan ke CampaignAssetSetService.MutateCampaignAssetSets menggunakan objek CampaignAssetSetOperation yang dibuat.

Jika Anda ingin mengaktifkan fitur ini di tingkat kampanye lagi:

1. Untuk setiap AssetSet (asset_set.resource_name) pokok yang ingin Anda ikut sertakan, buat CampaignAssetSet baru dengan asset_set yang ditetapkan ke asset_set.resource_name dan campaign yang ditetapkan ke nama resource kampanye Anda.
2. Untuk setiap CampaignAssetSet yang dibuat di langkah sebelumnya, buat CampaignAssetSetOperation dengan create ditetapkan ke CampaignAssetSet.
3. Kirim permintaan ke CampaignAssetSetService.MutateCampaignAssetSets menggunakan objek CampaignAssetSetOperation yang dibuat.

Memulihkan status keikutsertaan tingkat pelanggan untuk kampanye

Untuk membuat status keikutsertaan kampanye mewarisi setelan tingkat pelanggan lagi, ikuti langkah-langkah berikut:

1. Buat objek Campaign baru dengan excluded_parent_asset_set_types tanpa TRAVEL_FEED dalam daftar dan resource_name ditetapkan ke nama resource kampanye Anda.
2. Buat CampaignOperation dan tetapkan update ke Campaign yang dibuat sebelumnya dan update_mask dengan tepat.
3. Kirim permintaan ke CampaignService.MutateCampaigns menggunakan CampaignOperation yang dibuat pada langkah sebelumnya.

Bidding CPC manual per entitas

Mulai Google Ads API v25, Anda dapat mengonfigurasi penggantian bid CPC manual per entitas untuk hotel di Kampanye Penelusuran untuk Perjalanan menggunakan resource AdGroupCriterion dengan jenis kriteria CriterionType.VERTICAL_ADS_ITEM_BID (ad_group_criterion.entity_bid).

Prasyarat dan persyaratan kompatibilitas

Untuk membuat dan mengelola kriteria VERTICAL_ADS_ITEM_BID, kondisi berikut harus dipenuhi:

• Jenis kampanye: Kampanye Penelusuran untuk Perjalanan (Kampanye Penelusuran, AdvertisingChannelType.SEARCH, dengan AI Maksimal untuk kampanye Penelusuran diaktifkan Campaign.ai_max_setting.enable_ai_max dan feed hotel terkait [kumpulan aset TRAVEL_FEED]; hanya feed hotel yang didukung).
• Strategi bidding: CPC Manual (BiddingStrategyType.MANUAL_CPC) saja.
  • Tidak didukung pada strategi bidding otomatis atau strategi Smart Bidding (seperti Maksimalkan Konversi, Maksimalkan Nilai Konversi, Target CPA, atau Target ROAS).
• Hanya kriteria positif: negative harus disetel ke false. Bid entitas negatif tidak didukung.
• ID dan bid entity yang diperlukan: entity_bid.item_code dan cpc_bid_micros diperlukan saat membuat kriteria bid entity.

Definisi skema dan kolom

• Resource: AdGroupCriterion (ad_group_criterion)
• Format nama resource: customers/{customer_id}/adGroupCriteria/{ad_group_id}~{criterion_id}
• Enum jenis kriteria: CriterionType.VERTICAL_ADS_ITEM_BID
• Pesan: EntityBid (ad_group_criterion.entity_bid)

Layanan dan operasi yang didukung

Contoh kode dan payload

Contoh berikut menunjukkan cara membaca, membuat, memperbarui, dan menghapus kriteria VERTICAL_ADS_ITEM_BID.

Membaca bid entitas menggunakan GAQL

Gunakan GoogleAdsService.Search atau GoogleAdsService.SearchStream untuk mengkueri kriteria VERTICAL_ADS_ITEM_BID:

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'

Membuat bid entity

Kirim operasi create ke AdGroupCriterionService.MutateAdGroupCriteria:

{
  "customerId": "1234567890",
  "operations": [
    {
      "create": {
        "adGroup": "customers/1234567890/adGroups/987654321",
        "negative": false,
        "cpcBidMicros": "1500000",
        "entityBid": {
          "itemCode": "hotel_nyc_12345"
        }
      }
    }
  ]
}

Memperbarui jumlah bid entity yang ada

Kirim operasi update dengan updateMask ke AdGroupCriterionService.MutateAdGroupCriteria:

{
  "customerId": "1234567890",
  "operations": [
    {
      "updateMask": "cpcBidMicros",
      "update": {
        "resourceName": "customers/1234567890/adGroupCriteria/987654321~555444333",
        "cpcBidMicros": "2000000"
      }
    }
  ]
}

Menghapus bid entity

Kirim operasi remove ke AdGroupCriterionService.MutateAdGroupCriteria:

{
  "customerId": "1234567890",
  "operations": [
    {
      "remove": "customers/1234567890/adGroupCriteria/987654321~555444333"
    }
  ]
}

Aturan validasi dan penanganan error

Laporan performa

Anda dapat menggunakan ClickType.TRAVEL_ASSETS untuk mengidentifikasi data performa iklan yang ditayangkan sebagai Feed Perjalanan di Iklan Penelusuran, seperti mengambil data performa untuk iklan di semua kampanye Anda:

SELECT
  campaign.name,
  segments.click_type,
  metrics.impressions,
  metrics.clicks
FROM campaign
WHERE segments.click_type = 'TRAVEL_ASSETS'

Segmen dimensi itinerari

Anda juga dapat menyegmentasikan laporan performa untuk kampanye dengan feed perjalanan tertaut menurut dimensi itinerari:

• segments.advance_booking_window: Periode pemesanan di awal untuk itinerari dalam hari.
• segments.length_of_booking: Durasi pemesanan untuk rencana perjalanan 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).

Contoh kueri

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