ما المقصود بواجهة برمجة التطبيقات لإعداد تقارير المسارات المتعددة القنوات - نظرة عامة

يقدّم هذا المستند نظرة عامة عالية المستوى على واجهة برمجة التطبيقات لإعداد تقارير المسارات المتعددة القنوات في "إحصاءات Google". للحصول على مرجع تفصيلي حول واجهة برمجة التطبيقات، يمكنك الاطّلاع على الدليل المرجعي.

مقدمة

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

باستخدام واجهة برمجة التطبيقات لإعداد تقارير المسارات المتعددة القنوات، يمكنك إجراء ما يلي:

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

نظرة عامة على المفاهيم

في ما يلي المفاهيم الأساسية لواجهة برمجة التطبيقات لإعداد تقارير المسارات المتعددة القنوات:

  • علاقة التقارير بالمستخدمين والمشاهدات (الملفات الشخصية)
  • هيكل التقرير وكيفية إنشاء طلبات البحث.
  • بيانات مسار الإحالة الناجحة ومفاهيم الإحالة.
  • يتم العمل على الردّ من واجهة برمجة التطبيقات.

التقارير والمستخدمون والمشاهدات (الملفات الشخصية)

لطلب بيانات التقارير لمستخدم، يجب أن يحدّد تطبيقك هوية المستخدم وأن يحدّد ملفًا شخصيًا (ملفًا شخصيًا) لاسترداد البيانات له. يتم تحديد هوية المستخدم من خلال الحصول على بيانات اعتماد التفويض وتمريرها في كل طلب من طلبات البيانات من واجهة برمجة التطبيقات. يتم تحديد الملف الشخصي من خلال رقم تعريف الملف الشخصي. تشكّل الملفات الشخصية (الملفات الشخصية)، من بين كيانات أخرى، جزءًا من التدرّج الهرمي للإعدادات في "إحصاءات Google". يمكن أن يستخدم تطبيقك Management API لاجتياز هذا العرض الهرمي والحصول على رقم تعريف ملف شخصي.

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

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

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

بيانات مسار الإحالة الناجحة ومفاهيم الإحالة

يتم إنشاء تقارير "المسارات المتعددة القنوات" من مسارات الإحالات الناجحة: تسلسل التفاعلات (مثل النقرات/الإحالات من القنوات) التي أدت إلى كل إحالة ناجحة ومعاملة. يتم جمع مسارات الإحالات الناجحة عبر ملف تعريف ارتباط "إحصاءات Google" الذي يسجّل التفاعلات باستخدام المتصفّح والجهاز نفسه. تجمع بيانات "المسارات المتعدّدة القنوات" بيانات الإحالات الناجحة من "إحصاءات Google" مع تسلسل التفاعلات التي يتم رصدها في ملف تعريف الارتباط.

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

التعامل مع التقارير

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

تحتوي كل قيمة في الخلية على قيمة أساسية من نوع السلسلة أو قيمة مسار الإحالة الناجحة. قيمة مسار الإحالة الناجحة هذه هي مصفوفة من العناصر التي تمثّل جميع العُقد في ذلك المسار. يمكننا استخدام نوع المعلومات في عناوين الأعمدة لتحليل كل قيمة في الخلية إلى نوعها المناسب. يمكنك الاطّلاع على المزيد من المعلومات هنا.

سياسة الحصص

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

الخطوات التالية

بعد أن فهمت آلية عمل واجهة برمجة التطبيقات، نقدّم لك مجموعة من المراجع لمساعدتك في البدء: