个人资料 Feed 语义
如 Feed 类别定义中所述，快照 Feed 的语义如下：
- 对于快照 Feed 中的任何提供商，如果该提供商目前在 LSA 提供商数据库中不存在，系统将创建一个新的商家资料。
- 对于快照 Feed 中的任何提供商，如果该提供商目前存在于 LSA 提供商数据库中，则系统会更新其商家资料信息。
- 对于任何不在快照信息流中的提供商，如果该提供商目前存在于 LSA 提供商数据库中，则其商家资料将被删除。
增量 Feed 的语义会导致以下操作：
- 对于增量 Feed 中的任何提供商，如果该提供商当前在 LSA 提供商数据库中不存在，则不执行任何操作。
- 对于增量 Feed 中的任何提供商，如果该提供商目前存在于 LSA 提供商数据库中，则系统会更新其商家资料信息。
- 对于增量 Feed 中未包含的任何提供商，该方法不执行任何操作。
个人资料方面的错误处理
如果某个商家资料 Feed 项无效，我们不会在 LSA 数据库中更新该 Feed 项，同时会暂停该项，以免投放过时的数据。
如果个人资料 Feed 无效（例如不符合架构），我们将停止处理整个 Feed。我们将分享一份报告，其中包含 Feed 处理结果的摘要（例如错误、每项内容的处理状态等）。
协议和限制条件
限制条件。Feed 中的每个商家（Feed 项）都必须具有唯一的 ID。
限制。LSA 对各个数据字段施加了大小限制，如下表所示。
商家名称限制
- 长度上限：100 个字符（包括空格）
- 必须包含至少一个数字或字母
- 支持的字母编码包括 UTF-8、UTF-16 和 UTF-32（建议使用 UTF-8）
- 允许使用的特殊字符：
- 连字符
-、和号&、句点.、逗号,、撇号'、英文括号()
- 连字符
- 禁止使用全大写字母
- 禁止使用冒犯性字词
- 禁止使用表情符号
配置文件字段
下文介绍了给定提供商的设置字段。选填字段会明确标为选填。
| 字段名称 | 说明 | 字段类型 | 示例 | 必需 | 限制条件 |
|---|---|---|---|---|---|
| serviceProviderId | 商家详情（服务提供商）的唯一标识符 | 数值 | 12345 | 是 | 这是每个服务提供商的唯一 ID。这会转换为 int64。更新提供方时保持 ID 不变 |
| serviceProviderName | 商家名称 | 字符串 | "King David Garage Doors, Inc." | 是 | 最多 100 个字符。受名称限制条件政策的约束。 |
| serviceProviderWebsiteUrl | 商家网站网址 | 字符串 | https://abc.xyz | 否 | 以 http 或 https 开头 |
| 地址 | 企业办公地址 | 对象 | "addressLine1":"847 Oliver Avenue", "city":"Valley Stream", "region":"NY", "postalCode":"11581", "country": "US" | 是 | 如果可以提供街道地址，则必须使用街道地址填充 addressLine1。初始商家设置完成后，便无法更改国家/地区代码。 |
| aggregatorProfileUrl | 指向合作伙伴网站上个人资料页面的个人资料网址。 | 字符串 | http://aggregator.com/joes-plumbing/ | 否 | 以 http 或 https 开头 |
| yearBusinessStarted | 企业的成立年份 | 整数 | 2015 | 否 | YYYY 格式 |
| businessHours | 商家营业时间 | 对象数组 | 请参阅“配置文件 Feed 示例”。 | 是 | 查看限制条件的对象定义 |
| businessPhoneNumber | 采用 e164 格式的独立商家电话号码，应为空或归商家所有，而不是呼叫中心号码或合作伙伴分配的跟踪号码。 | 字符串 | “+16501112222” | 是 | 电话号码必须采用 E.164 格式 |
| 联系人 | 用于各种联系方式的联系信息 | 对象数组 | "{ “type”: “PHONE”, “address”: “+16501112222” }" | 是 | 类型可包含“PHONE”或“MESSAGE”。对于“PHONE”类型，地址必须包含采用 E.164 格式的电话号码。对于“MESSAGE”，地址不得填充。必须包含 PHONE 类型的元素，但 MESSAGE 类型的元素是可选的。 |
| targetingLanguages | 广告投放所用的语言列表。语言以 ISO 639-1 语言代码（小写，2 个字母）定义。 | 字符串数组 | “en”“fr” | 是 | 如果未提供，则默认为“en”。 |
| geoCovered | 商家提供服务的地理位置。 | 对象 | 否 | ||
| geoCovered ->criteriaIds | 与服务区域（地区、县、市、邮政编码）对应的条件 ID 列表。 | 整数数组 | 否 | 地理位置条件 ID 必须在 Google Ads 地理位置定位条件列表中有效。 | |
| categories | 商家提供的服务类别列表。 | 对象数组 | 请参阅“配置文件 Feed 示例”。 | 是 | 从 Google 提供的类别列表中选择。此属性应仅包含一个类别。 |
| 类别->任务 | 指定类别中已处理的任务的列表。 | 对象数组 | 是 | 从 Google 提供的任务列表中选择 | |
| tasks ->geoCovered | 任务所服务的地理位置 | 对象 | 是 | ||
| tasks ->geoCovered->postalCodeCriteriaIds | 与所服务的邮政编码对应的一系列条件 ID。 | 字符串数组 | 投放的一系列邮政编码的地理位置条件 ID，该条件 ID 必须在 Google Ads 地理位置定位列表中有效，且定位类型为 PostalCode | ||
| tasks ->geoCovered->cityCriteriaIds | 与所服务城市对应的条件 ID 列表。 | 字符串数组 | 投放广告的城市列表的地理位置条件 ID，该条件 ID 必须在 Google Ads 地理位置定位列表中有效（定位类型为“城市”） | ||
| 活跃 | 标志，用于指示相应商家应处于有效状态还是暂停状态 | 布尔值 | true/false | 是 | |
| monthlyBudget | 相应提供商的每月预算（以 monthlyBudgetCurrency 为单位） | 整数 | 100 | 是 | 必须大于或等于出价或潜在客户最低出价的最大值。 |
| monthlyBudgetCurrency | 每月预算和出价的币种。请参阅币种代码。 | 字符串 | “USD” | 是 | 初始商家设置完成后便无法更改。 |
| 宣传信息 | 每个类别的宣传信息数组 | 对象数组 | 是 | 从 Google 提供的宣传信息列表中选择 | |
| biddingStrategy | 相应商家在竞价中的出价策略。这会影响每位潜在客户的费用。 | 字符串 | “MANUAL_CPA” / “MAX_CONVERSION” | 否 | 从 Google 提供的列表中选择。如果未设置，此出价策略将默认为 MANUAL_CPA。 |
| biddingConfiguration | 每个类别的出价配置列表。仅适用于 MANUAL_CPA 出价策略。 | 对象数组 | 查看个人资料 Feed 示例 | 否 | 如果未提供任何配置，且 biddingStrategy 为 MANUAL_CPA，则将每个类别的默认值设置为最低出价。 |
| biddingConfiguration->categoryId | LSA 分类中的类别 ID。这些类别应与上面列出的类别相符。如果声明了出价配置，则此字段为必需字段。 | 字符串 | 否 | 从 Google 提供的列表中选择。 | |
| biddingConfiguration->manualCostPerLead | 手动配置“每位潜在客户费用”。如果 biddingStrategy 为“MANUAL_CPA”，则应提供此参数。 | 对象 | 否 | ||
| manualCostPerLead->bid | “每次引导成本”人工出价。潜在客户价格绝不会超过相应出价的值。如果声明了 manualCostPerLead，则必须提供此值。 | 数值 | 否 | 必须大于或等于底价。 |