แคมเปญบริการในพื้นที่ ช่วยให้คุณโฆษณาธุรกิจบน 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
ช่อง
กำหนดกลยุทธ์การเสนอราคาของแคมเปญบริการในพื้นที่
คุณสามารถตั้งค่ากลยุทธ์การเสนอราคาต่อไปนี้เป็นกลยุทธ์การเสนอราคามาตรฐาน แคมเปญบริการในพื้นที่
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
และตั้งค่าเป็น
ประเภทของ
บริการ
คุณควรใช้รหัสบริการที่ตรงกับการกำหนดเป้าหมายของแคมเปญ location และ category
การดำเนินการที่ไม่รองรับ
ข้อจำกัดที่ระบุในตารางต่อไปนี้สามารถเปลี่ยนแปลงได้ในเวอร์ชันต่อๆ ไปของ Google Ads API
การดำเนินการที่ไม่รองรับ | |
---|---|
สร้างและนำแคมเปญออก | Google Ads API จะบล็อกการสร้างแคมเปญบริการในพื้นที่ใหม่ |
การดำเนินการในเอนทิตีย่อยในแคมเปญ | Google Ads API ไม่รองรับการสร้าง การแก้ไข การนำออก หรือ การดึงข้อมูลกลุ่มโฆษณา โฆษณา หรือเกณฑ์ในแคมเปญบริการในพื้นที่ |
แหล่งข้อมูลเกี่ยวกับบริการในพื้นที่
เริ่มตั้งแต่ Google Ads API v15 ข้อมูลบางส่วนจาก โฆษณาบริการในพื้นที่แสดงโดยตรง ใน Google Ads API ผ่านแหล่งข้อมูลรายงานแบบอ่านอย่างเดียวต่อไปนี้
local_services_lead
local_services_lead_conversation
local_services_verification_artifact
local_services_employee
หากต้องการให้ทรัพยากรเหล่านี้ส่งคืนข้อมูล คุณต้องมีบริการในพื้นที่ ในบัญชีลูกค้าที่ส่งคำขอ และเนื่องจากช่องสามารถ แคมเปญบริการในพื้นที่ 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