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

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

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

טיפול בפעולות יצירה ועדכון (לגרסה 15 בלבד)

ב-Google Ads API v15, הפעולות שנתמכות ב-CustomerLifecycleGoalService ו-CampaignLifecycleGoalService שונות מעט משירותים אחרים ב-Google Ads API. במקום לבצע פעולות create ו-update נפרדות, בגרסה 15 CustomerLifecycleGoalOperation וב-CampaignLifecycleGoalOperation יש רק פעולת create ואתם מציינים את הכוונה באמצעות update_mask באופן הבא:

  • כדי ליצור יעד במחזור חיים באמצעות גרסה 15, צריך לאכלס את create ביעד, אבל לא להגדיר את resource_name ולא להגדיר את update_mask של הפעולה.

  • כדי לעדכן יעד במחזור חיים באמצעות גרסה 15, צריך לאכלס את create ביעד, להגדיר את ה-resource_name ולהגדיר את הערך update_mask כך שיציג את השדות שרוצים לעדכן.

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

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

פילוח הקהלים

החל מ-Google Ads API v17, צריך להשתמש במשאב 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 עם השילובים הבאים של 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 v16 ובגרסאות קודמות

מגדירים את השדות הבאים ב-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 v16 בינואר 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, כדאי להשתמש ב-methods 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
הקודם
יעדי הקמפיין