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