Verwenden Sie die Ressourcen CustomerLifecycleGoal
und CampaignLifecycleGoal
der Google Ads API, um Zielvorhaben im Zusammenhang mit dem Kundenlebenszyklus zu konfigurieren. Die Google Ads API unterstützt Zielvorhaben vom Typ „Kundenakquisition“, mit denen Sie Ihre Google Ads-Such- und Performance Max-Kampagnen für die effiziente Neukundengewinnung optimieren können.
Wenn in Ihrem Google Ads-Konto kontoübergreifendes Conversion-Tracking verwendet wird, müssen Sie Zielvorhaben für den Kundenlebenszyklus im Google Ads-Conversion-Konto und nicht direkt in Ihrem Google Ads-Konto konfigurieren. Sie sollten jedoch weiterhin Zielvorhaben für den Kampagnenlebenszyklus in Ihrem Konto festlegen. Das ist ähnlich wie bei der Verwaltung anderer Zielvorhaben, wenn Sie kontoübergreifendes Conversion-Tracking verwenden.
Zielvorhaben für den Kundenlebenszyklus konfigurieren
Konfigurieren Sie ein Zielvorhaben für den Kundenlebenszyklus auf Kundenebene, indem Sie eine CustomerLifecycleGoal
erstellen oder aktualisieren. 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
In der Google Ads API Version 17 und höher
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 der Google Ads API v16 im Februar 2025 ist es wichtig zu wissen, dass UserListCustomerType
und die Felder für die Zielgruppensegmentierung in CustomerLifecycleGoal
eine gemeinsame Ressource sind. Das bedeutet, dass das Erstellen neuer UserListCustomerType
-Instanzen in Version 17 und höher zu Änderungen an Ihrer CustomerLifecycleGoal
-Instanz in Version 16 und niedriger führt und umgekehrt.
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 können Sie den Optimierungsmodus der Kampagne festlegen und die Werteinstellungen des übergeordneten Kundenzielvorhabens überschreiben.
optimization_mode
kann einen der folgenden Werte haben:
TARGET_ALL_EQUALLY
- Die Kampagne richtet sich gleichermaßen an Neu- und Bestandskunden. Dies ist der Standardoptimierungsmodus.
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.
Zielvorhaben für den Lebenszyklus abrufen
Wie bei anderen Ressourcen in der Google Ads API können Sie die Methoden search
oder searchStream
von GoogleAdsService
verwenden, um Zielvorhaben für den gesamten Lebenszyklus abzurufen.
Mit der folgenden Abfrage werden die Details zu allen CustomerLifecycleGoal
in einem Google Ads-Konto abgerufen:
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
Mit der folgenden Abfrage werden die Details aller CampaignLifecycleGoal
abgerufen:
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