Zielvorhaben für den Kundenlebenszyklus

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

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 Akquisition 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 Lebenszyklus, 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 für goal_type den Wert NEW_CUSTOMER_ACQUISITION fest und konfigurieren Sie die Einstellungen im Feld new_customer_acquisition_goal_settings mit GoalService.

In den Einstellungen werden CustomerLifecycleOptimizationValueSettings verwendet, um Conversion-Wertanpassungen für akquirierte Kunden festzulegen:

• 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 (noch nicht unterstützt).
• 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 (noch nicht unterstützt).

Der Wert für „Hoher Lifetime-Wert“ sollte größer als der Wert für „Wert“ sein, sofern er festgelegt ist.

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 das Zielvorhaben „Kundenbindung“

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

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

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 auf Kontoebene ein neues Zielvorhaben „Kundenbindung“ für das angegebene Kundenkonto erstellt, das auf alle Kampagnen angewendet wird. Standardmäßig wird dieses Zielvorhaben auf alle Nutzer in Ihren Kundenabgleich-Nutzerlisten ausgerichtet.

Einstellungen für das Zielvorhaben „Kundenbindung im Treuepunkteprogramm“

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

Für Zielvorhaben zur Kundenbindung im Treuepunkteprogramm wird in value_settings nur die Einstellung value_multiplier 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 zur Kundenakquisition, Kundenbindung und 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 UserListCustomerType-Instanzen zu erstellen.

Das 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. Eine Nutzerliste kann jedoch mehrere zugeordnete UserListCustomerType-Instanzen haben, 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 mit CampaignGoalConfig kampagnenspezifische Überschreibungen oder Targeting-Optionen 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 campaign_new_customer_acquisition_settings Feld vom Typ CampaignNewCustomerAcquisitionGoalSettings:

• value_settings_override (Typ: CustomerLifecycleOptimizationValueSettings): Benutzerdefinierte Wertanpassungen, mit denen die Einstellungen auf Kontoebene überschrieben werden.
• target_option (Typ: CustomerLifecycleOptimizationMode): Steuert den Optimierungsmodus für den Kundenlebenszyklus. Folgende Optionen sind verfügbar:
  • TARGET_ALL: Die Kampagne ist auf Neukunden 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 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 für das Zielvorhaben „Kundenbindung“ für Kampagnen

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

• value_settings_override (Typ: CustomerLifecycleOptimizationValueSettings): Benutzerdefinierte Wertanpassungen, mit denen die Einstellungen auf Kontoebene überschrieben werden.
• 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_SPECIFIC
    # )

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

Wenn die Einstellung campaign_retention_settings.target_option nicht festgelegt ist, wird standardmäßig TARGET_ALL verwendet. Die Option, die Einstellung auf TARGET_SPECIFIC festzulegen, 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 Feld campaign_loyalty_retention_settings vom Typ CampaignLoyaltyRetentionGoalSettings für CampaignGoalConfig:

• value_settings_override (Typ: CustomerLifecycleOptimizationValueSettings): Benutzerdefinierte Wertanpassungen, mit denen die Einstellungen für den Wert für die Kundenbindung im Treuepunkteprogramm auf Kontoebene überschrieben werden.
• 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 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 doppeltes Zielvorhaben für den Lebenszyklus 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 Zielvorhaben zur Kundenbindung) oder GoalError.LOYALTY_RETENTION_GOAL_ALREADY_EXISTS (für Zielvorhaben zur Kundenbindung im Treuepunkteprogramm) ausgelöst.

Ungültige Werteinstellungen

Wenn Sie die Zielvorhabenwerteinstellungen für den Lebenszyklus konfigurieren und ein Wert für „Hoher Lifetime-Wert“ vorhanden ist, muss auch ein Standardwert vorhanden sein (GoalError.HIGH_LIFETIME_VALUE_PRESENT_BUT_VALUE_ABSENT). Außerdem muss der Wert für „Hoher Lifetime-Wert“ größer als der Wert sein, sofern er festgelegt ist (GoalError.HIGH_LIFETIME_VALUE_LESS_THAN_OR_EQUAL_TO_VALUE).

Fehler bei der Validierung der Kampagnenzielvorhabenkonfiguration

Konflikt bei der Überschreibung des Zielwerts

Wenn für Zielvorhaben zur 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 anwendbar, wenn Sie nur auf Neukunden ausrichten.

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

Überschreibungen 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).

Nicht kompatible Zielvorhaben

Ein Fehler wird ausgelöst, wenn in einer Kampagne versucht wird, nicht kompatible Zielvorhaben zur 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 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-Ressourcen 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-Ressourcen 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