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, aberresource_name
undupdate_mask
des .Um ein Lebenszyklusziel mit Version 15 zu aktualisieren, geben Sie in
create
das Zielvorhaben ein, denresource_name
des Ziels und legen Sieupdate_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
einerCustomerLifecycleGoal
.
- Nutzerlisten zur Sammlung
- 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.
- Weisen Sie jeder Nutzerliste eine oder mehrere Kategorien zu, indem Sie ein
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:
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 die folgenden Felder auf der
CustomerLifecycleGoal
:
lifecycle_goal_customer_definition_settings.existing_user_lists
gibt an, welche Nutzerlisten Bestandskunden enthalten.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:
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. Die
Das Feld „user_list “ enthält die zugehörige Nutzerlistenressource
Namen.
|
„UserListCustomerType“ in Version 17 mutieren | Nebenwirkung auf das Feld „CustomerLifecycleGoal“ in Version 16 |
---|---|
Erstellen oder entfernen Sie UserListCustomerType Instanzen.
|
Einzelne Ressourcennamen werden dem
lifecycle_goal_customer_definition_settings.existing_user_lists
|
UserListCustomerType Instanzen erstellen oder entfernen, wobei der
customer_type_category ist festgelegt auf
HIGH_VALUE_CUSTOMERS
|
Einzelne Ressourcennamen werden dem
lifecycle_goal_customer_definition_settings.high_lifetime_value_user_lists
|
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