Mit den Ressourcen CustomerLifecycleGoal
und CampaignLifecycleGoal
der Google Ads API können Sie Zielvorhaben konfigurieren, die sich auf den Kundenlebenszyklus beziehen. Ab Version 15 unterstützt die Google Ads API Zielvorhaben zur Kundenakquisition, mit denen Sie auf effiziente Weise über Ihre Google Ads-Suchkampagnen und Performance Max-Kampagnen Neukunden gewinnen 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-Kundenkonto konfigurieren und nicht direkt in Ihrem Google Ads-Konto. Sie sollten jedoch weiterhin Zielvorhaben für den Kampagnenlebenszyklus in Ihrem Konto festlegen. Die Vorgehensweise ist ähnlich wie die Verwaltung anderer Zielvorhaben beim kontoübergreifenden Conversion-Tracking.
Erstellungs- und Aktualisierungsvorgänge verarbeiten (nur Version 15)
In Version 15 der Google Ads API unterscheiden sich die in CustomerLifecycleGoalService
und CampaignLifecycleGoalService
unterstützten Vorgänge geringfügig von anderen Diensten in der Google Ads API. Statt separater create
- und update
-Vorgänge haben die v15-Vorgänge CustomerLifecycleGoalOperation
und CampaignLifecycleGoalOperation
nur einen create
-Vorgang. So geben Sie Ihren Intent mit update_mask
an:
Um ein Lebenszyklusziel mit Version 15 zu erstellen, geben Sie das Ziel in
create
ein, aber legen Sie weder dessenresource_name
noch dasupdate_mask
des Vorgangs fest.Wenn Sie ein Lebenszyklusziel mit Version 15 aktualisieren möchten, geben Sie das Zielvorhaben in
create
ein, legen Sie denresource_name
des Zielvorhabens und denupdate_mask
fest, um die Felder aufzulisten, die Sie aktualisieren möchten.
Zielvorhaben für den Kundenlebenszyklus konfigurieren
Konfigurieren Sie auf Kundenebene ein Lebenszyklusziel, indem Sie eine CustomerLifecycleGoal
erstellen oder aktualisieren. Pro Google Ads-Konto darf es höchstens ein 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 werden soll. Sie können das Feld customer_acquisition_goal_value_settings.high_lifetime_value
des Zielvorhabens lesen, aber dieses Feld ist in der Google Ads API unveränderlich.
Zielgruppen segmentieren
Ab Version 17 der Google Ads API müssen Sie die Ressource UserListCustomerType
verwenden, um Zielgruppen für Zielvorhaben für den Kundenlebenszyklus zu segmentieren. Das Konfigurieren von Zielgruppen direkt in der Ressource CustomerLifecycleGoal
wurde verworfen. Hier sind die Details:
- Vor Version 17:
- Nutzerlisten zur Sammlung
existing_user_lists
einerCustomerLifecycleGoal
hinzufügen.
- Nutzerlisten zur Sammlung
- 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
Mit UserListCustomerTypeService
erstellen Sie UserListCustomerType
-Instanzen.
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.
Eine UserListCustomerType
kann nur einer Nutzerliste zugewiesen werden, aber einer Nutzerliste können mehrere UserListCustomerType
-Instanzen zugeordnet sein, solange zwischen den UserListCustomerType
-Instanzen keine Konflikte bestehen. Der Versuch, UserListCustomerType
-Instanzen mit den folgenden Kombinationen von customer_type_category
derselben Nutzerliste zuzuweisen, führt 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 |
Google Ads API Version 16 und frühere Versionen
Legen Sie in der CustomerLifecycleGoal
Ihres Kontos die folgenden Felder fest:
lifecycle_goal_customer_definition_settings.existing_user_lists
gibt an, welche Nutzerlisten Bestandskunden enthalten.Das Feld
lifecycle_goal_customer_definition_settings.high_lifetime_value_user_lists
gibt an, welche Nutzerlisten Kunden mit hohem Lifetime-Wert enthalten. Sie können dieses Feld lesen, aber es ist in der Google Ads API unveränderlich.
Verhalten freigegebener Ressourcen
Bis zur Einstellung von Version 16 der Google Ads API im Januar 2025 ist zu beachten, dass UserListCustomerType
und die Felder zur Zielgruppensegmentierung in CustomerLifecycleGoal
eine gemeinsame Ressource sind. Das Erstellen neuer UserListCustomerType
-Instanzen in Version 17 und höher führt also zu Änderungen an der Instanz CustomerLifecycleGoal
in Version 16 und früheren Versionen und umgekehrt.
So werden die Felder in den beiden Ressourcen zugeordnet:
Feld „CustomerLifecycleGoal“ in Version 16 ändern | Nebeneffekt 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 Ressourcennamen der zugehörigen Nutzerliste.
|
„UserListCustomerType“ in v17 mutieren | Nebenwirkung auf das Feld „CustomerLifecycleGoal“ in Version 16 |
---|---|
Erstellen oder entfernen Sie UserListCustomerType Instanzen.
|
Einzelne Ressourcennamen werden 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 gesetzt ist
|
Einzelne Ressourcennamen werden lifecycle_goal_customer_definition_settings.high_lifetime_value_user_lists hinzugefügt oder daraus entfernt
|
Zielvorhaben für den Kampagnenlebenszyklus konfigurieren
Auf Kampagnenebene können Sie ein Zielvorhaben für den Lebenszyklus konfigurieren, indem Sie eine CampaignLifecycleGoal
erstellen oder aktualisieren. Pro Kampagne ist maximal ein CampaignLifecycleGoal
zulässig.
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 einer der folgenden Werte sein:
TARGET_ALL_EQUALLY
- Mit der Kampagne werden Neu- und Bestandskunden gleichermaßen angesprochen. Dies ist der standardmäßige Optimierungsmodus.
BID_HIGHER_FOR_NEW_CUSTOMERS
- Die Kampagne ist sowohl auf Neu- als auch auf Bestandskunden ausgerichtet. Für Kunden, die voraussichtlich Neukund*innen sind und nicht zu diesen
existing_user_lists
gehören, wird ein höheres Gebot abgegeben. TARGET_NEW_CUSTOMERS
- Die Kampagne ist ausschließlich auf Neukunden ausgerichtet.
Die value_settings
sind dieselben wie die customer_acquisition_goal_value_settings
für das Zielvorhaben auf Kundenebene. Mit diesen Einstellungen auf Kampagnenebene können Sie die Werte für eine bestimmte Kampagne überschreiben.
Lebenszyklusziele abrufen
Verwenden Sie wie bei anderen Ressourcen in der Google Ads API die Methoden search
oder searchStream
von GoogleAdsService
, um Lebenszyklusziele abzurufen.
Mit der folgenden Abfrage werden die Details jeder 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
In ähnlicher Weise ruft die folgende Abfrage die Details jedes 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