在地生活服務廣告活動

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

支援作業

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

您可以使用 GoogleAdsService.Search 或 GoogleAdsService.SearchStream 方法來擷取在地生活服務廣告活動及預算，查詢含有 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 欄位。

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

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

• ManualCpa，方法是設定 manual_cpa 欄位

  您可以透過 LocalServicesCampaignSettings.category_bids 設定 ManualCpa 的出價。您可以透過 Campaign.local_services_campaign_settings 擷取及設定 LocalServicesCampaignSettings 的在地生活服務廣告活動。

• MaximizeConversions，方法是設定 maximize_conversions 欄位

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

您可以將「在地生活服務」廣告活動的廣告時段設為廣告活動條件。

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

設定指定地區

如要為在地生活服務廣告活動啟用指定地區，請加入 LocationInfo，並使用 CampaignCriterionService.MutateCampaignCriteria 將其設為傳送至 Google Ads API 的 CampaignCriterion 的 location。 詳情請參閱指定地區。

指定特定服務類型

如要啟用特定服務類型的指定目標功能，請新增 LocalServiceIdInfo 並將其設為服務類型。

您應使用與廣告活動指定目標位置和類別相符的服務 ID。

不支援的操作

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

不支援的操作
建立及移除廣告活動	Google Ads API 可用來封鎖新的在地生活服務廣告活動，
廣告活動中子實體的作業	Google Ads API 不支援建立、修改、移除或擷取「在地生活服務」廣告活動中的廣告群組、廣告或條件。

在地生活服務資源

從 Google Ads API 第 15 版開始，在地生活服務廣告的部分資料會透過下列「唯讀」報表資源直接顯示在 Google Ads API 中：

• local_services_lead
• local_services_lead_conversation
• local_services_verification_artifact
• local_services_employee

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

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 欄位為空值。
• 系統無法提供 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'

從 Google Ads API 17 版開始，您可以使用 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.id = LEAD_ID
  

在地生活服務 - 驗證構件

LocalServicesVerificationArtifact 會提供廣告主商家的驗證資料。請注意，這些驗證是在商家層級進行，且不包含員工驗證。相關資料包括：

• 授權驗證
• 保險驗證
• 背景調查驗證
• 商家登記驗證

每次您向在地生活服務廣告提交驗證要求時，Google Ads API 中會為該執行個體建立新的驗證構件執行個體，而每個驗證成果都代表一個驗證要求。視驗證要求所代表的驗證要求類型而定，每個驗證成果可能包含下列資訊：

• 各個驗證構件的狀態
• 要用於背景調查驗證的背景調查網址
• 背景調查裁定時間 (如適用)
• 保險文件網址，可供查看已提交的保險資訊
• 保險遭拒原因 (如適用)
• 執照詳細資料 (類型、數字、名字、姓氏)
• 執照遭拒原因 (如適用)
• 授權文件網址 (如有) 查看已提交的授權圖片
• 商家登記詳細資料 (核對 ID、註冊編號)
• 商家登記遭拒原因 (如適用)
• 商業登記文件網址，用於查看已提交的登記圖片 (如適用)

您可以從 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 資源中使用名為 LocalServicesSetting 的新欄位。

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

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