Google 会使用 AI 技术将内容翻译成您偏好的语言。AI 翻译可能包含错误。

以“按潜在客户付费”为目标的效果最大化广告系列

以“按潜在客户付费”为目标的效果最大化广告系列可助力本地商家触达客户。这些广告系列会投放本地生活服务广告，因此也称为本地生活服务效果最大化广告系列，并使用 Google Ads API 中的 local_services_* 字段和服务进行配置。在这种设置下，您的营销支出将重点放在与客户建立直接联系。系统仅在潜在客户通过广告直接与您的商家联系时向您收费，而不是在他们点击广告时计费。

在开始之前，请确保您拥有具有标准访问权限的有效开发者令牌。如需了解详情，请参阅入门指南。

广告系列制作工作流程

制作指定“按潜在客户付费”目标的效果最大化广告系列的步骤如下：

完成账号级前提条件
检索 Google 商家资料商家信息和地址素材资源
以原子方式创建广告系列资源 (GoogleAdsService.Mutate)
启用广告系列并完成商家验证

满足账号级前提条件

如果您要为现有 Google Ads 账号制作广告系列，请先在账号中完成以下前提条件，然后再制作广告系列。如果您同时创建新的 Google Ads 账号，请在执行广告系列创建操作之前完成以下步骤：

接受服务条款（仅限 Google Ads 界面）：您必须在 Google Ads 账号设置页面中接受本地生活服务条款。此协议无法通过 API 以编程方式接受。在未接受协议的情况下制作或启用广告系列会返回 CampaignError.LOCAL_SERVICES_AGREEMENT_REQUIRED。
Google 商家资料关联（Google Ads 界面或 API）：将商家资料与 Google Ads 账号相关联（在 Google Ads 界面中的数据管理器 > 关联的账号下，或使用 LOCATION_SYNC 类型的 AssetSet 以编程方式关联）。请注意，仅创建 LOCATION_SYNC AssetSet 并不会为账号启用营业地点同步功能；您还必须使用 CustomerAssetSet (CustomerAssetSetService.MutateCustomerAssetSets) 将其附加到客户，并提供具有 https://www.googleapis.com/auth/business.manage 范围的 OAuth 2.0 http_authorization_token。如需了解详情，请参阅创建营业地点同步素材资源集并将其附加到客户。这会将营业地点作为账号LOCATION素材资源同步到 Google Ads 账号中。

检索 Google 商家资料中的商家信息和地址素材资源

使用 GoogleAdsService.Search 查询 asset 资源，这依赖于在前面的完成账号级前提条件部分中关联 Google 商家资料后同步的 LOCATION 素材资源。

该查询会检索广告系列设置所需的 Google 商家资料 listing_id，以及使用 AssetSetAsset 关联到广告系列的 STATIC_LOCATION_GROUP AssetSet 所需的 asset.resource_name：

SELECT
  asset.id,
  asset.name,
  asset.location_asset.place_id,
  asset.location_asset.business_profile_locations
FROM asset
WHERE asset.type = 'LOCATION'

以原子方式创建广告系列资源 (`GoogleAdsService.Mutate`)

以“按潜在客户付费”为目标的广告系列使用以下一组资源：

鉴于以“按潜在客户付费”为目标的广告系列有特定的设置要求，请将所有操作捆绑到单个原子 GoogleAdsService.Mutate 请求中，以防止配置不完整并确保事务完整性。

`CampaignBudget`（创建）

确定广告系列的每日预算：

amount_micros：每日预算金额（以微单位表示）。
delivery_method：STANDARD。
explicitly_shared：必须设置为 false。效果最大化广告系列无法使用共享预算。

`Campaign`（创建）

每个客户账号只能有一个未移除的本地生活服务效果最大化广告系列；创建第二个广告系列会返回 CampaignError.LOCAL_SERVICES_MULTIPLE_PERFORMANCE_MAX_CAMPAIGNS_NOT_ALLOWED。

