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

แคมเปญบริการในพื้นที่ช่วยให้คุณโฆษณา ธุรกิจใน 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'
ได้ที่ คู่มือประสิทธิภาพระดับแคมเปญ Performance Max

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ข้อจำกัดที่ระบุไว้ในตารางต่อไปนี้อาจมีการเปลี่ยนแปลงใน Google Ads API เวอร์ชันต่อๆ ไป

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

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

ระบบจะแสดงข้อมูลบางอย่างจากโฆษณาบริการในพื้นที่ โดยตรงใน 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 จะเป็นค่า Null หาก 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)

ตั้งแต่ v26 เป็นต้นไป คุณสามารถสร้างแคมเปญ Performance Max ของบริการในพื้นที่ใหม่ ผ่าน API ได้โดยตั้งค่า local_services_enabled = true ใน pmax_campaign_settings (เปลี่ยนแปลงไม่ได้หลังจากสร้าง) เมื่อสร้างแคมเปญ Performance Max ของบริการในพื้นที่ คุณต้องระบุทั้ง country_code และ listing_id ใน local_services_pmax_campaign_settings ใน v25 และเวอร์ชันก่อนหน้า API รองรับการอัปเดตเท่านั้น สำหรับแคมเปญที่มีอยู่ซึ่งสร้างใน 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 ของผู้ให้บริการ