تقارير التحسُّن

لقياس التأثير السببي لحملاتك الإعلانية في الانطباع عن العلامة التجارية والإحالات الناجحة وقيمة الإحالة الناجحة وسلوك البحث المجاني، يمكنك الاستعلام عن موارد تقارير قياس التحسّن في Google Ads API:

  • تقارير "تأثير العلامة التجارية": تقيّم هذه التقارير تأثير مدة مشاهدة الإعلان في الانطباع عن العلامة التجارية على مستوى أنواع القياس المستندة إلى استطلاعات الرأي في الإصدار 25 من Google Ads API والإصدارات الأحدث.
  • تقارير "زيادة الإحالات الناجحة": تقيس الإحالات الناجحة المتزايدة وقيمة الإحالة الناجحة والتكلفة لكل إحالة ناجحة متزايدة (iCPA) والعائد المتزايد للإنفاق الإعلاني (iROAS) مقارنةً بمجموعة مستبعَدة لم تشاهد الإعلانات في الإصدار 25 من Google Ads API والإصدارات الأحدث، بما في ذلك:
  • تقارير "زيادة البحث": تقيس هذه التقارير الزيادة المتزايدة في حجم طلبات البحث المجانية على "بحث Google" وYouTube الناتجة عن مدة مشاهدة الإعلانات في الإصدار 26 من Google Ads API والإصدارات الأحدث.

للاطّلاع على تقارير تجارب A/B العادية حول الموردَين experiment وcampaign، يُرجى مراجعة مقالة إعداد تقارير عن التجارب.

تقارير "تأثير العلامة التجارية"

لتقييم مدى تأثير حملاتك الإعلانية في الانطباع عن العلامة التجارية في الإصدار 25 من Google Ads API والإصدارات الأحدث، يمكنك الاستعلام عن موارد قياس "تأثير العلامة التجارية" المخصّصة.

مراجع "تأثير العلامة التجارية" وطرق عرض التقسيم

تكون إعدادات "تأثير العلامة التجارية" وفترات العرض وطرق العرض التفصيلية متاحة للقراءة فقط في Google Ads API (جميع الحقول هي OUTPUT_ONLY) ويتم ضبطها في واجهة مستخدم "إعلانات Google" أو من خلال ممثل عن Google أو جهة اتصال في "خدمات Google الاحترافية". يمكنك الاستعلام عن هذه الموارد باستخدام المَعلمة customer_id للحساب (الحساب الإداري أو الحساب الفرعي) الذي يملك الدراسة.

يمكنك الاستعلام عن مورد LiftMeasurementFlight لاسترداد البيانات الوصفية لجدول "تأثير العلامة التجارية" ومجموعة الاستطلاعات على مستوى الفترة، بما في ذلك حالة الفترة (lift_measurement_flight.status، المحدّدة حسب التعداد LiftMeasurementFlightStatus مع القيم ENABLED للفترات النشطة وSTOPPED للفترات التي تم إيقافها يدويًا)، ونطاقات تواريخ الفترة (lift_measurement_flight.start_date وlift_measurement_flight.end_date) في المنطقة الزمنية للعميل، ومستوى تقدّم جمع الردود على الاستطلاع المستهدف (lift_measurement_flight.survey_lift_measurement.response_collection_ratio_micros، حيث يساوي 0 %0 ويساوي 1000000 %100). لتحديد ما إذا كانت ENABLED قيد التقدّم أو مكتملة، قارِن التاريخ الحالي في المنطقة الزمنية للعميل مع lift_measurement_flight.start_date و lift_measurement_flight.end_date، وتحقَّق مما إذا كان response_collection_ratio_micros قد وصل إلى 1000000.

يمكنك الاستعلام عن المورد LiftMeasurementConfig لاسترداد مقاييس "تأثير العلامة التجارية" الإجمالية على مستوى الدراسة، أو الاستعلام عن موارد التقسيم التالية لتحليل مقاييس "تأثير العلامة التجارية" على مستوى سمات معيّنة:

أدرِج قسم segments.brand_lift_measurement_type لتقسيم مقاييس "تأثير العلامة التجارية" حسب نوع السؤال في الاستطلاع، والذي يتم تحديده من خلال تعداد BrandLiftMeasurementType (مثل RECALL أو AWARENESS). عند حذف قسم segments.brand_lift_measurement_type، تعرض واجهة برمجة التطبيقات مقاييس لنوع قياس واحد يتم اختياره تلقائيًا لكل شريحة. أدرِج قسم segments.date لتقسيم مقاييس "تأثير العلامة التجارية" حسب التاريخ (YYYY-MM-DD). يتم عرض مقياس metrics.cost_per_lifted_cookie بالوحدات الصغرى لعملة الحساب الذي يملك الدراسة.

