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

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

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

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

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

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

NEW_CUSTOMER_ACQUISITION

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

CUSTOMER_RETENTION

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

LOYALTY_RETENTION

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

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

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

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

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

ההגדרות משתמשות בCustomerLifecycleOptimizationValueSettings כדי לציין שינויים בערכי ההמרות של לקוחות חדשים:

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

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

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

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

כדי להגדיר שימור לקוחות, מגדירים את 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
    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]
    )

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

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

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

במקרה של יעדי שימור לקוחות שחברים במועדון הלקוחות, רק ההגדרה 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. אחרי שיוצרים יעד ברמת החשבון, משתמשים בשיטה mutate_campaign_goal_configs כדי ליצור CampaignGoalConfig באמצעות resource_name ב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.
    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]
    )

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

כדי לשנות הגדרות או להגדיר טירגוט ליעדי שימור ברמת הקמפיין, צריך להגדיר את השדה 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_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 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]
    )

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

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

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

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

אם יוצרים יעד כפול שקשור למחזור החיים של הלקוחות כשיעד כזה כבר קיים, מוצגת שגיאה מסוג GoalError.NEW_CUSTOMER_ACQUISITION_GOAL_ALREADY_EXISTS (לגבי צירוף לקוחות חדשים), 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.

שאילתת ה-SQL הבאה מאחזרת את הפרטים של כל 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