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

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

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

معالجة عمليات الإنشاء والتحديث (الإصدار 15 فقط)

في الإصدار 15 من Google Ads API، تختلف العمليات المتوفّرة في CustomerLifecycleGoalService وCampaignLifecycleGoalService قليلاً عن الخدمات الأخرى في Google Ads API. بدلاً من استخدام عمليتَي create وupdate منفصلتَين، يتضمّن الإصداران 15 CustomerLifecycleGoalOperation وCampaignLifecycleGoalOperation عملية create فقط، ويجب تحديد هدفك باستخدام update_mask على النحو التالي:

  • لإنشاء هدف دورة حياة باستخدام الإصدار 15، يجب تعبئة create بالهدف، ولكن عدم ضبط resource_name وعدم ضبط update_mask للعملية.

  • لتعديل هدف دورة حياة باستخدام الإصدار 15، يجب تعبئة create بالهدف، وضبط resource_name للهدف، وضبط update_mask لإدراج الحقول التي تريد تعديلها.

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

على مستوى العميل، يمكنك ضبط هدف مراحل النشاط من خلال إنشاء CustomerLifecycleGoal أو تعديله. يمكن إنشاء CustomerLifecycleGoal واحد على الأكثر لكل حساب على "إعلانات Google".

يحتوي هدف دورة حياة العميل على حقلين:

lifecycle_goal_customer_definition_settings

اضبط الحقل existing_user_lists للإشارة إلى قوائم المستخدمين التي تحتوي على عملاء حاليين.

يشير الحقل high_lifetime_value_user_lists إلى قوائم المستخدمين التي تحتوي على عملاء ذوي قيمة دائمة عالية. يمكنك قراءة هذا الحقل، ولكنه غير قابل للتغيير في Google Ads API.

customer_acquisition_goal_value_settings

اضبط الحقل value لتحديد تعديل القيمة الإضافي المطلوب إضافته إلى الإحالة الناجحة المتمثّلة بعملية الشراء الأولى التي يجريها العميل الجديد.

يمكنك قراءة high_lifetime_value للهدف، ولكن هذا الحقل غير قابل للتغيير في Google Ads API.

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

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