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 và quy định hạn chế được hỗ trợ trong Google Ads API.

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

Google Ads API hỗ trợ các thao tác sau cho chiến dịch Dịch vụ địa phương.

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 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 Quảng cáo 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à 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

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 Quảng cáo dịch vụ địa phương:

• ManualCpa bằng cách đặt trường manual_cpa

  Bạn có thể đặt giá thầu của ManualCpa thông qua LocalServicesCampaignSettings.category_bids. Bạn có thể truy xuất và đặt LocalServicesCampaignSettings của chiến dịch Quảng cáo Dịch vụ địa phương thông qua Campaign.local_services_campaign_settings.

• MaximizeConversions bằng cách đặt trường maximize_conversions

Đặ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í chiến dịch.

Tạo một AdScheduleInfo và đặt 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 một LocationInfo và đặt thành trường 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, 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 tính năng nhắm mục tiêu cho một loại dịch vụ cụ thể, hãy tạo một LocalServiceIdInfo có một trong các mã danh mục Dịch vụ địa phương, đặt mã đó trên trường local_service_id của một CampaignCriterion rồi gửi bằng CampaignCriterionService.MutateCampaignCriteria.

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 điểm xếp hạng và ý kiến 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 xếp hạng và gửi ý kiến phản hồi hay chưa.

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

Bảng sau đây liệt kê các thao tác không được hỗ trợ cho chiến dịch Dịch vụ địa phương độc lập (advertising_channel_type = 'LOCAL_SERVICES').

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:

• local_services_lead
• local_services_lead_conversation
• local_services_verification_artifact
• local_services_employee

Để các tài nguyên này trả về dữ liệu, tài khoản khách hàng gửi yêu cầu phải có một chiến dịch Dịch vụ địa phương hoặc chiến dịch Tối đa hoá hiệu suất cho Dịch vụ địa phương. Trường local_services_lead.campaign liên kết các bản ghi khách hàng tiềm năng với chiến dịch liên quan (bao gồm cả chiến dịch Tối đa hoá hiệu suất cho mục tiêu trả tiền dựa trên khách hàng tiềm năng, trong đó campaign.advertising_channel_type = 'PERFORMANCE_MAX' và campaign.pmax_campaign_settings.local_services_enabled = true). Để 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,
  campaign.advertising_channel_type,
  campaign.pmax_campaign_settings.local_services_enabled
FROM campaign
WHERE campaign.advertising_channel_type IN ('LOCAL_SERVICES', 'PERFORMANCE_MAX')

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, đặt dịch vụ hoặc sử dụng phiếu giảm giá của nhà quảng cáo.

Loại khách hàng tiềm năng được xác định bằng LocalServicesLeadType. Kể từ v26, COUPON được hỗ trợ để cho phép các loại khách hàng tiềm năng sử dụng phiếu giảm giá trong chiến dịch Dịch vụ địa phương và chiến dịch Tối đa hoá hiệu suất cho Dịch vụ địa phương.

Trường campaign liên kết bản ghi khách hàng tiềm năng với chiến dịch liên quan. Ngoài việc chọn các trường campaign được phân bổ (chẳng hạn như campaign.id và campaign.name), bạn có thể lọc truy vấn khách hàng tiềm năng theo tên tài nguyên chiến dịch (WHERE local_services_lead.campaign = ...) hoặc theo loại kênh quảng cáo (WHERE campaign.advertising_channel_type = ...) để phân đoạn khách hàng tiềm năng theo loại chiến dịch.

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. Dưới đâ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,
  local_services_lead.campaign
FROM local_services_lead

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

• Trường contact_details là rỗng nếu lead_status bằng WIPED_OUT.
• Kể từ v25, ContactDetails.email sẽ bị xoá và ContactDetails.phone_number_extension sẽ có trong thông báo ContactDetails do local_services_lead.contact_details trả về.
• Dữ liệu từ những khách hàng tiềm năng mà category_id thuộc danh mục chăm sóc sức khoẻ sẽ không được cung cấp.

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

LocalServicesLeadConversation cho thấy 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à một ví dụ về 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 để thêm tài nguyên 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 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 có 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 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_conversation.lead = 'customers/CUSTOMER_ID/localServicesLeads/LEAD_ID'
  

Tài liệu xác minh

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 những quy trình xác minh này áp dụng ở 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 kiểm tra lai lịch
• Xác minh giấy đăng ký kinh doanh

Mỗi khi 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 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 Google Ads API 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 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ét duyệt quy trình kiểm tra lai lịch (nếu có)
• URL của tài liệu 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 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 mã nhận dạng, số đăng ký)
• Lý do từ chối giấy đăng ký kinh doanh (nếu có)
• URL của giấy đăng ký kinh doanh để xem hình ảnh giấy đă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. Sau đây là một truy vấn mẫu giúp 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 của 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_override_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 xác minh theo khu vực đị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 trường local_services_settings trên tài nguyên customer có loại LocalServicesSettings.

