Lebenszyklusziele

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 einer CustomerLifecycleGoal Nutzerlisten hinzu.
  • 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.

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:

  1. Mit lifecycle_goal_customer_definition_settings.existing_user_lists wird angegeben, welche Nutzerlisten Bestandskunden enthalten.

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