Kampanye Jasa dan Servis memungkinkan Anda mengiklankan bisnis Anda di Google dan menerima prospek langsung dari calon pelanggan. Panduan ini merangkum operasi dan batasan yang didukung di Google Ads API versi saat ini.
Operasi yang didukung
Operasi berikut didukung.
Mengambil kampanye dan anggaran Jasa dan Servis
Kampanye dan anggaran Jasa dan Servis dapat diambil menggunakan metode
GoogleAdsService.Search
atau
GoogleAdsService.SearchStream
untuk membuat kueri resource kampanye dengan
advertising_channel_type = 'LOCAL_SERVICES'
. Berikut ini 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 Jasa dan Servis
Anda dapat memperbarui kolom status
kampanye dan
kolom amount_micros
anggaran kampanye terkait.
Menetapkan strategi bidding kampanye Jasa dan Servis
Anda dapat menetapkan strategi bidding berikut sebagai strategi bidding standar untuk kampanye Layanan Lokal:
ManualCpa
dengan menetapkan kolommanual_cpa
Anda dapat menetapkan bid
ManualCpa
melaluiLocalServicesCampaignSettings.category_bids
. Anda dapat mengambil dan menetapkanLocalServicesCampaignSettings
kampanye Jasa dan Servis melaluiCampaign.local_services_campaign_settings
.MaximizeConversions
dengan menetapkan kolommaximize_conversions
Menetapkan jadwal iklan sebagai kriteria kampanye
Anda dapat menetapkan jadwal iklan untuk kampanye Jasa dan Servis 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 Layanan Lokal, tambahkan
LocationInfo
dan tetapkan ke
location
dari
CampaignCriterion
yang dikirim 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.
Operasi yang tidak didukung
Batasan yang tercantum dalam tabel berikut dapat berubah pada versi Google Ads API mendatang.
Operasi yang tidak didukung | |
---|---|
Membuat dan menghapus kampanye | Google Ads API memblokir pembuatan kampanye Layanan Lokal baru. |
Operasi pada sub-entitas di kampanye | Google Ads API tidak mendukung pembuatan, perubahan, penghapusan, atau pengambilan grup iklan, iklan, atau kriteria di kampanye Jasa dan Servis. |
Referensi Jasa dan Servis
Beberapa data dari Iklan Jasa dan Servis ditampilkan langsung di Google Ads API melalui resource laporan hanya baca berikut:
local_services_lead
local_services_lead_conversation
local_services_verification_artifact
local_services_employee
Agar resource ini dapat menampilkan data, harus ada kampanye Layanan Lokal di akun klien yang membuat permintaan. Selain itu, karena hanya boleh ada satu kampanye Jasa dan Servis 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 Jasa dan Servis
LocalServicesLead
mengekspos detail
prospek yang dihasilkan saat konsumen menelepon, mengirim pesan, atau memesan layanan dari
pengiklan.
Data prospek Layanan Lokal dapat diambil dari
resource local_services_lead
. Berikut adalah
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_details
bernilai null jikalead_status
sama denganWIPED_OUT
. - Data dari prospek dengan
category_id
yang merupakan bagian dari kategori layanan kesehatan tidak tersedia.
Percakapan prospek Jasa dan Servis
LocalServicesLeadConversation
mengekspos 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 adalah contoh kueri yang memfilter hasil berupa 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'
Mulai Google Ads API versi 17, 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 setidaknya memiliki 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 Jasa dan Servis
LocalServicesVerificationArtifact
mengekspos data verifikasi untuk bisnis pengiklan. Perhatikan bahwa verifikasi ini berada di tingkat bisnis dan tidak mencakup verifikasi untuk karyawan. Data tersebut mencakup hal berikut:
- Verifikasi lisensi
- Verifikasi asuransi
- Verifikasi pemeriksaan latar belakang
- Verifikasi pendaftaran bisnis
Setiap kali permintaan verifikasi dikirimkan ke Iklan Jasa dan Servis, instance artefak verifikasi baru akan dibuat untuknya di Google Ads API, dan setiap artefak verifikasi mewakili satu permintaan verifikasi. Setiap artefak verifikasi dapat 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 penyelesaian pemeriksaan latar belakang (jika ada)
- URL dokumen asuransi untuk melihat informasi Asuransi yang telah dikirimkan
- Alasan penolakan asuransi (jika ada)
- Detail lisensi (jenis, nomor, nama depan, nama belakang)
- Alasan penolakan lisensi (jika ada)
- URL dokumen lisensi untuk melihat gambar lisensi yang telah dikirimkan (jika ada)
- Detail pendaftaran bisnis (ID pemeriksaan, nomor pendaftaran)
- Alasan penolakan pendaftaran bisnis (jika ada)
- URL dokumen pendaftaran bisnis untuk melihat gambar pendaftaran yang telah dikirimkan (jika ada)
Data artefak verifikasi dapat diambil dari resource
local_services_verification_artifact
. Berikut adalah 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 kategorikal
Untuk menentukan status permintaan verifikasi secara terprogram berdasarkan lokasi geografis, khususnya, kode target geografis) dan
ID kategori layanan lokal, Anda dapat menggunakan kolom baru
di resource customer
, yang disebut
LocalServicesSettings
.
Kolom ini menampilkan ringkasan tingkat tinggi tentang status permintaan verifikasi lisensi dan asuransi menurut lokasi dan kategori. Berikut adalah 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 jasa dan servis
LocalServicesEmployee
mengekspos data
tentang karyawan jasa dan servis yang telah diupload oleh pengiklan ke sistem kami.
Berikut adalah contoh kueri yang mengambil data untuk semua karyawan layanan lokal 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