تتيح واجهة Data Manager API الآن الإحالات الناجحة عبر الاتصال الهاتفي في "إعلانات Google" وبيانات التشخيص على مستوى الصف

الأربعاء 4 نوفمبر 2026

يضيف الإصدار الأخير من Data Manager API إمكانية تتبُّع الإحالات الناجحة عبر الاتصال الهاتفي في "إعلانات Google". وتضيف أيضًا تفاصيل على مستوى الصف إلى بيانات التشخيص لمساعدتك في العثور على السجلات المحدّدة التي واجهت مشاكل أثناء المعالجة وإصلاحها.

إرسال الإحالات الناجحة عبر الاتصال الهاتفي إلى "إعلانات Google"

يمكنك الآن استخدام Data Manager API من أجل إرسال الإحالات الناجحة عبر الاتصال الهاتفي إلى "إعلانات Google". يتتبّع تتبّع الإحالات الناجحة الناتجة من الاتصال الهاتفي الحالات التي تؤدي فيها إعلاناتك إلى إجراء مكالمات هاتفية والحالات التي تؤدي فيها هذه المكالمات إلى إجراءات يتخذها عملاء قيّمة.

لإرسال إحالة ناجحة عبر الاتصال الهاتفي، اضبط الحقل الجديد call_info في الحدث. يحتوي start_timestamp على وقت بدء المكالمة الهاتفية. تحديد هوية المتصل باستخدام رقم هاتف مجزّأ في user_data

الأخطاء والتحذيرات على مستوى الصف في بيانات التشخيص

لا يضمن طلب نقل البيانات الناجح معالجة كل سجلّ. تُعلمك واجهة برمجة التطبيقات Data Manager API الآن بالسجلّات التي واجهت مشاكل أثناء المعالجة. عند التحقّق من حالة الطلب وبيانات التشخيص لطلب معيّن، يتضمّن كلّ من ErrorCount وWarningCount الآن حقل record_indices. يسرد هذا الحقل المواضع التي تبدأ من 0 للسجلات المتأثرة في طلبك الأصلي.

على سبيل المثال، إذا كانت قيمة record_indices هي [0, 3] في ErrorCount مع السبب PROCESSING_ERROR_REASON_CLICK_NOT_FOUND، يعني ذلك أنّ الحدثَين الأول والرابع في طلبك لم ينجحا لهذا السبب. استخدِم هذه الفهارس مع سبب الخطأ لتصحيح السجلات التي تعذّر إرسالها وإعادة إرسالها. لم يتم رفض السجلات التي تتضمّن تحذيرات، ولكن تم تجاهل بعض بياناتها، لذا يجب إصلاح سبب التحذير في الطلبات المستقبلية.

إرسال معرّفات العملاء المحتملين مع إحالاتك الناجحة

استخدِم حقل lead_id الجديد في ad_identifiers لإرسال المعرّف الذي أنشأته Google عندما يرسل المستخدم نموذج عملاء محتملين. يمكنك تضمين lead_id والحقل الحالي match_id كمعرّفات للأحداث غير الإلكترونية والأحداث المتعدّدة المصادر التي يتم إرسالها إلى وجهات "إعلانات Google" وFloodlight و"إحصاءات Google".

لا يتوفّر بعد تحديد المصدر باستخدام lead_id وmatch_id. وإلى أن يتم ذلك، يمكنك تضمين معرّفات أخرى لضمان تحديد مصدر الأحداث.

البدء

هل تستخدم أدوات الترميز بالذكاء الاصطناعي؟ يمكنك استكشاف مهارات وكيل Data Manager API للحصول على إرشادات أكثر دقة وكفاءة مباشرةً في بيئة الترميز المستندة إلى الذكاء الاصطناعي.

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

إذا أردت أن تصبح شريك بيانات، يُرجى ملء نموذج إبداء الاهتمام بالشراكة.

صورة للمؤلف - ليندسي فولتا، نيابةً عن فريق العمل لواجهة برمجة التطبيقات Data Manager API

التصنيفات: الإحالات الناجحة، data-manager-api، الإصدار