Trường này cho thấy thông tin tóm tắt tổng quan 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 giúp 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à một 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 cho 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ụ địa phương kể từ v24. 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ụ địa phương (GLS PMax).

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

Kể từ v26, Google Ads API hỗ trợ cả việc tạo và cập nhật chiến dịch Tối đa hoá hiệu suất cho Dịch vụ địa phương. Bạn có thể tạo chiến dịch Tối đa hoá hiệu suất mới cho Dịch vụ địa phương thông qua API bằng cách tạo một chiến dịch Tối đa hoá hiệu suất (advertising_channel_type = 'PERFORMANCE_MAX') và đặt local_services_enabled = true trên pmax_campaign_settings (không thể thay đổi sau khi tạo). Khi tạo chiến dịch Tối đa hoá hiệu suất cho Dịch vụ địa phương, bạn phải cung cấp cả country_code và listing_id trong local_services_pmax_campaign_settings. Trong v24 và v25, API này chỉ hỗ trợ cập nhật cho các chiến dịch Tối đa hoá hiệu suất cho Dịch vụ địa phương hiện có do các tài khoản trong danh sách cho phép tạo trong giao diện người dùng. Để biết hướng dẫn toàn diện về cách định cấu hình các điều kiện tiên quyết và tạo chiến dịch một cách tự động, hãy xem hướng dẫn về chiến dịch Tối đa hoá hiệu suất cho mục tiêu trả tiền dựa trên khách hàng tiềm năng.

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 chiến dịch Tối đa hoá hiệu suất có phải là chiến dịch Dịch vụ địa phương hay không, hãy kiểm tra trường local_services_enabled trên pmax_campaign_settings của chiến dịch. Trường này là một boolean bất biến (CREATE ONLY) được đặt thành true khi tạo 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:

• listing_id: Mã trang thông tin trên Trang doanh nghiệp trên Google được liên kết với chiến dịch. Kể từ phiên bản v26, trường này là bắt buộc và không thể thay đổi trong quá trình tạo chiến dịch Tối đa hoá hiệu suất cho Dịch vụ địa phương. Mã trang thông tin phải được liên kết với tài khoản dưới dạng một thành phần LOCATION đang bật; nếu không, API sẽ trả về lỗi CampaignError.INVALID_LOCAL_SERVICES_PERFORMANCE_MAX_LISTING_ID. Vì listing_id được đánh dấu là IMMUTABLE, nên việc cố gắng cập nhật trường này sau khi tạo chiến dịch sẽ không thành công và trả về lỗi RequestError.IMMUTABLE_FIELD. Nhà phát triển có thể khám phá hoặc xác minh mã trang thông tin được liên kết bằng cách truy vấn tài nguyên Asset cho các thành phần LOCATION đã bật (kiểm tra location_asset.business_profile_locations). Để biết thêm thông tin, hãy xem bài viết Thành phần địa điểm.
• navigational_query_leads_enabled: Có sử dụng bộ lọc cụm từ tìm kiếm đ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. Kể từ v26, trường này là bắt buộc và không thể thay đổi, được đặt một lần trong quá trình tạo chiến dịch. Đây là mã quốc gia gồm hai chữ cái viết hoa (hiện chỉ hỗ trợ US cho chiến dịch Tối đa hoá hiệu suất cho Dịch vụ địa phương), được dùng để xác định các yêu cầu xác minh và xác thực tiêu chí vị trí đã chọn.
• phone_numbers: Danh sách số điện thoại liên kết với nhà cung cấp, được biểu thị bằng thông báo LocalServicesPhoneNumber. Nếu bạn bỏ qua, số điện thoại sẽ được đặt mặc định là số điện thoại trên trang thông tin Trang doanh nghiệp trên Google được liên kết và là số bắt buộc nếu trang thông tin Trang doanh nghiệp không có số điện thoại.

Số điện thoại

Mỗi mục nhập trong trường lặp lại phone_numbers sử dụng loại thông báo LocalServicesPhoneNumber với các trường sau:

• phone_number: Số điện thoại.
• country_code: Mã quốc gia gồm hai chữ cái viết hoa.
• 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ụ địa phương (đối với khách hàng tiềm năng gọi điện, mặc định).
  • DESTINATION_PHONE_NUMBER_FOR_SMS_ONLY: Số điện thoại đích hỗ trợ SMS (không bắt buộc, đối với thông báo qua SMS về khách hàng tiềm năng từ tin nhắn).
  • DESTINATION_PHONE_NUMBER_FOR_WHATSAPP_ONLY: Số điện thoại đích cho tài khoản WhatsApp của nhà cung cấp.