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

כדי להגדיר יעדים שקשורים למחזור החיים של הלקוח, משתמשים במשאבים 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 (double): ערך ההמרה המצטבר שצריך להוסיף להמרה הראשונה מסוג רכישה של לקוח חדש.
    • value_multiplier (double): המכפיל שיוחל על ערך ההמרה של הרכישה הראשונה של לקוח חדש (לא נתמך ב-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