دمج Line مع التوسّط

اختيار النظام الأساسي: Android (إصدار تجريبي) Android iOS Unity Flutter

يوضّح لك هذا الدليل كيفية استخدام GMA Next-Gen SDK لتحميل الإعلانات وعرضها من شبكة إعلانات LINE باستخدام توسط AdMob، مع تغطية عمليات الدمج المتسلسلة. توضّح هذه الصفحة كيفية إضافة LINE Ads Network إلى إعدادات التوسّط الخاصة بوحدة إعلانية، وكيفية دمج حزمة تطوير البرامج (SDK) ومحوّل LINE Ads Network في تطبيق Android.

تستخدم واجهة لوحة البيانات في LINE Ads Network نصًا يابانيًا للتصنيفات والأزرار والأوصاف. لم تتم ترجمة لقطات الشاشة الواردة في هذا الدليل. في المقابل، يتم في أوصاف هذا الدليل وتعليماته ترجمة التصنيفات والأزرار باستخدام ما يعادلها باللغة الإنجليزية بين قوسين.

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

يتضمّن برنامج التكيّف للتوسّط في "شبكة إعلانات LINE" الإمكانات التالية:

¹ تتوفّر الإعلانات المدمجة (لتقديم عروض الأسعار) في إصدار تجريبي مغلق، لذا يُرجى التواصل مع مدير حسابك لطلب الوصول إليها.

المتطلبات

• المستوى 24 لواجهة برمجة التطبيقات Android أو مستوى أعلى

• [لتقديم عروض الأسعار]: لدمج جميع أشكال الإعلانات المتوافقة في عروض الأسعار، استخدِم الإصدار 2.9.20241129.0 أو إصدارًا أحدث من محوّل LINE Ads Network (يُنصح باستخدام أحدث إصدار).

• أحدث محتوى من قناة GMA Next-Gen SDK

• أكمِل دليل البدء الخاص بالتوسّط.

الخطوة 1: إعداد الإعدادات في واجهة مستخدم "شبكة إعلانات LINE"

اشترِك وسجِّل الدخول إلى حسابك على LINE Ads Network.

إضافة تطبيق جديد

انقر على 広告枠管理 (إدارة الخانات الإعلانية) > メディア (الوسائط). بعد ذلك، انقر على 新規作成 (إنشاء جديد).

املأ النموذج وانقر على 登録 (تسجيل).

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

إنشاء موضع إعلان

انقر على معرّف التطبيق الذي تريد إضافة موضع إعلان إليه. بعد ذلك، انقر على 詳細 (التفاصيل).

انقر على スロット 追加 (إضافة خانة).

املأ النموذج للحصول على تفاصيل حول الفترة الزمنية. بالنسبة إلى نوع عروض الأسعار، اختَر عادي لضبط هذه الخانة للوساطة باستخدام العرض الإعلاني بدون انقطاع، أو عروض الأسعار باستخدام حِزم تطوير البرامج (SDK) من Google لضبط هذه الخانة لاستخدام عروض الأسعار. انقر على 登録 (تسجيل) بعد ملء النموذج.

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

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

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

لتنفيذ app-ads.txt لشبكة LINE Ads Network، اطّلِع على لمحة عن app-ads.txt.

الخطوة 2: إعداد طلب LINE Ads Network في واجهة مستخدم AdMob

ضبط إعدادات التوسّط للوحدة الإعلانية

عليك إضافة LINE Ads Network إلى إعدادات التوسّط الخاصة بوحدتك الإعلانية.

أولاً، سجِّل الدخول إلى حسابك على AdMob. بعد ذلك، انتقِل إلى علامة التبويب التوسّط. إذا كانت لديك مجموعة توسّط حالية تريد تعديلها، انقر على اسم مجموعة التوسّط هذه لتعديلها، ثم انتقِل إلى إضافة LINE Ads Network كمصدر إعلان.

لإنشاء مجموعة توسّط جديدة، انقر على إنشاء مجموعة توسّط.

أدخِل شكل الإعلان والمنصة، ثم انقر على متابعة.

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

اربط مجموعة التوسّط هذه بواحدة أو أكثر من وحداتك الإعلانية الحالية على AdMob. بعد ذلك، انقر على تم.

من المفترض أن تظهر الآن بطاقة الوحدات الإعلانية مملوءة بالوحدات الإعلانية التي اخترتها:

إضافة LINE Ads Network كمصدر إعلان

عروض الأسعار

ضمن بطاقة عروض الأسعار في قسم مصادر الإعلانات، انقر على إضافة مصدر إعلان. بعد ذلك، اختَر LINE Ads Network.

انقر على كيفية التوقيع على اتفاقية شراكة وإعداد شراكة عروض أسعار مع LINE Ads Network.



انقر على الإقرار والموافقة، ثم انقر على متابعة.



إذا كان لديك عملية ربط حالية لشبكة LINE Ads Network، يمكنك اختيارها. بخلاف ذلك، انقر على إضافة عملية ربط.



