Zielvorhaben für den Kundenlebenszyklus

Mit den Goal und CampaignGoalConfig Ressourcen der Google Ads API können Sie Zielvorhaben im Zusammenhang mit dem Kundenlebenszyklus konfigurieren. Die Google Ads API unterstützt Zielvorhaben für die Kundenakquisition und Zielvorhaben für die Kundenbindung, um Wertanpassungen für den Kundenlebenszyklus effizient über Ihre Google Ads-Kampagnen zu verwalten.

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 ist ähnlich wie bei der Verwaltung anderer Zielvorhaben wenn Sie kontoübergreifendes Conversion-Tracking verwenden.

Zielvorhabentypen für den Kundenlebenszyklus

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

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

NEW_CUSTOMER_ACQUISITION

Für die effiziente Gewinnung von Neukunden durch Zuweisen von Wertanpassungen zu ihren Conversions.

CUSTOMER_RETENTION

Für die erneute Interaktion mit Bestandskunden, Kunden mit hohem Umsatzpotenzial und inaktiven Kunden.

LOYALTY_RETENTION

Für die Steigerung der Kundenbindung und des Engagements speziell bei Mitgliedern von Treuepunkteprogrammen.

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 das goal_type auf NEW_CUSTOMER_ACQUISITION fest und konfigurieren Sie die Einstellungen im new_customer_acquisition_goal_settings Feld mit dem GoalService.

Im new_customer_acquisition_goal_settings.value_settings Feld werden mit CustomerLifecycleOptimizationValueSettings Conversion-Wert-Anpassungen für gewonnene Kunden angegeben:

• value_settings (CustomerLifecycleOptimizationValueSettings):
  • 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 für NEW_CUSTOMER_ACQUISITION nicht unterstützt, aber für LOYALTY_RETENTION).
  • high_lifetime_value_adjustment (oneof):
    • additional_high_lifetime_value (double): Zusätzlicher Conversion-Wert für Neukunden, die als Kunden mit hohem Lifetime-Wert identifiziert wurden.
    • high_lifetime_value_multiplier (double): Multiplikator für den Conversion-Wert, der für Neukunden mit hohem Lifetime-Wert angewendet werden soll (wird noch nicht unterstützt).

Der hohe Lifetime-Wert sollte größer als der Wert sein und der Multiplikator für den hohen Lifetime-Wert muss, falls festgelegt, unbedingt 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.
    value_settings = goal.new_customer_acquisition_goal_settings.value_settings
    value_settings.additional_value = 50.0
    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 das Zielvorhaben „Kundenbindung“

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

Bevor Sie ein Zielvorhaben für die Kundenbindung erstellen, müssen Sie die Voraussetzungen erfüllen, die in Zielvorhaben „Kundenbindung“ beschrieben sind. 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
    value_settings = goal.retention_goal_settings.value_settings
    value_settings.additional_value = 50.0
    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 auf Kontoebene ein neues Zielvorhaben „Kundenbindung“ für das angegebene Kundenkonto erstellt, das auf alle Kampagnen angewendet wird. Standardmäßig ist dieses Zielvorhaben auf alle Nutzer in Ihren Nutzerlisten zum Kundenabgleich ausgerichtet.

Einstellungen für das Zielvorhaben „Kundenbindung im Treuepunkteprogramm“

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

Im Gegensatz zu NEW_CUSTOMER_ACQUISITION und CUSTOMER_RETENTION (bei denen additive Wertanpassungen verwendet werden) wird bei LOYALTY_RETENTION die Einstellung value_multiplier in value_settings mit CustomerLifecycleOptimizationValueSettings 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, einschließlich Zielvorhaben für die Kundenakquisition, Zielvorhaben „Kundenbindung“ und Zielvorhaben „Kundenbindung“ im Treuepunkteprogramm. Sie müssen jede Nutzerliste mit einer oder mehreren Kategorien verknüpfen, indem Sie für jede Kombination aus Nutzerliste und Kategorie ein UserListCustomerType erstellen.

