แคมเปญบริการในพื้นที่

แคมเปญบริการในพื้นที่ช่วยให้คุณโฆษณาธุรกิจใน Google พร้อมรับโอกาสในการขายจากผู้มีโอกาสเป็นลูกค้าได้โดยตรง คู่มือนี้จะสรุปการดำเนินการและข้อจำกัดที่รองรับใน Google Ads API

การดำเนินการที่รองรับ

Google Ads API รองรับการดำเนินการต่อไปนี้สำหรับแคมเปญบริการในพื้นที่

ดึงข้อมูลแคมเปญและงบประมาณบริการในพื้นที่

คุณสามารถเรียกดูแคมเปญและงบประมาณของบริการในพื้นที่ได้โดยใช้เมธอด GoogleAdsService.Search หรือ GoogleAdsService.SearchStream เพื่อค้นหาทรัพยากร Campaign โดยที่ advertising_channel_type = 'LOCAL_SERVICES' มีตัวอย่างดังต่อไปนี้

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'

แก้ไขแคมเปญบริการในพื้นที่

คุณสามารถอัปเดตช่อง status ของแคมเปญและช่อง amount_micros ของงบประมาณแคมเปญที่เชื่อมโยงได้

กำหนดกลยุทธ์การเสนอราคา

คุณตั้งค่ากลยุทธ์การเสนอราคาต่อไปนี้เป็นกลยุทธ์การเสนอราคามาตรฐานของแคมเปญบริการในพื้นที่ได้

• ManualCpa โดยการตั้งค่าช่อง manual_cpa

  คุณตั้งราคาเสนอของ ManualCpa ได้ผ่าน LocalServicesCampaignSettings.category_bids คุณสามารถเรียกข้อมูลและตั้งค่า LocalServicesCampaignSettings ของแคมเปญบริการในพื้นที่ผ่าน Campaign.local_services_campaign_settings ได้

• MaximizeConversions โดยตั้งค่าช่อง maximize_conversions

ตั้งค่าช่วงเวลาที่โฆษณาทำงานเป็นเกณฑ์ของแคมเปญ

คุณสามารถตั้งค่าช่วงเวลาที่โฆษณาทำงานสำหรับแคมเปญบริการในพื้นที่เป็นเกณฑ์แคมเปญได้

สร้าง AdScheduleInfo และตั้งค่าเป็น ad_schedule ของ CampaignCriterion ที่ส่งไปยัง Google Ads API โดยใช้ CampaignCriterionService.MutateCampaignCriteria

ตั้งค่าการกำหนดเป้าหมายตามสถานที่

หากต้องการเปิดใช้การกำหนดเป้าหมายตามสถานที่สำหรับแคมเปญบริการในพื้นที่ ให้เพิ่ม LocationInfo และตั้งค่าเป็นช่อง location ของ CampaignCriterion ที่ส่งไปยัง Google Ads API โดยใช้ CampaignCriterionService.MutateCampaignCriteria ดูรายละเอียดเพิ่มเติมได้ที่การกำหนดเป้าหมายตามสถานที่

กำหนดเป้าหมายประเภทบริการที่เจาะจง

หากต้องการเปิดใช้การกำหนดเป้าหมายสำหรับประเภทบริการที่เฉพาะเจาะจง ให้สร้าง LocalServiceIdInfo ที่มีรหัสหมวดหมู่บริการในพื้นที่รหัสใดรหัสหนึ่ง แล้วตั้งค่าในช่อง local_service_id ของ CampaignCriterion จากนั้นส่งโดยใช้ CampaignCriterionService.MutateCampaignCriteria

คุณควรใช้รหัสบริการที่ตรงกับสถานที่ตั้งและหมวดหมู่เป้าหมายของแคมเปญ

ส่งความคิดเห็นเกี่ยวกับโอกาสในการขาย

ใช้เมธอด ProvideLeadFeedback ของ LocalServicesLeadService เพื่อส่งคะแนนและความคิดเห็นสำหรับโอกาสในการขาย นอกจากนี้ คุณยังตรวจสอบช่อง lead_feedback_submitted ของ LocalServicesLead เพื่อช่วยระบุว่ามีการให้คะแนนโอกาสในการขายและส่งความคิดเห็นหรือไม่

