通过本地生活服务广告系列,您可以在 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
。MaximizeConversions
(通过设置maximize_conversions
字段来设置)
将广告投放时间设为广告系列条件
您可以将本地生活服务广告系列的广告投放时间作为广告系列条件。
使用 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 客户帐号(拥有与潜在客户相关联的广告系列拥有)至少只读权限的电子邮件地址登录。
一次性请求所有对话可能是一个非常耗时的请求,因此您应该按潜在客户过滤对话,例如:
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