在地生活服務廣告活動

在地生活服務廣告活動 可讓你在 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 欄位

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

• MaximizeConversions敬上 透過設定欄位 maximize_conversions。

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

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

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

設定指定地區

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

指定特定服務類型

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

請使用與廣告活動指定目標相符的服務 ID location 和 category。

不支援的操作

下表所列的限制在日後的 Google Cloud Google Ads API

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

在地生活服務資源

自 Google Ads API v15 起， 在地生活服務廣告可直接公開 在 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