ライフサイクル目標

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

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

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

顧客レベルで、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 を削除してから、必要な更新を加えて新しい UserListCustomerType を作成する必要があります。

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

Google Ads API v16

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

1. lifecycle_goal_customer_definition_settings.existing_user_lists は、既存の顧客が含まれているユーザーリストを示します。

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

共有リソースの動作

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

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

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

キャンペーン単位で、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 広告 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