البدء

هذا المستند للمطوّرين الذين يريدون استخدام AdSense Management API للحصول على معلومات حول حساباتهم على AdSense. يفترض هذا المستند أنك على دراية بمفاهيم برمجة الويب وتنسيقات بيانات الويب.

قبل البدء

الحصول على حساب على AdSense

يجب الاشتراك في حسابك على AdSense أو تسجيل الدخول إليه للبدء.

التعرّف على AdSense

إذا لم تكن على دراية بمفاهيم AdSense، يمكنك الاطّلاع على المعلومات التمهيدية على AdSense وتجربة واجهة مستخدم AdSense قبل بدء الترميز.

اختيار مكتبة العملاء

في صفحة مكتبات العميل والنماذج، ستجد معلومات عن المكتبات والنماذج المتاحة. انقر فوق علامة التبويب الخاصة باللغة التي اخترتها واتّبع الروابط لتنزيل المصدر. تعالج مكتبات العملاء ما يلي:

  • مصادقة
  • اكتشاف الخدمات
  • إنشاء الطلبات إلى واجهة برمجة التطبيقات
  • تحليل الردود

اقرأ التعليمات لتثبيت وتهيئة مكتبة العملاء التي اخترتها، والموجودة عادةً في ملف README في الدليل الجذري للمستودع.

إذا كانت لعملية التنفيذ احتياجات خاصة، مثل استخدام لغة غير متاحة، يمكنك تقديم طلبات مباشرة إلى واجهة برمجة التطبيقات بدلاً من استخدام مكتبة عميل.

تسجيل طلبك

لاستخدام AdSense Management API، يجب تسجيل التطبيق الذي تعمل على تطويره من خلال إنشاء مشروع وإنشاء معرِّف عميل.

تسجيل تطبيقك

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

ملاحظة: يجب أن يكون حساب Google المستخدَم للتسجيل هو حساب مطوّر البرامج الخاص بك، أي الحساب الذي تريد أن يراه مستخدمو تطبيقك كمطوّر للتطبيق. ولا يلزم ربط هذا الحساب بمعلومات تسجيل الدخول إلى AdSense، حيث سيمنح المستخدمون حق الوصول إلى حساباتهم أثناء استخدام التطبيق.

دليل البدء السريع

يُرجى اتّباع الخطوات أدناه لتقديم طلباتك الأولى، علمًا بأنّ هذه الخطوات قد تختلف قليلاً حسب المكتبة أو اللغة المستخدَمة:

  1. استخدِم النموذج المناسب لاسترداد قائمة عملاء الإعلانات من حساب على AdSense. يبدأ هذا الطلب عملية تتم لمرة واحدة يجري فيها مستخدم AdSense مصادقة مشروعك وتفويضه.

    يمثّل عملاء الإعلانات رابطًا بين حساب على AdSense وأحد منتجات AdSense، مثل "الإعلانات على الشبكة الإعلانية" أو "الإعلانات على شبكة البحث". ويمكن أن يحتوي حساب AdSense على عميل واحد أو أكثر من عملاء الإعلانات.

    1. بالنسبة إلى تطبيقات الويب، ستتم إعادة توجيه المستخدمين إلى موقع إلكتروني يمكنهم فيه اختيار منح إمكانية الوصول. وبعد إتمام التفويض، ستتم إعادة توجيههم إلى عنوان URL لمعاودة الاتصال المحدّد في وحدة تحكُّم واجهات برمجة التطبيقات.
    2. تعمل التطبيقات المثبّتة بالطريقة نفسها. ستحاول مكتبة البرامج فتح نافذة متصفّح واستخدام رمز تفويض. بالنسبة إلى تطبيقات Android وChrome وiOS، يمكن أن تكون هذه الطريقة خاصة بالنظام الأساسي.
  2. استخدِم مستكشف واجهات برمجة التطبيقات في reports.generate لطلب التقرير التالي:
    • date_range: YESTERDAY
    • dimensions: DATE
    • metrics: ESTIMATED_EARNINGS

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

  3. حاول طلب التقرير نفسه من تطبيقك.
  4. يمكنك فلترة التقارير حسب الوحدات الإعلانية. استرجع قائمة الوحدات الإعلانية باستخدام adunits.list. تجدر الإشارة إلى أنّك تحتاج إلى معرّف عميل إعلانات (احصل عليه من الخطوة 1). بعد اختيار وحدة إعلانية، استخدِم رقم تعريفها في مَعلمة filter reports.generate:

    الوحدات الإعلانية هي عناصر نائبة يضبطها المستخدم للإعلانات، تحدِّد بعض السمات للإعلانات التي يتم عرضها (مثل الحجم والشكل).

    • date_range: YESTERDAY
    • dimensions: DATE
    • metrics: ESTIMATED_EARNINGS
    • filter: AD_UNIT_ID==ca-pub-123456789:987654321
  5. حاوِل الفلترة حسب القنوات المخصّصة أو القنوات المخصّصة لعناوين URL أو خلط فلاتر متعددة.

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

أصبحت جاهزًا لبدء التنفيذ من خلال استكشاف باقي المكالمات والموارد المتاحة في المستندات المرجعية.