هذا المستند مخصّص للمطوّرين الذين يريدون استخدام AdSense Management API للحصول على معلومات حول حساباتهم على AdSense. يفترض هذا المستند أنك على دراية بمفاهيم برمجة الويب وتنسيقات بيانات الويب.
قبل البدء
الحصول على حساب في AdSense
اشترِك أو سجّل الدخول إلى حسابك على AdSense للبدء.
التعرّف على AdSense
إذا لم تكن تعرف مفاهيم AdSense، يُرجى الاطّلاع على المعلومات التمهيدية حول AdSense وتجربة واجهة مستخدم AdSense قبل البدء في الترميز.
اختيار مكتبة البرامج
في صفحة "مكتبات العميل وعيّناته"، ستعثر على معلومات عن المكتبات والنماذج المتوفّرة. انقر فوق علامة التبويب الخاصة باللغة التي اخترتها واتبع الروابط لتنزيل المصدر. تتولى مكتبات العملاء معالجة ما يلي بالنيابة عنك:
- مصادقة
- اكتشاف الخدمات
- إنشاء الطلبات إلى واجهة برمجة التطبيقات
- تحليل الردود
اقرأ التعليمات لتثبيت مكتبة البرامج التي اخترتها وضبطها، والتي يمكنك العثور عليها عادةً في ملف README في الدليل الجذري للمستودع.
إذا كانت لعملية التنفيذ احتياجات خاصة، مثل استخدام لغة غير متاحة، يمكنك تقديم طلبات مباشرة إلى واجهة برمجة التطبيقات بدلاً من استخدام مكتبة عميل.
تسجيل تطبيقك
لاستخدام واجهة برمجة تطبيقات AdSense Management، يجب تسجيل التطبيق الذي تُطوّره عن طريق إنشاء مشروع وإنشاء معرِّف عميل.
تسجيل تطبيقكعدّل ملفات التهيئة لمشروع مكتبة العملاء باستخدام بيانات الاعتماد الجديدة التي أنشأتها للتو. تحقق من وثائق مكتبة العملاء لمزيد من التفاصيل.
ملاحظة: يجب أن يكون حساب Google المستخدَم للتسجيل هو حساب المطوّر الخاص بك، أي الحساب الذي تريد أن يراه مستخدمو تطبيقك على أنّه مطوّر التطبيق. هذا الحساب لا يلزم ربطه بمعلومات تسجيل دخول إلى AdSense، حيث سيمنح المستخدمون حق الوصول إلى حساباتهم الخاصة أثناء استخدام التطبيق.
دليل البدء السريع
اتّبِع الخطوات أدناه لتقديم طلباتك الأولى، مع العلم أنّ هذه الخطوات قد تختلف قليلاً حسب المكتبة أو اللغة التي تستخدمها:
- استخدِم العيّنة المناسبة لاسترداد قائمة عملاء الإعلانات من
حساب AdSense. يبدأ هذا الطلب عملية لمرة واحدة يصادق من خلالها مستخدم AdSense على مشروعك ويفوّضه.
يمثّل عملاء الإعلانات ارتباطًا بين حساب AdSense وأحد منتجات AdSense، مثل "إعلانات المحتوى" أو "الإعلانات على شبكة البحث". يمكن أن يحتوي حساب AdSense على عميل إعلانات واحد أو أكثر.
- بالنسبة إلى تطبيقات الويب، ستتم إعادة توجيه المستخدمين إلى موقع إلكتروني حيث يمكنهم اختيار منح إذن الوصول. بعد التفويض، ستتم إعادة توجيههم إلى عنوان URL لمعاودة الاتصال المحدّد في وحدة تحكُّم Google API.
- تعمل التطبيقات المثبّتة بالطريقة نفسها. وستحاول مكتبة البرامج فتح نافذة متصفّح واستخدام رمز تفويض. وبالنسبة إلى تطبيقات Android وChrome وiOS، ترتبط هذه الطريقة بالنظام الأساسي.
- استخدِم
مستكشف واجهات برمجة تطبيقات Google في
reports.generateلطلب التقرير التالي:date_range: YESTERDAYdimensions: DATEmetrics: ESTIMATED_EARNINGS
تقدّم لك التقارير إحصاءات حول الأرباح التي تحقّقها بالإضافة إلى العوامل التي تؤثر في هذه الأرباح. ويمكن عرضها على حساب كامل أو على مجموعة فرعية من الوحدات الإعلانية، من خلال استخدام القنوات.
- حاوِل طلب التقرير نفسه من طلبك.
- يمكنك فلترة التقارير حسب الوحدات الإعلانية. يمكنك استرجاع قائمة الوحدات الإعلانية باستخدام
adunits.list. تجدر الإشارة إلى أنّك تحتاج إلى معرّف عميل الإعلانات (يمكنك الحصول عليه من الخطوة 1). بعد اختيار وحدة إعلانية، استخدِم رقم تعريفها في مَعلمة الفلترreports.generate:الوحدات الإعلانية هي عناصر نائبة يضبطها المستخدمون للإعلانات، وتحدّد بعض خصائص الإعلانات التي يتم عرضها (مثل الحجم والشكل).
date_range: YESTERDAYdimensions: DATEmetrics: ESTIMATED_EARNINGSfilter: AD_UNIT_ID==ca-pub-123456789:987654321
- جرِّب الفلترة حسب القنوات المخصّصة أو قنوات عناوين URL أو استخدام فلاتر متعدّدة معًا.
القنوات هي أدوات تتيح لك تتبُّع أداء مجموعة فرعية من وحداتك الإعلانية. هناك نوعان من القنوات: عنوان URL والقنوات المخصّصة. تتيح لك الطريقة الأولى تتبُّع الأداء على مستوى صفحة أو نطاق محدّد، بينما تساعدك الطريقة الثانية في تتبّع الأداء على مستوى مجموعات محدّدة من الوحدات الإعلانية من اختيار المستخدمين.
أنت جاهز لبدء عملية التنفيذ باستكشاف بقية المكالمات والموارد المتاحة في المستندات المرجعية.