Halaman ini diterjemahkan oleh Cloud Translation API.

Kampanye Jasa dan Servis

Kampanye Jasa dan Servis memungkinkan Anda mengiklankan bisnis di Google dan menerima prospek langsung dari calon pelanggan. Panduan ini merangkum operasi yang didukung dan batasan di Google Ads API versi saat ini.

Operasi yang didukung

Mengambil kampanye dan anggaran Jasa dan Servis

Kampanye Jasa dan Servis dapat diambil menggunakan GoogleAdsService.Search atau GoogleAdsService.SearchStream metode untuk mengkueri resource kampanye di mana 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 status kampanye dan anggaran kampanye yang terkait Kolom amount_micros.

Menetapkan strategi bidding kampanye Jasa dan Servis

Anda dapat menetapkan strategi bidding berikut sebagai strategi bidding standar Kampanye Jasa dan Servis:

ManualCpa dengan menetapkan kolom manual_cpa

Anda dapat menetapkan bid sebesar ManualCpa melalui LocalServicesCampaignSettings.category_bids. Anda dapat mengambil dan menetapkan LocalServicesCampaignSettings Jasa dan Servis kampanye Campaign.local_services_campaign_settings.
MaximizeConversions dengan menetapkan kolom maximize_conversions

Tetapkan jadwal iklan sebagai kriteria kampanye

Anda dapat menetapkan jadwal iklan untuk kampanye Jasa dan Servis sebagai kampanye kriteria.

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 Jasa dan Servis, tambahkan LocationInfo dan tetapkan ke location dari CampaignCriterion yang dikirim ke Google Ads API, menggunakan CampaignCriterionService.MutateCampaignCriteria. Untuk detail selengkapnya, lihat Lokasi penargetan.

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 penargetan kampanye location dan category.

Operasi yang tidak didukung

Pembatasan yang tercantum dalam tabel berikut dapat berubah di versi mendatang Google Ads API.

Operasi yang tidak didukung
Membuat dan menghapus kampanye	Google Ads API memblokir pembuatan kampanye Jasa dan Servis baru.
Operasi pada sub-entitas dalam kampanye	Google Ads API tidak mendukung pembuatan, perubahan, penghapusan, atau pengambilan grup iklan, iklan, atau kriteria dalam kampanye Jasa dan Servis.

Referensi Jasa dan Servis

Mulai Google Ads API v15, beberapa data dari Iklan Jasa dan Servis ditampilkan secara langsung di Google Ads API melalui referensi laporan hanya baca berikut:

Agar resource ini dapat menampilkan data, harus ada elemen Jasa dan Servis di akun klien yang membuat permintaan. Dan karena hanya akan ada satu kampanye Jasa dan Servis per akun klien, resource ini menentukan kampanye. Untuk mengidentifikasi kampanye yang berafiliasi dengan resource ini gunakan kueri berikut:

SELECT campaign.id
FROM campaign
WHERE campaign.advertising_channel_type = 'LOCAL_SERVICES'

Prospek Jasa dan Servis

LocalServicesLead menampilkan detail prospek yang dihasilkan saat konsumen menelepon, mengirim pesan, atau memesan layanan dari pengiklan.

Data prospek Jasa dan Servis dapat diambil dari Referensi 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 jika lead_status sama dengan WIPED_OUT.
Data dari prospek yang category_id-nya merupakan bagian dari kategori layanan kesehatan tidak tersedia.

Percakapan prospek Jasa dan Servis

LocalServicesLeadConversation memaparkan detail percakapan yang telah terjadi sebagai bagian dari LocalServicesLead. Ada hubungan {i>one-to-many<i} dengan LocalServicesLead, dengan satu prospek dapat memiliki banyak percakapan. Sumber daya nama untuk prospek terkait dapat ditemukan di kolom lead.

Data percakapan dapat diambil dari local_services_lead_conversation resource Anda Berikut adalah contoh kueri yang memfilter hasil 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 LocalServicesLeadService.AppendLeadConversation untuk menambahkan LocalServicesLeadConversation resource ke LocalServicesLead.

Batasan

Untuk mengakses URL perekaman 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 bisa 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 menampilkan data verifikasi untuk bisnis. Perhatikan bahwa verifikasi dilakukan di tingkat bisnis dan tidak mencakup verifikasi untuk karyawan. Data tersebut meliputi:

Verifikasi lisensi
Verifikasi asuransi
Verifikasi pemeriksaan latar belakang
Verifikasi pendaftaran bisnis

Setiap kali permintaan verifikasi dikirim ke Iklan Jasa dan Servis, instance artefak verifikasi dibuat untuknya di Google Ads API, dan setiap artefak verifikasi mewakili satu permintaan verifikasi. Masing-masing artefak verifikasi mungkin berisi beberapa informasi berikut, tergantung jenis permintaan verifikasi yang diwakilinya:

Status setiap artefak verifikasi
URL pemeriksaan latar belakang yang akan digunakan untuk verifikasi pemeriksaan latar belakang
Waktu adjudikasi pemeriksaan latar belakang (jika ada)
URL dokumen asuransi untuk melihat informasi Asuransi yang sudah 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 cek, nomor pendaftaran)
Alasan penolakan pendaftaran bisnis (jika ada)
URL dokumen pendaftaran bisnis untuk melihat pendaftaran yang telah dikirimkan gambar (jika ada)

Data artefak verifikasi dapat diambil dari local_services_verification_artifact resource Anda Berikut contoh kueri yang mengambil data 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 asuransi dan lisensi geografis dan kategoris

Untuk menentukan status permintaan verifikasi secara terprogram berdasarkan lokasi geografis lokasi, khususnya, kode target geografis) dan kategori jasa dan servis ID, Anda dapat menggunakan di resource customer, yang disebut LocalServicesSetting.

Kolom ini menampilkan ringkasan tingkat tinggi terkait status izin dan asuransi permintaan verifikasi berdasarkan 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 karyawan layanan setempat yang telah diupload pengiklan profil Anda ke dalam sistem kami.

Berikut contoh kueri yang mengambil data 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