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

แคมเปญบริการในพื้นที่ช่วยให้คุณโฆษณาธุรกิจใน 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 ของผู้ให้บริการ