CustomerLifecycleGoal
と
次の CampaignLifecycleGoal
個のリソース:
Google Ads API: 顧客のライフサイクルに関連する目標を設定します。v15 以降、
Google Ads API: 顧客獲得をサポート
効率的に目標を達成するための
Google 広告の検索キャンペーンと P-MAX キャンペーンで新規顧客を獲得
比較します
Google 広告アカウントでクロスアカウント コンバージョン トラッキングを使用している場合は、以下のようになります。 Google 広告コンバージョンで顧客ライフサイクル目標を設定する必要がある お客様 直接ログインする必要はありません。その場合でも アカウントでキャンペーンのライフサイクル目標を 設定することもできます同様の方法で Google 広告アカウントで他の目標を管理する クロスアカウント コンバージョン トラッキング
作成オペレーションと更新オペレーションを処理する(v15 のみ)
Google Ads API v15 では、
CustomerLifecycleGoalService
、
CampaignLifecycleGoalService
Google Ads API の他のサービスとは若干異なります個別のリソースを
create
オペレーションと update
オペレーション、v15
CustomerLifecycleGoalOperation
および
CampaignLifecycleGoalOperation
create
演算しかなく、
update_mask
は次のようになります。
v15 を使用してライフサイクル目標を作成するには、
create
に目標を入力しますが、resource_name
を設定せず、インスタンスのupdate_mask
も設定しない あります。v15 を使用してライフサイクル目標を更新するには、目標を
create
に入力し、次のように設定します。 目標のresource_name
、update_mask
を設定して 指定します。
顧客ライフサイクル目標を設定する
顧客レベルで、ライフサイクル目標を作成または更新して、
CustomerLifecycleGoal
。場所によっては、
Google 広告アカウントごとに最大 1 つのCustomerLifecycleGoal
。「
customer_acquisition_goal_value_settings.value
フィールドは、追加の
新規顧客の最初の購入コンバージョンに追加する金額調整。Google Chat では
customer_acquisition_goal_value_settings.high_lifetime_value
の読み取り
このフィールドは Google Ads API では変更できません。
オーディエンスをセグメント化する
Google Ads API v17 以降では、
セグメント化するリソース: UserListCustomerType
顧客ライフサイクル目標に合わせてオーディエンスを
最適化できますGoogle Cloud コンソールで直接
CustomerLifecycleGoal
リソースは
非推奨です。詳細:
- v17 より前:
<ph type="x-smartling-placeholder">
- </ph>
- ユーザーリストを
existing_user_lists
CustomerLifecycleGoal
。
- ユーザーリストを
- v17 以降:
<ph type="x-smartling-placeholder">
- </ph>
- 各ユーザーリストを 1 つ以上のカテゴリに関連付けるには、
ユーザーリストとカテゴリの組み合わせごとに
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
の間に競合がなければ
説明します。次の権限で UserListCustomerType
インスタンスを割り当てようとしています:
次の組み合わせ:
customer_type_category
同じユーザーリストに追加すると
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
|
UserListCustomerType インスタンスを作成または削除します。ここで、
customer_type_category の設定
HIGH_VALUE_CUSTOMERS
|
個々のリソース名は
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 の他のリソースと同様に、search
または searchStream
を使用します。
取得する GoogleAdsService
のメソッド
ライフサイクル目標を設定します。
次のクエリは、すべての 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