Zielvorhaben für den Kundenlebenszyklus

Mit den Ressourcen Goal und CampaignGoalConfig der Google Ads API können Sie Zielvorhaben für den Kundenlebenszyklus konfigurieren. Die Google Ads API unterstützt Zielvorhaben für die Kundenakquisition und Zielvorhaben für die Kundenbindung, mit denen sich Anpassungen des Kundenlebenszykluswerts über Ihre Google Ads-Kampagnen effizient verwalten lassen.

Wenn in Ihrem Google Ads-Konto kontoübergreifendes Conversion-Tracking verwendet wird, müssen Sie Zielvorhaben für den Kundenlebenszyklus auf Kundenebene im Google Ads-Conversion-Konto und nicht direkt in Ihrem Google Ads-Konto konfigurieren. Sie sollten jedoch weiterhin Konfigurationen auf Kampagnenebene in Ihrem Konto festlegen. Das funktioniert ähnlich wie bei der Verwaltung anderer Zielvorhaben, wenn Sie kontoübergreifendes Conversion-Tracking verwenden.

Arten von Zielvorhaben für den Kundenlebenszyklus

Zielvorhaben für den Kundenlebenszyklus werden auf Kontoebene mit der Ressource Goal konfiguriert. Ein Zielvorhaben stellt ein bestimmtes Ziel im Lebenszyklus dar und wird durch seine goal_type definiert.

Folgende Zielvorhabentypen für den Kundenlebenszyklus werden unterstützt:

NEW_CUSTOMER_ACQUISITION

Um Neukund*innen effizient zu gewinnen, indem ihren Conversions Wertanpassungen zugewiesen werden.

CUSTOMER_RETENTION

Um Bestandskunden, Kunden mit hohem Umsatzpotenzial und inaktive Kunden zu erneuten Interaktionen zu animieren.

LOYALTY_RETENTION

Um die Kundenbindung und das Interesse speziell bei Mitgliedern des Treuepunkteprogramms zu steigern.

Zielvorhaben für den Kundenlebenszyklus konfigurieren

Konfigurieren Sie auf Kundenebene ein Zielvorhaben für den Kundenlebenszyklus, indem Sie ein Goal erstellen. In einem Google Ads-Konto kann es maximal ein Goal pro Zielvorhabentyp (NEW_CUSTOMER_ACQUISITION, CUSTOMER_RETENTION oder LOYALTY_RETENTION) geben.

Einstellungen für das Zielvorhaben „Kundenakquisition“

Wenn Sie das Zielvorhaben „Kundenakquisition“ einrichten möchten, legen Sie goal_type auf NEW_CUSTOMER_ACQUISITION fest und konfigurieren Sie die Einstellungen im Feld new_customer_acquisition_goal_settings mit GoalService.

In den Einstellungen wird CustomerLifecycleOptimizationValueSettings verwendet, um Conversion-Wertanpassungen für gewonnene Kunden anzugeben:

• value_adjustment (oneof):
  • additional_value (double): Zusätzlicher Conversion-Wert, der der ersten Kauf-Conversion eines Neukunden hinzugefügt werden soll.
  • value_multiplier (double): Multiplikator, der auf den Conversion-Wert für den ersten Kauf eines Neukunden angewendet werden soll (wird noch nicht unterstützt).
• high_lifetime_value_adjustment (oneof):
  • additional_high_lifetime_value (double): Zusätzlicher Conversion-Wert für Neukunden mit hohem Lifetime-Wert.
  • high_lifetime_value_multiplier (double): Multiplikator für den Conversion-Wert von Neukunden mit hohem Lifetime-Wert (wird noch nicht unterstützt).

Der hohe Lifetime-Wert muss größer als der Wert sein und der Multiplikator für den hohen Lifetime-Wert muss, sofern festgelegt, strikt größer als der Wertmultiplikator sein.

def create_nca_goal(client: GoogleAdsClient, customer_id: str) -> None:
    """Sends an API request to add a new New Customer Acquisition Goal.

    Args:
        client: an initialized GoogleAdsClient instance.
        customer_id: a client customer ID.
    """
    goal_operation: GoalOperation = client.get_type("GoalOperation")
    goal = goal_operation.create
    goal.goal_type = client.enums.GoalTypeEnum.NEW_CUSTOMER_ACQUISITION

    # Configure the value adjustments.
    goal.new_customer_acquisition_goal_settings.value_settings.additional_value = 50.0
    goal.new_customer_acquisition_goal_settings.value_settings.additional_high_lifetime_value = 100.0

    goal_service = client.get_service("GoalService")
    goal_service.mutate_goals(
        customer_id=customer_id, operations=[goal_operation]
    )