การดำเนินการที่ไม่รองรับ

ตารางต่อไปนี้แสดงการดำเนินการที่ไม่รองรับสำหรับแคมเปญบริการในพื้นที่แบบสแตนด์อโลน (advertising_channel_type = 'LOCAL_SERVICES')

แหล่งข้อมูลเกี่ยวกับบริการในพื้นที่

ข้อมูลบางอย่างจากโฆษณาบริการในพื้นที่จะแสดงใน Google Ads API โดยตรงผ่านแหล่งข้อมูลรายงานแบบอ่านอย่างเดียวต่อไปนี้

• local_services_lead
• local_services_lead_conversation
• local_services_verification_artifact
• local_services_employee

เพื่อให้ทรัพยากรเหล่านี้แสดงผลข้อมูล จะต้องมีแคมเปญบริการในพื้นที่หรือแคมเปญ Performance Max สำหรับบริการในพื้นที่ในบัญชีลูกค้าที่ส่งคำขอ ช่อง local_services_lead.campaign จะลิงก์ระเบียนโอกาสในการขายกลับไปยังแคมเปญที่เกี่ยวข้อง (รวมถึงแคมเปญ Performance Max สำหรับเป้าหมายแบบจ่ายต่อผู้สนใจรับบริการที่ campaign.advertising_channel_type = 'PERFORMANCE_MAX' และ campaign.pmax_campaign_settings.local_services_enabled = true) หากต้องการระบุแคมเปญที่แหล่งข้อมูลเหล่านี้เชื่อมโยงอยู่ ให้ใช้คำค้นหาต่อไปนี้

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')

ผู้มีโอกาสเป็นลูกค้าของบริการในพื้นที่

LocalServicesLead แสดงรายละเอียดของโอกาสในการขายที่สร้างขึ้นเมื่อผู้บริโภคโทร ส่งข้อความ จองบริการ หรือใช้คูปองจากผู้ลงโฆษณา

ประเภทผู้มีโอกาสเป็นลูกค้าจะกำหนดโดย LocalServicesLeadType ตั้งแต่เดือนv26เป็นต้นไป ระบบจะรองรับ COUPON เพื่อเปิดใช้ประเภทโอกาสในการขายคูปองในแคมเปญบริการในพื้นที่และแคมเปญ Performance Max สำหรับบริการในพื้นที่

ช่อง campaign จะลิงก์ระเบียนโอกาสในการขายกลับไปยังแคมเปญที่เชื่อมโยง นอกจากการเลือกช่อง campaign ที่ระบุแหล่งที่มา (เช่น campaign.id และ campaign.name) คุณยังกรองคำค้นหาโอกาสในการขายตามชื่อทรัพยากรแคมเปญ (WHERE local_services_lead.campaign = ...) หรือตามประเภทช่องทางโฆษณา (WHERE campaign.advertising_channel_type = ...) เพื่อแบ่งกลุ่มโอกาสในการขายตามประเภทแคมเปญได้

คุณสามารถดึงข้อมูลโอกาสในการขายของบริการในพื้นที่ได้จากทรัพยากร local_services_lead ตัวอย่างการค้นหา

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

ข้อจำกัด

• ช่อง contact_details จะเป็น Null หาก lead_status เท่ากับ WIPED_OUT
• ตั้งแต่เดือนv25เป็นต้นไป ระบบจะนำ ContactDetails.email ออก และ ContactDetails.phone_number_extension จะพร้อมใช้งานในข้อความ ContactDetails ที่ local_services_lead.contact_details แสดงผล
• ข้อมูลจากโอกาสในการขายที่ category_id เป็นส่วนหนึ่งของหมวดหมู่การดูแลสุขภาพจะไม่พร้อมใช้งาน

การสนทนากับผู้มีโอกาสเป็นลูกค้าของบริการในพื้นที่

LocalServicesLeadConversation จะแสดงรายละเอียดของการสนทนาที่เกิดขึ้นซึ่งเป็นส่วนหนึ่งของ LocalServicesLead ความสัมพันธ์กับ LocalServicesLead เป็นแบบ 1 ต่อหลาย โดยที่ผู้มีโอกาสเป็นลูกค้า 1 รายสามารถมีการสนทนาได้หลายรายการ ชื่อทรัพยากรของผู้มีโอกาสเป็นลูกค้าที่เกี่ยวข้องจะอยู่ในช่อง lead

คุณสามารถดึงข้อมูลการสนทนาได้จากทรัพยากร local_services_lead_conversation ต่อไปนี้คือตัวอย่างการค้นหาที่กรองผลลัพธ์ที่เป็นการโทร

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'

คุณสามารถใช้เมธอด LocalServicesLeadService.AppendLeadConversation เพื่อเพิ่มทรัพยากร LocalServicesLeadConversation ต่อท้าย LocalServicesLead ได้

ข้อจำกัด

• หากต้องการเข้าถึง URL ของการบันทึกการโทร คุณต้องลงชื่อเข้าใช้ด้วยอีเมลที่มีสิทธิ์เข้าถึงระดับอ่านอย่างเดียวเป็นอย่างน้อยในบัญชีลูกค้า Google Ads ที่เป็นเจ้าของแคมเปญที่เชื่อมโยงกับโอกาสในการขาย

• การขอการสนทนาทั้งหมดพร้อมกันอาจใช้เวลานาน ดังนั้นคุณควรกรองการสนทนาตามผู้มีโอกาสเป็นลูกค้า เช่น

  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'
  

อาร์ติแฟกต์การยืนยัน

LocalServicesVerificationArtifact แสดงข้อมูลการยืนยันสำหรับธุรกิจของผู้ลงโฆษณา โปรดทราบว่าการยืนยันเหล่านี้เป็นการยืนยันในระดับธุรกิจ และไม่รวมถึงการยืนยันสำหรับพนักงาน ซึ่งจะประกอบไปด้วยข้อมูลดังต่อไปนี้

• การยืนยันใบอนุญาต
• การยืนยันการประกันภัย
• การยืนยันการตรวจสอบภูมิหลัง
• การยืนยันการจดทะเบียนธุรกิจ

ทุกครั้งที่มีการส่งคำขอยืนยันไปยังโฆษณาบริการในพื้นที่ ระบบจะสร้างอินสแตนซ์อาร์ติแฟกต์การยืนยันใหม่ใน Google Ads API และอาร์ติแฟกต์การยืนยันแต่ละรายการจะแสดงคำขอยืนยันรายการเดียว อาร์ติแฟกต์การยืนยันแต่ละรายการอาจมีข้อมูลต่อไปนี้บางส่วน ทั้งนี้ขึ้นอยู่กับประเภทของคำขอยืนยันที่อาร์ติแฟกต์นั้นแสดง

• สถานะของอาร์ติแฟกต์การยืนยันแต่ละรายการ
• URL การตรวจสอบภูมิหลังที่จะใช้สำหรับการยืนยันการตรวจสอบภูมิหลัง
• เวลาในการพิจารณาการตรวจสอบภูมิหลัง (หากมี)
• URL ของเอกสารประกันภัยเพื่อดูข้อมูลประกันภัยที่ส่งไปแล้ว
• เหตุผลที่ปฏิเสธการประกัน (หากมี)
• รายละเอียดใบอนุญาต (ประเภท หมายเลข ชื่อ นามสกุล)
• เหตุผลที่ปฏิเสธใบอนุญาต (หากมี)
• URL ของเอกสารใบอนุญาตเพื่อดูรูปภาพใบอนุญาตที่ส่งแล้ว (หากมี)
• รายละเอียดการจดทะเบียนธุรกิจ (ตรวจสอบรหัส หมายเลขจดทะเบียน)
• เหตุผลที่ปฏิเสธการจดทะเบียนธุรกิจ (หากมี)
• URL ของเอกสารการจดทะเบียนธุรกิจเพื่อดูรูปภาพการจดทะเบียนที่ส่งแล้ว (หากมี)

คุณสามารถดึงข้อมูลอาร์ติแฟกต์การยืนยันได้จากทรัพยากร local_services_verification_artifact ต่อไปนี้คือตัวอย่างการค้นหาที่ดึงข้อมูลอาร์ติแฟกต์การยืนยันที่เกี่ยวข้องกับใบอนุญาตทั้งหมดสำหรับบัญชีลูกค้าหนึ่งๆ

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'

ข้อมูลการยืนยันทางภูมิศาสตร์และหมวดหมู่

หากต้องการระบุสถานะของคำขอการยืนยันตามสถานที่ตั้งทางภูมิศาสตร์ (โดยเฉพาะรหัสเป้าหมายทางภูมิศาสตร์) และรหัสหมวดหมู่บริการในพื้นที่แบบเป็นโปรแกรม คุณสามารถใช้ช่อง local_services_settings ในทรัพยากร customer ซึ่งมีประเภท LocalServicesSettings

ช่องนี้จะแสดงข้อมูลสรุประดับสูงเกี่ยวกับสถานะของคำขอการยืนยันใบอนุญาตและการประกันภัยตามสถานที่ตั้งและหมวดหมู่ ตัวอย่างการค้นหาที่ดึงข้อมูลดังกล่าวทั้งหมดมีดังนี้

SELECT
  customer.local_services_settings.granular_license_statuses,
  customer.local_services_settings.granular_insurance_statuses
FROM customer

พนักงานของบริการในพื้นที่

LocalServicesEmployee แสดงข้อมูลเกี่ยวกับพนักงานบริการในพื้นที่ซึ่งผู้ลงโฆษณาได้อัปโหลดโปรไฟล์โฆษณาลงในระบบของเรา

ต่อไปนี้คือตัวอย่างการค้นหาที่ดึงข้อมูลพนักงานบริการในพื้นที่ทั้งหมดสำหรับบัญชีลูกค้าที่ระบุ

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

แคมเปญ Performance Max สำหรับบริการในพื้นที่

แคมเปญ Performance Max รองรับการตั้งค่าที่เกี่ยวข้องกับบริการในพื้นที่ตั้งแต่ v24 เป็นต้นไป การตั้งค่าเหล่านี้ช่วยให้คุณกำหนดค่าและระบุแคมเปญ Performance Max ที่แสดงโฆษณาบริการในพื้นที่ (GLS PMax) ได้

สร้างแคมเปญ Performance Max สำหรับบริการในพื้นที่

ตั้งแต่ v26 เป็นต้นไป Google Ads API จะรองรับทั้งการสร้างและการอัปเดตแคมเปญ Performance Max สำหรับบริการในพื้นที่ คุณสร้างแคมเปญ Performance Max สำหรับบริการในพื้นที่ใหม่ผ่าน API ได้โดยสร้างแคมเปญ Performance Max (advertising_channel_type = 'PERFORMANCE_MAX') และตั้งค่า local_services_enabled = true ใน pmax_campaign_settings (เปลี่ยนแปลงไม่ได้หลังจากสร้าง) เมื่อสร้างแคมเปญ Performance Max สำหรับบริการในพื้นที่ คุณต้องระบุทั้ง country_code และ listing_id ใน local_services_pmax_campaign_settings ใน v24 และ v25 API จะรองรับการอัปเดตเท่านั้นสําหรับแคมเปญ Performance Max สำหรับบริการในพื้นที่ที่มีอยู่ซึ่งสร้างใน UI โดยบัญชีในรายการที่อนุญาต ดูวิธีการแบบครบวงจรในการกําหนดค่าข้อกําหนดเบื้องต้นและการสร้างแคมเปญแบบแยกส่วนได้ที่คู่มือ Performance Max สําหรับเป้าหมายแบบจ่ายต่อผู้สนใจรับบริการ

ระบุแคมเปญ Performance Max สำหรับบริการในพื้นที่

หากต้องการระบุว่าแคมเปญ Performance Max เป็นแคมเปญบริการในพื้นที่หรือไม่ ให้ตรวจสอบช่อง local_services_enabled ใน pmax_campaign_settings ของแคมเปญ ฟิลด์นี้เป็นบูลีนที่เปลี่ยนแปลงไม่ได้ (CREATE ONLY) ซึ่งตั้งค่าเป็น true เมื่อสร้างแคมเปญ

กำหนดการตั้งค่า

สำหรับแคมเปญที่ local_services_enabled เป็น true ให้กำหนดการตั้งค่าในช่อง local_services_pmax_campaign_settings ดังนี้

