本地生活服务广告系列

本地生活服务广告系列可让您在 Google 上宣传自己的业务,并直接从潜在客户那里获得销售线索。本指南总结了当前版本的 Google Ads API 中支持的操作和限制。

支持的操作

支持以下操作。

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

您可以使用 GoogleAdsService.SearchGoogleAdsService.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 的 CampaignCriterionad_schedule

设置地理位置定位

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

定位特定服务类型

如需针对特定服务类型启用定位,请添加 LocalServiceIdInfo 并将其设置为服务类型

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

提交潜在客户反馈

使用 LocalServicesLeadServiceProvideLeadFeedback() 方法提交潜在客户的评分和反馈。您还可以检查 LocalServicesLeadlead_feedback_submitted 字段,以帮助确定潜在客户是否已获得评分并提交反馈。

不支持的操作

下表中列出的限制可能会在未来版本的 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