name：广告系列的必需名称。
campaign_budget：在同一请求中创建的 CampaignBudget 的临时资源名称。
advertising_channel_type：必须设置为 PERFORMANCE_MAX。
brand_guidelines_enabled：必须设置为 false。与标准效果最大化广告系列（默认设置为 brand_guidelines_enabled = true，且需要关联 BUSINESS_NAME 和 LOGO CampaignAsset 资源）不同，本地生活服务效果最大化广告系列会设置 brand_guidelines_enabled = false。
pmax_campaign_settings.local_services_enabled：必须设置为 true（不可变布尔值；创建后无法修改）。
pmax_campaign_settings.local_services_pmax_campaign_settings：
- country_code：必需的 ISO-3166 国家/地区代码（由两个字母组成，'US'）。在创建时进行验证。
- listing_id：必需的数字 Google 商家资料商家信息 ID，表示提供商的营业地点。在广告系列制作时进行验证；如果 ID 无效，则返回 CampaignError.INVALID_LOCAL_SERVICES_PERFORMANCE_MAX_LISTING_ID。
- 可选：phone_numbers：重复的 LocalServicesPhoneNumber 消息，用于指定专用跟踪电话号码或商家电话号码（phone_number、country_code 和 GlsPhoneNumberType phone_number_type）。如果省略，则来电号码默认为关联的 Google 商家资料商家信息中的电话号码；如果商家资料商家信息中没有电话号码，则必须提供来电号码。支持的 phone_number_type 值包括 DESTINATION_PHONE_NUMBER_FOR_ADS（适用于来电潜在客户）和 DESTINATION_PHONE_NUMBER_FOR_SMS_ONLY（可选，适用于私信潜在客户短信通知）。
- 可选：founding_year：企业成立年份（例如 1998）。
- 可选：navigational_query_leads_enabled：一个布尔值，表示是否接收来自导航型含品牌词的搜索查询的潜在客户。
maximize_conversions：必需的出价策略消息，用于配置MAXIMIZE_CONVERSIONS出价（可选择target_cpa_micros）。不支持目标广告支出回报率和人工出价。
status：在创建时设置为 PAUSED，直到素材资源组、信号和商家验证最终确定。

`CampaignCriterion`（创建）

通过为每个条件捆绑一项操作，并链接到临时广告系列资源名称，为广告系列定义定位参数：

语言定位 (language)：对于美国广告系列，严格执行英语 (languageConstants/1000) 定位。其他语言会在变更时被拒绝。
服务区域地理位置定位 (location)：本地生活服务效果最大化广告系列必须至少有一个正向地理位置定位条件来定义服务区域（移除所有地理位置会返回 CampaignCriterionError.CANNOT_REMOVE_ALL_LOCATIONS_FROM_LOCAL_SERVICES_PMAX_CAMPAIGN）。在广告系列声明的 country_code (US) 中，支持在城市、县、邮政编码或州/省/自治区/直辖市一级进行正向包含和排除。不允许在国家/地区一级进行定位，否则会返回 CampaignCriterionError.CANNOT_TARGET_COUNTRY_FOR_LOCAL_SERVICES_CAMPAIGN。使用 GeoTargetConstantService.SuggestGeoTargetConstants、Google Ads 查询语言查询 geo_target_constant 或 Google Ads 地理位置定位参考表解析条件 ID。
可选：自定义广告投放时间 (ad_schedule)：如果省略，则默认全天候投放。使用正向 ad_schedule 条件限制递送。

地理位置定位组（`AssetSet` 和 `AssetSetAsset`）（创建）

创建一个 STATIC_LOCATION_GROUP 类型的 AssetSet，并将 location_group_parent_asset_set_id 设置为账号的有效 LOCATION_SYNC AssetSet 的 ID，然后使用 AssetSetAsset 关联特定的已同步 LOCATION 素材资源。

如需了解详情，请参阅地址素材资源指南。

`CampaignAssetSet`（创建）

将广告系列与 STATIC_LOCATION_GROUP 素材资源集相关联。关联后，此关联不可变且无法移除 (AssetSetLinkError.ASSET_SET_LINK_CANNOT_BE_REMOVED)。

如果设置为 partial_failure = false（GoogleAdsService.Mutate 的默认值），则捆绑操作中的任何验证失败都会以原子方式回滚整个事务。系统会强制执行以下三条 CampaignAssetSet 验证规则：

