本地生活服务广告系列

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

设置地理位置定位

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

定位特定服务类型

如需针对特定服务类型启用定位，请使用其中一个 本地生活服务类别 ID创建 LocalServiceIdInfo，在 CampaignCriterion的 local_service_id字段中进行设置，然后使用 CampaignCriterionService.MutateCampaignCriteria提交。

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

提交潜在客户反馈

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

不支持的操作

下表列出了独立本地生活服务 广告系列 (advertising_channel_type = 'LOCAL_SERVICES') 不支持的操作。

不支持的操作
创建和移除广告系列 Google Ads API 会阻止创建和移除独立本地生活服务 广告系列 (advertising_channel_type = 'LOCAL_SERVICES')。 从 v26 开始，您可以通过设置 pmax_campaign_settings.local_services_enabled = true 来创建新的本地生活服务效果最大化广告系列 (advertising_channel_type = 'PERFORMANCE_MAX')；请参阅 创建本地生活服务效果最大化 广告系列。
对广告系列中的子实体执行操作 对于独立本地生活服务广告系列 (advertising_channel_type = 'LOCAL_SERVICES')，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。
  • 从 v25 开始，ContactDetails.email 已被移除，并且 ContactDetails.phone_number_extension 可在 ContactDetails 消息 中使用，该消息由 local_services_lead.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'

您可以使用 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 中为其创建一个新的验证工件实例，并且每个验证工件都代表一个验证请求。每个验证工件可能包含以下部分信息，具体取决于它所代表的验证请求类型：

  • 每个验证工件的状态
  • 用于背景调查验证的背景调查网址
  • 背景调查裁决时间（如果适用）
  • 保险单据网址，用于查看已提交的保险信息
  • 保险被拒原因（如果适用）
  • 营业执照详细信息（类型、编号、名字、姓氏）
  • 营业执照被拒原因（如果适用）
  • 营业执照单据网址，用于查看已提交的营业执照图片（如果适用）
  • 工商注册详细信息（检查 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，您可以使用 local_services_settings 资源中的 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 开始。借助这些设置，您可以配置和识别投放本地生活服务广告 (GLS PMax) 的效果最大化广告系列。

创建本地生活服务效果最大化广告系列

从 v26 开始，您可以通过 API 创建新的本地生活服务效果最大化 广告系列，方法是创建效果最大化广告系列 （advertising_channel_type = 'PERFORMANCE_MAX'），并在 local_services_enabled = true 上设置 pmax_campaign_settings（创建后不可更改）。 创建本地生活服务效果最大化广告系列时， country_code 和 listing_id 中需要同时包含 local_services_pmax_campaign_settings。

在 v24 和 v25 中，API 仅支持 更新许可清单上的账号在界面中创建的现有本地生活服务效果最大化广告系列。

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

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

配置设置

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

  • listing_id：与广告系列关联的 Google 商家资料商家信息 ID。从 v26 开始，此字段在创建本地生活服务效果最大化广告系列期间是必需的且不可更改 。商家信息 ID 必须作为已启用的 LOCATION 素材资源与账号关联；否则， API 会返回 CampaignError.INVALID_LOCAL_SERVICES_PERFORMANCE_MAX_LISTING_ID 错误。由于 listing_id 标记为 IMMUTABLE，因此在广告系列创建后尝试更新此 字段会失败，并显示 RequestError.IMMUTABLE_FIELD。开发者可以通过查询 Asset资源以查找已启用的LOCATION素材资源（检查 location_asset.business_profile_locations）来发现或验证关联的商家信息 ID。如需了解详情，请参阅 地址素材资源。
  • navigational_query_leads_enabled：是否使用导航查询过滤条件。
  • founding_year：商家的成立年份。
  • country_code：本地生活服务广告的国家/地区代码。 此字段不可更改，并且在广告制作期间设置一次。它是 大写的双字母国家/地区代码，用于 确定验证要求并验证地理位置条件 选择。
  • phone_numbers：与 提供商关联的电话号码列表，由 LocalServicesPhoneNumber消息表示。

电话号码

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