本地生活服务广告系列

本地生活服务广告系列让您可以在 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 字段。

设置本地生活服务广告系列的出价策略

您可以将以下出价策略设置为本地生活服务广告系列的标准出价策略：

将广告投放时间设置为广告系列条件

您可以将本地生活服务广告系列的广告投放时间设置为广告系列条件。

创建 AdScheduleInfo，并使用 CampaignCriterionService.MutateCampaignCriteria 将其设置为发送到 Google Ads API 的 CampaignCriterion 的 ad_schedule。

设置地理位置定位

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

定位特定服务类型

如需为特定服务类型启用定位，请添加 LocalServiceIdInfo 并将其设置为 type of service。

您应使用与广告系列的定位地理位置和 类别相符的服务 ID。

提交潜在客户反馈

使用 ProvideLeadFeedback() 方法的 LocalServicesLeadService 提交 对潜在客户的评分和反馈。您还可以检查 lead_feedback_submitted的 LocalServicesLead字段，以帮助确定 潜在客户是否已获得评分以及是否已提交反馈。

不支持的操作

下表中列出的限制可能会在 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 字段为 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'

您可以使用 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 资源中的一个新 字段，称为 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.2 开始。借助这些设置，您可以配置和识别投放本地生活服务广告 (GLS PMax) 的效果最大化广告系列。

识别本地生活服务效果最大化广告系列

如需确定效果最大化广告系列是否为本地生活服务广告系列， 请检查广告系列的 pmax_campaign_settings 中的只读 local_services_enabled 字段。

配置设置

对于 local_services_enabled 为 true 的广告系列，请在 local_services_pmax_campaign_settings 字段下配置设置：

电话号码

phone_numbers 重复字段中的每个条目都使用 LocalServicesPhoneNumber消息类型，其中包含以下字段：