بعد ذلك، أدخِل معرّف التطبيق ومعرّف الخانة الذي حصلت عليهما في القسم السابق. بعد ذلك، انقر على تم.

شلال

ضمن بطاقة العرض بدون انقطاع في قسم مصادر الإعلانات، انقر على إضافة مصدر إعلان.

اختَر شبكة إعلانات LINE وفعِّل مفتاح التبديل التحسين. أدخِل اسم تسجيل الدخول وكلمة المرور اللذين حصلت عليهما في القسم السابق لإعداد ميزة "تحسين مصدر الإعلان" لشبكة LINE Ads Network. بعد ذلك، أدخِل قيمة التكلفة الفعلية لكل ألف ظهور لشبكة LINE Ads Network وانقر على متابعة.



إذا كان لديك عملية ربط حالية بـ "شبكة إعلانات LINE"، يمكنك اختيارها. بخلاف ذلك، انقر على إضافة عملية ربط.

بعد ذلك، أدخِل معرّف التطبيق ومعرّف الخانة الذي حصلت عليهما في القسم السابق. بعد ذلك، انقر على تم.

الخطوة 3: استيراد حزمة تطوير البرامج والمحوّل الخاصَّين بشبكة LINE Ads Network

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

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

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02")
    implementation("com.google.ads.mediation:line:3.0.1.1")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02'
    implementation 'com.google.ads.mediation:line:3.0.1.1'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

الدمج اليدوي

1. نزِّل أحدث إصدار من ملف .aar الخاص بحزمة SDK لشبكة LINE الإعلانية وأضِفه إلى مشروعك.

2. انتقِل إلى عناصر محوّل شبكة LINE Ads Network في مستودع Maven من Google. اختَر أحدث إصدار، ثم نزِّل ملف .aar الخاص بمحوّل شبكة LINE الإعلانية وأضِفه إلى مشروعك.

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

لا يلزم توفير رمز إضافي لدمج "شبكة إعلانات LINE".

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

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

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

يحتوي محوّل LINE Ads Network على طريقة مساعدة لتفعيل وضع الاختبار في LINE Ads Network. يجب ضبط هذا الخيار قبل تهيئة GMA Next-Gen SDK لضمان إعادة توجيهها بشكل صحيح إلى حزمة تطوير البرامج (SDK) الخاصة بشبكة LINE الإعلانية.

LineMediationAdapter.Companion.setTestMode(true);
LineMediationSnippets.java

LineMediationAdapter.setTestMode(true)
LineMediationSnippets.kt

التحقّق من الإعلانات الاختبارية

للتأكّد من أنّك تتلقّى إعلانات اختبارية من LINE Ads Network، فعِّل اختبار مصدر إعلان فردي في أداة فحص الإعلانات باستخدام مصادر الإعلانات LINE Ads Network (العرض الإعلاني بدون انقطاع).

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

المَعلمات الخاصة بالشبكة

يتوافق محوّل LINE Ads Network مع مَعلمة طلب إضافية يمكن تمريرها إلى المحوّل باستخدام الفئة LineExtras. تتضمّن الدالة الإنشائية للفئة المعلمات التالية:

enableAdSound

boolean لتحديد حالة بدء الصوت التلقائية لإعلانات البانر والإعلانات البينية والإعلانات مقابل مكافأة

في ما يلي مثال على الرمز البرمجي لكيفية إنشاء طلب إعلان يضبط هذه المَعلمات:

LineExtras lineExtras = new LineExtras(/* enableAdSound: */ true);
Bundle extras = lineExtras.build();

AdRequest request =
    new AdRequest.Builder().addNetworkExtrasBundle(LineMediationAdapter.class, extras).build();
LineMediationSnippets.java

val lineExtras = LineExtras(enableAdSound = true)
val extras = lineExtras.build()

val request =
  AdRequest.Builder().addNetworkExtrasBundle(LineMediationAdapter::class.java, extras).build()
LineMediationSnippets.kt

استخدام الإعلانات المُدمَجة مع المحتوى

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

يملأ محوّل LINE Ads Network أوصاف الحقول المتقدّمة للإعلانات المدمجة مع المحتوى التالية NativeAd.

¹ بالنسبة إلى الإعلانات المدمجة مع المحتوى، لا توفّر حزمة تطوير البرامج (SDK) الخاصة بشبكة LINE الإعلانية عنصرًا خاصًا برمز التطبيق. بدلاً من ذلك، يملأ محوّل LINE Ads Network رمز التطبيق بصورة شفافة.

رموز الخطأ

إذا لم يتمكّن المحوّل من تلقّي إعلان من LINE Ads Network، يمكنك التحقّق من الخطأ الأساسي من استجابة الإعلان باستخدام ResponseInfo.getAdSourceResponses() ضمن الفئات التالية:

com.line.ads
com.google.ads.mediation.line.LineMediationAdapter

في ما يلي الرموز والرسائل المصاحبة التي يعرضها محوّل LINE Ads Network عندما يتعذّر تحميل إعلان: