Dengan feed produk Hotel, Rental Akomodasi, atau Rekomendasi 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): Biarkan tingkat pelanggan
CustomerAssetSetditautkan, dan pastikanCampaign.excluded_parent_asset_set_typestidak berisiTRAVEL_FEED. - Memilih tidak menggunakan di tingkat pelanggan: Hapus pengaitan
CustomerAssetSettingkat pelanggan, dan jangan tautkanCampaignAssetSettingkat kampanye. - Memilih tidak ikut untuk kampanye tertentu: Tambahkan
TRAVEL_FEEDkeCampaign.excluded_parent_asset_set_types, dan hapus semua pengaitanCampaignAssetSettingkat kampanye. - Mengaktifkan hanya kampanye tertentu: Hapus pengaitan tingkat pelanggan
CustomerAssetSet, lalu buat penautan tingkat kampanyeCampaignAssetSetuntuk kampanye tersebut. - Gunakan feed khusus kampanye sementara kampanye lain tetap mewarisi: Tambahkan
TRAVEL_FEEDkeCampaign.excluded_parent_asset_set_typeskampanye, dan buat linkCampaignAssetSettingkat kampanye untuk feed tersebut.
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.
Memilih tidak menggunakan feed perjalanan di tingkat pelanggan
Untuk menonaktifkan Feed Perjalanan di Iklan Penelusuran di tingkat pelanggan, lakukan tindakan berikut:
Ambil
customer_asset_set.resource_namedanasset_set.resource_nameuntuk semua linkCustomerAssetSetyang jenisnya adalahTRAVEL_FEEDmenggunakan laporancustomer_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'Untuk setiap
customer_asset_set.resource_name, buatCustomerAssetSetOperationdan tetapkanremovekecustomer_asset_set.resource_nameyang diambil pada langkah sebelumnya.Kirim permintaan ke
CustomerAssetSetService.MutateCustomerAssetSetsmenggunakan objekCustomerAssetSetOperationyang dibuat.
Jika Anda ingin mengaktifkan fitur ini di tingkat pelanggan lagi:
- Untuk setiap
AssetSet(asset_set.resource_name) pokok yang ingin Anda tautkan, buatCustomerAssetSetbaru denganasset_setditetapkan keasset_set.resource_namedancustomerditetapkan ke nama resource pelanggan Anda. - Untuk setiap
CustomerAssetSetyang dibuat di langkah sebelumnya, buatCustomerAssetSetOperationdengancreateyang ditetapkan keCustomerAssetSet. - Kirim permintaan ke
CustomerAssetSetService.MutateCustomerAssetSetsmenggunakan objekCustomerAssetSetOperationyang dibuat.
Menonaktifkan feed perjalanan di tingkat kampanye
Untuk menonaktifkan Feed Perjalanan di Iklan Penelusuran di tingkat kampanye, Anda harus mengecualikan status keikutsertaan yang diwarisi dari tingkat pelanggan terlebih dahulu:
Ambil
excluded_parent_asset_set_typesmenggunakan laporancampaign:SELECT campaign.excluded_parent_asset_set_types FROM campaign WHERE campaign.id = 'INSERT_YOUR_CAMPAIGN_ID'Buat objek
Campaignbaru denganexcluded_parent_asset_set_typesditetapkan ke nilai sebelumnya ditambahTRAVEL_FEEDdanresource_nameditetapkan ke nama resource kampanye Anda.Buat
CampaignOperationdan tetapkanupdatekeCampaignyang dibuat sebelumnya danupdate_masksebagaimana mestinya.Kirim permintaan ke
CampaignService.MutateCampaignsmenggunakanCampaignOperationyang dibuat pada langkah sebelumnya.
Kemudian, hapus semua pengaitan feed perjalanan tingkat kampanye:
Untuk kampanye yang ingin Anda kecualikan, ambil
campaign_asset_set.resource_namedanasset_set.resource_nameuntuk semua linkCampaignAssetSetyang jenisnya adalahTRAVEL_FEEDmenggunakan laporancampaign_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'Untuk setiap
campaign_asset_set.resource_name, buatCampaignAssetSetOperationdan tetapkanremovekecampaign_asset_set.resource_nameyang diambil pada langkah sebelumnya.Kirim permintaan ke
CampaignAssetSetService.MutateCampaignAssetSetsmenggunakan objekCampaignAssetSetOperationyang dibuat.
Jika Anda ingin mengaktifkan fitur ini di tingkat kampanye lagi:
- Untuk setiap
AssetSet(asset_set.resource_name) pokok yang ingin Anda aktifkan, buatCampaignAssetSetbaru denganasset_setditetapkan keasset_set.resource_namedancampaignditetapkan ke nama resource kampanye Anda. - Untuk setiap
CampaignAssetSetyang dibuat di langkah sebelumnya, buatCampaignAssetSetOperationdengancreateyang ditetapkan keCampaignAssetSet. - Kirim permintaan ke
CampaignAssetSetService.MutateCampaignAssetSetsmenggunakan objekCampaignAssetSetOperationyang dibuat.
Memulihkan status keikutsertaan tingkat pelanggan untuk kampanye
Agar status keikutsertaan kampanye mewarisi setelan tingkat pelanggan lagi, ikuti langkah-langkah berikut:
- Buat objek
Campaignbaru denganexcluded_parent_asset_set_typestanpaTRAVEL_FEEDdalam daftar danresource_nameditetapkan ke nama resource kampanye Anda. - Buat
CampaignOperationdan tetapkanupdatekeCampaignyang dibuat sebelumnya danupdate_masksebagaimana mestinya. - Kirim permintaan ke
CampaignService.MutateCampaignsmenggunakanCampaignOperationyang 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). Untuk menetapkan penyesuaian bid grup iklan multiplikatif di seluruh dimensi itinerari perjalanan menggunakan AdGroupBidModifier, lihat Menyesuaikan bid dengan pengubah 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 yang diaktifkan melaluiCampaign.ai_max_setting.enable_ai_maxdan kumpulan aset feed hotelTRAVEL_FEEDterkait; 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:
negativeharus ditetapkan kefalse. Bid entitas negatif tidak didukung. - ID dan bid entitas yang diperlukan:
entity_bid.item_codedancpc_bid_microsdiperlukan saat membuat kriteria bid entitas.
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)
| Kolom | Jenis | Perilaku | Deskripsi |
|---|---|---|---|
entity_bid |
EntityBid |
IMMUTABLE |
Kriteria yang mewakili penggantian bid manual untuk satu item. |
entity_bid.item_code |
string |
IMMUTABLE, wajib |
ID atau kode yang menentukan entitas hotel tertentu (ID listingan hotel) yang cocok dengan feed hotel partner (1 hingga 256 karakter, dipangkas). |
cpc_bid_micros |
int64 |
Baca/Tulis | Jumlah bid CPC manual dalam mikro (misalnya,
1000000 sama dengan $1.00). |
negative |
bool |
IMMUTABLE |
Harus berupa false. |
Layanan dan operasi yang didukung
| Layanan | Metode | Tindakan yang didukung |
|---|---|---|
AdGroupCriterionService |
MutateAdGroupCriteria |
create, update
(cpc_bid_micros), remove |
GoogleAdsService |
Search
/ SearchStream |
Atribut kriteria kueri, kode item, dan nilai bid |
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 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 entity
Kirim operasi remove ke
AdGroupCriterionService.MutateAdGroupCriteria:
{
"customerId": "1234567890",
"operations": [
{
"remove": "customers/1234567890/adGroupCriteria/987654321~555444333"
}
]
}
Aturan validasi dan penanganan error
| Skenario | Pemicu / kondisi | Kode error yang ditampilkan |
|---|---|---|
| Kampanye CPC Non-Manual | Mencoba membuat bid entitas di kampanye dengan bidding otomatis atau Smart Bidding. | ContextError.OPERATION_NOT_PERMITTED_FOR_CONTEXT |
| Jenis kampanye tidak valid | Menambahkan bid entitas ke kampanye non-Penelusuran (misalnya, kampanye Display). | ContextError.OPERATION_NOT_PERMITTED_FOR_CONTEXT |
| Kriteria negatif | Menetapkan negative = true untuk
VERTICAL_ADS_ITEM_BID. |
ContextError.OPERATION_NOT_PERMITTED_FOR_CONTEXT |
| Kode item atau bid tidak ada | Mencoba membuat entity_bid tanpa memberikan
item_code atau cpc_bid_micros. |
RequestError.REQUIRED_FIELD_MISSING
/ FieldError.REQUIRED |
| Mengubah kode item | Mencoba memperbarui entity_bid.item_code pada kriteria yang ada. |
RequestError.IMMUTABLE_FIELD / FieldError.IMMUTABLE_FIELD |
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 itinerari dalam hari.segments.start_date: Tanggal mulai pemesanan yang diformat sebagaiyyyy-MM-dd.segments.start_day_of_week: Hari mulai pemesanan.segments.user_set_dates: Menunjukkan apakah tanggal yang ditentukan pengguna dipilih (USER_SELECTEDatauDEFAULT_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