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

استخدِم مَراجِع 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 لكل مجموعة من قائمة المستخدمين والفئة.

في الإصدار 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:

في الإصدار 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 والإصدارات الأقدم، والعكس بالعكس.

في ما يلي كيفية ربط الحقول في الموردَين:

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

على مستوى الحملة، يمكنك ضبط هدف مراحل النشاط من خلال إنشاء ملف شخصي أو تعديله في 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