只能将一个 STATIC_LOCATION_GROUP AssetSet 关联到该广告系列 (AssetSetLinkError.DUPLICATE_ASSET_SET_LINK)。
STATIC_LOCATION_GROUP 最多只能包含一个有效的 LOCATION 素材资源。
关联的 LOCATION 资产的商品详情 ID 必须与 campaign.pmax_campaign_settings.local_services_pmax_campaign_settings.listing_id (AssetSetLinkError.LOCATION_ASSET_DOES_NOT_MATCH_CAMPAIGN_LISTING_ID) 一致。

`AssetGroup`（创建）

配置本地生活服务素材资源组。与标准效果最大化广告系列不同，本地生活服务效果最大化广告系列素材资源组不需要 AssetGroupAsset 资源（标题、广告内容描述或图片）或 final_urls。

name：素材资源组的必需名称。
campaign：在同一请求中创建的 Campaign 的临时资源名称。
status：创建时必须设置为 ENABLED。
google_local_services_info.category_id：标准化类别 ID（例如 xcat:service_area_business_plumber）。指定不受支持的类别会返回 AssetGroupError.UNSUPPORTED_LOCAL_SERVICES_CATEGORY。
可选：google_local_services_info.callouts：重复的 LocalServicesCallout 消息（每个素材资源组最多允许 6 个宣传信息），带有 callout_id。

`AssetGroupSignal`（创建）

与标准效果最大化广告系列（信号为可选）不同，本地生活服务效果最大化广告系列要求每个素材资源组至少有一个 local_services_id AssetGroupSignal（移除所有信号会返回 AssetGroupSignalError.CANNOT_REMOVE_ALL_SIGNALS）。

local_services_id 是一个 LocalServiceIdInfo 消息，您可以在其中使用有效的服务类型 ID（例如 {"local_services_id": {"service_id": "install_faucet"}}）填充 local_services_id.service_id。AssetGroupSignal 资源不可变（仅限 CREATE 和 REMOVE；无 UPDATE）。

原子 mutate 请求示例

以下 REST JSON 示例演示了如何使用临时资源名称将所有操作捆绑到单个 POST /v26/customers/{customer_id}/googleAds:mutate 请求中：

{
  "mutateOperations": [
    {
      "campaignBudgetOperation": {
        "create": {
          "resourceName": "customers/{customer_id}/campaignBudgets/-1",
          "name": "Local Services PMax Budget",
          "amountMicros": "50000000",
          "deliveryMethod": "STANDARD",
          "explicitlyShared": false
        }
      }
    },
    {
      "campaignOperation": {
        "create": {
          "resourceName": "customers/{customer_id}/campaigns/-2",
          "name": "Local Services PMax Campaign",
          "advertisingChannelType": "PERFORMANCE_MAX",
          "status": "PAUSED",
          "campaignBudget": "customers/{customer_id}/campaignBudgets/-1",
          "brandGuidelinesEnabled": false,
          "maximizeConversions": {},
          "pmaxCampaignSettings": {
            "localServicesEnabled": true,
            "localServicesPmaxCampaignSettings": {
              "countryCode": "US",
              "listingId": "123456789",
              "phoneNumbers": [
                {
                  "phoneNumber": "+18005550100",
                  "countryCode": "US",
                  "phoneNumberType": "DESTINATION_PHONE_NUMBER_FOR_ADS"
                }
              ],
              "foundingYear": "1998",
              "navigationalQueryLeadsEnabled": true
            }
          }
        }
      }
    },
    {
      "campaignCriterionOperation": {
        "create": {
          "campaign": "customers/{customer_id}/campaigns/-2",
          "language": {
            "languageConstant": "languageConstants/1000"
          }
        }
      }
    },
    {
      "campaignCriterionOperation": {
        "create": {
          "campaign": "customers/{customer_id}/campaigns/-2",
          "location": {
            "geoTargetConstant": "geoTargetConstants/1014221"
          }
        }
      }
    },
    {
      "campaignCriterionOperation": {
        "create": {
          "campaign": "customers/{customer_id}/campaigns/-2",
          "adSchedule": {
            "dayOfWeek": "MONDAY",
            "startHour": 9,
            "startMinute": "ZERO",
            "endHour": 17,
            "endMinute": "ZERO"
          }
        }
      }
    },
    {
      "assetSetOperation": {
        "create": {
          "resourceName": "customers/{customer_id}/assetSets/-3",
          "name": "Local Services Location Group",
          "type": "STATIC_LOCATION_GROUP",
          "locationGroupParentAssetSetId": "LOCATION_SYNC_ASSET_SET_ID"
        }
      }
    },
    {
      "assetSetAssetOperation": {
        "create": {
          "assetSet": "customers/{customer_id}/assetSets/-3",
          "asset": "customers/{customer_id}/assets/LOCATION_ASSET_ID"
        }
      }
    },
    {
      "campaignAssetSetOperation": {
        "create": {
          "campaign": "customers/{customer_id}/campaigns/-2",
          "assetSet": "customers/{customer_id}/assetSets/-3"
        }
      }
    },
    {
      "assetGroupOperation": {
        "create": {
          "resourceName": "customers/{customer_id}/assetGroups/-4",
          "campaign": "customers/{customer_id}/campaigns/-2",
          "name": "Local Services Plumbing Asset Group",
          "status": "ENABLED",
          "googleLocalServicesInfo": {
            "categoryId": "xcat:service_area_business_plumber",
            "callouts": [
              {
                "calloutId": "family_owned"
              }
            ]
          }
        }
      }
    },
    {
      "assetGroupSignalOperation": {
        "create": {
          "assetGroup": "customers/{customer_id}/assetGroups/-4",
          "localServicesId": {
            "serviceId": "install_faucet"
          }
        }
      }
    }
  ]
}

