ライフサイクル目標

Google Ads API の CustomerLifecycleGoal リソースと CampaignLifecycleGoal リソースを使用して、顧客ライフサイクルに関連する目標を設定します。v15 では、Google Ads API は、Google 広告の検索キャンペーンと P-MAX キャンペーンを通じて新規顧客を効率的に獲得するための顧客獲得目標をサポートしています。

Google 広告アカウントでクロスアカウントコンバージョントラッキングを使用している場合は、顧客のライフサイクル目標を、Google 広告アカウントで直接設定するのではなく、Google 広告コンバージョンの顧客アカウントで設定する必要があります。ただし、キャンペーンのライフサイクル目標は、引き続きアカウントで設定する必要があります。これは、クロスアカウントコンバージョントラッキングを使用する際に他の目標を管理する方法と似ています。

作成オペレーションと更新オペレーションを処理する（v15 のみ）

Google Ads API v15 では、CustomerLifecycleGoalService と CampaignLifecycleGoalService でサポートされているオペレーションが、Google Ads API の他のサービスと若干異なります。v15 の CustomerLifecycleGoalOperation と CampaignLifecycleGoalOperation では、create と update のオペレーションを個別に使用する代わりに、create のオペレーションのみを使用できます。その場合、次のように update_mask を使用してインテントを指定します。

v15 を使用してライフサイクル目標を作成するには、create に目標を入力しますが、resource_name は設定せず、オペレーションの update_mask も設定しないでください。
v15 を使用してライフサイクル目標を更新するには、create に目標を入力し、目標の resource_name を設定して、更新するフィールドを一覧表示する update_mask を設定します。

顧客ライフサイクル目標を設定する

顧客レベルで、CustomerLifecycleGoal を作成または更新して、ライフサイクル目標を設定します。CustomerLifecycleGoal は Google 広告アカウントごとに 1 つまで設定できます。customer_acquisition_goal_value_settings.value フィールドでは、新規顧客の最初の購入コンバージョンに追加する、追加の値調整を定義します。目標の customer_acquisition_goal_value_settings.high_lifetime_value を読み取ることはできますが、このフィールドは Google Ads API では変更できません。

オーディエンスをセグメント化する

Google Ads API v17 以降、顧客ライフサイクルの目標に合わせてオーディエンスをセグメント化するには、UserListCustomerType リソースを使用する必要があります。CustomerLifecycleGoal リソースでオーディエンスを直接設定することはサポートされなくなりました。詳細:

v17 より前:
- ユーザーリストを CustomerLifecycleGoal の existing_user_lists コレクションに追加します。
v17 以降:
- ユーザーリストとカテゴリの組み合わせごとに UserListCustomerType を作成して、各ユーザーリストを 1 つ以上のカテゴリに関連付けます。

Google Ads API v17 以降

UserListCustomerTypeService を使用して UserListCustomerType インスタンスを作成します。CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings.existing_user_lists フィールドにすでに入力している場合、アカウントには関連する UserListCustomerType インスタンスがすでに含まれています。

UserListCustomerTypeService は create オペレーションと remove オペレーションのみをサポートしているため、既存の UserListCustomerType を更新する場合は、それを削除してから、必要な更新を含む新しいオペレーションを作成する必要があります。

UserListCustomerType は 1 つのユーザーリストにのみ割り当てることができますが、UserListCustomerType インスタンス間に競合がない限り、ユーザーリストには複数の UserListCustomerType インスタンスを関連付けることができます。次の customer_type_category の組み合わせで UserListCustomerType インスタンスを同じユーザーリストに割り当てようとすると、UserListCustomerTypeError.CONFLICTING_CUSTOMER_TYPES エラーが発生します。

最初の `customer_type_category`	2 回目の `customer_type_category`
購入者	CONVERTED_LEADS
購入者	QUALIFIED_LEADS
購入者	CART_ABANDONERS
CONVERTED_LEADS	QUALIFIED_LEADS
DISENGAGED_CUSTOMERS	CONVERTED_LEADS
DISENGAGED_CUSTOMERS	QUALIFIED_LEADS
DISENGAGED_CUSTOMERS	CART_ABANDONERS

Google Ads API v16 以前

