יעדים במחזור החיים

כדי להגדיר יעדים שקשורים למחזור החיים של הלקוח, משתמשים במשאבים Goal ו-CampaignGoalConfig של Google Ads API. ‫Google Ads API תומך ביעדי צירוף לקוחות וביעדי שימור כדי לנהל ביעילות את שינויי הערכים של מחזור החיים של הלקוחות באמצעות הקמפיינים ב-Google Ads.

אם בחשבון Google Ads שלכם מוגדר מעקב המרות ברמת חשבון ניהול, אתם צריכים להגדיר את היעדים שקשורים למחזור החיים של הלקוח ברמת החשבון בחשבון Google Ads שמוגדר בו מעקב המרות, ולא ישירות בחשבון Google Ads. עם זאת, עדיין כדאי להגדיר הגדרות ברמת הקמפיין בחשבון. זה דומה לאופן שבו מנהלים יעדים אחרים כשמשתמשים במעקב המרות ברמת חשבון ניהול.

סוגי יעדים שקשורים למחזור החיים של הלקוח

היעדים שקשורים למחזור החיים של הלקוח מוגדרים ברמת החשבון באמצעות המשאב Goal. יעד מייצג מטרה ספציפית במחזור החיים והוא מוגדר לפי goal_type.

סוגי היעדים הנתמכים שקשורים למחזור החיים של הלקוח הם:

NEW_CUSTOMER_ACQUISITION

כדי לצרף לקוחות חדשים ביעילות, אפשר להקצות שינויי ערכים להמרות שלהם.

CUSTOMER_RETENTION

כדי לעודד לקוחות קיימים, רווחיים ולא פעילים לאינטראקציה חוזרת.

LOYALTY_RETENTION

כדי לשפר את השימור והמעורבות של חברים במועדון הלקוחות.

הגדרת יעדים שקשורים למחזור החיים של הלקוח

ברמת הלקוח, מגדירים יעד שקשור למחזור החיים של הלקוח על ידי יצירה של Goal. בחשבון Google Ads יכול להיות לכל היותר Goal אחד לכל סוג יעד (NEW_CUSTOMER_ACQUISITION,‏ CUSTOMER_RETENTION או LOYALTY_RETENTION).

הגדרות היעד "צירוף לקוחות חדשים"

כדי להגדיר את היעד "צירוף לקוחות חדשים" (NCA), מגדירים את goal_type לערך NEW_CUSTOMER_ACQUISITION וקובעים את ההגדרות בשדה new_customer_acquisition_goal_settings באמצעות GoalService.

בשדה new_customer_acquisition_goal_settings.value_settings משתמשים ב-CustomerLifecycleOptimizationValueSettings כדי לציין התאמות של ערכי המרות ללקוחות שצורפו:

• value_settings (CustomerLifecycleOptimizationValueSettings):
  • value_adjustment (oneof):
    • ‫additional_value (מספר עשרוני): ערך המרה מצטבר שצריך להוסיף להמרות מסוג רכישה ברכישה הראשונה של לקוח חדש.
    • value_multiplier (מספר עשרוני): המכפיל שצריך להחיל על ערך ההמרה של הרכישה הראשונה של לקוח חדש (לא נתמך ב-NEW_CUSTOMER_ACQUISITION, נתמך ב-LOYALTY_RETENTION).
  • high_lifetime_value_adjustment (oneof):
    • ‫additional_high_lifetime_value (כפול): ערך המרה מצטבר של לקוחות חדשים שמזוהים כלקוחות עם ערך גבוה של חיי משתמש.
    • ‫high_lifetime_value_multiplier (מספר עשרוני): מכפיל ערך ההמרה שיוחל על לקוחות חדשים עם ערך גבוה של חיי משתמש (עדיין לא נתמך).

הערך הגבוה של ערך חיי המשתמש צריך להיות גדול מהערך, והמכפיל של הערך הגבוה של ערך חיי המשתמש חייב להיות גדול יותר מהמכפיל של הערך, אם הוא מוגדר.

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]
    )

הגדרות של היעד 'שימור לקוחות'

כדי להגדיר שימור לקוחות, מגדירים את goal_type לערך CUSTOMER_RETENTION ומגדירים את ההגדרות בשדה retention_goal_settings.

לפני שיוצרים יעד שימור, צריך לעמוד בדרישות המוקדמות שמתוארות במאמר מידע על היעד 'שימור'. הדרישות כוללות קמפיין למיקסום הביצועים ורשימת משתמשים של התאמה ללקוחות.

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]
    )

הפעולה הזו יוצרת יעד שימור חדש ברמת החשבון עבור חשבון הלקוח שצוין, והוא חל על כל הקמפיינים בחשבון הזה. כברירת מחדל, היעד הזה מטרגט את כל המשתמשים ברשימות המשתמשים שלכם מסוג "התאמה ללקוחות".

הגדרות היעד "שימור לקוחות במועדון"

כדי להגדיר יעדי שימור של חברים במועדון הלקוחות, מגדירים את השדה goal_type לערך LOYALTY_RETENTION וקובעים את ההגדרות בשדה loyalty_retention_goal_settings (LoyaltyRetentionGoal).

בניגוד ליעדים מסוג NEW_CUSTOMER_ACQUISITION ו-CUSTOMER_RETENTION (שמשתמשים בהתאמות של ערכים מצטברים), יעדים מסוג LOYALTY_RETENTION תומכים בהגדרה value_multiplier ב-value_settings באמצעות CustomerLifecycleOptimizationValueSettings:

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]
    )

פילוח הקהלים

אתם צריכים להשתמש במשאב UserListCustomerType כדי לפלח את הקהלים שלכם ליעדים שקשורים למחזור החיים של הלקוחות (כולל היעדים 'צירוף לקוחות חדשים', 'שימור לקוחות' ו'שימור נאמנות'). צריך לשייך כל רשימת משתמשים לקטגוריה אחת או יותר. כדי לעשות את זה, יוצרים UserListCustomerType לכל שילוב של רשימת משתמשים וקטגוריה.

משתמשים ב-UserListCustomerTypeService כדי ליצור מופעי UserListCustomerType.

הפעולות שנתמכות ב-UserListCustomerTypeService הן create ו-remove, ולכן אם רוצים לעדכן UserListCustomerType קיים, צריך להסיר אותו ואז ליצור חדש עם העדכונים הנדרשים.

אפשר להקצות UserListCustomerType רק לרשימת משתמשים אחת, אבל לרשימת משתמשים יכולים להיות כמה מופעים משויכים של UserListCustomerType, כל עוד אין התנגשויות בין המופעים של UserListCustomerType. אם תנסו להקצות UserListCustomerType מופעים עם השילובים הבאים של customer_type_category לאותה רשימת משתמשים, תתקבל השגיאה UserListCustomerTypeError.CONFLICTING_CUSTOMER_TYPES:

הגדרת היעדים שקשורים למחזור החיים של הלקוח בקמפיין

ברמת הקמפיין, אפשר להגדיר שינויים ספציפיים לקמפיין או אפשרויות טירגוט באמצעות CampaignGoalConfig. אחרי שיוצרים יעד ברמת החשבון, משתמשים ב-resource_name שלו כדי ליצור CampaignGoalConfig באמצעות השיטה mutate_campaign_goal_configs ב-CampaignGoalConfigService.

הגדרות של צירוף לקוחות חדשים בקמפיין

כדי לשנות את ההגדרות או להגדיר טירגוט ל-NCA ברמת הקמפיין, מגדירים את השדה campaign_new_customer_acquisition_settings מסוג CampaignNewCustomerAcquisitionGoalSettings:

