در تاریخ ۲۰ آگوست ساعت ۱۰:۰۰ صبح به وقت شرق آمریکا، به صورت زنده در Discord روی سرور Google Advertising and Measurement Community و در YouTube به ما بپیوندید! ما در مورد ویژگی‌های جدید اضافه شده در نسخه ۲۵.۱ از API تبلیغات گوگل صحبت خواهیم کرد.

این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

اهداف چرخه زندگی

از منابع Goal و CampaignGoalConfig در API گوگل ادز برای پیکربندی اهداف مرتبط با چرخه عمر مشتری استفاده کنید. API گوگل ادز از اهداف جذب مشتری و اهداف حفظ مشتری برای مدیریت کارآمد تنظیمات ارزش چرخه عمر مشتری از طریق کمپین‌های گوگل ادز شما پشتیبانی می‌کند.

اگر حساب گوگل ادز شما از ردیابی تبدیل بین حساب‌های کاربری استفاده می‌کند، باید اهداف چرخه عمر مشتری را در حساب تبدیل گوگل ادز پیکربندی کنید، نه مستقیماً در حساب گوگل ادز. با این حال، همچنان باید پیکربندی‌های سطح کمپین را در حساب خود تنظیم کنید. این مشابه نحوه مدیریت سایر اهداف هنگام استفاده از ردیابی تبدیل بین حساب‌های کاربری است.

انواع اهداف چرخه عمر مشتری

اهداف چرخه عمر مشتری در سطح حساب کاربری با استفاده از منبع Goal پیکربندی می‌شوند. یک goal نشان‌دهنده یک هدف چرخه عمر خاص است و توسط goal_type آن تعریف می‌شود.

انواع اهداف چرخه عمر پشتیبانی شده عبارتند از:

NEW_CUSTOMER_ACQUISITION: برای جذب موثر مشتریان جدید با اختصاص تنظیمات ارزش به تبدیل‌های آنها.
CUSTOMER_RETENTION: برای جذب مجدد مشتریان فعلی، با ارزش بالا و مشتریان از دست رفته.
LOYALTY_RETENTION: برای افزایش حفظ و تعامل، به ویژه در میان اعضای برنامه وفاداری.

اهداف چرخه عمر مشتری را پیکربندی کنید

در سطح مشتری، با ایجاد یک Goal ، یک هدف چرخه عمر را پیکربندی کنید. در یک حساب Google Ads، حداکثر می‌توان یک Goal برای هر نوع هدف ( NEW_CUSTOMER_ACQUISITION ، CUSTOMER_RETENTION یا LOYALTY_RETENTION ) داشت.

تنظیمات جدید هدف جذب مشتری

برای تنظیم جذب مشتری جدید (NCA)، goal_type روی NEW_CUSTOMER_ACQUISITION تنظیم کنید و تنظیمات را در فیلد new_customer_acquisition_goal_settings با استفاده از GoalService پیکربندی کنید.

این تنظیمات CustomerLifecycleOptimizationValueSettings برای تعیین تنظیمات ارزش تبدیل برای مشتریان جذب‌شده استفاده می‌کنند:

value_adjustment (یکی از):
- additional_value (دو برابر): ارزش تبدیل افزایشی برای اضافه کردن به اولین تبدیل خرید مشتری جدید.
- value_multiplier (double): ضریبی که برای اولین خرید مشتری جدید به ارزش تبدیل اعمال می‌شود (هنوز پشتیبانی نمی‌شود).
high_lifetime_value_adjustment (یکی از):
- additional_high_lifetime_value (double): ارزش تبدیل افزایشی برای مشتریان جدیدی که به عنوان ارزش طول عمر بالا شناسایی می‌شوند.
- ضریب 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 پیکربندی کنید.

قبل از ایجاد یک هدف حفظ مشتری، باید پیش‌نیازهای شرح داده شده در «درباره هدف حفظ مشتری» را برآورده کنید. این شامل داشتن یک کمپین Performance Max و یک لیست کاربر Customer Match می‌شود.

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]
    )

این یک هدف حفظ مشتری جدید در سطح حساب برای حساب مشتری مشخص شده ایجاد می‌کند که برای همه کمپین‌های آن اعمال خواهد شد. به طور پیش‌فرض، این هدف همه کاربران موجود در لیست‌های کاربران Customer Match شما را هدف قرار می‌دهد.

تنظیمات هدف حفظ وفاداری

برای تنظیم اهداف حفظ وفاداری برای اعضای برنامه وفاداری، 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 وجود نداشته باشد. تلاش برای اختصاص نمونه‌های UserListCustomerType با ترکیبات زیر از customer_type_category به یک لیست کاربر، منجر به خطای UserListCustomerTypeError.CONFLICTING_CUSTOMER_TYPES خواهد شد:

اولین `customer_type_category`	`customer_type_category`
خریداران	سرنخ‌های تبدیل‌شده
خریداران	سرنخ‌های واجد شرایط
خریداران	رهاکنندگان سبد خرید
سرنخ‌های تبدیل‌شده	سرنخ‌های واجد شرایط
مشتریان غیرفعال	سرنخ‌های تبدیل‌شده
مشتریان غیرفعال	سرنخ‌های واجد شرایط
مشتریان غیرفعال	رهاکنندگان سبد خرید
اعضای وفادار	اعضای وفادار

پیکربندی اهداف چرخه عمر کمپین

در سطح کمپین، می‌توانید با استفاده از CampaignGoalConfig ، گزینه‌های لغو یا هدف‌گذاری مختص کمپین را پیکربندی کنید. پس از اینکه یک هدف در سطح حساب کاربری داشتید، resource_name آن برای ایجاد یک CampaignGoalConfig با استفاده از متد mutate_campaign_goal_configs در 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 (برای NCA)، 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` )، مشتری‌یابی، سود ناخالص
حفظ وفاداری (مزایای PLA)	جذب مشتری جدید ("فقط برای مشتریان جدید پیشنهاد قیمت دهید" / `TARGET_SPECIFIC` )، مشتری‌یابی، سود ناخالص
اکتشاف	جذب مشتری جدید ("فقط برای مشتریان جدید پیشنهاد قیمت دهید" / `TARGET_SPECIFIC` ، "برای مشتریان جدید پیشنهاد قیمت بالاتری بدهید" / `TARGET_ALL` )

بازیابی اهداف چرخه عمر

همانند سایر منابع موجود در API گوگل ادز، از متدهای search یا searchStream از GoogleAdsService برای بازیابی اهداف و پیکربندی‌های چرخه عمر استفاده کنید.

کوئری زیر جزئیات هر Goal پیکربندی‌شده در یک حساب 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

قبلی

اهداف کمپین

اهداف چرخه زندگی با مجموعه‌ها، منظم بمانید ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.