ライフサイクル目標

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

Google 広告アカウントでクロスアカウント コンバージョン トラッキングを使用している場合は、以下のようになります。 Google 広告コンバージョンで顧客ライフサイクル目標を設定する必要がある お客様 直接ログインする必要はありません。ただし、アカウントでキャンペーンのライフサイクル目標を設定する必要があります。これは、クロスアカウント コンバージョン トラッキングで他の目標を管理する場合と同様です。

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

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

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

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

• v17 より前: <ph type="x-smartling-placeholder">
  </ph>
  • ユーザーリストを 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 メソッドを使用してライフサイクル目標を取得します。

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

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