כדאי להצטרף אלינו לשידור חי ב-Discord בשרת של קהילת הפרסום והמדידה של Google וב-YouTube ב-20 באוגוסט בשעה 10:00 (שעון החוף המזרחי)! במאמר הזה נסביר על התכונות החדשות שנוספו לגרסה 25.1 של Google Ads API.

‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

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

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

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

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

יעדים שקשורים למחזור החיים של הלקוח מוגדרים ברמת החשבון באמצעות מקור המידע Goal. יעד מייצג מטרה ספציפית שקשורה למחזור החיים של הלקוחות, והוא מוגדר לפי goal_type.

אלה סוגי היעדים שקשורים למחזור החיים של הלקוח שנתמכים:

NEW_CUSTOMER_ACQUISITION: כדי לצרף לקוחות חדשים ביעילות על ידי הקצאת שינויים בערך להמרות שלהם.
CUSTOMER_RETENTION: לעידוד לאינטראקציה חוזרת של לקוחות קיימים, לקוחות רווחיים ולקוחות לא פעילים.
LOYALTY_RETENTION: כדי להגביר את השימור והמעורבות בקרב חברי מועדון הלקוחות.

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

ברמת הלקוח, מגדירים יעד שקשור למחזור החיים של הלקוח על ידי יצירת Goal. יכול להיות לכל היותר יעד אחד מסוג Goal לכל סוג יעד (NEW_CUSTOMER_ACQUISITION,‏ CUSTOMER_RETENTION או LOYALTY_RETENTION) בחשבון Google Ads.

הגדרות של היעד 'צירוף לקוחות חדשים'

כדי להגדיר את היעד 'צירוף לקוחות חדשים' (NCA), מגדירים את הערך goal_type ל-NEW_CUSTOMER_ACQUISITION ומגדירים את ההגדרות בשדה new_customer_acquisition_goal_settings באמצעות GoalService.

ההגדרות משתמשות ב-CustomerLifecycleOptimizationValueSettings כדי לציין התאמות של ערכי המרות ללקוחות חדשים:

value_adjustment (oneof):
- ‫additional_value (double): ערך ההמרה המצטבר שיוסף להמרה ברכישה הראשונה של לקוח חדש.
- ‫value_multiplier (double): מכפיל להחלה על ערך ההמרה של הרכישה הראשונה של לקוח חדש (לא אפשרי עדיין).
high_lifetime_value_adjustment (oneof):
- ‫additional_high_lifetime_value (כפול): ערך המרה מצטבר של לקוחות חדשים שמזוהים כלקוחות עם ערך גבוה של חיי משתמש.
- ‫high_lifetime_value_multiplier (double): מכפיל ערך ההמרה שיחול על לקוחות חדשים עם ערך גבוה של חיי משתמש (לא אפשרי עדיין).

אם הערך מוגדר, ערך חיי המשתמש הגבוה צריך להיות גדול מהערך.

def create_nca_goal(client: GoogleAdsClient, customer_id: str) -> None:
    """Sends an API request to add a new New Customer Acquisition Goal.

    Args:
        client: an initialized GoogleAdsClient instance.
        customer_id: a client customer ID.
    """
    goal_operation: GoalOperation = client.get_type("GoalOperation")
    goal = goal_operation.create
    goal.goal_type = client.enums.GoalTypeEnum.NEW_CUSTOMER_ACQUISITION

    # Configure the value adjustments.
    goal.new_customer_acquisition_goal_settings.value_settings.additional_value = 50.0
    goal.new_customer_acquisition_goal_settings.value_settings.additional_high_lifetime_value = 100.0

    goal_service = client.get_service("GoalService")
    goal_service.mutate_goals(
        customer_id=customer_id, operations=[goal_operation]
    )

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

כדי להגדיר שימור לקוחות, מגדירים את goal_type לערך CUSTOMER_RETENTION ומגדירים את ההגדרות בשדה retention_goal_settings.

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

