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

استخدِم مَراجِع CustomerLifecycleGoal و CampaignLifecycleGoal الخاصة بواجهة برمجة التطبيقات Google Ads API لضبط الأهداف ذات الصلة برحلة العميل. اعتبارًا من الإصدار 15، تدعم 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 مثيل باستخدام المجموعات التالية من 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 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