Verwenden Sie die UserListCustomerTypeService, um Instanzen von UserListCustomerType zu erstellen.

Der UserListCustomerTypeService unterstützt nur die Vorgänge create und remove . Wenn Sie also ein vorhandenes UserListCustomerType aktualisieren möchten, müssen Sie es entfernen und dann ein neues mit den erforderlichen Aktualisierungen erstellen.

Ein UserListCustomerType kann nur einer Nutzerliste zugewiesen werden, aber einer Nutzerliste können mehrere verknüpfte UserListCustomerType-Instanzen zugewiesen sein, sofern es keine Konflikte zwischen den UserListCustomerType-Instanzen gibt. Wenn Sie versuchen, UserListCustomerType Instanzen mit den folgenden Kombinationen von customer_type_category derselben Nutzerliste zuzuweisen, wird der Fehler UserListCustomerTypeError.CONFLICTING_CUSTOMER_TYPES ausgelöst:

Konfigurationen für Zielvorhaben für den Kundenlebenszyklus für Kampagnen konfigurieren

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

Einstellungen für das Zielvorhaben „Kundenakquisition“ für Kampagnen

Wenn Sie Einstellungen überschreiben oder das Targeting für das Zielvorhaben „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, um die Einstellungen auf Kontoebene zu überschreiben.
• target_option (Typ: CustomerLifecycleOptimizationMode): Steuert den Optimierungsmodus für den Kundenlebenszyklus. Folgende Optionen sind verfügbar:
  • TARGET_ALL: Die Kampagne ist auf Neu- und Bestandskunden ausgerichtet, aber es werden höhere Gebote für Neukunden abgegeben, wobei die konfigurierten Wertanpassungen verwendet werden.
  • TARGET_SPECIFIC: Die Kampagne ist nur auf Neukunden ausgerichtet. Gebotsanpassungen sind für diese Option nicht zutreffend.

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.
    nca_settings = goal_config.campaign_new_customer_acquisition_settings
    nca_settings.target_option = (
        client.enums.CustomerLifecycleOptimizationModeEnum.TARGET_ALL
    )
    # Optionally override value settings.
    nca_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 für das Zielvorhaben „Kundenbindung“ für Kampagnen

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

• value_settings_override (Typ: CustomerLifecycleOptimizationValueSettings): Benutzerdefinierte Wertanpassungen, um die Einstellungen auf Kontoebene zu überschreiben.
• target_option (Typ: CustomerLifecycleOptimizationMode): Steuert den Optimierungsmodus. Die Standardeinstellung ist TARGET_ALL. Damit Sie die Einstellung 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_ALL
    )
    # Accounts on the allowlist can set TARGET_SPECIFIC instead:
    # 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 das Zielvorhaben „Kundenbindung im Treuepunkteprogramm“ für Kampagnen

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

• value_settings_override (Typ: CustomerLifecycleOptimizationValueSettings): Benutzerdefinierte Wertanpassungen, um die Einstellungen für den Wert für die Kundenbindung im Treuepunkteprogramm auf Kontoebene zu überschreiben.
• enable_bid_adjustments_for_loyalty_members (Typ: bool): Gibt an, ob Gebotsanpassungen für Mitglieder von Treuepunkteprogrammen in dieser Kampagne aktiviert werden sollen.
• show_targeted_loyalty_member_benefits_in_pla (Typ: bool): Gibt an, ob gezielte Vorteile für Mitglieder von Treuepunkteprogrammen in Anzeigen mit Produktinformationen in den entsprechenden Ländern angezeigt 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.

    Args:
        client: an initialized GoogleAdsClient instance.
        customer_id: a client customer ID.
        goal_resource_name: the resource name of an existing Loyalty 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.
    loyalty_settings = goal_config.campaign_loyalty_retention_settings
    loyalty_settings.enable_bid_adjustments_for_loyalty_members = True
    loyalty_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 doppeltes Zielvorhaben für den Kundenlebenszyklus erstellen, obwohl bereits eines vorhanden ist, wird der Fehler GoalError.NEW_CUSTOMER_ACQUISITION_GOAL_ALREADY_EXISTS (für das Zielvorhaben „Kundenakquisition“), GoalError.RETENTION_GOAL_ALREADY_EXISTS (für das Zielvorhaben „Kundenbindung“) oder GoalError.LOYALTY_RETENTION_GOAL_ALREADY_EXISTS (für Zielvorhaben für die Kundenbindung im Treuepunkteprogramm) ausgelöst.

