الموافقة والتحكم — Android
يمكنك استدعاء كل دوال Ad80 من أي خيط بأمان، ولا ترمي أي منها استثناءً أبداً.
التهيئة والبدء
Section titled “التهيئة والبدء”يهيّئ SDK نفسه عبر AndroidX App Startup، فلا تحتاج أن تكتب أي كود لذلك. كل ما يحدث على الخيط الرئيسي عند البدء هو تسجيل استدعاءات دورة الحياة. أما قراءة ملف manifest وبناء SDK فيجريان على خيط خلفي خاص به.
إن كان تطبيقك يعطّل App Startup، أو يزيل مُهيِّئ AD80، فاستدعِ Ad80.initialize(context) بنفسك في وقت مبكر،
مثلاً في Application.onCreate(). واستدعاؤها أكثر من مرة لا يغيّر شيئاً.
<provider android:name="androidx.startup.InitializationProvider" android:authorities="${applicationId}.androidx-startup" android:exported="false" tools:node="merge"> <meta-data android:name="dev.ad80.sdk.Ad80Initializer" tools:node="remove" /></provider>class MyApp : Application() { override fun onCreate() { super.onCreate() Ad80.initialize(this) // only needed when App Startup does not run the AD80 initializer }}public class MyApp extends Application { @Override public void onCreate() { super.onCreate(); Ad80.initialize(this); // only needed when App Startup does not run the AD80 initializer }}الموافقة
Section titled “الموافقة”لا يلتقط SDK شيئاً ولا يرسل شيئاً قبل منح الموافقة. وSDK لا يحفظ الموافقة، لذا استدعِ
Ad80.setConsent(...) في كل مرة يبدأ فيها التطبيق، فور معرفتك باختيار المستخدم. مثلاً بعد انتهاء مسار الموافقة
عندك (كمنصة Google لرسائل المستخدمين UMP).
import dev.ad80.sdk.Ad80
// After your consent flow, on every start:Ad80.setConsent(consentInformation.canRequestAds())import dev.ad80.sdk.Ad80;
// After your consent flow, on every start:Ad80.setConsent(consentInformation.canRequestAds());consentInformation هنا هو كائن ConsentInformation من UMP عندك. استخدم ما يحدّد الموافقة في تطبيقك أياً كان.
سحب الموافقة (Ad80.setConsent(false)) يوقف الالتقاط والطلبات فوراً، ويحذف كل ما ينتظر في الطابور على
الجهاز. ولن يُرسَل لاحقاً أي شيء كان في الطابور قبل سحب الموافقة.
مفتاح الإيقاف المحلي
Section titled “مفتاح الإيقاف المحلي”| الطريقة | الأثر |
|---|---|
Ad80.setEnabled(false) | يوقف SDK في هذه العملية: يتوقف الالتقاط والرفع ويُحذف الطابور. وتعيد Ad80.setEnabled(true) تشغيله. لا تُحفظ هذه الحالة بين العمليات. |
<meta-data android:name="dev.ad80.ENABLED" android:value="false" /> | يصبح SDK خاملاً في العملية كلها: لا يبدأ أي خيط، ولا يلتقط شيئاً، ويُبلغ عن Disabled(MANIFEST). استخدمه مثلاً في نكهة بناء (build flavor) يجب ألّا تُبلغ عن الإعلانات. |
Ad80.setEnabled(false) // for example from a remote flag or a settings screenAd80.setEnabled(false); // for example from a remote flag or a settings screenالإعدادات عن بُعد (مفتاح الإيقاف لدى AD80)
Section titled “الإعدادات عن بُعد (مفتاح الإيقاف لدى AD80)”يقرأ SDK إعداداته عن بُعد. بعد منح الموافقة، وما دام SDK مفعّلاً، يجلب إعداداته من AD80 (عبر GET /v1/config على العنوان نفسه)، ثم
يجلبها من جديد بعد كل ttlSeconds:
{ "enabled": true, "captureEnabled": true, "uploadEnabled": true, "ttlSeconds": 3600, "fullScreenCaptureEnabled": true }| الحقل | الأثر |
|---|---|
enabled | القيمة false توقف الالتقاط والرفع وتحذف الطابور. ويبقى هذا سارياً، حتى بعد إعادة التشغيل، إلى أن تأتي إعدادات لاحقة تعيد تفعيل SDK. وفي هذه الأثناء يواصل SDK فحص الإعدادات. |
captureEnabled | القيمة false توقف التقاط إعلانات جديدة. |
uploadEnabled | القيمة false توقف الرفع. |
fullScreenCaptureEnabled | القيمة false تتخطى الإعلانات بملء الشاشة (والنتيجة SKIPPED_FULLSCREEN_DISABLED)، وتُسقط ملاحظات الإعلانات بملء الشاشة التي في الطابور ولم تُسلَّم بعد. ولا يهمّ إلا الإعلانات التي يتتبّعها تطبيقك بـ Ad80.trackFullScreenAd. ويلزم لالتقاطها أن تكون enabled وcaptureEnabled وهذا الحقل كلها true. ويستطيع المالك والمشرفون تغييره لكل تطبيق من لوحة المتابعة، في التطبيقات وإعداد SDK. |
ttlSeconds | مدة صلاحية الإعدادات. يُبقيها SDK بين 300 و86400 ثانية. |
إن فشل الجلب، يواصل SDK العمل بآخر إعدادات وصلته (أو بالقيم الافتراضية أعلاه إن لم تصله إعدادات قط، إلا أن الالتقاط بملء الشاشة يبقى مغلقاً حتى تصله إعدادات)، ويحاول مجدداً بعد 15 دقيقة. ومع كل فشل جديد ينتظر مدة أطول، حتى يوم كامل.
المفتاح المحفوظ لكل تطبيق يكون مفعّلاً افتراضياً، لكن SDK نفسه يبدأ والقيمة fullScreenCaptureEnabled مغلقة، ويعدّ الحقل المفقود
أو الخاطئ مغلقاً. لذلك لا يبدأ الالتقاط بملء الشاشة إلا بعد أن يجلب SDK إعدادات تفتحه.
على الخطة المجانية تأتي الإعدادات بالقيمة enabled: false، فيبقى SDK المدمج في التطبيق خاملاً حتى تنتقل
المؤسسة إلى خطة تشمل الربط مع SDK. ويستطيع AD80 أيضاً إيقاف تطبيق مؤقتاً بطلب منك؛ راسلنا على
contact@ad80.dev.