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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

การดำเนินการที่ไม่รองรับ
สร้างและนำแคมเปญออก Google Ads API จะบล็อกการสร้างและนำแคมเปญบริการในพื้นที่แบบสแตนด์อโลน ออก (advertising_channel_type = 'LOCAL_SERVICES') ตั้งแต่ v26 เป็นต้นไป คุณสามารถสร้างแคมเปญ Performance Max ของบริการในพื้นที่ใหม่ (advertising_channel_type = 'PERFORMANCE_MAX') ได้โดยตั้งค่า pmax_campaign_settings.local_services_enabled = true ดู สร้างแคมเปญ Performance Max ของบริการในพื้นที่
การดำเนินการกับเอนทิตีย่อยในแคมเปญ สำหรับแคมเปญบริการในพื้นที่แบบสแตนด์อโลน (advertising_channel_type = 'LOCAL_SERVICES') Google Ads API ไม่รองรับการสร้าง การแก้ไข การนำออก หรือการดึงข้อมูลกลุ่มโฆษณา โฆษณา หรือเกณฑ์อื่นๆ นอกเหนือจากเกณฑ์ของแคมเปญที่ระบุไว้ใน การดำเนินการที่รองรับ สำหรับแคมเปญ Performance Max ของบริการในพื้นที่ ให้ใช้กลุ่มชิ้นงานและเกณฑ์ของแคมเปญ

ทรัพยากรบริการในพื้นที่

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

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

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

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

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

คุณสามารถดึงข้อมูลโอกาสในการขายของบริการในพื้นที่ได้จากทรัพยากร 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
FROM local_services_lead

ข้อจำกัด

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

บทสนทนาเกี่ยวกับโอกาสในการขายของบริการในพื้นที่

LocalServicesLeadConversation จะแสดงรายละเอียดของบทสนทนาที่เกิดขึ้นซึ่งเป็นส่วนหนึ่งของ LocalServicesLead โดยมีความสัมพันธ์แบบ 1 ต่อหลายกับ LocalServicesLead ซึ่งโอกาสในการขาย 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_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'

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

หากต้องการกำหนดสถานะของคำขอการยืนยันตามสถานที่ทางภูมิศาสตร์ (โดยเฉพาะ รหัสเป้าหมายทางภูมิศาสตร์) และ รหัสหมวดหมู่บริการในพื้นที่โดยใช้โปรแกรม คุณสามารถใช้ช่อง 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 เป็นต้นไป คุณสามารถสร้างแคมเปญ 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 เป็นแคมเปญบริการในพื้นที่หรือไม่ ให้ตรวจสอบช่อง local_services_enabled ใน pmax_campaign_settings ของแคมเปญ

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

สำหรับแคมเปญที่ 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: รหัสประเทศของโฆษณาบริการในพื้นที่ ช่องนี้เปลี่ยนแปลงไม่ได้และจะตั้งค่าเพียงครั้งเดียวในระหว่างการสร้างโฆษณา โดยเป็น รหัสประเทศ 2 ตัวอักษรแบบตัวพิมพ์ใหญ่ ซึ่งใช้เพื่อ กำหนดข้อกำหนดการยืนยันและตรวจสอบการเลือก เกณฑ์สถานที่ตั้ง
  • phone_numbers: รายการหมายเลขโทรศัพท์ที่เชื่อมโยงกับ ผู้ให้บริการ ซึ่งแสดงด้วย LocalServicesPhoneNumber ข้อความ

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

รายการแต่ละรายการในช่อง 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
    • DESTINATION_PHONE_NUMBER_FOR_WHATSAPP_ONLY: หมายเลขปลายทางสำหรับบัญชี WhatsApp ของผู้ให้บริการ