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.

Interaksi antara setelan pelanggan dan setelan kampanye

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

• Mewarisi feed pelanggan (default): Pertahankan CustomerAssetSet tingkat pelanggan yang ditautkan, dan pastikan Campaign.excluded_parent_asset_set_types tidak berisi TRAVEL_FEED.
• Menonaktifkan di tingkat pelanggan: Hapus hubungan CustomerAssetSet tingkat pelanggan, dan jangan tautkan CampaignAssetSet tingkat kampanye.
• Menonaktifkan kampanye tertentu: Tambahkan TRAVEL_FEED ke Campaign.excluded_parent_asset_set_types, dan hapus hubungan CampaignAssetSet tingkat kampanye.
• Mengaktifkan kampanye tertentu saja: Hapus hubungan CustomerAssetSet tingkat pelanggan, lalu buat link CampaignAssetSet tingkat kampanye untuk kampanye tersebut.
• Menggunakan feed khusus kampanye sementara kampanye lain terus mewarisi: Tambahkan TRAVEL_FEED ke Campaign.excluded_parent_asset_set_types kampanye, dan buat link CampaignAssetSet tingkat kampanye untuknya.

Menonaktifkan Feed Perjalanan di Iklan Penelusuran

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

Menonaktifkan di tingkat pelanggan

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

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

   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) yang ingin Anda tautkan, buat CustomerAssetSet baru dengan asset_set ditetapkan ke asset_set.resource_name dan customer ditetapkan ke nama resource pelanggan Anda.
2. Untuk setiap CustomerAssetSet yang dibuat pada langkah sebelumnya, buat CustomerAssetSetOperation dengan create ditetapkan ke CustomerAssetSet.
3. Kirim permintaan ke CustomerAssetSetService.MutateCustomerAssetSets menggunakan objek CustomerAssetSetOperation yang dibuat.

Menonaktifkan di tingkat kampanye

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

1. Ambil 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 ditetapkan ke nilai sebelumnya ditambah TRAVEL_FEED dan resource_name ditetapkan ke nama resource kampanye Anda.

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

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

Kemudian, hapus hubungan feed perjalanan tingkat kampanye:

1. Untuk kampanye yang ingin Anda nonaktifkan, ambil campaign_asset_set.resource_name dan asset_set.resource_name untuk semua CampaignAssetSet link yang jenisnya adalah 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 lagi di tingkat kampanye:

1. Untuk setiap AssetSet (asset_set.resource_name) yang ingin Anda aktifkan, buat CampaignAssetSet baru dengan asset_set ditetapkan ke asset_set.resource_name dan campaign ditetapkan ke nama resource kampanye Anda.
2. Untuk setiap CampaignAssetSet yang dibuat pada 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 yang sesuai.
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 Maks untuk kampanye Penelusuran diaktifkan Campaign.ai_max_setting.enable_ai_max dan feed hotel terkait [TRAVEL_FEED kumpulan aset]; hanya feed hotel yang didukung).
• Strategi bidding: Hanya CPC Manual (BiddingStrategyType.MANUAL_CPC).
  • 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 ditetapkan ke false. Bid entitas negatif tidak didukung.
• ID dan bid entitas wajib: entity_bid.item_code dan cpc_bid_micros diperlukan saat membuat kriteria bid entitas.

Skema dan definisi 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 membuat kueri VERTICAL_ADS_ITEM_BID kriteria:

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 entitas

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

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 untuk 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 yang ditautkan menurut dimensi itinerari:

• segments.advance_booking_window: Periode pemesanan di awal untuk itinerari dalam beberapa hari.
• segments.length_of_booking: Durasi pemesanan untuk itinerari dalam beberapa hari.
• segments.start_date: Tanggal mulai pemesanan yang diformat sebagai yyyy-MM-dd.
• segments.start_day_of_week: Hari mulai pemesanan dalam seminggu.
• 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