להשתמש ב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 ניתן לקיים
לפחות CustomerLifecycleGoal אחד לכל חשבון Google Ads.
השדה 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.
ההתנהגות של המשאבים המשותפים
עד שגרסה 16 של Google Ads API תיסגר בינואר 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