• ‫value_settings_override (סוג: CustomerLifecycleOptimizationValueSettings): שינויים מותאמים אישית בערכים שמאפשרים לבטל את ההגדרות ברמת החשבון.
• ‫target_option (סוג: CustomerLifecycleOptimizationMode): קובע את מצב האופטימיזציה של מחזור החיים של הלקוח. האפשרויות הן:
  • TARGET_ALL: הקמפיין מטרגט גם לקוחות חדשים וגם לקוחות קיימים, אבל מגיש הצעות מחיר גבוהות יותר ללקוחות חדשים באמצעות התאמות הערך שהוגדרו.
  • ‫TARGET_SPECIFIC: הקמפיין מטרגט לקוחות חדשים בלבד. התאמות של הצעות מחיר לא רלוונטיות לאפשרות הזו.

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]
    )

הגדרות שימור לקוחות בקמפיין

כדי לשנות את ההגדרות או להגדיר טירגוט ליעדי שימור ברמת הקמפיין, צריך להגדיר את השדה campaign_retention_settings מסוג CampaignRetentionGoalSettings:

• value_settings_override (סוג: CustomerLifecycleOptimizationValueSettings): התאמות של ערכים מותאמים אישית שיחליפו את ההגדרות ברמת החשבון.
• ‫target_option (סוג: CustomerLifecycleOptimizationMode): קובע את מצב האופטימיזציה. ברירת המחדל היא TARGET_ALL. כדי להגדיר את הערך TARGET_SPECIFIC, החשבון צריך להיות ברשימת ההיתרים המתאימה.

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]
    )

אם לא מגדירים את campaign_retention_settings.target_option, ברירת המחדל היא TARGET_ALL. האפשרות להגדיר את TARGET_SPECIFIC זמינה רק למשתמשים ברשימת ההיתרים המתאימה.

הגדרות שימור נאמנות בקמפיין

כדי לשנות את ההגדרות או לקבוע התנהגות ספציפית לחברי מועדון ברמת הקמפיין ליעדים מסוג LOYALTY_RETENTION, צריך להגדיר את השדה campaign_loyalty_retention_settings מסוג CampaignLoyaltyRetentionGoalSettings ב-CampaignGoalConfig:

• value_settings_override (סוג: CustomerLifecycleOptimizationValueSettings): שינויי ערכים בהתאמה אישית שמחליפים את הגדרות הערך של שימור נאמנות ברמת החשבון.
• ‫enable_bid_adjustments_for_loyalty_members (סוג: bool): האם להפעיל התאמות של הצעות מחיר לחברי מועדון הלקוחות בקמפיין הזה.
• show_targeted_loyalty_member_benefits_in_pla (סוג: bool): האם להציג הטבות למנויים ממוקדות לחברי מועדון בפורמט של מודעות פרטי מוצר (PLA) במדינות שעומדות בדרישות.

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]
    )

אימות ושגיאות

כשמגדירים יעדים שקשורים למחזור החיים של הלקוח, יכול להיות שתיתקלו במגבלות ובשגיאות הבאות:

שגיאות באימות יעדים

שכפול של הגדרת יעד

אם תנסו ליצור יעד כפול שקשור למחזור החיים של הלקוח, תופיע השגיאה GoalError.NEW_CUSTOMER_ACQUISITION_GOAL_ALREADY_EXISTS (ל-NCA), GoalError.RETENTION_GOAL_ALREADY_EXISTS (ליעדי שימור) או GoalError.LOYALTY_RETENTION_GOAL_ALREADY_EXISTS (ליעדי שימור של לקוחות נאמנים).

הגדרות ערך לא תקינות

כשמגדירים את ערכי היעדים שקשורים למחזור החיים של הלקוח, אם יש ערך גבוה של חיי המשתמש, צריך להיות גם ערך רגיל (GoalError.HIGH_LIFETIME_VALUE_PRESENT_BUT_VALUE_ABSENT), והערך הגבוה של חיי המשתמש צריך להיות גדול מהערך הרגיל, אם הוא מוגדר (GoalError.HIGH_LIFETIME_VALUE_LESS_THAN_OR_EQUAL_TO_VALUE).

