แคมเปญบริการในพื้นที่ช่วยให้คุณโฆษณา ธุรกิจใน 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ของงบประมาณแคมเปญที่เชื่อมโยงได้
กําหนดกลยุทธ์การเสนอราคาของแคมเปญบริการในพื้นที่
คุณตั้งกลยุทธ์การเสนอราคาต่อไปนี้เป็นกลยุทธ์การเสนอราคามาตรฐาน ของแคมเปญบริการในพื้นที่ได้
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 ที่มี
รหัสหมวดหมู่ของบริการในพื้นที่รายการใดรายการหนึ่ง ตั้งค่าในช่อง
local_service_id ของ
CampaignCriterion แล้วส่งโดยใช้
CampaignCriterionService.MutateCampaignCriteria
คุณควรใช้รหัสบริการที่ตรงกับสถานที่ตั้งและหมวดหมู่การกำหนดเป้าหมายของแคมเปญ
ส่งความคิดเห็นเกี่ยวกับโอกาสในการขาย
ใช้วิธี ProvideLeadFeedback ของ
LocalServicesLeadService เพื่อส่ง
การให้คะแนนและความคิดเห็นสำหรับโอกาสในการขาย นอกจากนี้ คุณยังตรวจสอบฟิลด์
lead_feedback_submitted ของ
LocalServicesLead เพื่อช่วยพิจารณา
ว่ามีการให้คะแนนโอกาสในการขายและส่งความคิดเห็นหรือไม่
การดำเนินการที่ไม่รองรับ
ข้อจํากัดที่ระบุไว้ในตารางต่อไปนี้อาจมีการเปลี่ยนแปลงใน Google Ads API เวอร์ชันต่อๆ ไป
| การดำเนินการที่ไม่รองรับ | |
|---|---|
| สร้างและนำแคมเปญออก | Google Ads API จะบล็อกการสร้างแคมเปญบริการในพื้นที่ใหม่ |
| การดำเนินการกับเอนทิตีย่อยในแคมเปญ | Google Ads API ไม่รองรับการสร้าง การแก้ไข การนำออก หรือ การดึงข้อมูลกลุ่มโฆษณา โฆษณา หรือเกณฑ์ในแคมเปญบริการในพื้นที่ |
แหล่งข้อมูลของบริการในพื้นที่
ข้อมูลบางอย่างจากโฆษณาบริการในพื้นที่ จะแสดงโดยตรงใน Google Ads API ผ่านแหล่งข้อมูลรายงานแบบอ่านอย่างเดียวต่อไปนี้
local_services_leadlocal_services_lead_conversationlocal_services_verification_artifactlocal_services_employee
หากต้องการให้แหล่งข้อมูลเหล่านี้แสดงข้อมูล จะต้องมีแคมเปญบริการในพื้นที่ ในบัญชีลูกค้าที่ส่งคำขอ เนื่องจากบัญชีลูกค้า 1 บัญชีมีได้เพียงแคมเปญบริการในพื้นที่ 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จะเป็นค่า Null หากlead_statusเท่ากับWIPED_OUT - ตั้งแต่เดือน
v25เป็นต้นไป ระบบจะนำContactDetails.emailออกและContactDetails.phone_number_extensionจะ พร้อมใช้งานในข้อความContactDetailsที่local_services_lead.contact_detailsส่งคืน - ข้อมูลจากโอกาสในการขายที่
category_idเป็นส่วนหนึ่งของหมวดหมู่การดูแลสุขภาพจะไม่พร้อมใช้งาน
การสนทนาเกี่ยวกับผู้มีโอกาสเป็นลูกค้าจากบริการในพื้นที่
LocalServicesLeadConversation
แสดงรายละเอียดของการสนทนาที่เกิดขึ้นในLocalServicesLead
มีความสัมพันธ์แบบหนึ่งต่อหลายกับ
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 ของบริการในพื้นที่
หากต้องการดูว่าแคมเปญ Performance Max เป็นแคมเปญบริการในพื้นที่หรือไม่ ให้ตรวจสอบฟิลด์ local_services_enabled แบบอ่านอย่างเดียวในpmax_campaign_settings ของแคมเปญ
กำหนดการตั้งค่า
สําหรับแคมเปญที่ local_services_enabled เป็น true ให้กําหนดการตั้งค่า
ในฟิลด์
local_services_pmax_campaign_settings
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: หมายเลขปลายทางที่รองรับ SMSDESTINATION_PHONE_NUMBER_FOR_WHATSAPP_ONLY: หมายเลขปลายทางสำหรับบัญชี WhatsApp ของผู้ให้บริการ