דף זה תורגם על ידי Cloud Translation API.

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

משתמשים במשאבים 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 של החשבון:

lifecycle_goal_customer_definition_settings.existing_user_lists מציין אילו רשימות משתמשים מכילות לקוחות קיימים.
השדה 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

יעדי הקמפיין