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à 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à 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 đây 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 GoogleAdsService.Search hoặc GoogleAdsService.SearchStream phương thức để 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 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

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 tiê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í của 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 AdScheduleInfo và đặt lịch quảng cáo đó thành ad_schedule của CampaignCriterion được gửi đến Google Ads API bằng cách sử dụng CampaignCriterionService.MutateCampaignCriteria.

Thiết lập tính năng 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 a LocationInfo và đặt trường đó thành the location field of the 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 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 tạo LocalServiceIdInfo bằng một trong các mã danh mục của Dịch vụ địa phương, đặt mã đó trên trường local_service_id của một CampaignCriterion và gửi mã đó bằng cách sử dụng CampaignCriterionService.MutateCampaignCriteria.

Bạn nên sử dụng mã dịch vụ phù hợp với vị trí nhắm mục tiêu và danh mục 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 phản hồi và xếp hạng 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 một khách hàng tiềm năng đã được xếp hạng và ý kiến phản hồi đã được gử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').

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 và xoá chiến dịch Dịch vụ địa phương độc lập (advertising_channel_type = 'LOCAL_SERVICES'). Kể từ v26, bạn có thể tạo chiến dịch Tối đa hoá hiệu suất mới của Dịch vụ địa phương (advertising_channel_type = 'PERFORMANCE_MAX') bằng cách đặt pmax_campaign_settings.local_services_enabled = true; hãy xem bài viết Tạo chiến dịch Tối đa hoá hiệu suất của Dịch vụ địa phương.
Thao tác trên các thực thể con trong chiến dịch Đối với chiến dịch Dịch vụ địa phương độc lập (advertising_channel_type = 'LOCAL_SERVICES'), 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í khác ngoài các tiêu chí của chiến dịch được liệt kê trong Thao tác được hỗ trợ. Đối với chiến dịch Tối đa hoá hiệu suất của Dịch vụ địa phương, hãy sử dụng nhóm thành phần và tiêu chí của chiến dịch.

Tài nguyên của 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ó thể đọ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ụ đị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à các tài nguyên này 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 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 từ Dịch vụ địa phương từ tài nguyên local_services_lead. Dưới đây là 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.
  • 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ề.
  • Không có dữ liệu từ khách hàng tiềm năng trong đó 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 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 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. Dưới đây là truy vấn mẫu 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 LocalServicesLeadService.AppendLeadConversation phương thức để thêm LocalServicesLeadConversation tài nguyên 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 mà khách hàng tiềm năng được liên kết.

  • Việc yêu cầu tất 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 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'

Dữ 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 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 bao gồm những nội dung sau:

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

Mỗi khi 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ể dữ liệu xác minh mới sẽ được tạo cho yêu cầu đó trong Google Ads API và mỗi dữ liệu xác minh đại diện cho một yêu cầu xác minh. Mỗi dữ liệu 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à dữ liệu đó đại diện:

  • Trạng thái của từng dữ liệu xác minh
  • URL kiểm tra lai lịch sẽ được dùng để xác minh lai lịch
  • Thời gian xét duyệt kiểm tra lai lịch (nếu có)
  • URL 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 chi tiết về giấy phép (loại, số, tên)
  • Lý do từ chối giấy phép (nếu có)
  • URL tài liệu giấy phép để xem hình ảnh giấy phép đã gửi (nếu có)
  • Thông tin chi tiết về thông tin đăng ký kinh doanh (mã kiểm tra, số đăng ký)
  • Lý do từ chối thông tin đăng ký kinh doanh (nếu có)
  • URL giấy đă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 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ả dữ liệu 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 xác minh theo danh mục và địa lý

Để xác định theo phương thức lập trì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 của Dịch vụ địa phương, 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 hiển thị bản 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à truy vấn mẫu truy xuất tất cả dữ liệu đó:

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 cung cấp 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 cung cấp 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 của 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 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 của Dịch vụ địa phương

Kể từ v26, bạn có thể tạo chiến dịch Tối đa hoá hiệu suất mới của Dịch vụ địa phương thông qua API bằng cách tạo 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 của Dịch vụ địa phương, bạn phải có cả country_code và listing_id trong local_services_pmax_campaign_settings.

Trong v24 và v25, API chỉ hỗ trợ các bản cập nhật cho chiến dịch Tối đa hoá hiệu suất hiện có của Dịch vụ địa phương do các tài khoản trong danh sách cho phép tạo trong giao diện người dùng.

Xác định chiến dịch Tối đa hoá hiệu suất của 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.

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

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

  • listing_id: Mã trang doanh nghiệp trên Google được liên kết với chiến dịch. Kể từ 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 của Dịch vụ địa phương. Mã trang doanh nghiệp phải được liên kết với tài khoản dưới dạng thành phần LOCATION đã bật; nếu không, API sẽ trả về CampaignError.INVALID_LOCAL_SERVICES_PERFORMANCE_MAX_LISTING_ID lỗi. 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ề RequestError.IMMUTABLE_FIELD. Nhà phát triển có thể khám phá hoặc xác minh các mã trang doanh nghiệp đượ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 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 không thể thay đổi và chỉ đượ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 LocalServicesPhoneNumber thông báo.

Số điện thoại

Mỗi mục 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, được xác định bằng GlsPhoneNumberTypeEnum.GlsPhoneNumberType. Các loại được hỗ trợ bao gồm:
    • DESTINATION_PHONE_NUMBER_FOR_ADS: Số đích đến dùng cho các cuộc gọi từ một đơn vị quảng cáo Dịch vụ địa phương (mặc định).
    • DESTINATION_PHONE_NUMBER_FOR_SMS_ONLY: Số đích đến hỗ trợ tin nhắn SMS.
    • DESTINATION_PHONE_NUMBER_FOR_WHATSAPP_ONLY: Số đích đến cho tài khoản WhatsApp của nhà cung cấp.