Lebenszyklusziele

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)

Tipp :In Version 16 der Google Ads API wurde die besondere Funktionsweise von mutate-Vorgängen für Lebenszyklusziele entfernt. Wenn Sie Version 16 verwenden, erstellen und aktualisieren Sie Lebenszyklusziele nach dem Standardansatz.

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 dessen resource_name noch das update_mask des Vorgangs fest.

• Wenn Sie ein Lebenszyklusziel mit Version 15 aktualisieren möchten, geben Sie das Zielvorhaben in create ein, legen Sie den resource_name des Zielvorhabens und den update_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 einer CustomerLifecycleGoal hinzufügen.
• 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.

Warnung: UserListCustomerType und die Felder zur Zielgruppensegmentierung in CustomerLifecycleGoal sind gemeinsam genutzte Ressourcen. Wenn Sie also neue UserListCustomerType-Instanzen in Version 17 erstellen, führt dies zu Änderungen an Ihrer Instanz CustomerLifecycleGoal in Version 16 und umgekehrt. Wir empfehlen Nutzern, so schnell wie möglich zu UserListCustomerType in Version 17 zu migrieren.

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:

1. lifecycle_goal_customer_definition_settings.existing_user_lists gibt an, welche Nutzerlisten Bestandskunden enthalten.

2. 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