في الإصدار 27 من Google Ads API والإصدارات الأحدث، يمكنك أيضًا اختيار حقل lift_guidance (lift_guidance.outcome وlift_guidance.guidance_message من النوع LiftGuidance) للقراءة فقط (OUTPUT_ONLY) في عبارة SELECT للغة طلب البحث في "إعلانات Google"‏ (GAQL) على lift_measurement_config وعلى موارد التقسيم الخمسة لتأثير العلامة التجارية (lift_measurement_age_range وlift_measurement_campaign وlift_measurement_device وlift_measurement_gender وlift_measurement_video) لتلقّي تفسير إحصائي على مستوى الصف. في lift_measurement_config، تتم تعبئة lift_guidance فقط عندما يختار طلب البحث أيضًا مقاييس أو شرائح "زيادة معدّل التذكّر" أو يفلترها (يتم حذفها في طلبات البحث عن الإعدادات التي تتضمّن بيانات وصفية فقط)، ويمكن أن يحتوي lift_guidance.guidance_message على روابط Markdown مضمّنة (مثل [Learn more](https://support.google.com/...)). لا يمكنك فلترة الحقول الفرعية لـ lift_guidance أو ترتيبها في عبارات WHERE أو ORDER BY. للاطّلاع على أوصاف قيم LiftOutcomeEnum.LiftOutcome التي يتم عرضها في lift_guidance.outcome، يُرجى مراجعة مقالة تفسير نتائج "تأثير العلامة التجارية".

الحدود الدنيا لإمكانية إعداد التقارير والردود الفارغة

تخضع تقارير "تأثير العلامة التجارية" لكلّ من الحدّ الأقصى المسموح به لوقت الاستجابة (يتطلّب تأخيرًا في المسار يتراوح بين 24 و48 ساعة بعد بدء الدراسة) والحدّ الأقصى المسموح به للردود لكلّ نوع قياس يتمّ استطلاعه (segments.brand_lift_measurement_type) لاستيفاء الحدّ الأدنى لعدد الردود الإحصائية والخصوصية:

  • معدّلات الإجابات الإيجابية (metrics.brand_lift_baseline_positive_response_rate* وmetrics.brand_lift_exposed_positive_response_rate*): يجب أن يتوفّر ما لا يقل عن 50 إجابة على الاستطلاع في المجموعة المقابلة (المجموعة التي شاهدت الإعلان أو المجموعة التي لم تشاهد الإعلان).
  • الحد الأدنى الصارم للتأثير الإيجابي (الدراسة الإجمالية حول LiftMeasurementConfig أو شريحة مستقلة): تأثير إيجابي من الناحية الإحصائية (p_value <= 0.50) مع إجمالي عدد ردود لا يقل عن 2,000 و860 رد لكل مجموعة.
  • الحدّ الأدنى للتأثير الإيجابي في الشريحة غير الصارمة (في مورد تفصيلي عندما تستوفي الدراسة الإجمالية الحدّ الأدنى الصارم مع تأثير إيجابي): تأثير إيجابي من الناحية الإحصائية (p_value <= 0.50) مع ما لا يقل عن 500 ردّ إجمالي و200 ردّ لكل مجموعة.
  • الحدّ الأدنى لعدد الردود في حال عدم رصد تحسُّن إيجابي (NO_SIGNIFICANT_LIFT مقابل NOT_ENOUGH_DATA): يجب الحصول على 4,100 ردّ على الأقل لكل مقياس في حال عدم رصد تحسُّن إيجابي ذي دلالة إحصائية.

إنّ طلبات البحث في LiftMeasurementConfig وموارد تفاصيل "تأثير العلامة التجارية" الخمسة (LiftMeasurementAgeRange وLiftMeasurementGender وLiftMeasurementDevice وLiftMeasurementCampaign وLiftMeasurementVideo) تُرجع ردًا فارغًا (results: []) بدلاً من خطأ في الحالات التالية:

  • مَعلمة customer_id التي تم طلبها غير مُدرَجة في القائمة المسموح بها أو لا تملك الدراسة.
  • تقع فلاتر التاريخ "WHERE" خارج تواريخ الرحلات التي تم تقييمها (lift_measurement_flight.start_date و lift_measurement_flight.end_date).
  • لم تستوفِ الدراسة أو الشريحة المحدّدة من الجمهور أو الجهاز أو الحملة أو الفيديو الحدود الدنيا لتأخير إعداد التقارير التي تتراوح بين 24 و48 ساعة وحجم الردود على الاستطلاع، حتى عندما يعرض LiftMeasurementConfig نتائج الدراسة الإجمالية.

لتحديد المشاكل وحلّها في الردود الفارغة، يُرجى اتّباع الخطوات التالية:

  1. يُرجى الاستعلام عن lift_measurement_flight للتأكّد من أنّ lift_measurement_flight.status = 'ENABLED'، والتحقّق من أنّ فلاتر تاريخ WHERE تقع ضمن lift_measurement_flight.start_date وlift_measurement_flight.end_date، وفحص مستوى تقدّم الاستطلاع في lift_measurement_flight.survey_lift_measurement.response_collection_ratio_micros (حيث يساوي 1000000 %100).
  2. يمكنك الاستعلام عن LiftMeasurementConfig للتأكّد مما إذا كانت الدراسة الإجمالية قد أنشأت مقاييس "تأثير العلامة التجارية" التي يمكن إعداد تقارير عنها قبل الاستعلام عن موارد التقسيم حسب السمات.

تفسير نتائج "تأثير العلامة التجارية"

في الإصدار 27 من Google Ads API والإصدارات الأحدث، يعرض الحقل lift_guidance.outcome قيمة LiftOutcomeEnum.LiftOutcome تصنّف الحالة الإحصائية لكل صف يتم عرضه، بالإضافة إلى نصائح يمكن لشخص عادي قراءتها حول تصدير البيانات الناقصة في lift_guidance.guidance_message:

  • نتائج الدراسة الجارية (عندما تكون قيمة lift_measurement_flight.status هي ENABLED ويكون التاريخ الحالي في المنطقة الزمنية للعميل يوافق تاريخ lift_measurement_flight.end_date أو يقع قبله مع قيمة lift_measurement_flight.survey_lift_measurement.response_collection_ratio_micros أقل من 1000000):
    • ‫STUDY_IN_PROGRESS_WITH_LIFT: الدراسة قيد التقدّم، ويظهر تأثير إيجابي أوّلي.
    • STUDY_IN_PROGRESS_NO_LIFT_YET: الدراسة قيد التنفيذ مع حجم أولي كافٍ، ولم يتم رصد أي تحسّن ذي دلالة إحصائية حتى الآن.
    • STUDY_IN_PROGRESS_COLLECTING_DATA: الدراسة قيد التقدّم وتجمع حاليًا الردود الأولية على الاستطلاع للوصول إلى الحد الأدنى المطلوب لإعداد التقارير الإحصائية.
  • نتائج الدراسة المكتملة (عندما يمرّ lift_measurement_flight.end_date أو عندما يصل lift_measurement_flight.survey_lift_measurement.response_collection_ratio_micros إلى 1000000):
    • POSITIVE_LIFT_DETECTED: تم رصد تحسُّن إيجابي ذي دلالة إحصائية للدراسة أو الشريحة المكتملة.
    • NO_SIGNIFICANT_LIFT: استوفت الدراسة أو الشريحة المكتملة الحدود الدنيا للدقة الإحصائية (ما لا يقل عن 4,100 ردّ إجمالي لكل مقياس)، ولم يتم رصد أي تحسّن إيجابي ذي دلالة إحصائية.
    • NOT_ENOUGH_DATA: لم تستوفِ الدراسة أو الشريحة المكتملة الحدّ الأدنى لعدد الردود على الاستطلاع المطلوب لإعداد التقارير الإحصائية (ما لا يقل عن 2,000 ردّ إجمالي و860 ردًّا لكل مجموعة في ما يتعلق بالتأثير الإيجابي في الدراسة الإجمالية، أو 500 ردّ إجمالي و200 ردّ لكل مجموعة في ما يتعلق بالتأثير الإيجابي في شريحة عندما يكون للدراسة الإجمالية تأثير إيجابي، أو 4,100 ردّ إجمالي لكل مقياس عندما لا يتم رصد أي تأثير إيجابي).

اتّبِع الإرشادات التالية عند تفسير نتائج "تأثير العلامة التجارية":

  • الفترات قيد التنفيذ مقابل الفترات المكتملة (STUDY_IN_PROGRESS_*): عندما تكون فترة دراسة "ENABLED" قيد التنفيذ (قبل مرور lift_measurement_flight.end_date وقبل وصول response_collection_ratio_micros إلى 1000000)، تكون الردود على الاستطلاع والنمذجة المصحَّحة من الانحياز لا تزال في مرحلة الاستقرار. يجب التعامل مع المقاييس قيد التقدّم على أنّها أولية، وتجنُّب إيقاف الحملات مؤقتًا أو خفض الميزانيات إلى أن تكتمل فترة العرض.
  • التأثير الإيجابي (POSITIVE_LIFT_DETECTED): عند رصد تأثير إيجابي للعلامة التجارية، يمكنك الاستعلام عن موارد التقسيم حسب السمات (LiftMeasurementAgeRange وLiftMeasurementGender وLiftMeasurementDevice وLiftMeasurementCampaign وLiftMeasurementVideo) لتحديد مجموعات الجمهور ذات الأداء العالي ("النقاط المضيئة") وتقييم مدى تأثير تصاميم الإعلانات في مسار التسويق للعلامة التجارية.
  • عدم كفاية البيانات أو عدم رصد تأثير ملحوظ (NOT_ENOUGH_DATA أو NO_SIGNIFICANT_LIFT): عندما يكون حجم الردود على الاستطلاع غير كافٍ (أقل من 4,100 ردّ في المجموع لكل مقياس بدون تأثير إيجابي، أو أقل من الحدود الصارمة البالغة 2,000/860 أو الحدود المرنة البالغة 500/200 لشريحة التأثير الإيجابي) أو عندما لا يتم رصد تأثير ذي دلالة إحصائية في شريحة معيّنة، لا تعتبر ذلك فشلاً للحملة أو تستبعد شرائح الجمهور استنادًا إلى عدم كفاية عيّنة الشريحة الواحدة. اطّلِع على مقاييس الدراسة الإجمالية في LiftMeasurementConfig، واستعلم عن قيم segments.brand_lift_measurement_type الأخرى التي تم استطلاعها (مثل RECALL أو AWARENESS في مسار الإحالة الناجحة العلوي)، واطّلِع على سمات التقسيم المتبقية.

أمثلة على طلبات البحث حول تأثير العلامة التجارية

بما أنّ البيانات الوصفية للحملات الموحّدة وإحصاءات التحسّن تتوفّر في موارد منفصلة، يتطلّب الاستعلام عن تفاصيل الحملات الموحّدة وإحصاءات الأداء استخدام طلبات بحث منفصلة في لغة طلب البحث في Google Ads ‏(GAQL).

طلب البحث عن تفاصيل الرحلة الجوية

لاسترداد البيانات الوصفية لحملة "تأثير العلامة التجارية"، مثل حالتها ونوع القياس والتواريخ المجدوَلة ومستوى تقدّم جمع الاستطلاعات، يمكنك إرسال طلب بحث إلى المورد LiftMeasurementFlight:

SELECT
  lift_measurement_flight.lift_measurement_config_id,
  lift_measurement_flight.lift_measurement_flight_id,
  lift_measurement_flight.name,
  lift_measurement_flight.status,
  lift_measurement_flight.lift_type,
  lift_measurement_flight.start_date,
  lift_measurement_flight.end_date,
  lift_measurement_flight.survey_lift_measurement.response_collection_ratio_micros
FROM lift_measurement_flight
WHERE lift_measurement_flight.lift_measurement_config_id = CONFIG_ID
  AND lift_measurement_flight.lift_type = 'SURVEY'

غيِّر القيم في السلسلة على الشكل التالي:

  • ‫CONFIG_ID: رقم التعريف الصحيح لإعدادات قياس التحسّن (lift_measurement_config.lift_measurement_config_id)

طلب بحث عن الإحصاءات

لاسترداد مقاييس "تأثير العلامة التجارية"، يمكنك إرسال طلب بحث عن مورد LiftMeasurementConfig أو مورد التقسيم المناسب. على سبيل المثال، يستردّ طلب البحث التالي مقاييس "تأثير العلامة التجارية" مقسّمة حسب الحملة ونوع قياس "تأثير العلامة التجارية" من المورد LiftMeasurementCampaign:

SELECT
  lift_measurement_campaign.lift_measurement_config_id,
  lift_measurement_campaign.campaign,
  segments.brand_lift_measurement_type,
  metrics.absolute_brand_lift,
  metrics.relative_brand_lift
FROM lift_measurement_campaign
WHERE lift_measurement_campaign.lift_measurement_config_id = CONFIG_ID

غيِّر القيم في السلسلة على الشكل التالي:

  • ‫CONFIG_ID: معرّف العدد الصحيح لإعدادات قياس التحسّن

إعداد تقارير عن مقياس "زيادة الإحالات الناجحة"

في الإصدار 25 من Google Ads API والإصدارات الأحدث، تقيس تقارير "زيادة الإحالات الناجحة" التأثير المتزايد لإعلاناتك على الإحالات الناجحة وقيمتها. تقارن دراسات "زيادة الإحالات الناجحة" سلوك الإحالات الناجحة بين مجموعة مشاهدي الإعلانات (المستخدمون الذين كانوا مؤهَّلين لرؤية إعلاناتك) ومجموعة التحكّم غير المشاهدة للإعلانات (المستخدمون الذين تم منعهم من رؤية إعلاناتك).

تكون إعدادات "زيادة الإحالات الناجحة" وفترات العرض وروابط التجارب متاحة للقراءة فقط في Google Ads API (جميع الحقول هي OUTPUT_ONLY) ويتم ضبطها في واجهة مستخدم "إعلانات Google" أو من خلال ممثل عن Google أو جهة اتصال في "خدمات Google الاحترافية". يمكنك الاستعلام عن مورد lift_measurement_config باستخدام مَعلمة customer_id للحساب الذي يملك الدراسة. يمكن للحساب الإداري الاستعلام مباشرةً عن دراسات "زيادة الإحالات الناجحة" التي يملكها في عدّة حسابات. يمكنك الاستعلام عن الدراسات التي يملكها حساب طفل باستخدام مَعلمة customer_id الخاصة بحساب الطفل (يمكن اختياريًا المصادقة باستخدام العنوان login-customer-id).

تتيح تقارير "زيادة الإحالات الناجحة" سيرَي عمل للدراسات، وكلاهما يتشاركان استكشاف الدراسة والفترة الزمنية والنطاقات الزمنية للّقطات التراكمية ونطاقات إجراءات الإحالات الناجحة:

  • تقارير مقياس "زيادة الإحالات الناجحة" المستقلة: تقيس هذه التقارير بشكل عام التزايد والتكلفة لكل إحالة ناجحة إضافية (iCPA) والعائد المتزايد للإنفاق الإعلاني (iROAS) على مستوى إجراءات الإحالات الناجحة المحدّدة أو جميع إجراءات الإحالات الناجحة من الحملات التي يتم قياسها في الدراسة.
  • تقارير اختبارات A/B ومقياس "زيادة الإحالات الناجحة": يقيس هذا النوع من التقارير الزيادة في الإحالات الناجحة لكل مجموعة تجربة ونتائج الفائزين وفقًا للإحصاء البايزي بين مجموعتَي تجربة متنافستَين (المجموعة الضابطة مقابل مجموعة التجربة)، بالإضافة إلى الزيادة الإجمالية في الإحالات الناجحة للدراسة.

للحصول على مساعدة في إنشاء طلبات بحث صالحة لمورد lift_measurement_config، استخدِم أداة أداة إنشاء الطلبات في "إعلانات Google".

في الإصدار 27 من Google Ads API والإصدارات الأحدث، يمكنك اختيار حقل (OUTPUT_ONLY) lift_measurement_config.lift_guidance المخصّص للقراءة فقط (lift_guidance.outcome وlift_guidance.guidance_message من النوع LiftGuidance) في عبارة SELECT ضمن GAQL في lift_measurement_config لتلقّي تفسير إحصائي على مستوى الصف لطلبات البحث المستقلة عن "زيادة الإحالات الناجحة" و"اختبار أ/ب" + "زيادة الإحالات الناجحة". في lift_measurement_config، تتم تعبئة lift_guidance فقط عندما يختار طلب البحث أيضًا مقاييس أو شرائح "زيادة" أو يفلترها (يتم حذفها في طلبات البحث عن الإعدادات التي تتضمّن بيانات وصفية فقط)، ويمكن أن يحتوي lift_guidance.guidance_message على روابط Markdown مضمّنة (مثل [Learn more](https://support.google.com/...)). لا يمكنك فلترة الحقول الفرعية لـ lift_guidance أو ترتيبها في عبارات WHERE أو ORDER BY. يعرض الحقل lift_guidance.outcome إحدى قيم LiftOutcomeEnum.LiftOutcome التالية:

  • نتائج الدراسة قيد التقدّم (عندما تكون قيمة lift_measurement_flight.status هي ENABLED ويكون التاريخ الحالي في المنطقة الزمنية للعميل يوافق تاريخ lift_measurement_flight.end_date أو يقع قبله):
    • ‫STUDY_IN_PROGRESS_WITH_LIFT: الدراسة قيد التقدّم، ويظهر تأثير إيجابي أوّلي.
    • STUDY_IN_PROGRESS_NO_LIFT_YET: الدراسة قيد التنفيذ مع حجم أولي كافٍ، ولم يتم رصد أي تحسّن ذي دلالة إحصائية حتى الآن.
    • STUDY_IN_PROGRESS_COLLECTING_DATA: الدراسة قيد التقدّم ويتم جمع بيانات الإحالات الناجحة الأولية بشكل نشط للوصول إلى الحد الأدنى لإعداد التقارير الإحصائية.
  • نتائج الدراسة المكتملة (بعد مرور lift_measurement_flight.end_date):
    • ‫POSITIVE_LIFT_DETECTED: تم رصد تأثير إيجابي ذي دلالة إحصائية للدراسة أو مجموعة التجربة أو الشريحة المكتملة.
    • ‫AB_WINNER_WITH_LIFT: دراسة اختبار أ/ب + مقياس "زيادة الإحالات الناجحة" تم إكمالها من خلال مجموعة تجربة فائزة في مقارنة مباشرة وتحسّن إيجابي ذي دلالة إحصائية مقارنةً بالمجموعة الضابطة التي لم تشاهد الإعلانات
    • ‫AB_WINNER_PARITY_VS_CONTROL: تم إكمال دراسة اختبار أ/ب ومقياس "زيادة الإحالات الناجحة" مع مجموعة تجريبية فائزة في مقارنة مباشرة، ولكنها متساوية مع المجموعة الضابطة غير المعرَّضة للإعلانات.
    • ‫NO_SIGNIFICANT_LIFT: استوفت الدراسة المكتملة أو مجموعة التجربة أو الشريحة حدود الدقة الإحصائية، ولم يتم رصد أي تأثير إيجابي ذو دلالة إحصائية.
    • NOT_ENOUGH_DATA: لم تحقّق الدراسة أو مجموعة التجربة أو الشريحة المكتملة عددًا كافيًا من الإحالات الناجحة للوصول إلى حدود الدقة الإحصائية.

التعرّف على إعدادات الدراسة والرحلات

لإعداد تقرير عن دراسة "زيادة الإحالات الناجحة"، عليك أولاً الاطّلاع على إعدادات الدراسة وجدول عرضها:

  1. استرداد إعدادات الدراسة: يمكنك الاستعلام عن مورد LiftMeasurementConfig لاسترداد اسم الدراسة ونسبة المجموعة الضابطة (lift_measurement_config.conversion_lift_holdback_ratio_micros) وإجراءات الإحالات الناجحة التي يتم تتبّعها (lift_measurement_config.conversion_actions) والحملات المرتبطة بشكل نشط (lift_measurement_config.campaigns) في الإصدار 26 من Google Ads API والإصدارات الأحدث. يتم التعبير عن الحقل conversion_lift_holdback_ratio_micros بالوحدات الصغيرة حيث يساوي 1,000,000 نسبة %100 (على سبيل المثال، يمثّل 300000 مجموعة ضابطة غير معرَّضة بنسبة %30). إذا لم تكن تعرف CONFIG_ID الدراسة، يمكنك حذف عبارة WHERE لسرد جميع إعدادات الدراسة في الحساب.
  2. استرداد الفترات الزمنية لمراقبة الرحلات الجوية: يمكنك الاستعلام عن المورد LiftMeasurementFlight للعثور على تواريخ الرحلات الجوية المجدولة (lift_measurement_flight.start_date وlift_measurement_flight.end_date) في المنطقة الزمنية للعميل. بما أنّ مورد LiftMeasurementConfig واحد يمكنه تجميع فترات عرض إعلانات "تأثير العلامة التجارية" (SURVEY) و"مقياس زيادة الإحالات الناجحة" (CONVERSION) و"مقياس زيادة البحث" (SEARCH)، يجب تضمين الحقل lift_measurement_flight.lift_type في عبارة SELECT والفلترة حسب lift_measurement_flight.lift_type = 'CONVERSION' في عبارة WHERE. يمكن ترتيب الحقلَين lift_measurement_flight.start_date وlift_measurement_flight.end_date في عبارات ORDER BY، ولكن لا يمكنك فلترتهما في عبارة WHERE.

يستردّ طلب البحث التالي إعدادات الدراسة (يُرجى حذف الحقل lift_measurement_config.campaigns في الإصدار 25 من Google Ads API، لأنّ هذا الحقل يتطلّب الإصدار 26 من Google Ads API والإصدارات الأحدث):

SELECT
  lift_measurement_config.lift_measurement_config_id,
  lift_measurement_config.name,
  lift_measurement_config.conversion_lift_holdback_ratio_micros,
  lift_measurement_config.conversion_actions,
  lift_measurement_config.campaigns
FROM lift_measurement_config
WHERE lift_measurement_config.lift_measurement_config_id = CONFIG_ID

غيِّر القيم في السلسلة على الشكل التالي:

  • ‫CONFIG_ID: رقم التعريف الصحيح لإعدادات قياس التحسّن (lift_measurement_config.lift_measurement_config_id)

يستردّ طلب البحث التالي جدول عرض دراسة "زيادة الإحالات الناجحة":

SELECT
  lift_measurement_flight.lift_measurement_config_id,
  lift_measurement_flight.lift_measurement_flight_id,
  lift_measurement_flight.name,
  lift_measurement_flight.status,
  lift_measurement_flight.lift_type,
  lift_measurement_flight.start_date,
  lift_measurement_flight.end_date
FROM lift_measurement_flight
WHERE lift_measurement_flight.lift_measurement_config_id = CONFIG_ID
  AND lift_measurement_flight.lift_type = 'CONVERSION'

غيِّر القيم في السلسلة على الشكل التالي:

  • ‫CONFIG_ID: رقم التعريف الصحيح لإعدادات قياس التحسّن (lift_measurement_config.lift_measurement_config_id)

في الإصدار 26 من Google Ads API والإصدارات الأحدث، يمكنك أيضًا الاطّلاع على إعدادات قياس التحسّن المرتبطة بحملة معيّنة مباشرةً من المورد campaign من خلال طلب البحث في الحقل campaign.lift_measurement_config. يؤدي الاستعلام عن هذا الحقل إلى تجنُّب المقارنة بين مصادر بيانات متعددة لمورد LiftMeasurementConfig بشكل منفصل:

SELECT
  campaign.id,
  campaign.lift_measurement_config
FROM campaign
WHERE campaign.id = CAMPAIGN_ID

غيِّر القيم في السلسلة على الشكل التالي:

  • ‫CAMPAIGN_ID: رقم التعريف الصحيح للحملة (campaign.id).

يعرض الحقل campaign.lift_measurement_config اسم مورد بالتنسيق customers/CUSTOMER_ID/liftMeasurementConfigs/CONFIG_ID. إذا شاركت حملة في دراسات تأثير متعددة، يحدّد هذا الحقل الإعدادات المرتبطة مؤخرًا (النشطة أو غير النشطة). في المقابل، لا يتضمّن الحقل lift_measurement_config.campaigns سوى الحملات المرتبطة بشكل نشط.

الاستعلام عن النطاقات الزمنية للّقطات التراكمية

يتم تنظيم نتائج مقياس "زيادة الإحالات الناجحة" على شكل لقطات تقييم تراكمية يومية بدءًا من تاريخ بدء العرض:

كلّ من segments.conversion_lift_start_date وsegments.conversion_lift_end_date هما حقلان من النوع INT64 تم تنسيقهما كأعداد صحيحة مكوّنة من 8 أرقام بدون علامات اقتباس وبدون واصلات بتنسيق YYYYMMDD (على سبيل المثال، 20260501). في المقابل، يعرض الحقلان lift_measurement_flight.start_date وlift_measurement_flight.end_date سلاسل تاريخ بتنسيق ISO 8601 YYYY-MM-DD (على سبيل المثال، 2026-05-01). وعلى عكس طلبات البحث عن تأثير العلامة التجارية ومقياس "زيادة البحث"، لا تتوافق الشريحة segments.date مع جميع مقاييس وشرائح مقياس "زيادة الإحالات الناجحة". يؤدي اختيار شريحة segments.date إلى جانب شرائح "زيادة الإحالات الناجحة" (مثل segments.conversion_lift_start_date) في عبارة SELECT إلى ظهور خطأ QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE، في حين أنّ دمج segments.date مع مقاييس "زيادة الإحالات الناجحة" يؤدي إلى ظهور خطأ QueryError.PROHIBITED_SEGMENT_WITH_METRIC_IN_SELECT_OR_WHERE_CLAUSE.

قد تتأخر أحدث لقطة محسوبة عن تاريخ انتهاء الحملة النشطة أثناء معالجة البيانات. يجب دائمًا الاستعلام عن مورد lift_measurement_config للحصول على أزواج (segments.conversion_lift_start_date, segments.conversion_lift_end_date) المتاحة مرتبة حسب segments.conversion_lift_end_date DESC أولاً لتحديد أحدث لقطة تم تقييمها.

يستردّ طلب البحث التالي النطاقات الزمنية المتاحة للّقطات في دراسة معيّنة:

SELECT
  segments.conversion_lift_start_date,
  segments.conversion_lift_end_date,
  segments.conversion_lift_included_conversion_action_types
FROM lift_measurement_config
WHERE lift_measurement_config.lift_measurement_config_id = CONFIG_ID
  AND segments.conversion_lift_included_conversion_action_types = 'SELECTED'
ORDER BY segments.conversion_lift_end_date DESC

غيِّر القيم في السلسلة على الشكل التالي:

  • ‫CONFIG_ID: معرّف العدد الصحيح لإعدادات قياس التحسّن

الفلترة حسب نطاق إجراء الإحالة الناجحة

يقيّم مقياس "زيادة الإحالات الناجحة" التزايد على مستوى نطاقَين يحدّدهما القسم segments.conversion_lift_included_conversion_action_types:

  • ‫SELECTED: إجراءات الإحالات الناجحة التي تم اختيارها أثناء إعداد الدراسة، أو جميع إجراءات الإحالات الناجحة (الأساسية) التي يمكن تقديم عروض أسعار لها في حال عدم تحديد إجراءات إحالات ناجحة مخصّصة.
  • ALL: جميع إجراءات الإحالات الناجحة من الحملات التي يتم قياسها في الدراسة.

عند طلب بيانات المورد lift_measurement_config للحصول على مقاييس "زيادة الإحالات الناجحة" بدون الفلترة حسب القسم segments.conversion_lift_included_conversion_action_types، تعرض واجهة برمجة التطبيقات صفَّين لكل شريحة، أحدهما لـ ALL والآخر لـ SELECTED. في GAQL، يجب أن يظهر أيضًا في عبارة SELECT أي حقل تقسيم غير مرتبط بالتاريخ (وأي قسم تاريخ للقطة مقياس "زيادة الإحالات الناجحة") تمّت فلترته في عبارة WHERE. وإلا، ستعرض واجهة برمجة التطبيقات الخطأ QueryError.EXPECTED_REFERENCED_FIELD_IN_SELECT_CLAUSE. عند الفلترة حسب segments.conversion_lift_included_conversion_action_types = 'SELECTED' في عبارة WHERE، يجب تضمين هذه الشريحة في عبارة SELECT.

تقارير مستقلة عن "زيادة الإحالات الناجحة"

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

الاستعلام عن مقياس "زيادة الإحالات الناجحة" والتكلفة الزائدة للإجراء (iCPA)

تُظهر تقارير "زيادة الإحالات الناجحة" تقديرات النقاط إلى جانب حدود الثقة الأحادية الجانب بنسبة %90 (*_p90_lower_bound و*_p90_upper_bound، اللذان يشكّلان معًا فاصل ثقة ثنائي الجانب بنسبة %80) والقيم الاحتمالية (p_value <= 0.10 يتوافق مع دلالة إحصائية أحادية الجانب بنسبة %90):

تتجاهل واجهة برمجة التطبيقات مقاييس "زيادة الإحالات الناجحة" في الصفوف المعروضة في الحالات التالية:

  • إذا كانت نافذة اللقطة الشاملة أقل من 4 أيام.
  • حجم الإحالات الناجحة التي تم قياسها غير الموسّعة أقل من الحدّ الأدنى لدقة العتبات (أقل من 65 إحالة ناجحة تم قياسها في مجموعة الاستبعاد أو أقل من 150 إحالة ناجحة تم قياسها للمجموعة التي شاهدت الإعلانات، ويتم تقييمها قبل تحجيم metrics.conversion_lift_baseline_conversions).
  • التأثير المقاس غير إيجابي (metrics.incremental_conversions_p_value > 0.5 لمقاييس الإحالات الناجحة، أو metrics.incremental_conversion_value_p_value > 0.5 لمقاييس قيمة الإحالة الناجحة).
  • في الإصدار 27 من Google Ads API والإصدارات الأحدث، يتم الاستعلام عن مقاييس عائد الإنفاق الإعلاني المتزايد (iROAS) (metrics.incremental_conversion_value_per_cost*) ومقاييس نتيجة الفائز بقيمة الإحالة الناجحة (metrics.incremental_conversion_value_winner_score وmetrics.incremental_conversion_value_per_cost_winner_score) في دراسة تم ضبطها أثناء الإعداد باستخدام عدد الإحالات الناجحة بدلاً من قيمة الإحالة الناجحة كمقياس أساسي. تظلّ مقاييس قيمة الإحالة الناجحة غير المرتبطة بالتكلفة (metrics.conversion_lift_baseline_conversion_value وmetrics.conversion_lift_exposed_conversion_value وmetrics.incremental_conversion_value* وmetrics.relative_conversion_value_lift*) معروضة في الدراسات الأساسية لعدد الإحالات الناجحة عندما يكون من الممكن إعداد تقارير عن تحسُّن قيمة الإحالة الناجحة.
  • يتم تجميع صفوف أو دراسات متعددة لأنّك حذفت الحقول lift_measurement_config.lift_measurement_config_id أو segments.conversion_lift_start_date أو segments.conversion_lift_end_date أو segments.conversion_lift_included_conversion_action_types من بند SELECT.

يُرجى اتّباع الإرشادات التالية عند تفسير نتائج مقياس "زيادة الإحالات الناجحة" المستقل:

  • الفترات قيد التنفيذ مقابل الفترات المكتملة (STUDY_IN_PROGRESS_*): عندما تكون فترة دراسة ENABLED لا تزال قيد التنفيذ (عندما يكون التاريخ الحالي في المنطقة الزمنية للعميل يوافق lift_measurement_flight.end_date أو يسبقه)، لا تزال عملية وضع نماذج للإحالات الناجحة في المجموعة الضابطة والمجموعة التجريبية وعملية تحديد مصدر الإحالات الناجحة المتأخرة في مرحلة الاستقرار. يجب التعامل مع المقاييس قيد التقدّم على أنّها أولية، وتجنُّب إيقاف الحملات مؤقتًا أو خفض الميزانيات إلى أن تكتمل فترة العرض.
  • التحسّن الإيجابي (POSITIVE_LIFT_DETECTED): يتم تفعيل إمكانية تسجيل مقياس "زيادة الإحالات الناجحة" في التقارير وlift_guidance.outcome = 'POSITIVE_LIFT_DETECTED' كلما كان التحسّن الذي تم قياسه إيجابيًا (p_value <= 0.50، ما يتوافق مع نسبة تأكّد تبلغ %50 على الأقل مع تقدير نقطة إيجابية، في حين يشير p_value <= 0.10 إلى دلالة إحصائية أحادية الجانب بنسبة %90 حيث *_p90_lower_bound >= 0) ويتم استيفاء الحد الأدنى من الدقة (4 أيام على الأقل من اللقطات، و65 إحالة ناجحة على الأقل في المجموعة المرجعية غير الموسّعة، و150 إحالة ناجحة على الأقل في المجموعة التي شاهدت الإعلانات غير الموسّعة). عند رصد تأثير إيجابي، يمكنك الاستعلام عن التقسيمات حسب السمات (الخصائص الديمغرافية أو الجهاز أو البلد أو فئة الإحالة الناجحة وإجراء الإحالة الناجحة) لتحديد المجموعات النموذجية العالية الأداء ("النقاط المضيئة").
  • بيانات غير كافية أو عدم رصد تحسُّن كبير (NOT_ENOUGH_DATA أو NO_SIGNIFICANT_LIFT): عندما يكون حجم البيانات غير كافٍ (أقل من 65 إحالة ناجحة أساسية غير معدَّلة أو أقل من 150 إحالة ناجحة غير معدَّلة للمجموعة التي شاهدت الإعلانات) أو عندما لا يتم رصد أي تحسُّن ذي دلالة إحصائية في شريحة معيّنة، لا تعتبر ذلك فشلاً للحملة أو تستبعد شرائح الجمهور استنادًا إلى عدم كفاية عيّنة الشريحة الواحدة. تحقَّق من مقاييس الدراسة الإجمالية وطلب البحث segments.conversion_lift_included_conversion_action_types = 'ALL' (إذا لم يُظهر SELECTED أي تحسُّن) أو التقسيمات المتبقية حسب السمات للتحقّق مما إذا كان التحسُّن الإيجابي قد تم عزله في مكان آخر.

يستردّ طلب البحث التالي إجمالي الإحالات الناجحة المتزايدة وحدود الثقة والتكلفة الزائدة للإجراء:

SELECT
  lift_measurement_config.lift_measurement_config_id,
  segments.conversion_lift_start_date,
  segments.conversion_lift_end_date,
  segments.conversion_lift_included_conversion_action_types,
  metrics.conversion_lift_baseline_conversions,
  metrics.conversion_lift_exposed_conversions,
  metrics.incremental_conversions,
  metrics.incremental_conversions_p90_lower_bound,
  metrics.incremental_conversions_p90_upper_bound,
  metrics.incremental_conversions_p_value,
  metrics.cost_per_incremental_conversion,
  metrics.cost_per_incremental_conversion_p90_lower_bound,
  metrics.cost_per_incremental_conversion_p90_upper_bound,
  metrics.relative_conversion_lift,
  metrics.relative_conversion_lift_p90_lower_bound,
  metrics.relative_conversion_lift_p90_upper_bound
FROM lift_measurement_config
WHERE lift_measurement_config.lift_measurement_config_id = CONFIG_ID
  AND segments.conversion_lift_start_date = START_DATE
  AND segments.conversion_lift_end_date = END_DATE
  AND segments.conversion_lift_included_conversion_action_types = 'SELECTED'

غيِّر القيم في السلسلة على الشكل التالي:

  • ‫CONFIG_ID: معرّف العدد الصحيح لإعدادات قياس التحسّن
  • ‫START_DATE: تاريخ بدء اللقطة كعدد صحيح YYYYMMDD مكوّن من 8 أرقام بدون علامات اقتباس (على سبيل المثال، 20260501).
  • ‫END_DATE: تاريخ انتهاء اللقطة كعدد صحيح مكوّن من 8 أرقام YYYYMMDD بدون علامات اقتباس (على سبيل المثال، 20260515).

الاستعلام عن زيادة قيمة الإحالة الناجحة والعائد المتزايد للإنفاق الإعلاني

لتقييم الإيرادات المتزايدة الناتجة عن إنفاقك الإعلاني، يمكنك طلب مقاييس قيمة الإحالة الناجحة ومقياس metrics.incremental_conversion_value_per_cost. تتم تعبئة مقاييس قيمة الإحالة الناجحة غير المرتبطة بالتكلفة (metrics.conversion_lift_baseline_conversion_value وmetrics.conversion_lift_exposed_conversion_value وmetrics.incremental_conversion_value* وmetrics.relative_conversion_value_lift*) عندما تتضمّن الدراسة زيادة في قيمة الإحالة الناجحة يمكن تسجيلها، بغض النظر عمّا إذا كان المقياس الأساسي للدراسة هو عدد الإحالات الناجحة أو قيمة الإحالة الناجحة. في الإصدار 27 من Google Ads API والإصدارات الأحدث، لا يتم عرض مقاييس عائد الإنفاق الإعلاني المتزايد (metrics.incremental_conversion_value_per_cost*) مع metrics.incremental_conversion_value_winner_score وmetrics.incremental_conversion_value_per_cost_winner_score إلا عند ضبط الدراسة أثناء الإعداد باستخدام قيمة الإحالة الناجحة كمقياس أساسي (ويتم حذفها في الدراسات التي تستخدم عدد الإحالات الناجحة كمقياس أساسي):

يستردّ طلب البحث التالي تزايد قيمة الإحالة الناجحة وحدود الثقة والعائد المتزايد للإنفاق الإعلاني:

SELECT
  lift_measurement_config.lift_measurement_config_id,
  segments.conversion_lift_start_date,
  segments.conversion_lift_end_date,
  segments.conversion_lift_included_conversion_action_types,
  metrics.conversion_lift_baseline_conversion_value,
  metrics.conversion_lift_exposed_conversion_value,
  metrics.incremental_conversion_value,
  metrics.incremental_conversion_value_p90_lower_bound,
  metrics.incremental_conversion_value_p90_upper_bound,
  metrics.incremental_conversion_value_p_value,
  metrics.incremental_conversion_value_per_cost,
  metrics.incremental_conversion_value_per_cost_p90_lower_bound,
  metrics.incremental_conversion_value_per_cost_p90_upper_bound,
  metrics.relative_conversion_value_lift,
  metrics.relative_conversion_value_lift_p90_lower_bound,
  metrics.relative_conversion_value_lift_p90_upper_bound
FROM lift_measurement_config
WHERE lift_measurement_config.lift_measurement_config_id = CONFIG_ID
  AND segments.conversion_lift_start_date = START_DATE
  AND segments.conversion_lift_end_date = END_DATE
  AND segments.conversion_lift_included_conversion_action_types = 'SELECTED'

غيِّر القيم في السلسلة على الشكل التالي:

  • ‫CONFIG_ID: معرّف العدد الصحيح لإعدادات قياس التحسّن
  • ‫START_DATE: تاريخ بدء اللقطة كعدد صحيح YYYYMMDD مكوّن من 8 أرقام بدون علامات اقتباس (على سبيل المثال، 20260501).
  • ‫END_DATE: تاريخ انتهاء اللقطة كعدد صحيح مكوّن من 8 أرقام YYYYMMDD بدون علامات اقتباس (على سبيل المثال، 20260515).

تقسيم النتائج حسب السمة

يمكنك تقسيم مقاييس الإحالات الناجحة المتزايدة حسب فئة الإحالة الناجحة أو إجراء الإحالة الناجحة أو الخصائص الديمغرافية أو الجهاز أو الموقع الجغرافي. عند طلب البحث عن المورد lift_measurement_config، اختَر فقط مجموعات الشرائح المتوافقة:

  • شرائح فئة الإحالة الناجحة وإجراء الإحالة الناجحة: يمكنك اختيار شرائح segments.conversion_lift_conversion_category وsegments.conversion_action وsegments.conversion_action_name بشكل فردي أو إقرانها ببعضها أو دمجها مع سمة واحدة على الأكثر تتعلّق بالخصائص الديمغرافية أو الجهاز أو البلد. (عند الاستعلام عن شريحة segments.experiment_arm، تكون شريحة segments.conversion_lift_conversion_category فقط متوافقة.)
  • الشرائح الديمغرافية وشرائح الأجهزة والشرائح الجغرافية: سمات segments.age_range وsegments.gender وsegments.device والبلد (segments.country مع segments.country_localized_name) غير متوافقة مع بعضها ومع شريحة segments.experiment_arm. اختَر سمة واحدة على الأكثر من هذه السمات الأربع لكل طلب بحث.

يؤدي اختيار شرائح غير متوافقة مع بعضها في عبارة SELECT إلى تعذُّر التحقّق من صحة طلب البحث وظهور الخطأ QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE. استخدِم أداة إنشاء الطلبات في "إعلانات Google" للتحقّق من صحة مجموعات الشرائح بشكل تفاعلي.

تقييم مقاييس فعالية التكلفة (metrics.cost_per_incremental_conversion* وmetrics.incremental_conversion_value_per_cost*) في صفوف الدراسة الإجمالية أو صفوف segments.experiment_arm فقط في الإصدارَين 25 و26 من Google Ads API، يسمح المخطّط باختيار مقاييس نسبة التكلفة الستة (metrics.cost_per_incremental_conversion وmetrics.cost_per_incremental_conversion_p90_lower_bound وmetrics.cost_per_incremental_conversion_p90_upper_bound وmetrics.incremental_conversion_value_per_cost وmetrics.incremental_conversion_value_per_cost_p90_lower_bound وmetrics.incremental_conversion_value_per_cost_p90_upper_bound) مع شرائح التقسيم الثمانية غير المرتبطة بالمجموعة التجريبية (segments.conversion_action وsegments.conversion_action_name وsegments.conversion_lift_conversion_category وsegments.age_range وsegments.gender وsegments.device وsegments.country وsegments.country_localized_name). اعتبارًا من الإصدار 27 من Google Ads API، يؤدي اختيار أيّ من مقاييس نسبة التكلفة الستة هذه مع أيّ من شرائح التقسيم الثمانية غير المرتبطة بالمجموعة التجريبية إلى تعذُّر التحقّق من صحة طلب البحث وظهور الخطأ QueryError.PROHIBITED_SEGMENT_WITH_METRIC_IN_SELECT_OR_WHERE_CLAUSE. ستبقى مقاييس قيمة الإحالة الناجحة غير المرتبطة بالتكلفة (metrics.conversion_lift_baseline_conversion_value وmetrics.conversion_lift_exposed_conversion_value وmetrics.incremental_conversion_value* وmetrics.relative_conversion_value_lift*) متاحة في شرائح فئة الإحالة الناجحة وإجراء الإحالة الناجحة والخصائص الديمغرافية والجهاز والبلد عندما يكون من الممكن إعداد تقارير عن تحسُّن قيمة الإحالة الناجحة (بغض النظر عمّا إذا كان المقياس الأساسي للدراسة هو عدد الإحالات الناجحة أو قيمة الإحالة الناجحة).

لتقييم التحسّن في فئات الإحالات الناجحة المحدّدة في تعداد ConversionActionCategory (مثل PURCHASE أو SIGNUP أو SUBMIT_LEAD_FORM)، يمكنك تقسيم النتائج حسب قسم segments.conversion_lift_conversion_category:

SELECT
  lift_measurement_config.lift_measurement_config_id,
  segments.conversion_lift_start_date,
  segments.conversion_lift_end_date,
  segments.conversion_lift_included_conversion_action_types,
  segments.conversion_lift_conversion_category,
  metrics.conversion_lift_baseline_conversions,
  metrics.conversion_lift_exposed_conversions,
  metrics.incremental_conversions,
  metrics.relative_conversion_lift
FROM lift_measurement_config
WHERE lift_measurement_config.lift_measurement_config_id = CONFIG_ID
  AND segments.conversion_lift_start_date = START_DATE
  AND segments.conversion_lift_end_date = END_DATE
  AND segments.conversion_lift_included_conversion_action_types = 'SELECTED'

غيِّر القيم في السلسلة على الشكل التالي:

  • ‫CONFIG_ID: معرّف العدد الصحيح لإعدادات قياس التحسّن
  • ‫START_DATE: تاريخ بدء اللقطة كعدد صحيح YYYYMMDD مكوّن من 8 أرقام بدون علامات اقتباس (على سبيل المثال، 20260501).
  • ‫END_DATE: تاريخ انتهاء اللقطة كعدد صحيح مكوّن من 8 أرقام YYYYMMDD بدون علامات اقتباس (على سبيل المثال، 20260515).

تعرض شريحة segments.conversion_action اسم مورد إجراء الإحالة الناجحة بالتنسيق customers/CUSTOMER_ID/conversionActions/CONVERSION_ACTION_ID. اختَر شريحة segments.conversion_action_name في مورد lift_measurement_config لاسترداد أسماء إجراءات الإحالات الناجحة التي يمكن لشخص عادي قراءتها بدون طلب البحث في مورد conversion_action بشكل منفصل. يُقسِّم طلب البحث التالي مقاييس "زيادة الإحالات الناجحة" حسب إجراء الإحالة الناجحة واسم إجراء الإحالة الناجحة وفئة الإحالة الناجحة:

SELECT
  lift_measurement_config.lift_measurement_config_id,
  segments.conversion_lift_start_date,
  segments.conversion_lift_end_date,
  segments.conversion_lift_included_conversion_action_types,
  segments.conversion_action,
  segments.conversion_action_name,
  segments.conversion_lift_conversion_category,
  metrics.conversion_lift_baseline_conversions,
  metrics.conversion_lift_exposed_conversions,
  metrics.incremental_conversions,
  metrics.relative_conversion_lift
FROM lift_measurement_config
WHERE lift_measurement_config.lift_measurement_config_id = CONFIG_ID
  AND segments.conversion_lift_start_date = START_DATE
  AND segments.conversion_lift_end_date = END_DATE
  AND segments.conversion_lift_included_conversion_action_types = 'SELECTED'

غيِّر القيم في السلسلة على الشكل التالي:

  • ‫CONFIG_ID: معرّف العدد الصحيح لإعدادات قياس التحسّن
  • ‫START_DATE: تاريخ بدء اللقطة كعدد صحيح YYYYMMDD مكوّن من 8 أرقام بدون علامات اقتباس (على سبيل المثال، 20260501).
  • ‫END_DATE: تاريخ انتهاء اللقطة كعدد صحيح مكوّن من 8 أرقام YYYYMMDD بدون علامات اقتباس (على سبيل المثال، 20260515).

يُقسّم طلب البحث التالي مقاييس "زيادة الإحالات الناجحة" حسب شريحة segments.device. استبدِل شريحة segments.age_range أو segments.gender في طلبات منفصلة لاسترداد التقسيمات الديمغرافية (يمكن دمجها اختياريًا مع شرائح فئة الإحالة الناجحة أو إجراء الإحالة الناجحة):

SELECT
  lift_measurement_config.lift_measurement_config_id,
  segments.conversion_lift_start_date,
  segments.conversion_lift_end_date,
  segments.conversion_lift_included_conversion_action_types,
  segments.device,
  metrics.conversion_lift_baseline_conversions,
  metrics.conversion_lift_exposed_conversions,
  metrics.incremental_conversions,
  metrics.relative_conversion_lift
FROM lift_measurement_config
WHERE lift_measurement_config.lift_measurement_config_id = CONFIG_ID
  AND segments.conversion_lift_start_date = START_DATE
  AND segments.conversion_lift_end_date = END_DATE
  AND segments.conversion_lift_included_conversion_action_types = 'SELECTED'

غيِّر القيم في السلسلة على الشكل التالي:

  • ‫CONFIG_ID: معرّف العدد الصحيح لإعدادات قياس التحسّن
  • ‫START_DATE: تاريخ بدء اللقطة كعدد صحيح YYYYMMDD مكوّن من 8 أرقام بدون علامات اقتباس (على سبيل المثال، 20260501).
  • ‫END_DATE: تاريخ انتهاء اللقطة كعدد صحيح مكوّن من 8 أرقام YYYYMMDD بدون علامات اقتباس (على سبيل المثال، 20260515).

لتقسيم النتائج حسب الموقع الجغرافي، أدرِج شريحتَي segments.country وsegments.country_localized_name (يمكنك اختياريًا دمجهما مع شريحة فئة الإحالة الناجحة أو شريحة إجراء الإحالة الناجحة). تعرض الشريحة segments.country اسم مورد ثابتًا للموقع الجغرافي المستهدف على مستوى العالم بالتنسيق geoTargetConstants/CRITERION_ID (على سبيل المثال، geoTargetConstants/2840 للولايات المتحدة).

يُقسِّم طلب البحث التالي مقاييس "زيادة الإحالات الناجحة" حسب اسم مورد معيار البلد واسم البلد المترجَم:

SELECT
  lift_measurement_config.lift_measurement_config_id,
  segments.conversion_lift_start_date,
  segments.conversion_lift_end_date,
  segments.conversion_lift_included_conversion_action_types,
  segments.country,
  segments.country_localized_name,
  metrics.conversion_lift_baseline_conversions,
  metrics.conversion_lift_exposed_conversions,
  metrics.incremental_conversions,
  metrics.relative_conversion_lift
FROM lift_measurement_config
WHERE lift_measurement_config.lift_measurement_config_id = CONFIG_ID
  AND segments.conversion_lift_start_date = START_DATE
  AND segments.conversion_lift_end_date = END_DATE
  AND segments.conversion_lift_included_conversion_action_types = 'SELECTED'

غيِّر القيم في السلسلة على الشكل التالي:

  • ‫CONFIG_ID: معرّف العدد الصحيح لإعدادات قياس التحسّن
  • ‫START_DATE: تاريخ بدء اللقطة كعدد صحيح YYYYMMDD مكوّن من 8 أرقام بدون علامات اقتباس (على سبيل المثال، 20260501).
  • ‫END_DATE: تاريخ انتهاء اللقطة كعدد صحيح مكوّن من 8 أرقام YYYYMMDD بدون علامات اقتباس (على سبيل المثال، 20260515).

تقارير اختبارات A/B ومقياس "زيادة الإحالات الناجحة"

في الإصدار 25 من Google Ads API والإصدارات الأحدث، تجمع دراسات اختبار A/B ومقياس "زيادة الإحالات الناجحة" بين تجربة من مجموعتَين (مقارنة استراتيجيات التحكّم مقابل استراتيجيات المعالجة) وقياس مجموعة الاستبعاد في Google Ads API لتقييم تزايد كل مجموعة واحتساب نتائج الفائزين وفقًا لنموذج بايزي. على عكس إعداد تقارير التجارب المباشرة في المورد experiment، والذي يقارن بين مقاييس عدد الزيارات غير المعدّلة لكل مجموعة تجربة، فإنّ الاستعلام عن المورد lift_measurement_config باستخدام الشريحة segments.experiment_arm يقيس التحسّن المتزايد لكل مجموعة تجربة مقارنةً بمجموعة مرجعية غير معرَّضة للإعلانات.

استكشاف التجارب ومجموعاتها

تربط دراسة "اختبار أ/ب" و"مقياس زيادة الإحالات الناجحة" مورد LiftMeasurementConfig بمورد experiment يتضمّن مجموعتَين من خلال الحقل (OUTPUT_ONLY) experiment.lift_measurement_config المخصّص للقراءة فقط.

للاطّلاع على التجربة المرتبطة ومجموعاتها في طلب واحد، يمكنك الاستعلام عن مورد ExperimentArm باستخدام حقول experiment المنسوبة والفلترة حسب حقل experiment.lift_measurement_config. يتضمّن الردّ حالة التحكّم لكل مجموعة (experiment_arm.control) وتقسيم عدد الزيارات (experiment_arm.traffic_split) والحملات المرتبطة (experiment_arm.campaigns) واسم المورد. استخدِم قيمة experiment_arm.resource_name التي تم عرضها (بتنسيق customers/CUSTOMER_ID/experimentArms/EXPERIMENT_ID~ARM_ID) للفلترة حسب شريحة segments.experiment_arm:

SELECT
  experiment.experiment_id,
  experiment.name,
  experiment.lift_measurement_config,
  experiment_arm.resource_name,
  experiment_arm.name,
  experiment_arm.control,
  experiment_arm.traffic_split,
  experiment_arm.campaigns
FROM experiment_arm
WHERE experiment.lift_measurement_config =
  'customers/CUSTOMER_ID/liftMeasurementConfigs/CONFIG_ID'

غيِّر القيم في السلسلة على الشكل التالي:

  • ‫CUSTOMER_ID: رقم تعريف العميل المكوّن من 10 أرقام للحساب الذي يملك الدراسة (بدون واصلات)
  • ‫CONFIG_ID: معرّف العدد الصحيح لإعدادات قياس التحسّن

إذا بدأت من EXPERIMENT_ID معروف (أو أردت إدراج جميع التجارب التي تم تفعيل التحسُّن فيها في الحساب)، نفِّذ طلب البحث experiment_arm نفسه الذي تمت فلترته حسب WHERE experiment.experiment_id = EXPERIMENT_ID (أو WHERE experiment.lift_measurement_config IS NOT NULL).

الاستعلام عن الزيادة في كل مجموعة اختبار ونتائج المجموعة الفائزة

لقياس القيمة المتزايدة لكل مجموعة وتقييم الاحتمال الإحصائي بأنّ مجموعة معيّنة هي الفائزة، أدرِج المقطع segments.experiment_arm في طلب البحث إلى المورد lift_measurement_config.

تُقيّم مقاييس نتيجة الفائز في الإحصاء البايزي التالية احتمال (من 0.0 إلى 1.0، بمجموع 1.0 في كلتا المجموعتَين عندما يكون لكلتا المجموعتَين تحسُّن إيجابي يمكن تسجيله) أن تكون مجموعة معيّنة أفضل:

  • ‫metrics.incremental_conversions_winner_score: احتمال أن تكون هذه المجموعة هي الفائزة في ما يتعلّق بالإحالات الناجحة المتزايدة، بعد تسويته حسب تقسيم عدد الزيارات في المجموعة (experiment_arm.traffic_split).
  • metrics.incremental_conversion_value_winner_score: احتمال أن تكون هذه المجموعة التجريبية هي الفائزة من حيث القيمة المتزايدة للإحالة الناجحة، بعد تسويتها حسب تقسيم عدد الزيارات للمجموعة التجريبية (experiment_arm.traffic_split). في الإصدار 27 من Google Ads API والإصدارات الأحدث، تتم تعبئة هذا الحقل فقط عندما يكون المقياس الأساسي للدراسة هو قيمة الإحالة الناجحة، ويتم حذفه (تركه بدون ضبط) في الدراسات التي يكون فيها عدد الإحالات الناجحة هو المقياس الأساسي.
  • metrics.cost_per_incremental_conversion_winner_score: احتمال أن تكون هذه المجموعة هي الفائزة من حيث التكلفة لكل إحالة ناجحة إضافية (أقل تكلفة زائدة للإجراء)، بعد تسويتها حسب الإنفاق.
  • metrics.incremental_conversion_value_per_cost_winner_score: احتمال أن تكون هذه المجموعة هي الفائزة من حيث القيمة التصاعدية للإحالة الناجحة لكل تكلفة (أعلى عائد إنفاق إعلاني متزايد)، بعد تسويتها حسب الإنفاق. في الإصدار 27 من Google Ads API والإصدارات الأحدث، تتم تعبئة هذا الحقل فقط عندما يكون المقياس الأساسي للدراسة هو قيمة الإحالة الناجحة، ويتم حذفه (يُترك بدون ضبط) في الدراسات التي يكون فيها عدد الإحالات الناجحة هو المقياس الأساسي.

يستردّ طلب البحث التالي نتائج التزايد لكل مجموعة ونتائج الفائز وفقًا للإحصاء البايزي لكلتا المجموعتَين:

SELECT
  lift_measurement_config.lift_measurement_config_id,
  segments.conversion_lift_start_date,
  segments.conversion_lift_end_date,
  segments.conversion_lift_included_conversion_action_types,
  segments.experiment_arm,
  metrics.conversion_lift_baseline_conversions,
  metrics.conversion_lift_exposed_conversions,
  metrics.incremental_conversions,
  metrics.cost_per_incremental_conversion,
  metrics.incremental_conversions_winner_score,
  metrics.cost_per_incremental_conversion_winner_score,
  metrics.incremental_conversion_value,
  metrics.incremental_conversion_value_winner_score,
  metrics.incremental_conversion_value_per_cost_winner_score
FROM lift_measurement_config
WHERE lift_measurement_config.lift_measurement_config_id = CONFIG_ID
  AND segments.conversion_lift_start_date = START_DATE
  AND segments.conversion_lift_end_date = END_DATE
  AND segments.conversion_lift_included_conversion_action_types = 'SELECTED'

غيِّر القيم في السلسلة على الشكل التالي:

  • ‫CONFIG_ID: معرّف العدد الصحيح لإعدادات قياس التحسّن
  • ‫START_DATE: تاريخ بدء اللقطة كعدد صحيح YYYYMMDD مكوّن من 8 أرقام بدون علامات اقتباس (على سبيل المثال، 20260501).
  • ‫END_DATE: تاريخ انتهاء اللقطة كعدد صحيح مكوّن من 8 أرقام YYYYMMDD بدون علامات اقتباس (على سبيل المثال، 20260515).

لفلترة مجموعة واحدة، أضِف AND segments.experiment_arm = 'customers/CUSTOMER_ID/experimentArms/EXPERIMENT_ID~ARM_ID' إلى عبارة WHERE، حيث EXPERIMENT_ID هو رقم تعريف التجربة وARM_ID هو رقم تعريف المجموعة الذي يتم عرضه في حقل experiment_arm.resource_name. تتيح الشريحة segments.experiment_arm الفلترة في عبارات WHERE (= و!= وIN وNOT IN)، ولكن لا يمكنك ترتيبها في عبارة ORDER BY.

تفسير نتائج اختبارات A/B ومقياس "زيادة الإحالات الناجحة"

تُقيّم دراسة اختبار أ/ب ومقياس "زيادة الإحالات الناجحة" فرضيتَين في الوقت نفسه: تفوّق المجموعة التجريبية في المقارنة المباشرة (metrics.*_winner_score) والزيادة السببية مقارنةً بالمجموعة الضابطة التي لم يتم عرض الإعلانات لها (metrics.incremental_* و*_p_value). في حين أنّ فترة عرض الإعلانات في دراسة ENABLED لا تزال جارية (STUDY_IN_PROGRESS_*، عندما يكون التاريخ الحالي في المنطقة الزمنية للعميل يوافق أو يسبق lift_measurement_flight.end_date)، لا تزال المقارنة المباشرة بين المجموعات التجريبية ووضع نماذج للإحالات الناجحة للمجموعة الضابطة في مرحلة الاستقرار. يجب التعامل مع المقاييس قيد التقدّم على أنّها أولية، وتجنُّب ترقية مجموعة تجربة أو إعادة تخصيص الميزانيات إلى أن تكتمل مدة التجربة.

في الدراسات المكتملة، يتم تصنيف مجموعة التجربة على أنّها فائزة في المقارنة المباشرة عندما تستوفي الحدّ الأدنى من مستويات الدقة (4 أيام على الأقل من اللقطات، و65 إحالة ناجحة أساسية غير معدَّلة، و150 إحالة ناجحة غير معدَّلة للمستخدمين الذين شاهدوا الإعلانات)، وتحقّق 0 <= p_value <= 0.50، وتحصل على نتيجة فائزة وفقًا لنموذج بايزي أكبر من 0.55 (> 0.55) في المقياس الأساسي للدراسة. ينتج عن هذا التقييم الثنائي الفرضية حالتان متميزتان للفائز (تنعكسان أيضًا في lift_guidance.outcome في الإصدار 27 من Google Ads API والإصدارات الأحدث):

  • فائز واضح مع تأثير سببي (AB_WINNER_WITH_LIFT): تتفوّق المجموعة الفائزة على المجموعة المنافسة في المقارنة المباشرة (winner_score > 0.55) وتحقّق زيادة ذات دلالة إحصائية في الإحالات الناجحة أو قيمة الإحالات الناجحة مقارنةً بالمجموعة الضابطة التي لم يتم عرض الإعلانات لها. يمكنك الترويج لاستراتيجية المجموعة الفائزة أو توسيع نطاقها، والاطّلاع على التقسيمات التفصيلية للسمات من أجل مراجعة المجموعات النموذجية العالية الأداء.
  • الفائز في التجربة المباشرة مع تساوي الأداء مع المجموعة الضابطة (AB_WINNER_PARITY_VS_CONTROL): تتفوّق مجموعة التجربة الفائزة على مجموعة التجربة المنافسة في التجربة المباشرة (winner_score > 0.55)، ولكن لا تحقّق أيّ من المجموعتَين تحسّنًا متزايدًا ذا دلالة إحصائية مقارنةً بالمجموعة الضابطة التي لم يتم عرض الإعلانات لها عند المستوى الذي تم الاستعلام عنه. قبل زيادة الإنفاق على المجموعة الفائزة، يمكنك الاستعلام عن ALL الإحالات الناجحة (segments.conversion_lift_included_conversion_action_types = 'ALL') و segments.conversion_lift_conversion_category التفاصيل للتحقّق مما إذا كان التأثير السببي الإيجابي قد تم عزله في مكان آخر.

تنطبق نتيجة "POSITIVE_LIFT_DETECTED" على مستوى دقة طلبات البحث في اختبارات A/B ومقياس "زيادة الإحالات الناجحة" على النحو التالي:

  • صفوف الدراسة المجمّعة (OVERALL) (طلبات البحث بدون segments.experiment_arm): حقّقت الدراسة تأثيرًا إيجابيًا مقارنةً بالمجموعة الضابطة التي لم تشاهد الإعلانات (p_value <= 0.50)، ولم تحقّق أيّ من المجموعتَين نتيجة فائزة في المقارنة المباشرة أكبر من 0.55.
  • الصفوف لكل مجموعة (segments.experiment_arm): عندما تفوز مجموعة واحدة (winner_score > 0.55) وتحقّق المجموعتان تحسّنًا إيجابيًا مقارنةً بالمجموعة الضابطة، يعرض صف المجموعة الفائزة القيمة AB_WINNER_WITH_LIFT، بينما يعرض صف المجموعة غير الفائزة القيمة POSITIVE_LIFT_DETECTED.
  • صفوف تقسيم فئة الإحالة الناجحة (segments.conversion_lift_conversion_category): تُرجع صفوف التحسّن الإيجابي دائمًا القيمة POSITIVE_LIFT_DETECTED لأنّه لا يتم تقييم نتائج الفائزين لكل فئة إحالة ناجحة.

عندما يعرض أحد الأقسام NOT_ENOUGH_DATA أو NO_SIGNIFICANT_LIFT، لا توقِف مؤقتًا مجموعات التجربة أو تستبعد شرائح الجمهور استنادًا إلى عدم كفاية عيّنة القسم الواحد. اطّلِع على مقاييس الدراسة الإجمالية وALL إحالة ناجحة (segments.conversion_lift_included_conversion_action_types = 'ALL').

الاستعلام عن نتائج المجموعات المجمّعة والدراسات المتعددة

عند حذف شريحة segments.experiment_arm من طلب بحث في مورد lift_measurement_config، تعرض واجهة برمجة التطبيقات تزايدًا على مستوى الدراسة مجمّعًا في كلا المجموعتَين المدمجتَين. في طلبات البحث عن المجموعات المجمّعة، يجب حذف مقاييس metrics.*_winner_score الأربعة التي تنطبق فقط على المجموعات المتنافسة ويتم حذفها (تُترك بدون ضبط) في صفوف المجموعات المجمّعة بدون segments.experiment_arm. استخدِم طلبات البحث على مستوى الدراسة في مقياس "زيادة الإحالات الناجحة" والتكلفة الزائدة للإجراء (iCPA) وطلب البحث عن تحسُّن قيمة الإحالات الناجحة وعائد الإنفاق الإعلاني المتزايد (iROAS).

عند تقسيم نتائج اختبار A/B ومقياس &quot;زيادة الإحالات الناجحة&quot; حسب شريحة segments.experiment_arm، تتيح واجهة برمجة التطبيقات استخدام شريحة segments.conversion_lift_conversion_category فقط كسمة تقسيم إضافية. بما أنّ الإنفاق في المجموعة لا يُنسب إلى فئات إحالات ناجحة فردية، عليك تقييم مقاييس الإحالات الناجحة وزيادة قيمة الإحالات الناجحة (مع حذف مقياسَي "التكلفة الزائدة للإجراء" و"العائد المتزايد للإنفاق الإعلاني"، اللذين يتعذّر عليهما اجتياز عملية التحقّق من صحة طلب البحث مع ظهور الخطأ QueryError.PROHIBITED_SEGMENT_WITH_METRIC_IN_SELECT_OR_WHERE_CLAUSE في الإصدار 27 من Google Ads API والإصدارات الأحدث) عند تضمين شريحة segments.conversion_lift_conversion_category. الشرائح segments.conversion_action وsegments.conversion_action_name وsegments.age_range وsegments.gender وsegments.device وsegments.country وsegments.country_localized_name وsegments.date غير متوافقة مع الشريحة segments.experiment_arm ومع المقاييس metrics.*_winner_score. يؤدي اختيار أي من هذه الشرائح غير المتوافقة مع segments.experiment_arm إلى عرض الخطأ QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE (والخطأ QueryError.PROHIBITED_SEGMENT_WITH_METRIC_IN_SELECT_OR_WHERE_CLAUSE إذا كان طلب البحث يختار أيضًا أي مقياس metrics.*_winner_score).

لاسترداد نتائج إعدادات دراسات متعددة في طلب واحد، يمكنك الفلترة باستخدام عامل التشغيل IN:

SELECT
  lift_measurement_config.lift_measurement_config_id,
  segments.conversion_lift_start_date,
  segments.conversion_lift_end_date,
  segments.conversion_lift_included_conversion_action_types,
  segments.experiment_arm,
  segments.conversion_lift_conversion_category,
  metrics.incremental_conversions,
  metrics.incremental_conversions_winner_score,
  metrics.incremental_conversion_value,
  metrics.incremental_conversion_value_winner_score
FROM lift_measurement_config
WHERE lift_measurement_config.lift_measurement_config_id IN (
    CONFIG_ID_1, CONFIG_ID_2)
  AND segments.conversion_lift_start_date = START_DATE
  AND segments.conversion_lift_end_date = END_DATE
  AND segments.conversion_lift_included_conversion_action_types = 'SELECTED'

غيِّر القيم في السلسلة على الشكل التالي:

  • ‫CONFIG_ID_1: رقم التعريف الصحيح لإعدادات قياس التحسّن الأولى
  • ‫CONFIG_ID_2: رقم التعريف الصحيح لإعدادات قياس التحسّن الثانية
  • ‫START_DATE: تاريخ بدء اللقطة كعدد صحيح YYYYMMDD مكوّن من 8 أرقام بدون علامات اقتباس (على سبيل المثال، 20260501).
  • ‫END_DATE: تاريخ انتهاء اللقطة كعدد صحيح مكوّن من 8 أرقام YYYYMMDD بدون علامات اقتباس (على سبيل المثال، 20260515).

تؤدي المساواة التامة في التاريخ (= START_DATE و= END_DATE) إلى عرض صفوف فقط للدراسات التي تشترك في نافذة اللقطة نفسها. عند الاستعلام عن الدراسات التي تتضمّن تواريخ بدء مختلفة للحملات أو أحدث تواريخ للّقطات التي تم تقييمها، يمكنك الفلترة باستخدام عوامل تشغيل النطاق (>= و<=) أو حذف فلاتر التاريخ من عبارة WHERE مع الاحتفاظ بشريحتَي segments.conversion_lift_start_date وsegments.conversion_lift_end_date في عبارة SELECT.

تقارير "زيادة البحث"

لقياس الزيادة في حجم طلبات البحث المجاني الناتجة عن حملاتك الإعلانية في الإصدار 26 من Google Ads API والإصدارات الأحدث، يمكنك الاستعلام عن موارد تقارير "زيادة البحث". يحدّد مقياس "زيادة البحث" الفرق في سلوك البحث عن علامتك التجارية أو منتجاتك بين المستخدمين الذين شاهدوا إعلاناتك ومجموعة التحكّم التي لم تشاهدها.

موارد مقياس "زيادة البحث" وتقسيمه

يمكنك إرسال طلب بحث إلى المورد SearchLiftKeywordBundle لاسترداد تفاصيل حول حزم الكلمات الرئيسية التي تم ضبطها لدراسات "زيادة البحث". مورد SearchLiftKeywordBundle هو للقراءة فقط في Google Ads API (جميع الحقول هي OUTPUT_ONLY)، ويتم ضبط حِزم الكلمات الرئيسية في واجهة مستخدم "إعلانات Google" أو من خلال ممثل عن Google أو جهة اتصال في GPS. حقولها القابلة للاستعلام في GAQL هي resource_name وsearch_lift_keyword_bundle_id وsource (SearchLiftMatchingInfoSource) وstatus (SearchLiftKeywordBundleStatus) (لا يمكن اختيار حقل keywords المتكرّر في طلبات البحث في GAQL).

يمكنك الاستعلام عن المورد LiftMeasurementConfig لاسترداد مقاييس "زيادة البحث" وإعدادات الدراسة الإجمالية.

في الإصدار 27 من Google Ads API والإصدارات الأحدث، يمكنك أيضًا اختيار الحقل (OUTPUT_ONLY) lift_measurement_config.lift_guidance للقراءة فقط (lift_guidance.outcome و lift_guidance.guidance_message، من النوع LiftGuidance) في عبارة GAQL SELECT على lift_measurement_config عند طلب مقاييس أو شرائح "زيادة البحث" (segments.search_lift_keyword_bundle أو segments.search_property). في lift_measurement_config، يتم حذف lift_guidance في طلبات البحث عن الإعدادات التي تتضمّن بيانات وصفية فقط، ويمكن أن يحتوي lift_guidance.guidance_message على روابط Markdown مضمّنة (مثل [Learn more](https://support.google.com/...)). بالنسبة إلى "زيادة البحث"، يعرض lift_guidance.outcome القيمة STUDY_IN_PROGRESS_WITH_LIFT أو STUDY_IN_PROGRESS_NO_LIFT_YET أو STUDY_IN_PROGRESS_COLLECTING_DATA أو POSITIVE_LIFT_DETECTED (بنسبة تأكّد لا تقل عن %70، p_value <= 0.30) أو NO_SIGNIFICANT_LIFT أو NOT_ENOUGH_DATA (يتم تقييمها وفقًا للحدود الدنيا التي لا تقل عن 1,000,000 مرّة ظهور إجمالية أو 100,000 مرّة ظهور للشريحة، و75 عملية بحث مرصودة على الأقل، و17 على الأقل من أصل 20 مجموعة ملفات تعريف ارتباط، حيث تؤدي حزمة واحدة من الكلمات الرئيسية ذات الأداء الضعيف إلى عرض القيمة NOT_ENOUGH_DATA في نتائج الدراسة الإجمالية).

تقسيم أداء مقياس "زيادة البحث" حسب السمات التالية:

  • segments.search_lift_keyword_bundle: التقسيم حسب اسم مورد حزمة الكلمات الرئيسية متوافقة مع segments.search_property وsegments.date والشرائح الديمغرافية (segments.device وsegments.age_range وsegments.gender). تسجّل كل حزمة كلمات رئيسية التكلفة الكاملة للحملة ومرّات الظهور، ويمكن أن تنتمي الكلمات الرئيسية إلى أكثر من حزمة واحدة. لا تجمع metrics.search_lift_cost_micros أو metrics.search_lift_impressions أو مقاييس "زيادة البحث" في مجموعات الكلمات الرئيسية.
  • segments.search_property: التقسيم حسب موقع البحث الذي تم إجراء البحث فيه، ويتم تحديده من خلال التعداد SearchLiftSearchProperty (مثل GOOGLE_SEARCH أو YOUTUBE). يتوافق القسم segments.search_property مع القسمين segments.search_lift_keyword_bundle وsegments.date فقط. يؤدي الجمع بين segments.search_property والشرائح الديمغرافية (segments.device أو segments.age_range أو segments.gender) إلى تعذُّر التحقّق من صحة طلب البحث. بما أنّ السمة segments.search_property تقسّم البيانات حسب المكان الذي حدثت فيه عمليات البحث المجاني اللاحقة بدلاً من مكان عرض الإعلانات، فإنّ الصفوف المقسّمة حسب السمة segments.search_property تكرّر التكلفة ومرّات الظهور غير المقسّمة على مستوى الحملة في الإصدار 26 من Google Ads API. اعتبارًا من الإصدار 27 من Google Ads API، تصبح جميع مقاييس الإنفاق ومرات الظهور الثمانية (metrics.search_lift_cost_micros وmetrics.search_lift_impressions وmetrics.normalized_incremental_searches_per_cost* وmetrics.normalized_incremental_searches_per_impression*) غير متوافقة مع segments.search_property ويتعذّر التحقّق من صحة طلب البحث بسبب الخطأ QueryError.PROHIBITED_SEGMENT_WITH_METRIC_IN_SELECT_OR_WHERE_CLAUSE.
  • شرائح الخصائص الديمغرافية والتواريخ: segments.device وsegments.age_range وsegments.gender وsegments.date

مقاييس "زيادة البحث"

يوفّر المورد LiftMeasurementConfig مقاييس "زيادة البحث" لتقييم التغييرات في سلوك البحث:

  • metrics.relative_search_lift: الفرق في حجم طلبات البحث بين المجموعة التجريبية والمجموعة الضابطة، ويتم التعبير عنه كجزء من طلبات البحث في المجموعة الضابطة.
  • ‫metrics.relative_search_lift_p90_lower_bound وmetrics.relative_search_lift_p90_upper_bound: حدود الثقة أحادية الجانب بنسبة %90 (التي تشكّل معًا فاصل ثقة ثنائي الجانب بنسبة %80) لتأثير البحث النسبي.
  • metrics.incremental_searches_p_value: القيمة الاحتمالية للزيادة في البحث، والتي تمثّل الاحتمال الإحصائي لحدوث الزيادة الملحوظة في طلبات البحث عن طريق الصدفة.
  • metrics.search_lift_cost_micros: إجمالي تكلفة (بالوحدات الصغرى) مرّات ظهور الإعلان التي تم عرضها لشريحة قياس "زيادة البحث" هذه. غير متوافق مع segments.search_property في الإصدار 27 من Google Ads API والإصدارات الأحدث
  • metrics.search_lift_impressions: إجمالي عدد مرّات ظهور الإعلان التي تم عرضها لشريحة قياس "زيادة البحث" هذه لا يتوافق مع segments.search_property في الإصدار 27 من Google Ads API والإصدارات الأحدث.

يتم تسجيل المقاييس المتزايدة التي تم تسويتها التالية، بالإضافة إلى حدود الثقة أحادية الجانب المقابلة لها والتي تبلغ %90 (*_p90_lower_bound و*_p90_upper_bound)، عندما يكون التحسّن إيجابيًا من الناحية الإحصائية:

أمثلة على طلبات البحث في دراسة "زيادة البحث"

توضّح طلبات البحث التالية في GAQL كيفية استرداد حِزم الكلمات الرئيسية ومقاييس الأداء في مقياس "زيادة البحث".

طلب بحث عن حزمة الكلمات الرئيسية

لاسترداد حِزم الكلمات الرئيسية التي تم إعدادها لقياسات "زيادة البحث"، يمكنك طلب المورد search_lift_keyword_bundle:

SELECT
  search_lift_keyword_bundle.resource_name,
  search_lift_keyword_bundle.search_lift_keyword_bundle_id,
  search_lift_keyword_bundle.source,
  search_lift_keyword_bundle.status
FROM search_lift_keyword_bundle

طلب البحث عن المقاييس

تتوافق قيم search_lift_keyword_bundle.resource_name التي تم استردادها في طلب البحث عن حزمة الكلمات الرئيسية مع القيم المعروضة في شريحة segments.search_lift_keyword_bundle في طلب البحث التالي. للاطّلاع على CONFIG_ID والحملات المرتبطة وجدول الرحلات لدراستك، اتّبِع الخطوات الواردة في مقالة الاطّلاع على إعدادات الدراسة والرحلات في الموردَين lift_measurement_config وlift_measurement_flight (فلترة الرحلات حسب lift_measurement_flight.lift_type = 'SEARCH').

يستردّ طلب البحث التالي مقاييس "زيادة البحث" مقسّمة حسب حزمة الكلمات الرئيسية وموقع البحث (يُرجى حذف segments.search_property عند اختيار metrics.search_lift_cost_micros أو metrics.search_lift_impressions):

SELECT
  lift_measurement_config.lift_measurement_config_id,
  segments.search_lift_keyword_bundle,
  segments.search_property,
  metrics.relative_search_lift,
  metrics.relative_search_lift_p90_lower_bound,
  metrics.relative_search_lift_p90_upper_bound,
  metrics.incremental_searches_p_value,
  metrics.normalized_incremental_searches,
  metrics.normalized_incremental_searches_p90_lower_bound,
  metrics.normalized_incremental_searches_p90_upper_bound
FROM lift_measurement_config
WHERE lift_measurement_config.lift_measurement_config_id = CONFIG_ID

غيِّر القيم في السلسلة على الشكل التالي:

  • ‫CONFIG_ID: معرّف العدد الصحيح لإعدادات قياس التحسّن
السابق
إعداد التقارير
التالي
استرداد البيانات الجغرافية