本地生活服务广告系列

通过本地生活服务广告系列，您可以在 Google 上宣传您的商家信息，直接从潜在客户那里获得他们的相关信息。本指南总结了 Google Ads API 中支持的操作和限制。

支持的操作

Google Ads API 支持对本地生活服务广告系列执行以下操作。

检索本地生活服务广告系列和预算

您可以使用 GoogleAdsService.Search 或 GoogleAdsService.SearchStream 方法查询 advertising_channel_type = 'LOCAL_SERVICES' 的 Campaign 资源，从而检索本地生活服务广告系列和预算。示例如下：

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。

设置地理位置定位

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

定位特定服务类型

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

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

提交潜在客户反馈

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

不支持的操作

下表列出了独立本地生活服务广告系列 (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 中公开：

为了让这些资源返回数据，发出请求的客户账号中必须有本地生活服务广告系列或本地生活服务效果最大化广告系列。local_services_lead.campaign 字段会将潜在客户记录与其关联的广告系列（包括采用“按潜在客户付费”目标的效果最大化广告系列，其中 campaign.advertising_channel_type = 'PERFORMANCE_MAX' 且 campaign.pmax_campaign_settings.local_services_enabled = true）重新关联。如需确定这些资源所属的广告系列，请使用以下查询：

SELECT
  campaign.id,
  campaign.advertising_channel_type,
  campaign.pmax_campaign_settings.local_services_enabled
FROM campaign
WHERE campaign.advertising_channel_type IN ('LOCAL_SERVICES', 'PERFORMANCE_MAX')

本地生活服务潜在客户

LocalServicesLead 会公开消费者致电、发送消息、预订服务或使用广告客户提供的优惠券时生成的潜在客户详细信息。

潜在客户类型由 LocalServicesLeadType 定义。从 v26开始，COUPON 支持在本地生活服务广告系列和本地生活服务效果最大化广告系列中启用优惠券潜在客户类型。

campaign 字段会将潜在客户记录与其关联的广告系列重新关联。除了选择归因的 campaign 字段（例如 campaign.id 和 campaign.name）之外，您还可以按广告系列资源名称 (WHERE local_services_lead.campaign = ...) 或广告渠道类型 (WHERE campaign.advertising_channel_type = ...) 过滤潜在客户查询，以便按广告系列类型对潜在客户进行细分。

您可以从 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,
  local_services_lead.campaign
FROM local_services_lead

限制

  • 如果 lead_status 等于 WIPED_OUT，则 contact_details 字段为 null。
  • 从 v25 开始，ContactDetails.email 将被移除，ContactDetails.phone_number_extension 可在 local_services_lead.contact_details 返回的 ContactDetails 消息中使用。
  • 无法获取 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_override_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 资源中的 local_services_settings 字段，该字段的类型为 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 开始，Google Ads API 支持创建和更新本地生活服务效果最大化广告系列。您可以通过 API 制作新的本地生活服务效果最大化广告系列，方法是制作效果最大化广告系列 (advertising_channel_type = 'PERFORMANCE_MAX') 并在 pmax_campaign_settings 上设置 local_services_enabled = true（制作后不可变）。制作本地生活服务效果最大化广告系列时，local_services_pmax_campaign_settings 中必须同时包含 country_code 和 listing_id。在 v24 和 v25 中，该 API 仅支持更新由许可清单中的账号在界面中创建的现有本地生活服务效果最大化广告系列。如需了解有关配置前提条件和以原子方式制作广告系列的端到端说明，请参阅以“按潜在客户付费”为目标的效果最大化广告系列指南。

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

如需确定效果最大化广告系列是否为本地生活服务广告系列，请查看广告系列的 pmax_campaign_settings 上的 local_services_enabled 字段。此字段是一个不可变 (CREATE ONLY) 布尔值，在制作广告系列时设置为 true。

配置设置

对于 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 资源来发现或验证关联的商家信息 ID，以查找已启用的 LOCATION 素材资源（检查 location_asset.business_profile_locations）。如需了解详情，请参阅地址素材资源。
  • navigational_query_leads_enabled：是否使用导航查询过滤条件。
  • founding_year：商家的成立年份。
  • country_code：本地生活服务广告的国家/地区代码。 从 v26 开始，此字段为必填字段且不可变，在广告系列制作期间设置一次。这是一个由两个大写字母组成的国家/地区代码（目前，本地生活服务效果最大化广告系列仅支持 US），用于确定验证要求并验证地理位置定位条件选择。
  • phone_numbers：与提供商关联的电话号码列表，由 LocalServicesPhoneNumber 消息表示。如果省略，电话号码将默认为关联的 Google 商家资料中的电话号码；如果商家资料中没有电话号码，则必须提供电话号码。

电话号码

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

  • phone_number：电话号码。
  • country_code：大写的双字母国家/地区代码。
  • phone_number_type：电话号码的类型，由 GlsPhoneNumberTypeEnum.GlsPhoneNumberType 定义。支持的类型包括：
    • DESTINATION_PHONE_NUMBER_FOR_ADS：用于接收来自本地生活服务广告单元的来电的目标号码（对于来电潜在客户，默认）。
    • DESTINATION_PHONE_NUMBER_FOR_SMS_ONLY：支持短信的目标号码（可选，用于短信通知形式的私信潜在客户）。
    • DESTINATION_PHONE_NUMBER_FOR_WHATSAPP_ONLY：提供商 WhatsApp 账号的目标号码。