Kampanye Local Services

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

Operasi yang didukung

Google Ads API mendukung operasi berikut untuk kampanye Jasa dan Servis.

Mengambil kampanye dan anggaran Jasa dan Servis

Kampanye dan anggaran Jasa dan Servis dapat diambil menggunakan metode GoogleAdsService.Search atau GoogleAdsService.SearchStream untuk mengkueri resource Campaign 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

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

• ManualCpa dengan menetapkan kolom manual_cpa

  Anda dapat menetapkan bid ManualCpa melalui LocalServicesCampaignSettings.category_bids. Anda dapat mengambil dan menetapkan LocalServicesCampaignSettings kampanye Jasa dan Servis melalui Campaign.local_services_campaign_settings.

• MaximizeConversions dengan menetapkan kolom maximize_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 Jasa dan Servis, tambahkan LocationInfo dan tetapkan ke kolom 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, buat LocalServiceIdInfo dengan salah satu ID kategori Jasa dan Servis, tetapkan di kolom local_service_id CampaignCriterion, dan kirimkan menggunakan CampaignCriterionService.MutateCampaignCriteria.

Anda harus menggunakan ID layanan yang cocok dengan lokasi dan kategori penargetan kampanye Anda.

Mengirim masukan prospek

Gunakan metode ProvideLeadFeedback dari LocalServicesLeadService untuk mengirimkan rating dan masukan untuk prospek. Anda juga dapat memeriksa kolom lead_feedback_submitted dari LocalServicesLead untuk membantu menentukan apakah prospek telah diberi rating dan masukan telah dikirimkan.

Operasi yang tidak didukung

Tabel berikut mencantumkan operasi yang tidak didukung untuk kampanye Jasa dan Servis mandiri (advertising_channel_type = 'LOCAL_SERVICES').

Referensi Jasa dan Servis

Beberapa data dari Iklan Local Services diekspos 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 menampilkan data, harus ada kampanye Jasa dan Servis atau kampanye Performa Maksimal Jasa dan Servis di akun klien yang membuat permintaan. Kolom local_services_lead.campaign menautkan data prospek kembali ke kampanye terkait (termasuk kampanye Performa Maksimal untuk sasaran bayar per prospek dengan campaign.advertising_channel_type = 'PERFORMANCE_MAX' dan campaign.pmax_campaign_settings.local_services_enabled = true). Untuk mengidentifikasi kampanye yang berafiliasi dengan resource ini, gunakan kueri berikut:

SELECT
  campaign.id,
  campaign.advertising_channel_type,
  campaign.pmax_campaign_settings.local_services_enabled
FROM campaign
WHERE campaign.advertising_channel_type IN ('LOCAL_SERVICES', 'PERFORMANCE_MAX')

Prospek Jasa dan Servis

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

Jenis prospek ditentukan oleh LocalServicesLeadType. Mulai v26, COUPON didukung untuk mengaktifkan jenis prospek kupon di seluruh kampanye Local Services dan kampanye Performa Maksimal untuk Local Services.

Kolom campaign menautkan data prospek kembali ke kampanye terkait. Selain memilih kolom campaign yang diatribusikan (seperti campaign.id dan campaign.name), Anda dapat memfilter kueri prospek berdasarkan nama resource kampanye (WHERE local_services_lead.campaign = ...) atau berdasarkan jenis saluran iklan (WHERE campaign.advertising_channel_type = ...) untuk menyegmentasikan prospek menurut jenis kampanye.

Data prospek Jasa dan Servis 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,
  local_services_lead.campaign
FROM local_services_lead

Batasan

• Kolom contact_details bernilai null jika lead_status sama dengan WIPED_OUT.
• Mulai v25, ContactDetails.email dihapus dan ContactDetails.phone_number_extension tersedia pada pesan ContactDetails yang ditampilkan oleh local_services_lead.contact_details.
• Data dari prospek yang category_id-nya 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, di mana 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 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 tersebut.

• 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_conversation.lead = 'customers/CUSTOMER_ID/localServicesLeads/LEAD_ID'
  

Artefak verifikasi

LocalServicesVerificationArtifact mengekspos data verifikasi untuk bisnis pengiklan. Perhatikan bahwa verifikasi ini dilakukan 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 Local Services, instance artefak verifikasi baru akan dibuat untuk permintaan tersebut 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 penilaian 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 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_override_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 verifikasi geografis dan kategoris

Untuk menentukan status permintaan verifikasi secara terprogram berdasarkan lokasi geografis (khususnya, kode target geografis) dan ID kategori Jasa dan Servis, Anda dapat menggunakan kolom local_services_settings di resource customer, yang memiliki jenis LocalServicesSettings.

