2025年4月7日よりカスタマーマッチのメンバーシップ有効期限を更新

*この記事は Da Yang, Trevor Mulchay による Google Ads Developer Blog の記事 "Update to Customer Match membership expiration starting April 7, 2025" を元に翻訳・加筆したものです。詳しくは元記事をご覧ください。*2025 年 4 月 7 日より、Google 広告とディスプレイ＆ビデオ 360 プラットフォームのカスタマー マッチ リストに最大 540 日間のメンバーシップ期間が新たに導入され、徐々にロールアウトされます。これは、カスタマー マッチのベスト プラクティスへの準拠性を高めるための変更です。

この日以降、メンバーシップの有効期限が設定されていない既存リスト、あるいは 540 日を超えるメンバーシップ有効期限が設定されている既存リストは、最大メンバーシップ期間が 540 日に更新されます。期間が 540 日を超える既存メンバーには、540 日のメンバーシップ期間が遡及的に適用されます。メンバーシップの有効期限が切れるに連れて、反映されるリストのサイズは小さくなります。キャンペーンのターゲットとなるユーザーのセグメントが小さすぎると、広告を配信できず、自動的に一時停止される可能性があります。2025 年 4 月 7 日までにカスタマー マッチ リストを更新し、メンバーシップを更新するか、期限切れのカスタマー マッチ リストを最新のリストに置き換えてください。それにより、広告キャンペーンの中断を回避できます。

メンバーシップ期間を設定している場合は、定期的にカスタマー データをリストに再アップロードし、リストを更新する必要があります。これを行わないと、時間の経過とともにリストのサイズが小さくなります。カスタマー マッチの詳細については、こちらの記事をご覧ください。

Google Ads API ユーザーに必要なアクション

2025 年 4 月 7 日以降、Google Ads API の [UserList.membership_life_span](https://developers.google.com/google-ads/api/reference/rpc/v18/UserList#membership_life_span) フィールドに 540 を超える値を設定するリクエストを行うと、[RangeError.TOO_HIGH](https://developers.google.com/google-ads/api/reference/rpc/v18/RangeErrorEnum.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 の [membershipDurationDays](https://developers.google.com/display-video/api/reference/rest/v3/firstAndThirdPartyAudiences#FirstAndThirdPartyAudience.FIELDS.membership_duration_days) フィールドに 540 を超える値を設定する [firstAndThirdPartyAudiences.create](https://developers.google.com/display-video/api/reference/rest/v3/firstAndThirdPartyAudiences/create) リクエストと [firstAndThirdPartyAudiences.patch](https://developers.google.com/display-video/api/reference/rest/v3/firstAndThirdPartyAudiences/patch) リクエストを行うと、400 エラーが返されます。カスタマー マッチ リストを作成するときは、membershipDurationDays フィールドを設定する必要があるため、現在の実装を確認し、このフィールドに 540 を超える値を設定しないようにしてください。

既存のカスタマー マッチ リストの membershipDurationDays フィールドが 540 日を超える値に設定されている場合、2025 年 4 月 7 日より、最大 540 日の新しいメンバーシップ期間に自動移行されます。この日付以降、カスタマー マッチ リストを定期的に更新する必要があります。カスタマー マッチ リストを更新する方法の例は、ガイドをご覧ください。

問題が発生した場合や、変更について不明な点がある場合は、Display & Video 360 API テクニカル サポート問い合わせフォームからお問い合わせください。

Posted by Thanet Knack Praneenararat - Ads Developer Relations Team