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

Chiến dịch Dịch vụ địa phương giúp bạn quảng cáo doanh nghiệp của mình trên Google và trực tiếp thu hút được 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à các quy định hạn chế trong phiên bản hiện tại của API Google Ads.

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

Các thao tác sau đượ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 phương thức GoogleAdsService.Search hoặc GoogleAdsService.SearchStream để truy vấn các tài nguyên chiến dịch 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 các trường status của chiến dịch và amount_micros của ngân sách chiến dịch được liên kết.

Đặt chiến lược đặt giá thầu của 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 chiến dịch Dịch vụ địa phương làm tiêu chí của chiến dịch.

Tạo một AdScheduleInfo và đặt thành ad_schedule của CampaignCriterion được gửi đến API Google Ads, bằng cách sử dụng CampaignCriterionService.MutateCampaignCriteria.

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

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

Nhắm đến 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 một LocalServiceIdInfo và đặt thành loại dịch vụ.

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

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

Các 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.

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 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

Một số dữ liệu từ Quảng cáo dịch vụ địa phương được 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:

Để các tài nguyên này trả về dữ liệu, tài khoản khách hàng phải có chiến dịch Dịch vụ địa phương thực hiện yêu cầu. Và vì mỗi tài khoản khách hàng chỉ có thể có một chiến dịch Dịch vụ địa phương, nên các tài nguyên này không chỉ định một chiến dịch. Để xác định chiến dịch liên kết với các tài nguyên này, hãy 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 từ chiến dịch Dịch vụ địa phương

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

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

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 có giá trị rỗng nếu lead_status bằng WIPED_OUT.
  • Không có dữ liệu từ khách hàng tiềm năng mà category_id thuộc danh mục chăm sóc sức khoẻ.

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

LocalServicesLeadConversation hiển thị thông tin chi tiết về các cuộc trò chuyện đã diễn ra trong một LocalServicesLead. Có mối quan hệ một với nhiều với LocalServicesLead, trong đó một khách hàng tiềm năng có thể có nhiều cuộc trò chuyện. Bạn có thể tìm thấy tên tài nguyê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ừ tài nguyên local_services_lead_conversation. Dưới đây là ví dụ về truy vấn lọc ra 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 phương thức LocalServicesLeadService.AppendLeadConversation để thêm tài nguyên LocalServicesLeadConversation vào LocalServicesLead.

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

  • Để truy cập vào URL bản ghi cuộc gọi, bạn phải đăng nhập bằng một đị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ể mất nhiều thời gian, vì vậy, 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 hiển thị dữ liệu xác minh cho doanh nghiệp của nhà quảng cáo. Xin lưu ý rằng các quy trình xác minh này ở 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 thông tin kiểm tra lai lịch
  • Quy trình xác minh giấy đăng ký kinh doanh

Bất cứ khi nào bạn gửi yêu cầu xác minh đến Quảng cáo dịch vụ địa phương, một thực thể cấu phần phần mềm xác minh mới sẽ được tạo cho yêu cầu đó 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ỗi cấu phần phần mềm xác minh có thể chứa một số thông tin sau, tuỳ thuộc vào loại yêu cầu xác minh mà cấu phần phần mềm đó đạ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 quy trình kiểm tra lai lịch
  • Thời gian xử lý kết quả 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 cấp phép (nếu có)
  • URL của tài liệu giấy phép để xem hình ảnh giấy phép đã gửi (nếu có)
  • Thông tin đăng ký kinh doanh (kiểm tra giấy tờ tuỳ thân, số đăng ký)
  • Lý do từ chối đăng ký doanh nghiệp (nếu có)
  • URL của giấy tờ đăng ký kinh doanh để xem hình ảnh đăng ký đã gửi (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ừ tài nguyên local_services_verification_artifact. Dưới đây là truy vấn mẫu truy xuất dữ liệu cho tất cả cá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 nhất định:

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 về giấy phép và bảo hiểm theo vị trí địa lý và danh mục

Để xác định trạng thái của các yêu cầu xác minh theo vị trí địa lý (cụ thể là mã mục tiêu địa lý) và mã danh mục dịch vụ địa phương theo phương thức lập trình, bạn có thể sử dụng một trường mới trên tài nguyên customer có tên là LocalServicesSettings.

Trường này hiển thị thông tin tóm tắt cấp cao về trạng thái của các yêu cầu xác minh giấy phép và bảo hiểm theo vị trí và danh mục. Dưới đây là một truy vấn mẫu truy xuất tất 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 cung cấp 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 hồ sơ quảng cáo của họ lên 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ụ tại địa phương của một tài khoản khách hàng nhất định:

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