このページは Cloud Translation API によって翻訳されました。

ライフサイクル目標

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 エラーが発生します。

最初の `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 では変更できません。

共有リソースの動作

Google Ads API v16 が 2025 年 1 月に廃止されるまで、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` に追加または削除されます。
`UserListCustomerType` インスタンスを作成または削除します。ここで、`customer_type_category` は `HIGH_VALUE_CUSTOMERS` に設定されています。	個々のリソース名が `lifecycle_goal_customer_definition_settings.high_lifetime_value_user_lists` に追加または削除されます。

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

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

キャンペーンレベルの目標の 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

キャンペーン目標