Chiến dịch Dịch vụ địa phương

Chiến dịch Dịch vụ địa phương cho phép bạn quảng cáo doanh nghiệp của mình trên Google và nhận khách hàng tiềm năng trực tiếp từ khách hàng tiềm năng. Hướng dẫn này tóm tắt các thao tác được hỗ trợ và trong phiên bản hiện tại của API Google Ads.

Thao tác được hỗ trợ

Truy xuất ngân sách và chiến dịch Dịch vụ địa phương

Bạn có thể truy xuất ngân sách và chiến dịch Dịch vụ địa phương bằng cách sử dụng GoogleAdsService.Search hoặc GoogleAdsService.SearchStream để truy vấn các tài nguyên chiến dịch mà trong đó advertising_channel_type = 'LOCAL_SERVICES'. Dưới đây là ví dụ:

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'

Chỉnh sửa chiến dịch Dịch vụ địa phương

Bạn có thể cập nhật status của chiến dịch và ngân sách chiến dịch đã liên kết amount_micros trường.

Thiết lập chiến lược đặt giá thầu cho các chiến dịch Dịch vụ địa phương

Bạn có thể đặt các chiến lược đặt giá thầu sau làm chiến lược đặt giá thầu chuẩn của Chiến dịch Dịch vụ địa phương:

Đặt lịch quảng cáo làm tiêu chí chiến dịch

Bạn có thể đặt lịch quảng cáo cho một chiến dịch Dịch vụ địa phương dưới dạng chiến dịch tiêu chí.

Tạo một AdScheduleInfo rồi đặt nó thành ad_schedule của CampaignCriterion được gửi đến API Google Ads bằng CampaignCriterionService.MutateCampaignCriteria.

Đặt tiêu chí nhắm mục tiêu theo vị trí

Để bật tiêu chí nhắm mục tiêu theo vị trí cho chiến dịch Dịch vụ địa phương, hãy thêm LocationInfo và đặt thành location của CampaignCriterion được gửi đến API Google Ads bằng CampaignCriterionService.MutateCampaignCriteria. Để biết thêm chi tiết, hãy xem Vị trí nhắm mục tiêu.

Nhắm mục tiêu các loại dịch vụ cụ thể

Để bật tính năng nhắm mục tiêu cho một loại dịch vụ cụ thể, hãy thêm thuộc tính LocalServiceIdInfo và đặt thành loại tối đa.

Bạn nên sử dụng mã dịch vụ phù hợp với tiêu chí nhắm mục tiêu của chiến dịch location và danh mục.

Các thao tác không được hỗ trợ

Những quy định hạn chế được liệt kê trong bảng sau có thể thay đổi trong các phiên bản sau này của API Google Ads.

Các thao tác không được hỗ trợ
Tạo và xoá chiến dịch API Google Ads chặn việc tạo chiến dịch Dịch vụ địa phương mới.
Thao tác trên các thực thể phụ trong chiến dịch API Google Ads không hỗ trợ việc tạo, sửa đổi, xoá hoặc truy xuất các nhóm quảng cáo, quảng cáo hoặc tiêu chí trong chiến dịch Dịch vụ địa phương.

Tài nguyên về Dịch vụ địa phương

Kể từ API Google Ads phiên bản 15, một số dữ liệu từ Quảng cáo Dịch vụ địa phương hiển thị trực tiếp trong API Google Ads thông qua các tài nguyên báo cáo chỉ có thể đọc sau đây:

Để trả về dữ liệu cho các tài nguyên này, bạn phải có một Dịch vụ địa phương trong tài khoản khách hàng đưa ra yêu cầu. Và vì chỉ có thể có một chiến dịch Dịch vụ địa phương cho mỗi tài khoản khách hàng, những tài nguyên này hãy chỉ định một chiến dịch. Để xác định chiến dịch mà các tài nguyên này được liên kết với, sử dụng truy vấn sau:

SELECT campaign.id
FROM campaign
WHERE campaign.advertising_channel_type = 'LOCAL_SERVICES'

Khách hàng tiềm năng Dịch vụ địa phương

LocalServicesLead hiển thị thông tin chi tiết về khách hàng tiềm năng được tạo ra khi người tiêu dùng gọi điện, nhắn tin hoặc đặt trước dịch vụ nhà quảng cáo.

Bạn có thể truy xuất dữ liệu khách hàng tiềm năng trên Dịch vụ địa phương từ Tài nguyên local_services_lead. Sau đây là một truy vấn ví dụ:

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

Các điểm hạn chế

  • Trường contact_details rỗng nếu lead_status bằng WIPED_OUT.
  • Dữ liệu từ những khách hàng tiềm năng thuộc danh mục chăm sóc sức khoẻ có category_id không có.

Cuộc trò chuyện của khách hàng tiềm năng trên Dịch vụ địa phương

