Verwenden Sie die Operatoren CustomerLifecycleGoal
und
CampaignLifecycleGoal
Ressourcen des
Google Ads API, um Zielvorhaben zu konfigurieren, die sich auf den Kundenlebenszyklus beziehen. Ab Version 15 enthält das Feld
Unterstützung der Kundenakquisition durch die Google Ads API
Zielvorhaben
mit Such- und Performance Max-Kampagnen in Google Ads Neukunden gewinnen
Kampagnen.
Wenn in Ihrem Google Ads-Konto das kontoübergreifende Conversion-Tracking verwendet wird, müssen Sie Zielvorhaben für den Kundenlebenszyklus im Google Ads-Conversion-Kundenkonto und nicht direkt in Ihrem Google Ads-Konto konfigurieren. Sie sollten trotzdem die Zielvorhaben für den Kampagnenlebenszyklus. Das funktioniert ähnlich wie andere Zielvorhaben verwalten, wenn Sie kontoübergreifendes Conversion-Tracking nutzen.
Zielvorhaben für den Kundenlebenszyklus konfigurieren
Konfigurieren Sie auf Kundenebene ein Lebenszyklusziel, indem Sie ein
CustomerLifecycleGoal
Pro Google Ads-Konto kann es maximal eine CustomerLifecycleGoal
geben. Im Feld customer_acquisition_goal_value_settings.value
wird die zusätzliche Wertanpassung definiert, die der ersten Kauf-Conversion eines Neukunden hinzugefügt wird. Sie können die customer_acquisition_goal_value_settings.high_lifetime_value
des Zielvorhabens lesen, dieses Feld ist jedoch in der Google Ads API unveränderlich.
Zielgruppen segmentieren
Ab der Google Ads API v17 müssen Sie die Ressource UserListCustomerType
verwenden, um Ihre Zielgruppen für Zielvorhaben des Kundenlebenszyklus zu segmentieren. Die direkte Konfiguration von Zielgruppen über die Ressource CustomerLifecycleGoal
wird eingestellt. Hier sind die Details:
- Vor Version 17:
- Fügen Sie der
existing_user_lists
-Sammlung einerCustomerLifecycleGoal
Nutzerlisten hinzu.
- Fügen Sie der
- Ab Version 17:
- Verknüpfen Sie jede Nutzerliste mit einer oder mehreren Kategorien, indem Sie für jede Kombination aus Nutzerliste und Kategorie eine
UserListCustomerType
erstellen.
- Verknüpfen Sie jede Nutzerliste mit einer oder mehreren Kategorien, indem Sie für jede Kombination aus Nutzerliste und Kategorie eine
Ab Version 17 der Google Ads API
Verwenden Sie UserListCustomerTypeService
, um UserListCustomerType
-Instanzen zu erstellen.
Wenn Sie das Feld CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings.existing_user_lists
bereits ausgefüllt haben, enthält Ihr Konto bereits zugehörige UserListCustomerType
-Instanzen.
UserListCustomerTypeService
unterstützt nur create
- und remove
-Vorgänge. Wenn Sie also eine vorhandene UserListCustomerType
aktualisieren möchten, müssen Sie sie entfernen und dann eine neue mit den erforderlichen Aktualisierungen erstellen.
Einem UserListCustomerType
kann nur eine Nutzerliste zugewiesen werden. Eine Nutzerliste kann jedoch mehrere verknüpfte UserListCustomerType
-Instanzen haben, sofern keine Konflikte zwischen den UserListCustomerType
-Instanzen auftreten. Wenn Sie versuchen, derselben Nutzerliste UserListCustomerType
-Instanzen mit den folgenden Kombinationen von customer_type_category
zuzuweisen, führt dies zu einem UserListCustomerTypeError.CONFLICTING_CUSTOMER_TYPES
-Fehler:
Erste customer_type_category |
Zweite customer_type_category |
---|---|
KÄUFER | CONVERTED_LEADS |
KÄUFER | QUALIFIED_LEADS |
KÄUFER | CART_ABANDONERS |
CONVERTED_LEADS | QUALIFIED_LEADS |
DISENGAGED_CUSTOMERS | CONVERTED_LEADS |
DISENGAGED_CUSTOMERS | QUALIFIED_LEADS |
DISENGAGED_CUSTOMERS | CART_ABANDONERS |
In der Google Ads API Version 16
Legen Sie in der CustomerLifecycleGoal
Ihres Kontos die folgenden Felder fest:
Mit
lifecycle_goal_customer_definition_settings.existing_user_lists
wird angegeben, welche Nutzerlisten Bestandskunden enthalten.Im Feld
lifecycle_goal_customer_definition_settings.high_lifetime_value_user_lists
wird angegeben, welche Nutzerlisten Kunden mit hohem Lifetime-Wert enthalten. Sie können dieses Feld lesen, es ist jedoch in der Google Ads API unveränderlich.
Verhalten gemeinsam genutzter Ressourcen
Bis zur Einstellung von Version 16 der Google Ads API im Januar 2025 ist Folgendes zu beachten:
UserListCustomerType
und die Felder zur Zielgruppensegmentierung auf
CustomerLifecycleGoal
sind eine freigegebene Ressource. Das heißt, das Erstellen neuer
UserListCustomerType
Instanzen in v17 und höher führen zu Änderungen
auf Ihre CustomerLifecycleGoal
-Instanz in Version 16 und früheren Versionen, und umgekehrt
in der Umgebung.
So werden die Felder in den beiden Ressourcen zugeordnet:
Änderung des Felds „CustomerLifecycleGoal“ in Version 16 | Nebenwirkung auf „UserListCustomerType“ in Version 17 |
---|---|
lifecycle_goal_customer_definition_settings.existing_user_lists
|
Erstellt oder entfernt UserListCustomerType -Instanzen. Das Feld user_list enthält den Namen der verknüpften Nutzerlistenressource.
|
Änderung von „UserListCustomerType“ in Version 17 | Nebenwirkung auf das Feld „CustomerLifecycleGoal“ in Version 16 |
---|---|
UserListCustomerType -Instanzen erstellen oder entfernen
|
Einzelne Ressourcennamen werden der lifecycle_goal_customer_definition_settings.existing_user_lists hinzugefügt oder daraus entfernt.
|
UserListCustomerType -Instanzen erstellen oder entfernen, wobei customer_type_category auf HIGH_VALUE_CUSTOMERS festgelegt ist
|
Einzelne Ressourcennamen werden der lifecycle_goal_customer_definition_settings.high_lifetime_value_user_lists hinzugefügt oder daraus entfernt.
|
Zielvorhaben für den Kampagnenlebenszyklus konfigurieren
Konfigurieren Sie auf Kampagnenebene ein Zielvorhaben für den Lebenszyklus, indem Sie eine CampaignLifecycleGoal
erstellen oder aktualisieren. Pro Kampagne kann es höchstens einen CampaignLifecycleGoal
geben.
Mit dem Feld „customer_acquisition_goal_settings
“ eines Zielvorhabens auf Kampagnenebene
Optimierungsmodus der Kampagne festlegen und Werteinstellungen überschreiben
vom übergeordneten Zielvorhaben „Kunden“.
optimization_mode
kann einer der folgenden Werte sein:
TARGET_ALL_EQUALLY
- Mit der Kampagne werden Neu- und Bestandskunden gleichermaßen angesprochen. Dies ist die Standardeinstellung. Optimierungsmodus.
BID_HIGHER_FOR_NEW_CUSTOMERS
- Die Kampagne richtet sich sowohl an Neu- als auch an Bestandskunden. Die Gebote sind jedoch für Kunden höher, die voraussichtlich Neukunden sind und sich nicht in einer der
existing_user_lists
befinden. TARGET_NEW_CUSTOMERS
- Die Kampagne richtet sich nur an Neukunden.
Die value_settings
sind mit den customer_acquisition_goal_value_settings
auf Kundenebene identisch. Mit diesen Einstellungen auf Kampagnenebene können Sie die Werte für eine bestimmte Kampagne überschreiben.
Lebenszyklusziele abrufen
Wie bei anderen Ressourcen in der Google Ads API verwenden Sie search
oder searchStream
.
GoogleAdsService
-Methoden zum Abrufen
Lebenszyklusziele zu erreichen.
Mit der folgenden Abfrage werden die Details jeder CustomerLifecycleGoal
in einem
Google Ads-Konto:
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
Die folgende Abfrage ruft die Details aller CampaignLifecycleGoal
ab:
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