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