أهداف مراحل النشاط

استخدِم مَراجِع CustomerLifecycleGoal و CampaignLifecycleGoal من Google Ads API لضبط الأهداف ذات الصلة بمراحل نشاط العميل. تتيح واجهة برمجة التطبيقات Google Ads API استخدام أهداف اكتساب العميل لاكتساب عملاء جدد بكفاءة من خلال "الحملات على شبكة البحث" و"حملات الأداء الأفضل" في "إعلانات Google".

إذا كان حسابك على "إعلانات Google" يستخدِم ميزة "تتبُّع الإحالات الناجحة في جميع الحسابات"، يجب ضبط أهداف خطوات المستخدِم في حساب الإحالة الناجحة على "إعلانات Google" بدلاً من ضبطها مباشرةً في حسابك على "إعلانات Google". ومع ذلك، يجب ضبط أهداف خطوات المستخدِمين في الحملة في حسابك. يشبه ذلك الطريقة التي تديرها بها الأهداف الأخرى عند استخدام تتبُّع الإحالات الناجحة على مستوى جميع الحسابات.

ضبط أهداف مراحل نشاط العملاء

على مستوى العميل، يمكنك ضبط هدف مرحلة نشاط العميل عن طريق إنشاء ملف شخصي أو تعديله CustomerLifecycleGoal. يمكن أن يكون هناك CustomerLifecycleGoal واحد كحدٍ أقصى لكل حساب على "إعلانات Google". يحدِّد الحقل 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 لكل مجموعة من قائمة المستخدمين والفئة.

تحذير: UserListCustomerType وحقول تقسيم الجمهور في CustomerLifecycleGoal هما مورد مشترَك، ما يعني أنّ إنشاء مثيلات UserListCustomerType جديدة في الإصدار 17 سيؤدي إلى إجراء تعديلات على مثيل CustomerLifecycleGoal في الإصدار 16 والعكس صحيح. ننصحك بنقل بيانات المستخدمين إلى UserListCustomerType في الإصدار 17 في أقرب وقت ممكن.

في الإصدار 17 من Google Ads API والإصدارات اللاحقة

استخدِم رمز 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

في الإصدار 16 من Google Ads API

اضبط الحقول التالية في CustomerLifecycleGoal حسابك:

1. يشير الرمز lifecycle_goal_customer_definition_settings.existing_user_lists إلى قوائم المستخدمين التي تحتوي على عملاء حاليين.

2. يشير الحقل 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":

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