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

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

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

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

คุณดึงข้อมูลแคมเปญบริการในพื้นที่ได้โดยใช้ GoogleAdsService.Search หรือ GoogleAdsService.SearchStream วิธีค้นหาทรัพยากรแคมเปญ 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 ดูรายละเอียดเพิ่มเติมได้ที่ตำแหน่ง การกำหนดเป้าหมาย

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

หากต้องการเปิดใช้การกำหนดเป้าหมายสำหรับประเภทบริการที่เฉพาะเจาะจง ให้เพิ่ม LocalServiceIdInfo และตั้งค่าเป็น ประเภทของ บริการ

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

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

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

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

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

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

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

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
  • ข้อมูลจากโอกาสในการขายที่ 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'

ใน Google Ads API เวอร์ชัน 17 เป็นต้นไป คุณสามารถใช้ 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.id = LEAD_ID
    

อาร์ติแฟกต์การยืนยันสำหรับบริการในพื้นที่

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

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

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

  • สถานะของอาร์ติแฟกต์การยืนยันแต่ละรายการ
  • 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'

ข้อมูลใบอนุญาตและการประกันภัยตามภูมิศาสตร์และตามหมวดหมู่

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

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

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