自动配置转化目标

转化目标由后端根据账号和合作伙伴资格条件自动预配和管理；在初始原子广告系列创建期间，您无需传递转化目标操作。

本地生活服务广告系列仅限于支持的本地生活服务潜在客户转化类别。尝试配置其他目标会返回 CampaignConversionGoalError.GOAL_NOT_ALLOWED_FOR_LOCAL_SERVICES_CAMPAIGN。此外，本地生活服务广告系列需要广告系列级替换目标；停用替换目标会返回 ConversionGoalCampaignConfigError.CANNOT_DISABLE_CAMPAIGN_OVERRIDE_GOALS_FOR_LOCAL_SERVICES_CAMPAIGN。

非优惠券广告系列：
- PHONE_CALL_LEAD (LOCAL_SERVICES_ADS)：在广告系列制作时自动关联为默认有效可出价目标 (biddable = true)。此目标是必需的，不能设置为 biddable = false（否则会返回 CampaignConversionGoalError.CANNOT_UNLINK_LOCAL_SERVICES_GOAL_FROM_LOCAL_SERVICES_CAMPAIGN）。
- MESSAGE_LEAD (LOCAL_SERVICES_ADS)：在账号级自动预先创建，因此转化操作存在，但在广告系列级默认为biddable = false（默认停用）。如需选择启用通过消息联系的潜在客户（在创建时或之后），请使用 CampaignConversionGoalOperation 将广告系列转化目标 customers/{customer_id}/campaignConversionGoals/{campaign_id}~MESSAGE_LEAD~LOCAL_SERVICES_ADS 更新为 biddable = true。
- BOOK_APPOINTMENT (LOCAL_SERVICES_ADS)：在关联的营业地点检测到已获批准的 Reserve with Google 合作伙伴后，系统会异步预配并关联下游 (biddable = true)。
POS 优惠券合作伙伴广告系列（Clover、Lightspeed、Express Oil）：
- CONVERTED_LEAD (LOCAL_SERVICES_ADS)：创建后自动关联（线下促销兑换）为可出价的有效目标。优惠券合作伙伴广告系列专门针对CONVERTED_LEAD进行优化，无法使用电话或私信潜在客户目标。

启用广告系列并完成商家验证

启用广告系列：使用 CampaignService.MutateCampaigns 将广告系列状态从 PAUSED 更新为 ENABLED。
完成信任与安全验证：通过 Google Ads 界面（“管理”>“政策”）完成工商登记、身份验证、执照和文件提交。验证通过后，广告就会开始投放。