2025 年 2 月 12 日，星期三
自 2025 年 4 月 7 日起，Google Ads 和 Display & Video 360 平台中的目标客户匹配名单将逐步实施最长 540 天的全新成员资格有效期。此次变更是为了更好地遵循目标客户匹配最佳实践。
自该日期起，如果现有名单未设置成员资格有效期或有效期超过 540 天，系统会将有效期更新为 540 天（成员资格有效期上限），并追溯性地将 540 天的成员资格有效期应用于所有有效期更长的现有成员。随着成员资格的过期，名单的规模将相应地减小。如果广告系列定位的细分用户群过小，将无法投放广告，并且可能会自动暂停。请在 2025 年 4 月 7 日之前刷新目标客户匹配名单，以更新成员资格，或将过期的目标客户匹配名单替换为最新名单，确保您的广告系列不会中断。
设置成员资格有效期后，您需要开始定期刷新名单，方法是向名单重新上传客户数据。如果不这样做，名单规模会随着时间的推移而不断减小。如需详细了解目标客户匹配，请参阅这篇文章。
Google Ads API 用户需要采取的行动
自 2025 年 4 月 7 日起，如果请求将 Google Ads API 中的 UserList.membership_life_span 字段设为大于 540 的值，系统将会返回 RangeError.TOO_HIGH 错误。我们建议您检查当前的实现，确保不再将该字段值设置为大于 540。
对于 Google Ads API 中 membership_life_span 字段大于 540 的现有用户名单，自 2025 年 4 月 7 日起，客户数据用户名单将自动迁移，成员资格有效期最长为 540 天。如果您需要更新代码以定期刷新客户名单，请查看我们的指南中的示例。
如果您未在 Google Ads API 中设置 membership_life_span 字段，并且会定期刷新客户名单，则无需采取任何措施。如果不设置此字段，效果与将其设置为上限值 540 天相同。
如果您遇到问题或对这些变更有疑问，请通过 Google Ads API 论坛与我们联系。
Display & Video 360 API 用户需要采取的行动
自 2025 年 4 月 7 日起，如果向 Display & Video 360 API 发出的 firstAndThirdPartyAudiences.create 和 firstAndThirdPartyAudiences.patch 请求将 membershipDurationDays 字段设为大于 540 的值，系统将会返回 400 错误。创建目标客户匹配名单时，必须设置 membershipDurationDays 字段，因此我们建议您检查当前的实现，确保不再将该字段的值设置为大于 540。
自 2025 年 4 月 7 日起，如果现有目标客户匹配名单的 membershipDurationDays 字段值大于 540 天，系统会自动将其成员资格有效期迁移至新的上限值 540 天。在此日期之后，您需要定期刷新目标客户匹配名单。请参阅我们的指南，了解如何更新您的目标客户匹配名单。
如果您遇到问题或对这些变更有疑问，请使用 Display & Video 360 API 技术支持联系表单与我们联系。
- Da Yang，Google Ads API 团队
- Trevor Mulchay，Display & Video 360 API 团队
标签： customer-match、 display-video-360-api、 google-ads、 google-ads-api