Kampanye Local Services memungkinkan Anda mengiklankan bisnis Anda di Google dan menerima prospek secara langsung dari calon pelanggan. Panduan ini merangkum operasi dan batasan yang didukung dalam Google Ads API versi saat ini.
Operasi yang didukung
Operasi berikut didukung.
Mengambil kampanye dan anggaran Local Services
Kampanye dan anggaran Local Services dapat diambil menggunakan
GoogleAdsService.Search atau
GoogleAdsService.SearchStream
metode untuk membuat kueri resource kampanye dengan
advertising_channel_type = 'LOCAL_SERVICES'. Berikut contohnya:
SELECT
campaign.id,
campaign.status,
campaign_budget.id,
campaign_budget.period,
campaign_budget.amount_micros,
campaign_budget.type
FROM campaign
WHERE campaign.advertising_channel_type = 'LOCAL_SERVICES'
Mengedit kampanye Local Services
Anda dapat memperbarui status kampanye dan
amount_micros anggaran kampanye terkait.
Menetapkan strategi bidding kampanye Local Services
Anda dapat menetapkan strategi bidding berikut sebagai strategi bidding standar kampanye Local Services:
ManualCpadengan menetapkan kolommanual_cpaAnda dapat menetapkan bid
ManualCpamelaluiLocalServicesCampaignSettings.category_bids. Anda dapat mengambil dan menetapkanLocalServicesCampaignSettingskampanye Local Services melaluiCampaign.local_services_campaign_settings.MaximizeConversionsdengan menetapkan kolommaximize_conversions
Menetapkan jadwal iklan sebagai kriteria kampanye
Anda dapat menetapkan jadwal iklan untuk kampanye Local Services sebagai kriteria kampanye.
Buat AdScheduleInfo dan tetapkan ke
ad_schedule dari
CampaignCriterion yang dikirim ke Google Ads API, menggunakan
CampaignCriterionService.MutateCampaignCriteria.
Menetapkan penargetan lokasi
Untuk mengaktifkan penargetan lokasi untuk kampanye Local Services, tambahkan
LocationInfo dan tetapkan ke location dari CampaignCriterion yang di
kirim ke Google Ads API, menggunakan
CampaignCriterionService.MutateCampaignCriteria.
Untuk mengetahui detail selengkapnya, lihat Penargetan
lokasi.
Menargetkan jenis layanan tertentu
Untuk mengaktifkan penargetan untuk jenis layanan tertentu, tambahkan LocalServiceIdInfo dan tetapkan ke jenis
layanan.
Anda harus menggunakan ID layanan yang cocok dengan lokasi dan kategori penargetan kampanye Anda.
Mengirim masukan prospek
Gunakan metode ProvideLeadFeedback() dari
LocalServicesLeadService untuk mengirim
rating dan masukan untuk prospek. Anda juga dapat memeriksa
lead_feedback_submitted kolom dari
LocalServicesLead untuk membantu menentukan
apakah prospek diberi rating dan masukan dikirimkan.
Operasi yang tidak didukung
Batasan yang tercantum dalam tabel berikut dapat berubah di Google Ads API versi mendatang.
| Operasi yang tidak didukung | |
|---|---|
| Membuat dan menghapus kampanye | Google Ads API memblokir pembuatan kampanye Local Services baru. |
| Operasi pada sub-entitas dalam kampanye | Google Ads API tidak mendukung pembuatan, modifikasi, penghapusan, atau pengambilan grup iklan, iklan, atau kriteria dalam kampanye Local Services. |
Resource Local Services
Beberapa data dari Iklan Local Services ditampilkan langsung di Google Ads API melalui resource laporan hanya baca berikut ini:
local_services_leadlocal_services_lead_conversationlocal_services_verification_artifactlocal_services_employee
Agar resource ini menampilkan data, harus ada kampanye Local Services di akun klien yang membuat permintaan. Karena hanya boleh ada satu kampanye Local Services per akun klien, resource ini tidak menentukan kampanye. Untuk mengidentifikasi kampanye yang terkait dengan resource ini, gunakan kueri berikut:
SELECT campaign.id
FROM campaign
WHERE campaign.advertising_channel_type = 'LOCAL_SERVICES'
Prospek Local Services
LocalServicesLead menampilkan detail prospek yang dibuat saat konsumen menelepon, mengirim pesan, atau memesan layanan dari pengiklan.
Data prospek Local Services dapat diambil dari resource local_services_lead. Berikut contoh kueri:
SELECT
local_services_lead.lead_type,
local_services_lead.category_id,
local_services_lead.service_id,
local_services_lead.contact_details,
local_services_lead.lead_status,
local_services_lead.creation_date_time,
local_services_lead.locale,
local_services_lead.lead_charged,
local_services_lead.credit_details.credit_state,
local_services_lead.credit_details.credit_state_last_update_date_time
FROM local_services_lead
Batasan
- Kolom
contact_detailsbernilai null jikalead_statussama denganWIPED_OUT. - Data dari prospek dengan
category_idyang merupakan bagian dari kategori layanan kesehatan tidak tersedia.
Percakapan prospek Local Services
LocalServicesLeadConversation
menampilkan detail percakapan yang telah terjadi sebagai bagian dari
LocalServicesLead. Ada hubungan one-to-many dengan LocalServicesLead, dengan satu prospek dapat memiliki banyak percakapan. Nama resource untuk prospek terkait dapat ditemukan di kolom lead.
Data percakapan dapat diambil dari resource.local_services_lead_conversation Berikut contoh kueri yang memfilter hasil yang merupakan panggilan telepon:
SELECT
local_services_lead_conversation.id,
local_services_lead_conversation.conversation_channel,
local_services_lead_conversation.participant_type,
local_services_lead_conversation.lead,
local_services_lead_conversation.event_date_time,
local_services_lead_conversation.phone_call_details.call_duration_millis,
local_services_lead_conversation.phone_call_details.call_recording_url,
local_services_lead_conversation.message_details.text,
local_services_lead_conversation.message_details.attachment_urls
FROM local_services_lead_conversation
WHERE local_services_lead_conversation.conversation_channel = 'PHONE_CALL'
Anda dapat menggunakan metode
LocalServicesLeadService.AppendLeadConversation
untuk menambahkan resource
LocalServicesLeadConversation
ke LocalServicesLead.
Batasan
- Untuk mengakses URL rekaman panggilan, Anda harus login dengan alamat email yang memiliki setidaknya akses hanya baca ke akun klien Google Ads yang memiliki kampanye yang terkait dengan prospek.
Meminta semua percakapan sekaligus dapat menjadi permintaan yang memakan waktu, jadi Anda harus memfilter percakapan berdasarkan prospek, misalnya:
SELECT local_services_lead_conversation.id, local_services_lead_conversation.event_date_time, local_services_lead_conversation.message_details.text FROM local_services_lead_conversation WHERE local_services_lead.id = LEAD_ID
Artefak verifikasi Local Services
LocalServicesVerificationArtifact
menampilkan data verifikasi untuk bisnis pengiklan. Perhatikan bahwa verifikasi ini berada di tingkat bisnis dan tidak mencakup verifikasi untuk karyawan. Data ini mencakup hal berikut:
- Verifikasi lisensi
- Verifikasi asuransi
- Verifikasi pemeriksaan latar belakang
- Verifikasi pendaftaran bisnis
Setiap kali permintaan verifikasi dikirimkan ke Iklan Local Services, instance artefak verifikasi baru akan dibuat untuknya di Google Ads API, dan setiap artefak verifikasi mewakili satu permintaan verifikasi. Setiap artefak verifikasi mungkin berisi beberapa informasi berikut, bergantung pada jenis permintaan verifikasi yang diwakilinya:
- Status setiap artefak verifikasi
- URL pemeriksaan latar belakang yang akan digunakan untuk verifikasi pemeriksaan latar belakang
- Waktu pertimbangan pemeriksaan latar belakang (jika berlaku)
- URL dokumen asuransi untuk melihat informasi Asuransi yang telah dikirimkan
- Alasan penolakan asuransi (jika berlaku)
- Detail lisensi (jenis, nomor, nama depan, nama belakang)
- Alasan penolakan lisensi (jika berlaku)
- URL dokumen lisensi untuk melihat gambar lisensi yang telah dikirimkan (jika berlaku)
- Detail dokumen pendaftaran bisnis (ID pemeriksaan, nomor pendaftaran)
- Alasan penolakan pendaftaran bisnis (jika berlaku)
- URL dokumen pendaftaran bisnis untuk melihat gambar pendaftaran yang telah dikirimkan (jika berlaku)
Data artefak verifikasi dapat diambil dari
local_services_verification_artifact
resource. Berikut contoh kueri yang mengambil data untuk semua artefak verifikasi terkait lisensi untuk akun klien tertentu:
SELECT
local_services_verification_artifact.id,
local_services_verification_artifact.creation_date_time,
local_services_verification_artifact.status,
local_services_verification_artifact.artifact_type,
local_services_verification_artifact.license_verification_artifact.license_type,
local_services_verification_artifact.license_verification_artifact.license_number,
local_services_verification_artifact.license_verification_artifact.licensee_first_name,
local_services_verification_artifact.license_verification_artifact.licensee_last_name,
local_services_verification_artifact.license_verification_artifact.rejection_reason
FROM local_services_verification_artifact
WHERE local_services_verification_artifact.artifact_type = 'LICENSE'
Data lisensi dan asuransi geografis dan kategoris
Untuk menentukan status permintaan verifikasi secara terprogram berdasarkan lokasi
geografis, khususnya, kode target geografis) dan
ID kategori Local Services, Anda dapat menggunakan
kolom baru di resource customer, yang disebut
LocalServicesSettings.
Kolom ini menampilkan ringkasan tingkat tinggi status permintaan verifikasi lisensi dan asuransi berdasarkan lokasi dan kategori. Berikut contoh kueri yang mengambil semua data tersebut:
SELECT
customer.local_services_settings.granular_license_statuses,
customer.local_services_settings.granular_insurance_statuses
FROM customer
Karyawan Local Services
LocalServicesEmployee menampilkan data tentang karyawan Local Services yang diupload pengiklan profil iklan mereka ke sistem kami.
Berikut contoh kueri yang mengambil data untuk semua karyawan Local Services untuk akun klien tertentu:
SELECT
local_services_employee.status,
local_services_employee.type,
local_services_employee.university_degrees,
local_services_employee.residencies,
local_services_employee.fellowships,
local_services_employee.job_title,
local_services_employee.year_started_practicing,
local_services_employee.languages_spoken,
local_services_employee.first_name,
local_services_employee.middle_name,
local_services_employee.last_name
FROM local_services_employee
Kampanye Performa Maksimal Local Services
Kampanye Performa Maksimal mendukung setelan terkait Local Services mulai dari v24.2. Setelan ini memungkinkan Anda mengonfigurasi dan mengidentifikasi kampanye Performa Maksimal yang menayangkan Iklan Local Services (GLS PMax).
Mengidentifikasi kampanye Performa Maksimal Local Services
Untuk mengidentifikasi apakah kampanye Performa Maksimal adalah kampanye Local Services,
periksa kolom local_services_enabled hanya baca di
pmax_campaign_settings kampanye.
Mengonfigurasi setelan
Untuk kampanye dengan local_services_enabled adalah true, konfigurasi setelan
di kolom
local_services_pmax_campaign_settings:
navigational_query_leads_enabled: Apakah akan menggunakan filter kueri navigasi.founding_year: Tahun pendirian bisnis.country_code: Kode negara Iklan Local Services. Kolom ini tidak dapat diubah dan ditetapkan sekali selama pembuatan iklan. Kolom ini adalah kode negara dua huruf huruf besar, yang digunakan untuk menentukan persyaratan verifikasi dan memvalidasi pemilihan kriteria lokasi.phone_numbers: Daftar nomor telepon yang terkait dengan penyedia layanan, yang diwakili olehLocalServicesPhoneNumberpesan.
Nomor telepon
Setiap entri di kolom berulang phone_numbers menggunakan jenis pesan
LocalServicesPhoneNumber dengan
kolom berikut:
phone_number: Nomor telepon.country_code: Kode negara dua huruf huruf besar .phone_number_type: Jenis nomor telepon, yang ditentukan olehGlsPhoneNumberTypeEnum.GlsPhoneNumberType. Jenis yang didukung mencakup:DESTINATION_PHONE_NUMBER_FOR_ADS: Nomor tujuan yang akan digunakan untuk panggilan dari unit iklan Local Services (default).DESTINATION_PHONE_NUMBER_FOR_SMS_ONLY: Nomor tujuan yang mendukung SMS.DESTINATION_PHONE_NUMBER_FOR_WHATSAPP_ONLY: Nomor tujuan untuk akun WhatsApp penyedia layanan.