تخطَّ إلى المحتوى

التطبيقات وإعداد SDK

صفحة التطبيقات وإعداد SDK هي المكان الذي تسجّل فيه تطبيقك، وتنشئ مفتاح الرفع الخاص به، وتضيف إليه SDK. الربط مع SDK جزء من خطتَي Starter وEnterprise. أما في الخطة المجانية فتعرض لك الصفحة معاينة للإعداد، وتبقى خطوة المفتاح مقفلة (غير متاح في خطتك).

أدخل معرّف التطبيق في الحقل معرّف تطبيق Android: اسم الحزمة (applicationId، مثل com.example.news) في تطبيق Android، أو معرّف الحزمة (bundle identifier) في تطبيق iOS. وأضف إن شئت الاسم الظاهر، ثم اضغط أضف تطبيقاً.

يتكوّن المعرّف من مقطعين على الأقل تفصل بينهما نقاط، ويبدأ كل مقطع بحرف (والمسموح فيه أحرف وأرقام وشرطات سفلية). ولا يزيد طوله على 150 حرفاً، ولا يتكرر داخل مؤسستك. ولا تُقبل الشرطة (-): فمعرّف حزمة iOS الذي فيه شرطة لا يمكن تسجيله حالياً.

في قسم مفاتيح الرفع اضغط أنشئ مفتاح رفع. أعطِ المفتاح الوصف (والافتراضية نسخة النشر). تظهر لك نافذة مفتاحك الجديد وفيها المفتاح مرة واحدة فقط، مع هذا التنبيه: لن يظهر هذا المفتاح إلا هذه المرة. انسخه الآن واحفظه في مكان آمن، فلن نستطيع عرضه مجدداً. انسخه، ثم اضغط حفظته.

تبدأ مفاتيح الرفع بـ ad80_ik_. كل مفتاح منها يرفع الإعلانات لهذا التطبيق وحده، ولا يستطيع قراءة أي شيء. تضع المفتاح في التطبيق (في ملف البيان manifest على Android، وفي Info.plist على iOS؛ راجع تثبيت SDK).

تعرض القائمة لكل مفتاح بادئته والوصف وأُنشئ وآخر استخدام وحالته (يعمل أو مُبطَل).

  • جدّد ينشئ مفتاحاً جديداً للتطبيق نفسه. يبقى المفتاح القديم صالحاً إلى أن تُبطله، فتستطيع أن تنشر المفتاح الجديد في تحديث للتطبيق أولاً.
  • أبطِل (ثم نعم، أبطِله) يوقف المفتاح فوراً، ولن تستطيع التطبيقات التي ما زالت تستخدمه أن ترفع شيئاً بعد ذلك.

يعرض لك مربع الربط مقتطفات Android الخاصة بهذا التطبيق، مع هذه الملاحظة: أضف سطر الاعتمادية وعناصر ملف AndroidManifest (مفتاح الرفع وعنوان ad80)، ثم شغّل SDK بعد موافقة المستخدم. يبدأ وحده ويجد إعلانات البانر والإعلانات المدمجة، أما الإعلانات بملء الشاشة فتحتاج إلى سطر واحد إضافي تجده في الأسفل. وينبّهك أيضاً: لم يُنشر SDK على Maven بعد: هذا الاسم ورقم الإصدار مؤقتان إلى أن ننشره. لا تستخدم هذا الإحداثي، فـ AD80 يرسل لك SDK مترجماً. وفي تطبيق iOS اتّبع تبويب iOS في تثبيت SDK؛ فالمربع لا يعرض مقتطفات iOS.

وللإعلانات بملء الشاشة يضيف المربع سطراً مع هذه الملاحظة: للإعلانات بملء الشاشة، أضف هذا السطر قبل كل استدعاء لـ {show} مباشرة. وهذا السطر هو Ad80.trackFullScreenAd(ad)؛ والاستدعاء في iOS يحمل الاسم نفسه.

التعليمات الكاملة المحدّثة، ومنها عنصر نقطة الاتصال المطلوب واستدعاء الموافقة، تجدها في تثبيت SDK.

التقاط الإعلانات بملء الشاشة

Section titled “التقاط الإعلانات بملء الشاشة”

يتحكم مفتاح التقاط الإعلانات بملء الشاشة (التقط الإعلانات بملء الشاشة في هذا التطبيق) في إمكانية التقاط الإعلانات البينية وإعلانات المكافأة وإعلانات فتح التطبيق لهذا التطبيق. وهو مفعّل افتراضياً لكل تطبيق. ويقرّر أمران آخران:

  • أن يشترك التطبيق: لا يلتقط SDK إعلاناً بملء الشاشة إلا بعد أن يستدعي تطبيقك Ad80.trackFullScreenAd قبل عرضه مباشرة. انظر الإعلانات والشبكات المدعومة.
  • أن يكون الالتقاط مفعّلاً لهذا التطبيق أيضاً. فإن أوقف AD80 SDK أو الالتقاط للتطبيق، فلا تُلتقط الإعلانات بملء الشاشة كذلك.

أما SDK نفسه فيبدأ والالتقاط بملء الشاشة مغلق، إلى أن يجلب إعداداته فيجد المفتاح مفعّلاً. فالتغيير هنا يصل إلى التطبيق حين يتحقق من إعداداته في المرة القادمة.

لا يغيّر المفتاح إلا المالك أو أحد المشرفين، ويرى الباقون المفتاح مع هذه العبارة: يغيّر هذا الإعداد المالك أو أحد المشرفين فقط.

يخبرك فحص الاتصال هل تصل عمليات الرفع من تطبيقك أم لا:

الحالةمعناها
لا مفتاح رفعأنشئ مفتاح رفع، ثم أضفه إلى التطبيق.
ننتظر أول رفعابنِ التطبيق مع SDK، وافتح شاشة فيها إعلان. نتحقق في هذه الصفحة كل بضع ثوانٍ.
تصلنا الإعلاناتعمليات الرفع تصل، وتعرض الصفحة آخر رفع {when}.

إذا بقيت الحالة على ننتظر أول رفع، فراجع اختبر الربط.

مفاتيح API: للسكربتات والتصدير التي تقرأ بياناتك. لا تضعها داخل تطبيق أبداً. اضغط أنشئ مفتاح API، واختر وصفاً والصلاحيات، ثم انسخ المفتاح من النافذة، فهو لا يظهر إلا مرة واحدة. تبدأ مفاتيح API بـ ad80_ck_. ولمعرفة الصلاحيات راجع واجهة REST: المصادقة.

المالكون والمشرفون وحدهم يستطيعون إنشاء التطبيقات والمفاتيح.