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