באופן דומה, כשמגדירים ערכים כפליים, אם יש מכפיל של ערך גבוה של חיי המשתמש, צריך להיות גם מכפיל ערך (GoalError.HIGH_LIFETIME_VALUE_MULTIPLIER_PRESENT_BUT_VALUE_MULTIPLIER_ABSENT), והמכפיל של הערך הגבוה של חיי המשתמש צריך להיות גדול יותר ממכפיל הערך (GoalError.HIGH_LIFETIME_VALUE_MULTIPLIER_LESS_THAN_OR_EQUAL_TO_VALUE_MULTIPLIER).

שגיאות באימות של הגדרות היעד של הקמפיין

התנגשות בין ערכים ספציפיים של יעד חלופי

אם הגדרתם את היעד 'צירוף לקוחות חדשים' וקבעתם את הערך target_option כ-TARGET_SPECIFIC (כדי לטרגט רק לקוחות חדשים), אסור להגדיר ביטולים של ערכים ברמת הקמפיין (CampaignGoalConfigError.CAMPAIGN_OVERRIDE_VALUES_SET_FOR_NEW_CUSTOMER_ACQUISITION_TARGET_SPECIFIC_OPTION). לא ניתן להשתמש בהתאמות של הצעות מחיר כשמטרגטים רק לקוחות חדשים.

שינוי הגדרות של ערך לא חוקי

כשמגדירים ברמת הקמפיין שינויים בהגדרות של ערך חיי המשתמש, אם יש ערך גבוה של חיי המשתמש, צריך להיות גם ערך רגיל (CampaignGoalConfigError.HIGH_LIFETIME_VALUE_PRESENT_BUT_VALUE_ABSENT), וערך גבוה של חיי המשתמש צריך להיות גדול מהערך, אם הוא מוגדר (CampaignGoalConfigError.HIGH_LIFETIME_VALUE_LESS_THAN_OR_EQUAL_TO_VALUE). באופן דומה, בהגדרות של ערך מכפיל, אם יש מכפיל של ערך גבוה של חיי המשתמש, צריך להיות גם מכפיל ערך (CampaignGoalConfigError.HIGH_LIFETIME_VALUE_MULTIPLIER_PRESENT_BUT_VALUE_MULTIPLIER_ABSENT), ומכפיל של ערך גבוה של חיי המשתמש צריך להיות גדול יותר ממכפיל הערך (CampaignGoalConfigError.HIGH_LIFETIME_VALUE_MULTIPLIER_LESS_THAN_OR_EQUAL_TO_VALUE_MULTIPLIER).

תמיכה בסוגי קמפיינים עם ערך גבוה לטווח הארוך

אפשר להגדיר שינויים של ערך חיי משתמש גבוה ושינויים של מכפיל ערך חיי משתמש גבוה רק בסוגי קמפיינים נתמכים (CampaignGoalConfigError.CAMPAIGN_OVERRIDE_HIGH_LIFETIME_VALUE_NOT_SUPPORTED_FOR_CAMPAIGN_TYPE או CampaignGoalConfigError.CAMPAIGN_OVERRIDE_HIGH_LIFETIME_VALUE_MULTIPLIER_NOT_SUPPORTED_FOR_CAMPAIGN_TYPE).

יעדים לא תואמים

אם מנסים להחיל בקמפיין בו-זמנית יעדי אופטימיזציה לא תואמים של מחזור החיים של הלקוחות, מופיעה הודעת שגיאה (CampaignGoalConfigError.CANNOT_USE_INCOMPATIBLE_CLO_GOALS). בטבלה הבאה מפורטים שילובים של יעדים שסותרים זה את זה וגורמים להצגת השגיאה הזו:

אחזור יעדים שקשורים למחזור החיים של הלקוח

כמו במשאבים אחרים ב-Google Ads API, משתמשים בשיטות search או searchStream של GoogleAdsService כדי לאחזר יעדים והגדרות של מחזור החיים.

השאילתה הבאה מאחזרת את הפרטים של כל Goal שהוגדר בחשבון Google Ads API:

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

באופן דומה, השאילתה הבאה מאחזרת את הפרטים של כל CampaignGoalConfig:

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