アカウントの CustomerLifecycleGoal で次のフィールドを設定します。

lifecycle_goal_customer_definition_settings.existing_user_lists は、既存の顧客が含まれているユーザーリストを示します。
lifecycle_goal_customer_definition_settings.high_lifetime_value_user_lists フィールドは、ライフタイムバリューの高いユーザーが含まれているユーザーリストを示します。このフィールドは読み取ることができますが、Google Ads API では変更できません。

共有リソースの動作

2025 年 1 月に Google Ads API v16 が廃止されるまでは、UserListCustomerType と CustomerLifecycleGoal のオーディエンスセグメンテーションフィールドは共有リソースであることにご留意ください。つまり、v17 以降で新しい UserListCustomerType インスタンスを作成すると、v16 以前では CustomerLifecycleGoal インスタンスが変更され、その逆も同様です。

2 つのリソースのフィールドは次のようにマッピングされます。

v16 の「CustomerLifecycleGoal」フィールドの変更	v17 の「UserListCustomerType」に対する副作用
`lifecycle_goal_customer_definition_settings.existing_user_lists`	`UserListCustomerType` インスタンスを作成または削除します。`user_list` フィールドには、関連するユーザーリストのリソース名が含まれます。

v17 での「UserListCustomerType」の変更	v16 の「CustomerLifecycleGoal」フィールドの副作用
`UserListCustomerType` インスタンスを作成または削除します。	個々のリソース名は、`lifecycle_goal_customer_definition_settings.existing_user_lists`
`customer_type_category` が `HIGH_VALUE_CUSTOMERS` に設定されている `UserListCustomerType` インスタンスを作成または削除する	個々のリソース名は、`lifecycle_goal_customer_definition_settings.high_lifetime_value_user_lists`

キャンペーンのライフサイクル目標を設定

キャンペーン単位では、CampaignLifecycleGoal を作成または更新してライフサイクル目標を設定します。キャンペーンごとに最大 1 つのCampaignLifecycleGoalを指定できます。

キャンペーン単位の目標の customer_acquisition_goal_settings フィールドを使用すると、キャンペーンの最適化モードを設定したり、親の顧客目標の値の設定をオーバーライドしたりできます。

optimization_mode は次のいずれかの値です。

TARGET_ALL_EQUALLY: キャンペーンのターゲットは、新規顧客と既存顧客を同じにします。これはデフォルトの最適化モードです。
BID_HIGHER_FOR_NEW_CUSTOMERS: このキャンペーンは、新規顧客と既存顧客の両方をターゲットにしますが、existing_user_lists に含まれないと予測される新規顧客に対する入札単価を高くします。
TARGET_NEW_CUSTOMERS: キャンペーンは新規顧客のみをターゲットにします。

value_settings は、顧客レベルの目標の customer_acquisition_goal_value_settings と同じです。これらのキャンペーン単位の設定を使用すると、特定のキャンペーンの値をオーバーライドできます。

ライフサイクル目標を取得する

Google Ads API の他のリソースと同様に、GoogleAdsService の search メソッドまたは searchStream メソッドを使用して、ライフサイクル目標を取得します。

次のクエリは、Google 広告アカウントのすべての CustomerLifecycleGoal の詳細を取得します。

SELECT
  customer_lifecycle_goal.lifecycle_goal_customer_definition_settings.existing_user_lists,
  customer_lifecycle_goal.lifecycle_goal_customer_definition_settings.high_lifetime_value_user_lists,
  customer_lifecycle_goal.customer_acquisition_goal_value_settings.value,
  customer_lifecycle_goal.customer_acquisition_goal_value_settings.high_lifetime_value
FROM customer_lifecycle_goal

同様に、次のクエリはすべての CampaignLifecycleGoal の詳細を取得します。

SELECT
  campaign_lifecycle_goal.campaign,
  campaign_lifecycle_goal.customer_acquisition_goal_settings.optimization_mode,
  campaign_lifecycle_goal.customer_acquisition_goal_settings.value_settings.value,
  campaign_lifecycle_goal.customer_acquisition_goal_settings.value_settings.high_lifetime_value
FROM campaign_lifecycle_goal

キャンペーン目標