Lebenszyklusziele

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 Sie in Ihrem Google Ads-Konto kontoübergreifendes Conversion-Tracking verwenden, müssen Zielvorhaben für den Kundenlebenszyklus in der Google Ads-Conversion Kunde nicht direkt in Ihrem Google Ads-Konto. Sie sollten trotzdem die Zielvorhaben für den Kampagnenlebenszyklus. Das funktioniert ähnlich wie andere Zielvorhaben verwalten, wenn Sie kontoübergreifendes Conversion-Tracking nutzen.

Erstellungs- und Aktualisierungsvorgänge verarbeiten (nur Version 15)

In Version 15 der Google Ads API werden die in der API CustomerLifecycleGoalService und CampaignLifecycleGoalService unterscheiden sich geringfügig von anderen Diensten in der Google Ads API. Anstatt separate Die Vorgänge create und update, die Version 15 CustomerLifecycleGoalOperation und CampaignLifecycleGoalOperation nur einen create-Vorgang haben und Sie Ihren Intent mithilfe der Methode update_mask so:

• Um mit Version 15 ein Zielvorhaben für den Lebenszyklus zu erstellen, geben Sie in create das Zielvorhaben ein, aber resource_name und update_mask des .

• Um ein Lebenszyklusziel mit Version 15 zu aktualisieren, geben Sie in create das Zielvorhaben ein, den resource_name des Ziels und legen Sie update_mask fest, um die die Sie aktualisieren möchten.

Zielvorhaben für den Kundenlebenszyklus konfigurieren

Konfigurieren Sie auf Kundenebene ein Lebenszyklusziel, indem Sie ein CustomerLifecycleGoal Unter Umständen gibt es maximal ein CustomerLifecycleGoal pro Google Ads-Konto. Die Mit dem Feld customer_acquisition_goal_value_settings.value wird die zusätzliche Wertanpassung, die der ersten Kauf-Conversion eines Neukunden hinzugefügt werden soll. Sie können customer_acquisition_goal_value_settings.high_lifetime_value des Ziel, aber dieses Feld ist in der Google Ads API unveränderlich.

Zielgruppen segmentieren

Ab Version 17 der Google Ads API müssen Sie das UserListCustomerType zu segmentierende Ressource Ihre Zielgruppen im Hinblick auf Zielvorhaben für den Kundenlebenszyklus. Konfigurieren von Zielgruppen direkt über ist die Ressource CustomerLifecycleGoal eingestellt. Hier sind die Details:

• Vor Version 17: <ph type="x-smartling-placeholder">
  </ph>
  • Nutzerlisten zur Sammlung existing_user_lists einer CustomerLifecycleGoal.
• Ab v17: <ph type="x-smartling-placeholder">
  </ph>
  • Weisen Sie jeder Nutzerliste eine oder mehrere Kategorien zu, indem Sie ein UserListCustomerType für jede Kombination aus Nutzerliste und Kategorie.

Ab Version 17 der Google Ads API

Verwenden Sie die Methode UserListCustomerTypeService bis UserListCustomerType Instanzen erstellen Wenn Sie das Feld CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings.existing_user_lists enthält, enthält Ihr Konto bereits die zugehörigen UserListCustomerType Instanzen.

Die UserListCustomerTypeService unterstützt nur create und remove Vorgänge aktualisieren. Wenn Sie also eine vorhandene UserListCustomerType aktualisieren möchten, entfernen Sie sie und erstellen Sie eine neue mit den notwendigen Aktualisierungen.

Ein UserListCustomerType kann nur einer Nutzerliste zugewiesen werden, aber einer Nutzerliste kann mehrere verknüpfte UserListCustomerType-Instanzen haben solange es keine Konflikte zwischen UserListCustomerType gibt Instanzen. Es wird versucht, UserListCustomerType Instanzen mit der folgenden Kombinationen von customer_type_category Nutzerliste hinzufügen, führt das zu einer UserListCustomerTypeError.CONFLICTING_CUSTOMER_TYPES-Fehler:

Google Ads API Version 16 und frühere Versionen

Legen Sie die folgenden Felder auf der CustomerLifecycleGoal:

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

2. Die lifecycle_goal_customer_definition_settings.high_lifetime_value_user_lists gibt an, welche Nutzerlisten Kunden mit hohem Lifetime-Wert enthalten. Ich kann dieses Feld lesen. Es ist jedoch in der Google Ads API unveränderlich.

Verhalten freigegebener 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:

Zielvorhaben für den Kampagnenlebenszyklus konfigurieren

Auf Kampagnenebene können Sie ein Zielvorhaben für den Lebenszyklus konfigurieren, indem Sie ein Zielvorhaben für den CampaignLifecycleGoal Unter Umständen gibt es maximal ein CampaignLifecycleGoal pro Kampagne.

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 ist sowohl auf Neu- als auch auf Bestandskunden ausgerichtet, die Gebote für die voraussichtlich neu sind und nicht in einem der existing_user_lists.

TARGET_NEW_CUSTOMERS

Die Kampagne ist nur auf Neukunden ausgerichtet.

Die value_settings sind dieselben wie die customer_acquisition_goal_value_settings für das Zielvorhaben auf Kundenebene. Diese Einstellungen auf Kampagnenebene, um die Werte für eine bestimmte Kampagne zu ü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

In ähnlicher Weise ruft die folgende Abfrage die Details jedes CampaignLifecycleGoal:

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