Kampanye Local Services

Kampanye Local Services memungkinkan Anda mengiklankan bisnis Anda di Google dan menerima lead secara 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 Local Services.

Mengambil kampanye dan anggaran Local Services

Kampanye dan anggaran Local Services dapat diambil menggunakan metode GoogleAdsService.Search atau GoogleAdsService.SearchStream untuk membuat kueri resource Campaign 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

Anda dapat menetapkan strategi bidding berikut sebagai strategi bidding standar kampanye Local Services:

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 kolom 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 Local Services, 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 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 versi Google Ads API mendatang.

Operasi yang tidak didukung
Membuat dan menghapus kampanye Google Ads API memblokir pembuatan kampanye Local Services baru.
Operasi pada sub-entity 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 diekspos langsung di Google Ads API melalui resource laporan hanya baca berikut:

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 mengekspos detail prospek yang dihasilkan 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_details bernilai null jika lead_status sama dengan WIPED_OUT.
  • Mulai v25, ContactDetails.email dihapus dan ContactDetails.phone_number_extension tersedia di pesan ContactDetails yang ditampilkan oleh local_services_lead.contact_details.
  • Data dari prospek dengan category_id yang merupakan bagian dari kategori layanan kesehatan tidak tersedia.

Percakapan prospek Local Services

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

Artefak verifikasi

LocalServicesVerificationArtifact mengekspos 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 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 verifikasi 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 local_services_settings di resource customer, yang memiliki jenis LocalServicesSettings.

Kolom ini mengekspos 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 mengekspos data tentang karyawan Local Services yang diupload pengiklan ke 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. Setelan ini memungkinkan Anda mengonfigurasi dan mengidentifikasi kampanye Performa Maksimal yang menayangkan Iklan Local Services (GLS PMax).

Mulai v26, Anda dapat membuat kampanye Performa Maksimal Local Services baru melalui API dengan menetapkan local_services_enabled = true di pmax_campaign_settings (tidak dapat diubah setelah pembuatan). Saat membuat kampanye Performa Maksimal Local Services, keduanya country_code dan listing_id diperlukan di local_services_pmax_campaign_settings. Di v25 dan versi sebelumnya, API hanya mendukung update untuk kampanye yang ada yang dibuat di UI oleh pengguna dalam daftar yang diizinkan.

Mengidentifikasi kampanye Performa Maksimal Local Services

Untuk mengidentifikasi apakah kampanye Performa Maksimal adalah kampanye Local Services, periksa kolom local_services_enabled di pmax_campaign_settings kampanye.

Mengonfigurasi setelan

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

  • listing_id: ID listingan Google Profil Bisnis yang ditautkan ke kampanye. Mulai v26, kolom ini wajib dan tidak dapat diubah selama pembuatan kampanye Performa Maksimal Local Services. ID listingan harus ditautkan ke akun sebagai aset LOCATION yang diaktifkan; jika tidak, API akan menampilkan CampaignError.INVALID_LOCAL_SERVICES_PERFORMANCE_MAX_LISTING_ID error. Karena listing_id ditandai IMMUTABLE, upaya untuk memperbarui kolom ini setelah pembuatan kampanye akan gagal dengan RequestError.IMMUTABLE_FIELD. Developer dapat menemukan atau memverifikasi ID listingan tertaut dengan membuat kueri resource Asset untuk aset LOCATION yang diaktifkan (memeriksa location_asset.business_profile_locations). Untuk mengetahui 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. 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 oleh LocalServicesPhoneNumber pesan.

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 oleh GlsPhoneNumberTypeEnum.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.