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 Google Ads API.

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

Các thao tác sau được hỗ trợ.

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

Bạn có thể truy xuất chiến dịch và ngân sách của Dịch vụ địa phương bằng cách sử dụng phương thức GoogleAdsService.Search hoặc GoogleAdsService.SearchStream để truy vấn các tài nguyên campaign 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à các trường 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 cho 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 đây 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 giá trị này thành ad_schedule của CampaignCriterion được gửi đến Google Ads API 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 LocationInfo và đặt thành location của CampaignCriterion được gửi đến Google Ads API, bằng cách sử dụng CampaignCriterionService.MutateCampaignCriteria. Để biết thêm thông tin chi tiết, hãy xem bài viết Nhắm mục tiêu theo vị trí.

Nhắm đến các loại dịch vụ cụ thể

Để bật tiêu chí 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.

Gửi ý kiến phản hồi về khách hàng tiềm năng

Sử dụng phương thức ProvideLeadFeedback() của LocalServicesLeadService để gửi ý kiến đánh giá và phản hồi cho một khách hàng tiềm năng. Bạn cũng có thể kiểm tra trường lead_feedback_submitted của LocalServicesLead để xác định xem khách hàng tiềm năng có được đánh giá và gửi ý kiến phản hồi hay không.

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

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

Các thao tác không được hỗ trợ
Tạo và xoá chiến dịch Google Ads API chặn việc tạo chiến dịch Dịch vụ địa phương mới.
Các thao tác trên các thực thể phụ trong một chiến dịch Google Ads API 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 Google Ads API thông qua các tài nguyên báo cáo chỉ đọc sau đây:

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

LocalServicesLead cho biết 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 ví dụ về cụm từ tìm kiếm:

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.
  • 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 sẽ không có sẵn.

Cuộc trò chuyện với khách hàng tiềm năng từ 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 cho 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. Sau đây là ví dụ về một truy vấn 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'

Bạn có thể sử dụng phương thức LocalServicesLeadService.AppendLeadConversation để nối các tài nguyên LocalServicesLeadConversation vào một 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 đối với tài khoản khách hàng Google Ads sở hữu chiến dịch mà khách hàng tiềm năng được liên kết.

  • Việc yêu cầu tất cả các cuộc trò chuyện cùng một lúc có thể là một yêu cầu tốn thời gian, vì vậy, bạn nên lọc cá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

Thông tin 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 thực hiện ở 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 một yêu cầu xác minh được gửi đến Quảng cáo dịch vụ địa phương, một phiên bản mới của đối tượng xác minh sẽ được tạo cho yêu cầu đó trong Google Ads API và mỗi đối tượng xác minh sẽ đại diện cho một yêu cầu xác minh duy nhất. Mỗi chứng từ 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à chứng từ đó đại diện:

  • Trạng thái của từng hiện vật xác minh
  • URL kiểm tra lý lịch được dùng để xác minh quy trình kiểm tra lý lịch
  • Thời gian xem xét kết quả kiểm tra lý 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 giấy phép để xem hình ảnh giấy phép đã gửi (nếu có)
  • Thông tin đăng ký kinh doanh (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ủa cấu phần phần mềm xác minh từ tài nguyên local_services_verification_artifact. Sau đây là một ví dụ về truy vấn 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 danh mục và địa lý

Để 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ụ tại đị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 cho biết 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 địa điểm và danh mục. Sau đây là một ví dụ về truy vấn 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 cho thấy dữ liệu về nhân viên dịch vụ tại đị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.

Sau đây là một ví dụ về truy vấn 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

Chiến dịch Tối đa hoá hiệu suất cho dịch vụ địa phương

Chiến dịch Tối đa hoá hiệu suất hỗ trợ các chế độ cài đặt liên quan đến Dịch vụ tại địa phương kể từ phiên bản 24.2. Các chế độ cài đặt này cho phép bạn định cấu hình và xác định một chiến dịch Tối đa hoá hiệu suất phân phát Quảng cáo dịch vụ tại địa phương (GLS PMax).

Xác định chiến dịch Tối đa hoá hiệu suất cho Dịch vụ địa phương

Để xác định xem một chiến dịch Tối đa hoá hiệu suất có phải là chiến dịch Dịch vụ tại địa phương hay không, hãy kiểm tra trường chỉ đọc local_services_enabled trên pmax_campaign_settings của chiến dịch.

Thiết lập chế độ cài đặt

Đối với những chiến dịch có local_services_enabled là true, hãy định cấu hình chế độ cài đặt trong trường local_services_pmax_campaign_settings:

  • navigational_query_leads_enabled: Có sử dụng bộ lọc truy vấn điều hướng hay không.
  • founding_year: Năm thành lập doanh nghiệp.
  • country_code: Mã quốc gia của Quảng cáo dịch vụ địa phương. Trường này là bất biến và được đặt một lần trong quá trình tạo quảng cáo. Đây là mã quốc gia gồm hai chữ cái viết hoa, được dùng để xác định các yêu cầu xác minh và xác thực lựa chọn tiêu chí về vị trí.
  • phone_numbers: Danh sách số điện thoại được liên kết với nhà cung cấp, được biểu thị bằng thông báo LocalServicesPhoneNumber.

Số điện thoại

Mỗi mục trong trường lặp lại phone_numbers đều sử dụng kiểu thông báo LocalServicesPhoneNumber với các trường sau:

  • phone_number: Số điện thoại.
  • country_code: Chữ in hoa, mã quốc gia gồm hai chữ cái.
  • phone_number_type: Loại số điện thoại, do GlsPhoneNumberTypeEnum.GlsPhoneNumberType xác định. Các loại được hỗ trợ bao gồm:
    • DESTINATION_PHONE_NUMBER_FOR_ADS: Số điện thoại đích để sử dụng cho các cuộc gọi từ một đơn vị quảng cáo Dịch vụ tại địa phương (mặc định).
    • DESTINATION_PHONE_NUMBER_FOR_SMS_ONLY: Số điện thoại đích có hỗ trợ SMS.
    • DESTINATION_PHONE_NUMBER_FOR_WHATSAPP_ONLY: Số điện thoại nhận của tài khoản WhatsApp của nhà cung cấp.