本地生活服务广告系列

本地生活服务广告系列 让您可以在 Google 上宣传自己的业务，并直接从 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的 CampaignCriterion 发送到 Google Ads API， CampaignCriterionService.MutateCampaignCriteria。

设置地理位置定位

要为本地生活服务广告系列启用地理位置定位，请添加 LocationInfo，并将其设置为 location的 CampaignCriterion 发送到 Google Ads API， CampaignCriterionService.MutateCampaignCriteria。 有关详情，请参阅位置 定位条件。

定位特定的服务类型

要启用定位特定服务类型，请将 LocalServiceIdInfo，并将其设置为 服务。

您应该使用与广告系列的定位相匹配的服务 ID location 和 category。

不支持的操作

下表中列出的限制可能会在 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 字段为 null。
• 对于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。

限制

• 要访问通话录音网址，您必须使用符合以下条件的电子邮件地址登录： 对拥有 与该潜在客户相关联的广告系列。

• 一次请求所有会话可能非常耗时， 您应按潜在客户过滤对话，例如：

  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