def create_retention_goal(client: GoogleAdsClient, customer_id: str) -> None:
    """Sends an API request to add a new Customer Retention Goal.

    Args:
        client: an initialized GoogleAdsClient instance.
        customer_id: a client customer ID.
    """
    goal_operation: GoalOperation = client.get_type("GoalOperation")
    goal = goal_operation.create
    goal.goal_type = client.enums.GoalTypeEnum.CUSTOMER_RETENTION
    goal.retention_goal_settings.value_settings.additional_value = 50.0
    goal.retention_goal_settings.value_settings.additional_high_lifetime_value = 100.0

    goal_service = client.get_service("GoalService")
    goal_service.mutate_goals(
        customer_id=customer_id, operations=[goal_operation]
    )

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

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

כדי להגדיר יעדי שימור לחברים במועדון הלקוחות, מגדירים את goal_type לערך LOYALTY_RETENTION ומגדירים את ההגדרות בשדה loyalty_retention_goal_settings (LoyaltyRetentionGoal).

במקרה של יעדי שימור של חברי מועדון, רק ההגדרה value_multiplier נתמכת ב-value_settings באמצעות CustomerLifecycleOptimizationValueSettings:

def create_loyalty_retention_goal(client: GoogleAdsClient, customer_id: str) -> None:
    """Sends an API request to add a new Loyalty Retention Goal.

    Args:
        client: an initialized GoogleAdsClient instance.
        customer_id: a client customer ID.
    """
    goal_operation: GoalOperation = client.get_type("GoalOperation")
    goal = goal_operation.create
    goal.goal_type = client.enums.GoalTypeEnum.LOYALTY_RETENTION
    goal.loyalty_retention_goal_settings.value_settings.value_multiplier = 1.5

    goal_service = client.get_service("GoalService")
    goal_service.mutate_goals(
        customer_id=customer_id, operations=[goal_operation]
    )

פילוח הקהלים

אתם צריכים להשתמש במשאב UserListCustomerType כדי לפלח את הקהלים שלכם ליעדים שקשורים למחזור החיים של הלקוחות (כולל היעדים 'צירוף לקוחות חדשים', 'שימור לקוחות' ו'שימור נאמנות'). כדי לשייך כל רשימת משתמשים לקטגוריה אחת או יותר, צריך ליצור UserListCustomerType לכל שילוב של רשימת משתמשים וקטגוריה.

משתמשים ב-UserListCustomerTypeService כדי ליצור מכונות 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
LOYALTY_TIER_X_MEMBERS	LOYALTY_TIER_Y_MEMBERS

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

ברמת הקמפיין, אפשר להגדיר שינויים או אפשרויות טירגוט ספציפיים לקמפיין באמצעות CampaignGoalConfig. אחרי שיוצרים יעד ברמת החשבון, משתמשים בשיטה mutate_campaign_goal_configs כדי ליצור CampaignGoalConfig באמצעות הסמל resource_name בדף CampaignGoalConfigService.

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

כדי לשנות הגדרות או להגדיר טירגוט של NCA ברמת הקמפיין, צריך להגדיר את השדה campaign_new_customer_acquisition_settings מסוג CampaignNewCustomerAcquisitionGoalSettings:

‫value_settings_override (סוג: CustomerLifecycleOptimizationValueSettings): התאמות של ערכים מותאמים אישית כדי לבטל את ההגדרות ברמת החשבון.
‫target_option (סוג: CustomerLifecycleOptimizationMode): שולט במצב האופטימיזציה של מחזור החיים של הלקוחות. האפשרויות הן:
- ‫TARGET_ALL: הקמפיין מטרגט גם לקוחות חדשים וגם לקוחות קיימים, אבל מגיש הצעות מחיר גבוהות יותר ללקוחות חדשים באמצעות התאמות הערך שהוגדרו.
- ‫TARGET_SPECIFIC: הקמפיין מטרגט רק לקוחות חדשים. התאמות של הצעות מחיר לא רלוונטיות לאפשרות הזו.

def create_campaign_nca_config(
    client: GoogleAdsClient,
    customer_id: str,
    goal_resource_name: str,
    campaign_resource_name: str,
) -> None:
    """Sends an API request to add a new CampaignGoalConfig for NCA.

    Args:
        client: an initialized GoogleAdsClient instance.
        customer_id: a client customer ID.
        goal_resource_name: the resource name of an existing NCA Goal.
        campaign_resource_name: the resource name of an existing Campaign.
    """
    operation: CampaignGoalConfigOperation = client.get_type("CampaignGoalConfigOperation")
    goal_config = operation.create
    goal_config.campaign = campaign_resource_name
    goal_config.goal = goal_resource_name

    # Set the target option to target both new and existing customers.
    goal_config.campaign_new_customer_acquisition_settings.target_option = (
        client.enums.CustomerLifecycleOptimizationModeEnum.TARGET_ALL
    )
    # Optionally override value settings.
    goal_config.campaign_new_customer_acquisition_settings.value_settings_override.additional_value = 60.0

    campaign_goal_config_service = client.get_service("CampaignGoalConfigService")
    campaign_goal_config_service.mutate_campaign_goal_configs(
        customer_id=customer_id, operations=[operation]
    )

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

כדי לשנות הגדרות או להגדיר טירגוט ליעדי שימור ברמת הקמפיין, צריך להגדיר את השדה campaign_retention_settings מסוג CampaignRetentionGoalSettings:

‫value_settings_override (סוג: CustomerLifecycleOptimizationValueSettings): התאמות של ערכים מותאמים אישית כדי לבטל את ההגדרות ברמת החשבון.
‫target_option (סוג: CustomerLifecycleOptimizationMode): קובע את מצב האופטימיזציה. ברירת המחדל היא TARGET_ALL. כדי להגדיר את האפשרות הזו ל-TARGET_SPECIFIC, החשבון שלכם צריך להיות ברשימת ההיתרים המתאימה.

def create_campaign_retention_config(
  client: GoogleAdsClient,
  customer_id: str,
  goal_resource_name: str,
  campaign_resource_name: str
) -> None:
    """Sends an API request to add a new CampaignGoalConfig for Retention.

    Args:
        client: an initialized GoogleAdsClient instance.
        customer_id: a client customer ID.
        goal_resource_name: the resource name of an existing Retention Goal.
        campaign_resource_name: the resource name of an existing Campaign.
    """
    operation: CampaignGoalConfigOperation = client.get_type("CampaignGoalConfigOperation")
    goal_config = operation.create
    goal_config.campaign = campaign_resource_name
    goal_config.goal = goal_resource_name

    # goal_config.campaign_retention_settings.target_option = (
    #   client.enums.CustomerLifecycleOptimizationModeEnum.TARGET_SPECIFIC
    # )

    campaign_goal_config_service = client.get_service("CampaignGoalConfigService")
    campaign_goal_config_service.mutate_campaign_goal_configs(
      customer_id=customer_id, operations=[operation]
    )

אם לא מגדירים את campaign_retention_settings.target_option, ברירת המחדל היא TARGET_ALL. האפשרות להגדיר את TARGET_SPECIFIC זמינה רק למשתמשים שנכללים ברשימת ההיתרים המתאימה.

הגדרות שימור נאמנות בקמפיין

כדי לעקוף הגדרות או להגדיר התנהגות ספציפית לחברי מועדון ברמת הקמפיין עבור יעדי LOYALTY_RETENTION, מגדירים את השדה campaign_loyalty_retention_settings מסוג CampaignLoyaltyRetentionGoalSettings ב-CampaignGoalConfig:

‫value_settings_override (סוג: CustomerLifecycleOptimizationValueSettings): התאמות של ערכים מותאמים אישית שנועדו לעקוף את הגדרות הערך של שימור לקוחות במועדון הלקוחות ברמת החשבון.
‫enable_bid_adjustments_for_loyalty_members (סוג: bool): האם להפעיל התאמות של הצעות מחיר לחברי מועדון לקוחות בקמפיין הזה.
‫show_targeted_loyalty_member_benefits_in_pla (סוג: bool): האם להציג הטבות לחברי מועדון שמטורגטות במודעות כרטיס מוצר (PLA) במדינות שעומדות בדרישות.

def create_campaign_loyalty_retention_config(
    client: GoogleAdsClient,
    customer_id: str,
    goal_resource_name: str,
    campaign_resource_name: str,
) -> None:
    """Sends an API request to add a new CampaignGoalConfig for Loyalty Retention.

    Args:
        client: an initialized GoogleAdsClient instance.
        customer_id: a client customer ID.
        goal_resource_name: the resource name of an existing Loyalty Retention Goal.
        campaign_resource_name: the resource name of an existing Campaign.
    """
    operation: CampaignGoalConfigOperation = client.get_type("CampaignGoalConfigOperation")
    goal_config = operation.create
    goal_config.campaign = campaign_resource_name
    goal_config.goal = goal_resource_name

    # Enable bid adjustments and targeted loyalty benefits in PLAs.
    goal_config.campaign_loyalty_retention_settings.enable_bid_adjustments_for_loyalty_members = True
    goal_config.campaign_loyalty_retention_settings.show_targeted_loyalty_member_benefits_in_pla = True

    campaign_goal_config_service = client.get_service("CampaignGoalConfigService")
    campaign_goal_config_service.mutate_campaign_goal_configs(
        customer_id=customer_id, operations=[operation]
    )

אימות ושגיאות

כשמגדירים יעדים שקשורים למחזור החיים של הלקוחות, יכול להיות שתיתקלו במגבלות ובשגיאות הבאות:

שגיאות באימות יעדים

שכפול הגדרת היעד: אם יוצרים יעד כפול שקשור למחזור החיים של הלקוח כשיעד כזה כבר קיים, מוצגת שגיאה GoalError.NEW_CUSTOMER_ACQUISITION_GOAL_ALREADY_EXISTS (לגבי צירוף לקוחות חדשים), GoalError.RETENTION_GOAL_ALREADY_EXISTS (לגבי יעדי שימור) או GoalError.LOYALTY_RETENTION_GOAL_ALREADY_EXISTS (לגבי יעדי שימור של לקוחות נאמנים).
הגדרות ערך לא תקינות: כשמגדירים את שווי היעדים שקשורים למחזור החיים של הלקוח, אם מוגדר ערך גבוה של ערך חיי המשתמש, צריך להגדיר גם ערך רגיל (GoalError.HIGH_LIFETIME_VALUE_PRESENT_BUT_VALUE_ABSENT). בנוסף, אם מוגדר ערך גבוה של ערך חיי המשתמש, הוא צריך להיות גדול מהערך הרגיל (GoalError.HIGH_LIFETIME_VALUE_LESS_THAN_OR_EQUAL_TO_VALUE).

שגיאות באימות של הגדרת יעד הקמפיין

קונפליקט בשינוי של ערך ספציפי: במקרה של יעדי צירוף לקוחות חדשים, אם הערך של target_option הוא TARGET_SPECIFIC (כדי לטרגט רק לקוחות חדשים), אסור להגדיר ביטולים של ערכים ברמת הקמפיין (CampaignGoalConfigError.CAMPAIGN_OVERRIDE_VALUES_SET_FOR_NEW_CUSTOMER_ACQUISITION_TARGET_SPECIFIC_OPTION). התאמות של הצעות מחיר לא רלוונטיות כשמטרגטים רק לקוחות חדשים.
תמיכה בסוגי קמפיינים עם ערך גבוה לטווח הארוך: חובה להגדיר ביטולים של ערך גבוה לאורך חיי הלקוח רק לסוגי קמפיינים נתמכים (CampaignGoalConfigError.CAMPAIGN_OVERRIDE_HIGH_LIFETIME_VALUE_NOT_SUPPORTED_FOR_CAMPAIGN_TYPE).
מטרות עסקיות לא תואמות: אם מנסים להחיל על קמפיין בו-זמנית יעדים לא תואמים של אופטימיזציה של מחזור החיים של הלקוח (CampaignGoalConfigError.CANNOT_USE_INCOMPATIBLE_CLO_GOALS), מוצגת שגיאה. בטבלה שלמטה מפורטות שילובי יעדים שאינם תואמים ושגורמים להצגת השגיאה הזו:

סוג היעד / המצב של מחזור החיים של הלקוח	יעד או מצב לא תואמים
שימור לקוחות ("הגשת הצעות מחיר רק על לקוחות לא פעילים" / `TARGET_SPECIFIC`)	צירוף לקוחות חדשים ("הגשת הצעת מחיר על לקוחות חדשים בלבד" / `TARGET_SPECIFIC`, "הגשת הצעות מחיר גבוהות יותר על לקוחות חדשים" / `TARGET_ALL`), איתור לקוחות פוטנציאליים
שימור לקוחות ("הגשת הצעות מחיר גבוהות יותר על לקוחות לא פעילים" / `TARGET_ALL`)	צירוף לקוחות חדשים ("הגשת הצעת מחיר ללקוחות חדשים בלבד" / `TARGET_SPECIFIC`), איתור לקוחות פוטנציאליים
שימור נאמנות (מכפיל הערך)	צירוף לקוחות חדשים ("הגשת הצעות מחיר רק ללקוחות חדשים" / `TARGET_SPECIFIC`), שימור לקוחות ("הגשת הצעות מחיר רק ללקוחות לא פעילים" / `TARGET_SPECIFIC`), איתור לקוחות פוטנציאליים, רווח ברוטו
שימור חברים במועדון הלקוחות (הטבות במודעות פרטי מוצר)	צירוף לקוחות חדשים ('הגשת הצעות מחיר רק על לקוחות חדשים' / `TARGET_SPECIFIC`), איתור לקוחות פוטנציאליים, רווח ברוטו
זיהוי לקוחות פוטנציאליים	צירוף לקוחות חדשים ("הגשת הצעת מחיר ללקוחות חדשים בלבד" / `TARGET_SPECIFIC`, "הגשת הצעת מחיר גבוהה יותר ללקוחות חדשים" / `TARGET_ALL`)

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

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

שאילתת ה-SQL הבאה מאחזרת את הפרטים של כל Goal שהוגדר בחשבון Google Ads API:

SELECT
  goal.goal_id,
  goal.goal_type,
  goal.owner_customer,
  goal.new_customer_acquisition_goal_settings.value_settings.additional_value,
  goal.new_customer_acquisition_goal_settings.value_settings.additional_high_lifetime_value,
  goal.retention_goal_settings.value_settings.additional_value,
  goal.retention_goal_settings.value_settings.additional_high_lifetime_value,
  goal.loyalty_retention_goal_settings.value_settings.value_multiplier
FROM goal

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

SELECT
  campaign_goal_config.campaign,
  campaign_goal_config.goal,
  campaign_goal_config.goal_type,
  campaign_goal_config.campaign_new_customer_acquisition_settings.target_option,
  campaign_goal_config.campaign_new_customer_acquisition_settings.value_settings_override.additional_value,
  campaign_goal_config.campaign_new_customer_acquisition_settings.value_settings_override.additional_high_lifetime_value,
  campaign_goal_config.campaign_retention_settings.target_option,
  campaign_goal_config.campaign_retention_settings.value_settings_override.additional_value,
  campaign_goal_config.campaign_loyalty_retention_settings.value_settings_override.value_multiplier,
  campaign_goal_config.campaign_loyalty_retention_settings.enable_bid_adjustments_for_loyalty_members,
  campaign_goal_config.campaign_loyalty_retention_settings.show_targeted_loyalty_member_benefits_in_pla
FROM campaign_goal_config

יעדי הקמפיין

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