دمج حزمة تطوير البرامج (SDK) الخاصة بمنصة BIGO Ads مع ميزة "التوسّط"

يوضّح لك هذا الدليل كيفية استخدام Google Mobile Ads SDK (Legacy) لتحميل الإعلانات وعرضها من BIGO Ads SDK باستخدام التوسّط، مع تغطية عمليات الدمج المستندة إلى عروض الأسعار. توضّح هذه الصفحة كيفية إضافة حزمة تطوير البرامج (SDK) الخاصة بـ "إعلانات BIGO" إلى إعدادات التوسّط الخاصة بوحدة إعلانية، وكيفية دمج حزمة تطوير البرامج (SDK) ومحوّل "إعلانات BIGO" في تطبيق Android.

عمليات الدمج وأشكال الإعلانات المتوافقة

يتضمّن محوّل التوسّط الخاص بحزمة تطوير البرامج (SDK) من BIGO Ads الإمكانات التالية:

المتطلبات الأساسية

قبل المتابعة، يُرجى التأكّد مما يلي:

• المستوى 24 من واجهة برمجة التطبيقات Android أو الإصدارات الأحدث

• أحدث إصدار من Google Mobile Ads SDK (Legacy)

• إعداد التوسّط

الخطوة 1: إعداد الإعدادات في واجهة مستخدم حزمة تطوير البرامج (SDK) لمنصة BIGO Ads

سجِّل الدخول إلى لوحة بيانات BIGO Ads.

إنشاء تطبيق

انتقِل إلى علامة التبويب المستودع الإعلاني، ثم انقر على الزر + إضافة ضمن جدول التطبيقات والمواقع الإلكترونية.

املأ بقية النموذج وانقر على إرسال.

دوِّن رقم تعريف التطبيق.

إنشاء خانة إعلانية

بعد مراجعة طلبك، انتقِل إلى جدول الخانات الإعلانية وانقر على الزر + إضافة.

اختَر عروض الأسعار على الخادم في نوع المزاد، واملأ بقية النموذج، ثم انقر على إرسال.

دوِّن رقم تعريف الخانة الإعلانية.

تعديل ملف app-ads.txt

مبادرة "البائعون المعتمَدون للتطبيقات" app-ads.txt هي مبادرة يقدّمها "مختبر IAB التقني" للمساعدة في ضمان عدم بيع المساحة المتوفّرة للإعلانات في تطبيقك سوى من خلال القنوات التي حدَّدت أنّها مخوّلة. لتجنُّب حدوث خسائر كبيرة في إيرادات الإعلانات، عليك استخدام ملف app-ads.txt. إذا لم يسبق لك إجراء ذلك، عليك إنشاء ملف app-ads.txt في "إدارة إعلانات Google".

لتنفيذ app-ads.txt لحزمة تطوير البرامج (SDK) الخاصة بـ BIGO Ads، انتقِل إلى علامة التبويب APP-ads.txt من لوحة البيانات واتّبِع التعليمات الواردة في علامة التبويب.

الخطوة 2: إعداد طلب BIGO Ads SDK في واجهة مستخدم "مدير إعلانات Google"

سجِّل الدخول إلى حسابك على "مدير إعلانات Google".

إضافة حزمة تطوير البرامج (SDK) الخاصة بمنصة BIGO Ads في "الشركات"

تفعيل ميزة "مشاركة الإشارات الآمنة"

مشاركة الإشارات الآمنة في طلبات عروض الأسعار

السماح بمشاركة الإشارات الآمنة في ميزة "عروض الأسعار باستخدام حِزم تطوير البرامج (SDK)"

ضبط عروض الأسعار باستخدام حزمة تطوير البرامج (SDK) من BIGO Ads

ضبط عملية ربط الوحدات الإعلانية

إضافة BIGO TECHNOLOGY PTE LTD إلى قائمة شركاء الإعلانات بموجب اللائحة العامة لحماية البيانات ولوائح الولايات الأمريكية

اتّبِع الخطوات الواردة في إعدادات اللوائح التنظيمية الأوروبية و إعدادات اللوائح التنظيمية في الولايات الأمريكية لإضافة Empathy Technology Pte.Ltd. (BIGO Ads) إلى قائمة الشركاء الإعلانيين بموجب اللوائح التنظيمية الأوروبية وإضافة ** BIGOAds** إلى قائمة الشركاء الإعلانيين بموجب اللوائح التنظيمية في الولايات الأمريكية ضمن واجهة مستخدم "إدارة إعلانات Google".

الخطوة 3: استيراد حزمة تطوير البرامج (SDK) والمحوّل الخاصَّين بمنصة BIGO Ads

دمج "استوديو Android" (يُنصح به)

في ملف Gradle على مستوى التطبيق، أضِف تبعيات التنفيذ التالية:

dependencies {
    implementation("com.google.android.gms:play-services-ads:25.5.0")
    implementation("com.google.ads.mediation:bigo:6.1.0.0")
}

