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