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

استخدِم مَراجِع 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 بالجمعات التالية من 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