dependencies {
    implementation 'com.google.android.gms:play-services-ads:25.5.0'
    implementation 'com.google.ads.mediation:bigo:6.1.0.0'
}

الخطوة 4: تنفيذ إعدادات الخصوصية على حزمة تطوير البرامج (SDK) لمنصة BIGO Ads

موافقة المستخدمين في الاتحاد الأوروبي و"اللائحة العامة لحماية البيانات"

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

تقرأ حزمة تطوير البرامج (SDK) من BIGO Ads تلقائيًا الموافقة بموجب اللائحة العامة لحماية البيانات (GDPR) التي تم ضبطها من خلال منصات إدارة الموافقة، بما في ذلك حزمة تطوير البرامج لمنصة UMP. لمزيد من المعلومات، يُرجى الاطّلاع على دليل دمج حزمة تطوير البرامج (SDK) الخاصة بـ "إعلانات BIGO" حول اللائحة العامة لحماية البيانات.

قوانين الخصوصية في الولايات الأمريكية

تتطلّب قوانين الخصوصية في الولايات الأمريكية منح المستخدمين الحق في إيقاف "بيع" "معلوماتهم الشخصية" (وفق تعريف القانون لهاتَين العبارتَين)، باستخدام ميزة الإيقاف المقدّمة من خلال رابط بارز يتضمّن العبارة "عدم بيع معلوماتي الشخصية" على الصفحة الرئيسية للطرف الذي يُجري عملية "البيع". يتيح دليل الامتثال لقوانين الخصوصية في الولايات الأمريكية إمكانية تفعيل المعالجة المحدودة للبيانات لعرض إعلانات Google، ولكن لا يمكن لـ Google تطبيق هذا الإعداد على كل شبكة إعلانات في سلسلة التوسّط. لذلك، عليك تحديد كل شبكة إعلانات في سلسلة التوسّط قد تشارك في بيع المعلومات الشخصية واتّباع الإرشادات المقدَّمة من كل شبكة من هذه الشبكات لضمان الامتثال.

يوضّح نموذج الرمز البرمجي التالي كيفية تمرير علامة الموافقة إلى حزمة تطوير البرامج (SDK) الخاصة بمنصة BIGO Ads. يجب استدعاء هذا الإجراء قبل طلب الإعلانات من خلال Google Mobile Ads SDK (Legacy).

BigoAdSdk.setUserConsent(context, ConsentOptions.CCPA, true);
BigoMediationSnippets.java

BigoAdSdk.setUserConsent(context, ConsentOptions.CCPA, true)
BigoMediationSnippets.kt

لمزيد من المعلومات، يُرجى الاطّلاع على دليل دمج حزمة تطوير البرامج (SDK) الخاصة بـ "إعلانات BIGO" على قانون خصوصية المستهلك في كاليفورنيا (CCPA).

الخطوة 5: إضافة الرمز المطلوب

لا يلزم استخدام رمز إضافي لدمج حزمة تطوير البرامج BIGO Ads SDK.

الخطوة 6: اختبار عملية الإعداد

تفعيل الإعلانات الاختبارية

تأكَّد من تسجيل جهازك الاختباري في "إدارة الإعلانات".

توفّر BIGO Ads أرقام تعريف التطبيقات وأرقام تعريف الخانات الإعلانية الاختبارية على Android للمساعدة في الاختبار والدمج.

تأكيد الإعلانات الاختبارية

للتأكّد من تلقّي إعلانات اختبارية من حزمة تطوير البرامج (SDK) الخاصة بـ BIGO Ads، فعِّل اختبار مصدر إعلان فردي في "أداة فحص الإعلانات" باستخدام مصادر الإعلانات BIGO Ads SDK(عروض الأسعار).

خطوات اختيارية

إعلانات مدمجة مع المحتوى

عرض الإعلانات

يعرض محوِّل حزمة تطوير البرامج (SDK) لـ BIGO Ads إعلاناته المدمجة مع المحتوى كعناصر NativeAd. يتم ملء الحقول التالية NativeAd.

رموز الخطأ

إذا لم يتمكّن المحوّل من تلقّي إعلان من حزمة تطوير البرامج (SDK) الخاصة بمنصة BIGO Ads، يمكنك التحقّق من الخطأ الأساسي من استجابة الإعلان باستخدام ResponseInfo.getAdapterResponses() ضمن الفئات التالية:

sg.bigo.ads
com.google.ads.mediation.bigo.BigoMediationAdapter

في ما يلي الرموز والرسائل المصاحبة التي يعرضها محوِّل حزمة تطوير البرامج (SDK) لعرض الإعلانات من BIGO Ads عند تعذّر تحميل إعلان:

سجلّ تغييرات محوّل التوسّط في Bigo على Android

الإصدار 6.1.0.0

• تم التحقّق من التوافق مع الإصدار 6.1.0 من حزمة تطوير البرامج (SDK) لمنصة Bigo Ads.

تم إنشاؤه واختباره باستخدام:

• الإصدار 25.5.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
• الإصدار 1.4.0 من "الجيل التالي من SDK لإعلانات Google على الأجهزة الجوّالة"
• ‫Bigo Ads SDK الإصدار 6.1.0

الإصدار 6.0.1.0

• تم التأكّد من التوافق مع الإصدار 6.0.1 من حزمة تطوير البرامج (SDK) لمنصة Bigo Ads.

تم إنشاؤه واختباره باستخدام:

• الإصدار 25.4.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
• الإصدار 1.4.0 من "الجيل التالي من SDK لإعلانات Google على الأجهزة الجوّالة"
• ‫Bigo Ads SDK الإصدار 6.0.1

الإصدار 6.0.0.1

• ثبِّت إصدار 1.9.0 من تبعية Kotlin الخاصة بالمحوّل (وهو الحد الأدنى من إصدار Kotlin المتوافق مع الجيل التالي من SDK لإعلانات Google على الأجهزة الجوّالة).

تم إنشاؤه واختباره باستخدام:

• الإصدار 25.4.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
• الإصدار 1.4.0 من "الجيل التالي من SDK لإعلانات Google على الأجهزة الجوّالة"
• الإصدار 6.0.0 من حزمة تطوير البرامج (SDK) الخاصة بمنصة Bigo Ads

الإصدار 6.0.0.0

• تم التأكّد من التوافق مع الإصدار 6.0.0 من حزمة تطوير البرامج (SDK) لمنصة Bigo Ads.

تم إنشاؤه واختباره باستخدام:

• الإصدار 25.4.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
• الإصدار 1.3.1 من "الجيل التالي من SDK لإعلانات Google على الأجهزة الجوّالة"
• الإصدار 6.0.0 من حزمة تطوير البرامج (SDK) الخاصة بمنصة Bigo Ads

الإصدار 5.10.1.0

• تم التأكّد من التوافق مع الإصدار 5.10.1 من حزمة تطوير البرامج (SDK) لمنصة Bigo Ads.

تم إنشاؤه واختباره باستخدام:

• الإصدار 25.4.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
• الإصدار 1.2.1 من الجيل التالي من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
• ‫Bigo Ads SDK الإصدار 5.10.1

الإصدار 5.9.0.1

• يتم ربط حقل "الخرائط" AgeRestrictedTreatment بواجهة برمجة التطبيقات COPPA API من Bigo.

تم إنشاؤه واختباره باستخدام:

• الإصدار 25.4.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
• الإصدار 1.2.1 من الجيل التالي من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
• الإصدار 5.9.0 من حزمة تطوير البرامج (SDK) لمنصة Bigo Ads

الإصدار 5.9.0.0

• تم التأكّد من التوافق مع الإصدار 5.9.0 من حزمة تطوير البرامج (SDK) لمنصة Bigo Ads.

تم إنشاؤه واختباره باستخدام:

• الإصدار 25.2.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
• الإصدار 1.0.1 من الجيل التالي من حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة
• الإصدار 5.9.0 من حزمة تطوير البرامج (SDK) لمنصة Bigo Ads

الإصدار 5.8.0.0

• تمت إضافة سمة لإنشاء المحوّل مع مصدر الاعتمادية الخاص بـ "الجيل التالي من SDK لإعلانات Google على الأجهزة الجوّالة".
• تم التأكّد من التوافق مع الإصدار 5.8.0 من حزمة تطوير البرامج (SDK) لمنصة Bigo Ads.

تم إنشاؤه واختباره باستخدام:

• الإصدار 25.1.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
• ‫Bigo Ads SDK الإصدار 5.8.0

الإصدار 5.7.1.0

• تم التأكّد من التوافق مع الإصدار 5.7.1 من حزمة تطوير البرامج (SDK) الخاصة بمنصة Bigo Ads.

تم إنشاؤه واختباره باستخدام:

• الإصدار 25.0.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
• Bigo Ads SDK version 5.7.1.

الإصدار 5.7.0.0

• تمّت إضافة إمكانية إعادة توجيه مَعلمة tagForUnderAgeOfConsent "SDK لإعلانات Google على الأجهزة الجوّالة" إلى حزمة Bigo Ads SDK.
• تم التأكّد من التوافق مع الإصدار 5.7.0 من حزمة تطوير البرامج (SDK) لمنصة Bigo Ads.

تم إنشاؤه واختباره باستخدام:

• الإصدار 24.9.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
• ‫Bigo Ads SDK الإصدار 5.7.0

الإصدار 5.5.2.0

• تمّت إضافة إمكانية استخدام أشكال الإعلانات التالية: إعلانات البانر والإعلانات البينية والإعلانات مقابل مكافأة والإعلانات المدمجة مع المحتوى.
• تم التأكّد من التوافق مع الإصدار 5.5.2 من حزمة تطوير البرامج (SDK) لمنصة Bigo Ads.

تم إنشاؤه واختباره باستخدام:

• الإصدار 24.9.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
• الإصدار 5.5.2 من حزمة تطوير البرامج (SDK) الخاصة بمنصة Bigo Ads