Kolom ini menampilkan ringkasan umum status permintaan verifikasi lisensi dan asuransi 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 tentang karyawan jasa dan servis yang profil iklannya 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

Kampanye Performa Maksimal Jasa dan Servis

Kampanye Performa Maksimal mendukung setelan terkait Jasa dan Servis mulai v24. Setelan ini memungkinkan Anda mengonfigurasi dan mengidentifikasi kampanye Performa Maksimal yang menayangkan Iklan Local Services (PMax GLS).

Membuat kampanye Performa Maksimal Jasa dan Servis

Mulai v26, Google Ads API mendukung pembuatan dan pembaruan kampanye Performa Maksimal Jasa dan Servis. Anda dapat membuat kampanye Performa Maksimal Jasa dan Servis baru melalui API dengan membuat kampanye Performa Maksimal (advertising_channel_type = 'PERFORMANCE_MAX') dan menetapkan local_services_enabled = true di pmax_campaign_settings (tidak dapat diubah setelah pembuatan). Saat membuat kampanye Performa Maksimal Jasa dan Servis, country_code dan listing_id diperlukan di local_services_pmax_campaign_settings. Di v24 dan v25, API hanya mendukung pembaruan untuk kampanye Performa Maksimal Jasa dan Servis yang sudah ada yang dibuat di UI oleh akun yang ada dalam daftar yang diizinkan. Untuk petunjuk menyeluruh tentang cara mengonfigurasi prasyarat dan membuat kampanye secara atomik, lihat panduan Performa Maksimal untuk sasaran bayar per lead.

Mengidentifikasi kampanye Performa Maksimal Jasa dan Servis

Untuk mengidentifikasi apakah kampanye Performa Maksimal adalah kampanye Jasa dan Servis, periksa kolom local_services_enabled di pmax_campaign_settings kampanye. Kolom ini adalah boolean yang tidak dapat diubah (CREATE ONLY) yang ditetapkan ke true saat pembuatan kampanye.

Konfigurasi setelan

Untuk kampanye dengan local_services_enabled adalah true, konfigurasikan setelan di bagian kolom local_services_pmax_campaign_settings:

• listing_id: ID listingan Google Profil Bisnis yang ditautkan ke kampanye. Mulai v26, kolom ini wajib diisi dan tidak dapat diubah selama pembuatan kampanye Performa Maksimal Jasa dan Servis. ID listingan harus ditautkan ke akun sebagai aset LOCATION yang diaktifkan; jika tidak, API akan menampilkan error CampaignError.INVALID_LOCAL_SERVICES_PERFORMANCE_MAX_LISTING_ID. Karena listing_id ditandai sebagai IMMUTABLE, upaya untuk memperbarui kolom ini setelah pembuatan kampanye akan gagal dengan RequestError.IMMUTABLE_FIELD. Developer dapat menemukan atau memverifikasi ID listingan tertaut dengan mengkueri resource Asset untuk aset LOCATION yang diaktifkan (memeriksa location_asset.business_profile_locations). Untuk informasi selengkapnya, lihat Aset lokasi.
• navigational_query_leads_enabled: Apakah akan menggunakan filter kueri navigasi.
• founding_year: Tahun pendirian bisnis.
• country_code: Kode negara iklan Local Services. Mulai v26, kolom ini wajib diisi dan tidak dapat diubah, ditetapkan sekali selama pembuatan kampanye. Kode ini adalah kode negara dua huruf dalam huruf besar (saat ini, hanya US yang didukung untuk kampanye Performa Maksimal Jasa dan Servis), yang digunakan untuk menentukan persyaratan verifikasi dan memvalidasi pemilihan kriteria lokasi.
• phone_numbers: Daftar nomor telepon yang terkait dengan penyedia, yang diwakili oleh pesan LocalServicesPhoneNumber. Jika dihilangkan, nomor telepon akan ditetapkan secara default ke nomor telepon di listingan Google Profil Bisnis yang ditautkan, dan wajib diisi jika listingan Profil Bisnis tidak memiliki nomor telepon.

Nomor telepon

Setiap entri dalam 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 oleh GlsPhoneNumberTypeEnum.GlsPhoneNumberType. Jenis yang didukung meliputi:
  • DESTINATION_PHONE_NUMBER_FOR_ADS: Nomor tujuan yang akan digunakan untuk panggilan dari unit iklan Local Services (untuk lead panggilan, default).
  • DESTINATION_PHONE_NUMBER_FOR_SMS_ONLY: Nomor tujuan yang mendukung SMS (opsional, untuk notifikasi SMS prospek pesan).
  • DESTINATION_PHONE_NUMBER_FOR_WHATSAPP_ONLY: Nomor tujuan untuk akun WhatsApp penyedia.