LocalServicesLeadConversation công bố thông tin chi tiết về các cuộc trò chuyện diễn ra trong LocalServicesLead. Có mối quan hệ một với nhiều với LocalServicesLead, nơi một khách hàng tiềm năng có thể có nhiều cuộc trò chuyện. Tài nguyên Bạn có thể tìm thấy tên của khách hàng tiềm năng có liên quan trong trường lead.

Bạn có thể truy xuất dữ liệu cuộc trò chuyện từ local_services_lead_conversation nguồn. Dưới đây là truy vấn mẫu giúp lọc kết quả là cuộc gọi điện thoại:

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'

Kể từ phiên bản 17 của API Google Ads, bạn có thể sử dụng LocalServicesLeadService.AppendLeadConversation phương thức để thêm LocalServicesLeadConversation vào LocalServicesLead.

Các điểm hạn chế

  • Để truy cập vào URL của bản ghi âm cuộc gọi, bạn phải đăng nhập bằng địa chỉ email có ít nhất quyền chỉ có thể đọc đối với tài khoản khách hàng Google Ads sở hữu chiến dịch liên kết với khách hàng tiềm năng đó.

  • Việc yêu cầu tất cả cuộc trò chuyện cùng một lúc có thể tốn thời gian, do đó bạn nên lọc cuộc trò chuyện theo khách hàng tiềm năng, ví dụ:

    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

Cấu phần phần mềm xác minh Dịch vụ địa phương

LocalServicesVerificationArtifact tiết lộ dữ liệu xác minh cho nhà quảng cáo của chúng tôi. Lưu ý rằng quy trình xác minh ở cấp doanh nghiệp và không bao gồm quy trình xác minh cho nhân viên. Dữ liệu này bao gồm:

  • Xác minh giấy phép
  • Xác minh bảo hiểm
  • Xác minh quy trình kiểm tra lai lịch
  • Xác minh giấy đăng ký kinh doanh

Bất cứ khi nào một yêu cầu xác minh được gửi đến Quảng cáo dịch vụ địa phương, tạo bản sao cấu phần phần mềm xác minh trong API Google Ads, và mỗi cấu phần phần mềm xác minh đại diện cho một yêu cầu xác minh. Một cấu phần phần mềm xác minh có thể chứa một số thông tin sau, tùy thuộc vào về loại yêu cầu xác minh mà URL đó đại diện:

  • Trạng thái của từng cấu phần phần mềm xác minh
  • URL kiểm tra lai lịch dùng để xác minh kiểm tra lai lịch
  • Thời gian phân xử kiểm tra lai lịch (nếu có)
  • URL của chứng từ bảo hiểm để xem thông tin bảo hiểm đã gửi
  • Lý do từ chối bảo hiểm (nếu có)
  • Thông tin về giấy phép (loại, số, họ, tên)
  • Lý do từ chối giấy phép (nếu có)
  • URL của tài liệu cấp phép để xem hình ảnh giấy phép đã gửi (nếu có)
  • Thông tin đăng ký kinh doanh (mã kiểm tra, số đăng ký)
  • Lý do từ chối đăng ký kinh doanh (nếu có)
  • URL của giấy tờ đăng ký kinh doanh để xem đơn đăng ký đã gửi hình ảnh (nếu có)

Bạn có thể truy xuất dữ liệu cấu phần phần mềm xác minh từ local_services_verification_artifact nguồn. Dưới đây là truy vấn mẫu truy xuất dữ liệu cho tất cả Cấu phần phần mềm xác minh liên quan đến giấy phép cho một tài khoản khách hàng cụ thể:

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'

Dữ liệu bảo hiểm và giấy phép theo địa lý và phân loại

Xác định trạng thái của yêu cầu xác minh theo vị trí địa lý bằng phương pháp lập trình vị trí, cụ thể là mã đích địa lý) và danh mục dịch vụ địa phương , bạn có thể sử dụng trên tài nguyên customer, được gọi là LocalServicesSetting.

Trường này hiển thị tóm tắt cấp cao về trạng thái giấy phép và bảo hiểm yêu cầu xác minh theo địa điểm và danh mục. Dưới đây là truy vấn mẫu truy xuất tất cả các dữ liệu như vậy:

SELECT
  customer.local_services_settings.granular_license_statuses,
  customer.local_services_settings.granular_insurance_statuses
FROM customer

Nhân viên dịch vụ địa phương

LocalServicesEmployee hiển thị dữ liệu về nhân viên dịch vụ địa phương mà nhà quảng cáo đã tải quảng cáo của họ lên hồ sơ vào hệ thống của chúng tôi.

Dưới đây là truy vấn mẫu truy xuất dữ liệu cho tất cả nhân viên dịch vụ địa phương của một tài khoản khách hàng cụ thể:

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