通过本地生活服务广告系列,您可以在 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
的出价。您可以通过Campaign.local_services_campaign_settings
检索并设置LocalServicesCampaignSettings
的本地生活服务广告系列。
将广告投放时间设为广告系列条件
您可以将本地生活服务广告系列的广告投放时间作为广告系列条件。
使用 CampaignCriterionService.MutateCampaignCriteria
创建 AdScheduleInfo
,并将其设置为发送到 Google Ads API 的 CampaignCriterion
的 ad_schedule
。
设置地理位置定位
如需为本地生活服务广告系列启用地理位置定位,请添加 LocationInfo
,并使用 CampaignCriterionService.MutateCampaignCriteria
将其设置为发送到 Google Ads API 的 CampaignCriterion
的 location
。如需了解详情,请参阅地理位置定位。
定位特定的服务类型
如需针对特定服务类型启用定位,请添加 LocalServiceIdInfo
并将其设置为服务类型。
您应该使用与广告系列的定位地理位置和类别相匹配的服务 ID。
不支持的操作
下表中列出的限制可能会在 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
。
限制
- 要访问通话录音网址,您必须使用对相应 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
资源中名为 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