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

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

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

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

ברמת הלקוח, מגדירים יעד מחזור חיים על ידי יצירה או עדכון של CustomerLifecycleGoal. אפשר ליצור רק CustomerLifecycleGoal אחד לכל חשבון Google Ads. השדה customer_acquisition_goal_value_settings.value מגדיר את הערך הנוסף שנוסף כתוצאה מההמרה ברכישה הראשונה של לקוח חדש. אפשר לקרוא את השדה customer_acquisition_goal_value_settings.high_lifetime_value של היעד, אבל אי אפשר לשנות אותו ב-Google Ads API.

פילוח הקהלים

החל מגרסה 17 של Google Ads API, עליכם להשתמש במשאב UserListCustomerType כדי לפלח את הקהלים שלכם ליעדים שקשורים למחזור החיים של הלקוחות. הגדרת קהלים ישירות במשאב CustomerLifecycleGoal הוצאה משימוש. הנה הפרטים:

  • לפני גרסה 17:
    • מוסיפים רשימות משתמשים לאוסף existing_user_lists של CustomerLifecycleGoal.
  • החל מגרסה 17:
    • כדי לשייך כל רשימת משתמשים לקטגוריה אחת או יותר, יוצרים UserListCustomerType לכל שילוב של רשימת משתמשים וקטגוריה.

ב-Google Ads API מגרסה 17 ואילך

משתמשים ב-UserListCustomerTypeService כדי ליצור מכונות UserListCustomerType. אם כבר מאכלסים את השדה CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings.existing_user_lists, החשבון כבר מכיל מכונות UserListCustomerType קשורות.

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

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

פרק הזמן הראשון של customer_type_category השני customer_type_category
רוכשים CONVERTED_LEADS
רוכשים QUALIFIED_LEADS
רוכשים CART_ABANDONERS
CONVERTED_LEADS QUALIFIED_LEADS
DISENGAGED_CUSTOMERS CONVERTED_LEADS
DISENGAGED_CUSTOMERS QUALIFIED_LEADS
DISENGAGED_CUSTOMERS CART_ABANDONERS

ב-Google Ads API גרסה 16

מגדירים את השדות הבאים ב-CustomerLifecycleGoal של החשבון:

  1. lifecycle_goal_customer_definition_settings.existing_user_lists מציין אילו רשימות משתמשים מכילות לקוחות קיימים.

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

התנהגות של משאבים משותפים

עד להוצאה משימוש של Google Ads API בגרסה 16 בפברואר 2025, חשוב לזכור ש-UserListCustomerType והשדות של פילוח הקהלים ב-CustomerLifecycleGoal הם משאב משותף. כלומר, יצירת מכונות UserListCustomerType חדשות בגרסה 17 ואילך תוביל לשינויים במכונה של CustomerLifecycleGoal בגרסה 16 ואילך, ולהפך.

כך מתבצע המיפוי של השדות בשני המשאבים:

שינוי של השדה CustomerLifecycleGoal בגרסה 16 תופעת לוואי על 'UserListCustomerType' בגרסה 17
lifecycle_goal_customer_definition_settings.existing_user_lists יצירת מכונות UserListCustomerType או הסרה שלהן. השדה user_list מכיל את שם המשאב המשויך של רשימת המשתמשים.
שינוי של UserListCustomerType בגרסה 17 תופעת לוואי בשדה CustomerLifecycleGoal בגרסה 16
יצירה או הסרה של מכונות UserListCustomerType. שמות של משאבים ספציפיים יתווספו או יוסרו מהרשימה lifecycle_goal_customer_definition_settings.existing_user_lists
יצירה או הסרה של מכונות UserListCustomerType, כאשר הערך של customer_type_category מוגדר ל-HIGH_VALUE_CUSTOMERS שמות של משאבים ספציפיים יתווספו או יוסרו מהרשימה lifecycle_goal_customer_definition_settings.high_lifetime_value_user_lists

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

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

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

הערך של optimization_mode יכול להיות אחד מהערכים הבאים:

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

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

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

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

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

SELECT
  customer_lifecycle_goal.lifecycle_goal_customer_definition_settings.existing_user_lists,
  customer_lifecycle_goal.lifecycle_goal_customer_definition_settings.high_lifetime_value_user_lists,
  customer_lifecycle_goal.customer_acquisition_goal_value_settings.value,
  customer_lifecycle_goal.customer_acquisition_goal_value_settings.high_lifetime_value
FROM customer_lifecycle_goal

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

SELECT
  campaign_lifecycle_goal.campaign,
  campaign_lifecycle_goal.customer_acquisition_goal_settings.optimization_mode,
  campaign_lifecycle_goal.customer_acquisition_goal_settings.value_settings.value,
  campaign_lifecycle_goal.customer_acquisition_goal_settings.value_settings.high_lifetime_value
FROM campaign_lifecycle_goal