Ungültige Werteinstellungen

Wenn Sie Werteinstellungen für Zielvorhaben 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). Außerdem muss der hohe Lifetime-Wert größer als der Wert sein, falls er festgelegt ist (GoalError.HIGH_LIFETIME_VALUE_LESS_THAN_OR_EQUAL_TO_VALUE).

Ähnlich verhält es sich bei multiplikativen Werteinstellungen: 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). Außerdem muss der Multiplikator für den hohen Lifetime-Wert unbedingt größer als der Wertmultiplikator sein (GoalError.HIGH_LIFETIME_VALUE_MULTIPLIER_LESS_THAN_OR_EQUAL_TO_VALUE_MULTIPLIER).

Fehler bei der Validierung der Kampagnenzielvorhabenkonfiguration

Konflikt bei der Überschreibung des Zielwerts

Wenn für Zielvorhaben „Kundenakquisition“ target_option auf TARGET_SPECIFIC festgelegt ist (um nur auf Neukunden auszurichten), dürfen keine Wertüberschreibungen auf Kampagnenebene konfiguriert werden (CampaignGoalConfigError.CAMPAIGN_OVERRIDE_VALUES_SET_FOR_NEW_CUSTOMER_ACQUISITION_TARGET_SPECIFIC_OPTION). Gebotsanpassungen sind nicht zutreffend, wenn Sie nur auf Neukunden ausrichten.

Ungültige Überschreibung der Werteinstellungen

Wenn Sie Überschreibungen für Werteinstellungen für den Lebenszyklus auf Kampagnenebene konfigurieren und ein hoher Lifetime-Wert vorhanden ist, muss auch ein Standardwert vorhanden sein (CampaignGoalConfigError.HIGH_LIFETIME_VALUE_PRESENT_BUT_VALUE_ABSENT). Außerdem muss der hohe Lifetime-Wert größer als der Wert sein, falls er festgelegt ist (CampaignGoalConfigError.HIGH_LIFETIME_VALUE_LESS_THAN_OR_EQUAL_TO_VALUE). Ähnlich verhält es sich bei multiplikativen Werteinstellungen: 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). Außerdem muss der Multiplikator für den hohen Lifetime-Wert unbedingt 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 den hohen Lifetime-Wert und Überschreibungen für den Multiplikator für den hohen Lifetime-Wert dürfen nur für unterstützte Kampagnentypen festgelegt werden (CampaignGoalConfigError.CAMPAIGN_OVERRIDE_HIGH_LIFETIME_VALUE_NOT_SUPPORTED_FOR_CAMPAIGN_TYPE oder CampaignGoalConfigError.CAMPAIGN_OVERRIDE_HIGH_LIFETIME_VALUE_MULTIPLIER_NOT_SUPPORTED_FOR_CAMPAIGN_TYPE).

Inkompatible Zielvorhaben

Ein Fehler wird ausgelöst, wenn in einer Kampagne versucht wird, inkompatible Zielvorhaben für die Optimierung des Kundenlebenszyklus 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 search oder searchStream Methoden von GoogleAdsService verwenden, um Zielvorhaben und Konfigurationen für den Lebenszyklus 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