Einstellungen für Zielvorhaben „Kundenbindung“

Wenn Sie das Zielvorhaben „Kundenbindung“ einrichten möchten, setzen Sie goal_type auf CUSTOMER_RETENTION und konfigurieren Sie die Einstellungen im Feld retention_goal_settings.

Bevor Sie ein Zielvorhaben „Kundenbindung“ erstellen, müssen Sie die unter Zielvorhaben „Kundenbindung“ beschriebenen Voraussetzungen erfüllen. Dazu gehören eine Performance Max-Kampagne und eine Nutzerliste zum Kundenabgleich.

def create_retention_goal(client: GoogleAdsClient, customer_id: str) -> None:
    """Sends an API request to add a new Customer Retention Goal.

    Args:
        client: an initialized GoogleAdsClient instance.
        customer_id: a client customer ID.
    """
    goal_operation: GoalOperation = client.get_type("GoalOperation")
    goal = goal_operation.create
    goal.goal_type = client.enums.GoalTypeEnum.CUSTOMER_RETENTION
    goal.retention_goal_settings.value_settings.additional_value = 50.0
    goal.retention_goal_settings.value_settings.additional_high_lifetime_value = 100.0

    goal_service = client.get_service("GoalService")
    goal_service.mutate_goals(
        customer_id=customer_id, operations=[goal_operation]
    )

Dadurch wird ein neues Zielvorhaben „Kundenbindung“ auf Kontoebene für das angegebene Kundenkonto erstellt, das auf alle Kampagnen angewendet wird. Standardmäßig wird mit diesem Zielvorhaben auf alle Nutzer in Ihren Customer Match-Nutzerlisten ausgerichtet.

Einstellungen für das Zielvorhaben „Kundenbindung“

Wenn Sie Zielvorhaben zur Kundenbindung für Treuepunkteprogramm-Mitglieder einrichten möchten, legen Sie goal_type auf LOYALTY_RETENTION fest und konfigurieren Sie die Einstellungen im Feld loyalty_retention_goal_settings (LoyaltyRetentionGoal).

Bei Zielvorhaben „Kundentreue und -bindung“ wird in value_settings mit CustomerLifecycleOptimizationValueSettings nur die Einstellung value_multiplier unterstützt:

def create_loyalty_retention_goal(client: GoogleAdsClient, customer_id: str) -> None:
    """Sends an API request to add a new Loyalty Retention Goal.

    Args:
        client: an initialized GoogleAdsClient instance.
        customer_id: a client customer ID.
    """
    goal_operation: GoalOperation = client.get_type("GoalOperation")
    goal = goal_operation.create
    goal.goal_type = client.enums.GoalTypeEnum.LOYALTY_RETENTION
    goal.loyalty_retention_goal_settings.value_settings.value_multiplier = 1.5

    goal_service = client.get_service("GoalService")
    goal_service.mutate_goals(
        customer_id=customer_id, operations=[goal_operation]
    )

Zielgruppen segmentieren

Sie müssen die UserListCustomerType-Ressource verwenden, um Ihre Zielgruppen für Zielvorhaben für den Kundenlebenszyklus zu segmentieren, z. B. für die Zielvorhaben „Kundenakquisition“, „Kundenbindung“ und „Loyalty-Bindung“. Sie müssen jede Nutzerliste einer oder mehreren Kategorien zuordnen, indem Sie für jede Kombination aus Nutzerliste und Kategorie ein UserListCustomerType erstellen.

Verwenden Sie UserListCustomerTypeService, um UserListCustomerType-Instanzen zu erstellen.

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

Ein UserListCustomerType kann nur einer Nutzerliste zugewiesen werden. Eine Nutzerliste kann jedoch mehrere zugehörige UserListCustomerType-Instanzen haben, sofern keine Konflikte zwischen den UserListCustomerType-Instanzen bestehen. Wenn Sie versuchen, UserListCustomerType-Instanzen mit den folgenden Kombinationen von customer_type_category derselben Nutzerliste zuzuweisen, tritt ein UserListCustomerTypeError.CONFLICTING_CUSTOMER_TYPES-Fehler auf:

Konfigurationen für Zielvorhaben für den Kampagnenlebenszyklus konfigurieren

Auf Kampagnenebene können Sie mit CampaignGoalConfig kampagnenspezifische Überschreibungen oder Ausrichtungsoptionen konfigurieren. Sobald Sie ein Zielvorhaben auf Kontoebene haben, verwenden Sie dessen resource_name, um mit der Methode mutate_campaign_goal_configs für CampaignGoalConfigService ein CampaignGoalConfig zu erstellen.