• listing_id: รหัสข้อมูล Google Business Profile ที่ลิงก์กับแคมเปญ ตั้งแต่เดือนv26 เป็นต้นไป ช่องนี้เป็นช่องที่ต้องกรอกและเปลี่ยนแปลงไม่ได้ในระหว่างการสร้างแคมเปญ Performance Max สำหรับบริการในพื้นที่ รหัสข้อมูลต้องลิงก์กับบัญชีเป็นชิ้นงาน LOCATION ที่เปิดใช้ ไม่เช่นนั้น API จะแสดงข้อผิดพลาด CampaignError.INVALID_LOCAL_SERVICES_PERFORMANCE_MAX_LISTING_ID เนื่องจาก listing_id มีการทำเครื่องหมายเป็น IMMUTABLE การพยายามอัปเดตช่องนี้หลังจากสร้างแคมเปญจึงไม่สำเร็จโดยมีข้อผิดพลาด RequestError.IMMUTABLE_FIELD นักพัฒนาแอปสามารถค้นหาหรือยืนยันรหัสข้อมูลที่ลิงก์ได้โดยค้นหาทรัพยากร Asset เพื่อดูชิ้นงาน LOCATION ที่เปิดใช้ (ตรวจสอบ location_asset.business_profile_locations) ดูข้อมูลเพิ่มเติมได้ที่ชิ้นงานสถานที่ตั้ง
• navigational_query_leads_enabled: ระบุว่าจะใช้ตัวกรองคำค้นหาที่เป็นการนำทางหรือไม่
• founding_year: ปีที่ก่อตั้งธุรกิจ
• country_code: รหัสประเทศของโฆษณาบริการในพื้นที่ ตั้งแต่ v26 เป็นต้นไป ช่องนี้เป็นช่องที่ต้องกรอกและเปลี่ยนแปลงไม่ได้ โดยตั้งค่าได้เพียงครั้งเดียวระหว่างการสร้างแคมเปญ เป็นรหัสประเทศ 2 ตัวอักษรพิมพ์ใหญ่ (ปัจจุบันแคมเปญ Performance Max สำหรับบริการในพื้นที่รองรับเฉพาะ US เท่านั้น) ซึ่งใช้เพื่อกำหนดข้อกำหนดในการยืนยันและตรวจสอบความถูกต้องของการเลือกเกณฑ์สถานที่ตั้ง
• phone_numbers: รายการหมายเลขโทรศัพท์ที่เชื่อมโยงกับผู้ให้บริการ ซึ่งแสดงด้วยข้อความ LocalServicesPhoneNumber หากละเว้น หมายเลขโทรศัพท์จะใช้ค่าเริ่มต้นเป็นหมายเลขโทรศัพท์ในข้อมูล Google Business Profile ที่ลิงก์ และจำเป็นต้องระบุหากข้อมูล Business Profile ไม่มีหมายเลขโทรศัพท์

หมายเลขโทรศัพท์

แต่ละรายการในฟิลด์ที่ซ้ำได้ phone_numbers จะใช้ประเภทข้อความ LocalServicesPhoneNumber กับฟิลด์ต่อไปนี้

• phone_number: หมายเลขโทรศัพท์
• country_code: รหัสประเทศ 2 ตัวอักษรพิมพ์ใหญ่
• phone_number_type: ประเภทของหมายเลขโทรศัพท์ที่กำหนดโดย GlsPhoneNumberTypeEnum.GlsPhoneNumberType ประเภทที่รองรับมีดังนี้
  • DESTINATION_PHONE_NUMBER_FOR_ADS: หมายเลขปลายทางที่จะใช้สำหรับการโทรจากหน่วยโฆษณาบริการในพื้นที่ (สำหรับโอกาสในการขายจากการโทร ซึ่งเป็นค่าเริ่มต้น)
  • DESTINATION_PHONE_NUMBER_FOR_SMS_ONLY: หมายเลขปลายทางที่รองรับ SMS (ไม่บังคับ สำหรับการแจ้งเตือนทาง SMS เกี่ยวกับโอกาสในการขายผ่านข้อความ)
  • DESTINATION_PHONE_NUMBER_FOR_WHATSAPP_ONLY: หมายเลขปลายทางสำหรับบัญชี WhatsApp ของผู้ให้บริการ