在地生活服務廣告活動

在地生活服務廣告活動可讓你在 Google 上宣傳商家，並直接從潛在顧客獲得待開發客戶。本指南會概略說明目前 Google Ads API 版本支援的作業和限制。

支援作業

Google Ads API 支援在地生活服務廣告活動的下列作業。

擷取在地生活服務廣告活動和預算

您可以使用 GoogleAdsService.Search 或 GoogleAdsService.SearchStream 方法查詢 Campaign 資源，擷取在地生活服務廣告活動和預算，其中 advertising_channel_type = 'LOCAL_SERVICES'。範例如下：

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'

編輯在地生活服務廣告活動

您可以更新廣告活動的status和相關聯廣告活動預算的amount_micros欄位。

設定在地生活服務廣告活動的出價策略

您可以將下列出價策略設為在地生活服務廣告活動的標準出價策略：

將廣告時段設為廣告活動條件

您可以為在地生活服務廣告活動設定廣告時段，做為廣告活動條件。

建立 AdScheduleInfo，並使用 CampaignCriterionService.MutateCampaignCriteria 將其設為傳送至 Google Ads API 的 ad_schedule CampaignCriterion。

設定指定地區

如要為在地生活服務廣告活動啟用指定地區功能，請新增 LocationInfo，並使用 CampaignCriterionService.MutateCampaignCriteria，將其設為傳送至 Google Ads API 的 CampaignCriterion 的 location 欄位。詳情請參閱「指定目標位置」。

指定特定服務類型

如要啟用特定服務類型的指定目標，請使用其中一個在地生活服務類別 ID 建立 LocalServiceIdInfo，在 CampaignCriterion 的 local_service_id 欄位中設定，然後使用 CampaignCriterionService.MutateCampaignCriteria 提交。

請使用與廣告活動指定地點和類別相符的服務 ID。

提交待開發客戶意見回饋

使用 LocalServicesLeadService 的 ProvideLeadFeedback 方法，提交待開發客戶的評分和意見回饋。您也可以檢查 LocalServicesLead 的 lead_feedback_submitted 欄位，判斷系統是否已評估待開發客戶並提交意見回饋。

不支援的操作

下表列出的限制可能會在日後的 Google Ads API 版本中有所變更。

不支援的操作
建立及移除廣告活動 Google Ads API 會禁止建立新的在地生活服務廣告活動。
廣告活動中子實體的作業 Google Ads API 不支援在在地生活服務廣告活動中建立、修改、移除或擷取廣告群組、廣告或條件。

在地生活服務資源

Google Ads API 會透過下列唯讀報表資源，直接公開在地生活服務廣告的部分資料：

如要讓這些資源傳回資料，提出要求的客戶帳戶中必須有在地生活服務廣告活動。由於每個客戶帳戶只能有一個在地生活服務廣告活動，因此這些資源不會指定廣告活動。如要找出這些資源所屬的廣告活動，請使用下列查詢：

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

在地生活服務待開發客戶

LocalServicesLead 會公開待開發客戶的詳細資料，這些資料是在消費者致電、傳送訊息給廣告主，或預訂廣告主的服務時產生。

您可以從 local_services_lead 資源擷取在地生活服務待開發客戶要求資料。以下是查詢範例：

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

限制

  • 如果 lead_status 等於 WIPED_OUT，則 contact_details 欄位為空值。
  • 自 v25起，系統會移除 ContactDetails.email，並在 local_services_lead.contact_details 傳回的 ContactDetails 訊息中提供 ContactDetails.phone_number_extension。
  • 如果潛在客戶資料屬於醫療保健類別，則無法使用 category_id。

在地生活服務待開發客戶對話

LocalServicesLeadConversation 會顯示對話的詳細資料，這些對話是 LocalServicesLead 的一部分。與 LocalServicesLead 之間是一對多關係，也就是說，一個待開發客戶可以有多個對話。相關待開發客戶的資源名稱位於 lead 欄位。

對話資料可從 local_services_lead_conversation 資源擷取。以下查詢範例會篩選電話通話的結果：

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'

您可以使用 LocalServicesLeadService.AppendLeadConversation 方法，將 LocalServicesLeadConversation 資源附加至 LocalServicesLead。

限制

  • 如要存取通話錄音網址，您必須使用具備至少唯讀存取權的電子郵件地址登入，存取擁有與待開發客戶相關聯廣告活動的 Google Ads 客戶帳戶。

  • 一次要求所有對話可能需要較長時間，因此建議您依據待開發客戶篩選對話，例如：

    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'

在地生活服務驗證構件

LocalServicesVerificationArtifact 公開廣告主業務的驗證資料。請注意，這些驗證是在商家層級進行，不包括員工驗證。包括：

  • 執照驗證
  • 保險驗證
  • 背景調查驗證
  • 商家登記驗證

每當向在地生活服務廣告提交驗證要求時，Google Ads API 就會為該要求建立新的驗證構件例項，每個驗證構件代表單一驗證要求。每個驗證構件可能包含下列部分資訊，視其代表的驗證要求類型而定：

  • 各項驗證構件的狀態
  • 用於背景調查驗證的背景調查網址
  • 背景調查裁決時間 (如適用)
  • 保險文件網址，可查看已提交的保險資訊
  • 保險拒絕原因 (如適用)
  • 駕照詳細資料 (類型、號碼、名字、姓氏)
  • 執照遭拒原因 (如適用)
  • 查看已提交執照圖片的執照文件網址 (如適用)
  • 商業登記詳細資料 (身分證件、登記號碼)
  • 商家登記遭拒原因 (如適用)
  • 公司設立登記文件網址，可查看已提交的登記資料 圖片 (如適用)

您可以從 local_services_verification_artifact 資源擷取驗證構件資料。以下是查詢範例，可擷取特定客戶帳戶的所有執照相關驗證構件資料：

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'

地理位置和類別授權與保險資料

如要以程式輔助方式，依地理位置 (具體來說是地理位置目標代碼) 和在地生活服務類別 ID 判斷驗證要求狀態，可以使用 customer 資源的 local_services_settings 欄位，該欄位的類型為 LocalServicesSettings。

這個欄位會依地點和類別，顯示執照和保險驗證要求狀態的摘要。以下是擷取所有這類資料的查詢範例：

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

在地生活服務員工

LocalServicesEmployee 會公開廣告主上傳到系統的廣告設定檔中，有關當地服務員工的資料。

以下是查詢範例，可擷取特定客戶帳戶的所有當地服務員工資料：

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

在地生活服務最高成效廣告活動

最高成效廣告活動將於 v24起支援與在地服務相關的設定。您可以透過這些設定，設定及識別放送在地服務廣告的最高成效廣告活動 (在地服務廣告最高成效廣告活動)。

找出在地生活服務最高成效廣告活動

如要判斷最高成效廣告活動是否為在地生活服務廣告活動，請檢查廣告活動pmax_campaign_settings中的唯讀local_services_enabled 欄位。

調整設定

如果廣告活動的 local_services_enabled 為 true，請在「local_services_pmax_campaign_settings」欄位下方設定：

電話號碼

phone_numbers 重複欄位中的每個項目都會使用 LocalServicesPhoneNumber 訊息型別，並包含下列欄位：