Einstellungen für die Kundenakquisition der Kampagne

Wenn Sie Einstellungen überschreiben oder das Targeting für die Kundenakquisition auf Kampagnenebene konfigurieren möchten, konfigurieren Sie das Feld campaign_new_customer_acquisition_settings vom Typ CampaignNewCustomerAcquisitionGoalSettings:

• value_settings_override (Typ: CustomerLifecycleOptimizationValueSettings): Benutzerdefinierte Wertanpassungen zum Überschreiben der Einstellungen auf Kontoebene.
• target_option (Typ: CustomerLifecycleOptimizationMode): Steuert den Optimierungsmodus für den Kundenlebenszyklus. Folgende Optionen sind verfügbar:
  • TARGET_ALL: Die Kampagne ist sowohl auf Neu- als auch auf Bestandskunden ausgerichtet. Für Neukunden werden jedoch mithilfe der konfigurierten Wertanpassungen höhere Gebote abgegeben.
  • TARGET_SPECIFIC: Die Kampagne richtet sich nur an Neukunden. Gebotsanpassungen sind für diese Option nicht anwendbar.

def create_campaign_nca_config(
    client: GoogleAdsClient,
    customer_id: str,
    goal_resource_name: str,
    campaign_resource_name: str,
) -> None:
    """Sends an API request to add a new CampaignGoalConfig for NCA.

    Args:
        client: an initialized GoogleAdsClient instance.
        customer_id: a client customer ID.
        goal_resource_name: the resource name of an existing NCA Goal.
        campaign_resource_name: the resource name of an existing Campaign.
    """
    operation: CampaignGoalConfigOperation = client.get_type("CampaignGoalConfigOperation")
    goal_config = operation.create
    goal_config.campaign = campaign_resource_name
    goal_config.goal = goal_resource_name

    # Set the target option to target both new and existing customers.
    goal_config.campaign_new_customer_acquisition_settings.target_option = (
        client.enums.CustomerLifecycleOptimizationModeEnum.TARGET_ALL
    )
    # Optionally override value settings.
    goal_config.campaign_new_customer_acquisition_settings.value_settings_override.additional_value = 60.0

    campaign_goal_config_service = client.get_service("CampaignGoalConfigService")
    campaign_goal_config_service.mutate_campaign_goal_configs(
        customer_id=customer_id, operations=[operation]
    )

Einstellungen zur Kundenbindung für Kampagnen

Wenn Sie Einstellungen überschreiben oder das Targeting für Zielvorhaben zur Kundenbindung auf Kampagnenebene konfigurieren möchten, konfigurieren Sie das Feld campaign_retention_settings vom Typ CampaignRetentionGoalSettings:

• value_settings_override (Typ: CustomerLifecycleOptimizationValueSettings): Benutzerdefinierte Wertanpassungen zum Überschreiben der Einstellungen auf Kontoebene.
• target_option (Typ: CustomerLifecycleOptimizationMode): Steuert den Optimierungsmodus. Die Standardeinstellung ist TARGET_ALL. Damit Sie den Wert auf TARGET_SPECIFIC festlegen können, muss Ihr Konto auf der entsprechenden Zulassungsliste stehen.

def create_campaign_retention_config(
  client: GoogleAdsClient,
  customer_id: str,
  goal_resource_name: str,
  campaign_resource_name: str
) -> None:
    """Sends an API request to add a new CampaignGoalConfig for Retention.

    Args:
        client: an initialized GoogleAdsClient instance.
        customer_id: a client customer ID.
        goal_resource_name: the resource name of an existing Retention Goal.
        campaign_resource_name: the resource name of an existing Campaign.
    """
    operation: CampaignGoalConfigOperation = client.get_type("CampaignGoalConfigOperation")
    goal_config = operation.create
    goal_config.campaign = campaign_resource_name
    goal_config.goal = goal_resource_name

    # goal_config.campaign_retention_settings.target_option = (
    #   client.enums.CustomerLifecycleOptimizationModeEnum.TARGET_SPECIFIC
    # )

    campaign_goal_config_service = client.get_service("CampaignGoalConfigService")
    campaign_goal_config_service.mutate_campaign_goal_configs(
      customer_id=customer_id, operations=[operation]
    )

Wenn campaign_retention_settings.target_option nicht festgelegt ist, wird standardmäßig TARGET_ALL verwendet. Die Option zum Festlegen von TARGET_SPECIFIC ist nur für Nutzer auf der entsprechenden Zulassungsliste verfügbar.

Einstellungen für die Kundenbindung bei Treuepunkteprogrammen für Kampagnen

Wenn Sie Einstellungen überschreiben oder ein für Treuepunkte-Mitglieder spezifisches Verhalten auf Kampagnenebene für LOYALTY_RETENTION-Zielvorhaben konfigurieren möchten, konfigurieren Sie das Feld campaign_loyalty_retention_settings vom Typ CampaignLoyaltyRetentionGoalSettings für CampaignGoalConfig:

• value_settings_override (Typ: CustomerLifecycleOptimizationValueSettings): Benutzerdefinierte Wertanpassungen zum Überschreiben der Einstellungen für den Wert für die Kundenbindung auf Kontoebene.
• enable_bid_adjustments_for_loyalty_members (Typ: bool): Gibt an, ob Gebotsanpassungen für Teilnehmer am Treuepunkteprogramm in dieser Kampagne aktiviert werden sollen.
• show_targeted_loyalty_member_benefits_in_pla (Typ: bool): Gibt an, ob gezielte Vorteile für Mitglieder des Treuepunkteprogramms in infrage kommenden Ländern im Format von Anzeigen mit Produktinformationen präsentiert werden sollen.

def create_campaign_loyalty_retention_config(
    client: GoogleAdsClient,
    customer_id: str,
    goal_resource_name: str,
    campaign_resource_name: str,
) -> None:
    """Sends an API request to add a new CampaignGoalConfig for Loyalty Retention.

    Args:
        client: an initialized GoogleAdsClient instance.
        customer_id: a client customer ID.
        goal_resource_name: the resource name of an existing Loyalty Retention Goal.
        campaign_resource_name: the resource name of an existing Campaign.
    """
    operation: CampaignGoalConfigOperation = client.get_type("CampaignGoalConfigOperation")
    goal_config = operation.create
    goal_config.campaign = campaign_resource_name
    goal_config.goal = goal_resource_name

    # Enable bid adjustments and targeted loyalty benefits in PLAs.
    goal_config.campaign_loyalty_retention_settings.enable_bid_adjustments_for_loyalty_members = True
    goal_config.campaign_loyalty_retention_settings.show_targeted_loyalty_member_benefits_in_pla = True

    campaign_goal_config_service = client.get_service("CampaignGoalConfigService")
    campaign_goal_config_service.mutate_campaign_goal_configs(
        customer_id=customer_id, operations=[operation]
    )

Validierung und Fehler

Beim Konfigurieren von Zielvorhaben für den Kundenlebenszyklus können die folgenden Einschränkungen und Fehler auftreten:

Fehler bei der Zielvorhabenvalidierung

Doppelte Zielvorhabenkonfiguration

Wenn Sie ein Zielvorhaben für den Lebenszyklus duplizieren, obwohl bereits eines vorhanden ist, wird ein Fehler vom Typ GoalError.NEW_CUSTOMER_ACQUISITION_GOAL_ALREADY_EXISTS (für Kundenakquisition), GoalError.RETENTION_GOAL_ALREADY_EXISTS (für Zielvorhaben zur Kundenbindung) oder GoalError.LOYALTY_RETENTION_GOAL_ALREADY_EXISTS (für Zielvorhaben zur Kundenbindung für Treuepunkte) ausgegeben.

Ungültige Werteinstellungen

Wenn Sie Einstellungen für den Zielvorhabenwert für den Lebenszyklus konfigurieren und ein hoher Lifetime-Wert vorhanden ist, muss auch ein Standardwert vorhanden sein (GoalError.HIGH_LIFETIME_VALUE_PRESENT_BUT_VALUE_ABSENT). Der hohe Lifetime-Wert muss größer als der Wert sein, sofern er festgelegt ist (GoalError.HIGH_LIFETIME_VALUE_LESS_THAN_OR_EQUAL_TO_VALUE).

Bei multiplikativen Werteinstellungen gilt: Wenn der Multiplikator für den hohen Lifetime-Wert vorhanden ist, muss auch der Wertmultiplikator vorhanden sein (GoalError.HIGH_LIFETIME_VALUE_MULTIPLIER_PRESENT_BUT_VALUE_MULTIPLIER_ABSENT). Der Multiplikator für den hohen Lifetime-Wert muss strikt größer als der Wertmultiplikator sein (GoalError.HIGH_LIFETIME_VALUE_MULTIPLIER_LESS_THAN_OR_EQUAL_TO_VALUE_MULTIPLIER).

Validierungsfehler bei der Konfiguration von Kampagnenzielvorhaben

Konflikt bei Überschreibung eines bestimmten Zielwerts

Bei Zielvorhaben „Kundenakquisition“ darf target_option nicht auf TARGET_SPECIFIC festgelegt sein (nur Neukunden als Zielgruppe), wenn Überschreibungen auf Kampagnenebene konfiguriert sind (CampaignGoalConfigError.CAMPAIGN_OVERRIDE_VALUES_SET_FOR_NEW_CUSTOMER_ACQUISITION_TARGET_SPECIFIC_OPTION). Gebotsanpassungen sind nicht anwendbar, wenn nur Neukunden als Zielgruppe verwendet werden.

Ungültige Überschreibung von Werteinstellungen

Wenn Sie Überschreibungen der Einstellungen für den Lebenszykluswert auf Kampagnenebene konfigurieren und ein hoher Lifetime-Wert vorhanden ist, muss auch ein Standardwert vorhanden sein (CampaignGoalConfigError.HIGH_LIFETIME_VALUE_PRESENT_BUT_VALUE_ABSENT). Der hohe Lifetime-Wert muss größer als der Wert sein, sofern er festgelegt ist (CampaignGoalConfigError.HIGH_LIFETIME_VALUE_LESS_THAN_OR_EQUAL_TO_VALUE). Bei multiplikativen Werteinstellungen gilt: Wenn der Multiplikator für den hohen Lifetime-Wert vorhanden ist, muss auch der Wertmultiplikator vorhanden sein (CampaignGoalConfigError.HIGH_LIFETIME_VALUE_MULTIPLIER_PRESENT_BUT_VALUE_MULTIPLIER_ABSENT). Der Multiplikator für den hohen Lifetime-Wert muss streng größer als der Wertmultiplikator sein (CampaignGoalConfigError.HIGH_LIFETIME_VALUE_MULTIPLIER_LESS_THAN_OR_EQUAL_TO_VALUE_MULTIPLIER).

Unterstützung für Kampagnentypen mit hohem Lifetime-Wert

Überschreibungen für hohen Lifetime-Wert und Multiplikatorüberschreibungen für hohen Lifetime-Wert dürfen nur für unterstützte Kampagnentypen (CampaignGoalConfigError.CAMPAIGN_OVERRIDE_HIGH_LIFETIME_VALUE_NOT_SUPPORTED_FOR_CAMPAIGN_TYPE oder CampaignGoalConfigError.CAMPAIGN_OVERRIDE_HIGH_LIFETIME_VALUE_MULTIPLIER_NOT_SUPPORTED_FOR_CAMPAIGN_TYPE) festgelegt werden.

Inkompatible Zielvorhaben

Es wird ein Fehler ausgegeben, wenn für eine Kampagne versucht wird, inkompatible Zielvorhaben für die Kundenlebenszyklusoptimierung gleichzeitig anzuwenden (CampaignGoalConfigError.CANNOT_USE_INCOMPATIBLE_CLO_GOALS). In der folgenden Tabelle sind sich gegenseitig ausschließende Zielvorhabenkombinationen aufgeführt, die diesen Fehler auslösen:

Zielvorhaben für den Kundenlebenszyklus 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 Kundenlebenszyklus und Konfigurationen abzurufen.

Mit der folgenden Abfrage werden die Details aller konfigurierten Goal in einem Google Ads API-Konto abgerufen:

SELECT
  goal.goal_id,
  goal.goal_type,
  goal.owner_customer,
  goal.new_customer_acquisition_goal_settings.value_settings.additional_value,
  goal.new_customer_acquisition_goal_settings.value_settings.additional_high_lifetime_value,
  goal.retention_goal_settings.value_settings.additional_value,
  goal.retention_goal_settings.value_settings.additional_high_lifetime_value,
  goal.loyalty_retention_goal_settings.value_settings.value_multiplier
FROM goal

Mit der folgenden Abfrage werden die Details aller CampaignGoalConfig abgerufen:

SELECT
  campaign_goal_config.campaign,
  campaign_goal_config.goal,
  campaign_goal_config.goal_type,
  campaign_goal_config.campaign_new_customer_acquisition_settings.target_option,
  campaign_goal_config.campaign_new_customer_acquisition_settings.value_settings_override.additional_value,
  campaign_goal_config.campaign_new_customer_acquisition_settings.value_settings_override.additional_high_lifetime_value,
  campaign_goal_config.campaign_retention_settings.target_option,
  campaign_goal_config.campaign_retention_settings.value_settings_override.additional_value,
  campaign_goal_config.campaign_loyalty_retention_settings.value_settings_override.value_multiplier,
  campaign_goal_config.campaign_loyalty_retention_settings.enable_bid_adjustments_for_loyalty_members,
  campaign_goal_config.campaign_loyalty_retention_settings.show_targeted_loyalty_member_benefits_in_pla
FROM campaign_goal_config