Liaالمطورون

المفاهيم

إعلانات شاشة كاملة بثلاثة أشكال، بالإضافة إلى الإعلانات الشريطية والمنسقة التي Lia تُثبت بجانب صفحتك. جميعها تُعرض بواسطة Lia وتُنظم بحيث لا يشعر أحد بالإرهاق. يمكن لخادمك التحقق من أن الفيديو المُكافئ تم مشاهدته فعليًا قبل منح أي شيء.

#ثلاثة أشكال

التنسيقماذا هومتى تستخدمه
rewardedفيديو يختاره الشخص لمشاهدته، مقابل شيء ما."شاهد فيديو للحصول على فرصة ثانية."
rewardedInterstitialيقدم Lia أولًا، مع خيار المشاهدة والتجاهل، ثم يعرضه كمكافأة.مكافأة في نقطة طبيعية، دون زر خاص بك.
interstitialإعلان كامل بين اللحظات، دون أي شيء في المقابل.بين الجولات أو المستويات. Lia تتحكم في هذه.

صفحتك تسأل بـ Lia.showAd({ format }), أو الإختصارات Lia.showRewardedAd(), Lia.showRewardedInterstitialAd() و Lia.showInterstitialAd(). Lia يحمل الإعلان ويعرضه داخل تطبيقك، مع مشغله الخاص أثناء التحميل، ويوقف تطبيقك حتى ينتهي من'مغلق.

#ما تعيده

كل استدعاء إعلان يجيب بمجرد إغلاق الإعلان:

{ "watched": true, "shown": true, "adId": "ad_8e1c4b0f2a9d47c6b3e15a07" }
حقلالمعنى
watchedتم مشاهدة فيديو مكافأة حتى نهايته. قدم المكافأة. دائمًا false للوحة إعلانية.
shownإعلان ظهر على الشاشة.
adIdالإعلان'معرّفها، لخادمك للتحقق. ظاهر عندما watched هو صحيح، وعندما تم عرض إعلان.
reasonلماذا هناك'لا يوجد مكافأة، عندما watched هو خاطئ.

الأسباب التي'سوف ترى:

السببالمعنى
cancelledأغلقوا الفيديو قبل انتهائه.
skippedاختاروا تخطي عندما عرضت Lia إعلانًا مُكافأة.
no_adلم يكن هناك إعلان جاهز للعرض.
too_soonإعلان، ولا'لأنها دوريها، فإنه يتم حلها فورًا مع
failedLia لم تتمكن'لتسجيل العرض.
أي شيء آخرمشكلة اتصال أو خادم، مثل network.

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

#أي واحد يستخدم

  • بين الجولات والألعاب: الإعلانات الوسطية. هم'مختصرة وقابلة للإغلاق، ولا يحتاج أحد إلى اختيارها. اتصل Lia.showInterstitialAd() في كل توقف طبيعي (تنتهي الجولة، لعب مرة أخرى) ودع Lia تقرر ما إذا كان يجب عرضه.
  • المكافآت فقط عندما يطلب اللاعب لشيء في المقابل: ملاحظة، فرصة ثانية، دوران إضافي، خلف زر يقول ذلك. لا تلعب واحدة بمفردها بين الجولات: فيديو طويل Someone لم يلعبه'ت الاختيار هو ما يجعل الناس يغادرون اللعبة.

#السرعة

ألعاب' النوافذ الإعلانية لها إيقاعها الخاص، منفصل عن Lia'مملكتها الإعلانات: بشكل افتراضي، على الأكثر إعلان واحد كل 90 ثانية، وفقط كل 2nd مرة يطلب فيها تطبيقك (كل جولة أو لعبة 2nd). يمكن لفريق Lia تعديل كلاهما. عندما لا'لدورهم، showInterstitialAd() الإجابات فورًا بـ reason: "too_soon" ولا شيء يتم عرضه. فقط استمر.

فيديوهات مكافأة فقط عندما يطلب اللاعب'لإيقافهم، لأن الناس يختارونهم، ومشاهدة واحد لا تدفع الترويج التالي أبداً.

#إعلانات جوجل الخاصة بك، في صفحتك

تريد إعلانًا داخل محتواك، يتحرك معه، مثل مساحة بين صفوف تدفق؟ استخدم علامات الإعلانات الخاصة بك من Google (AdSense أو Google Ad Manager) في صفحتك'س HTML، كما في أي موقع ويب. Lia تسجل عرض الويب الخاص بها مع جوجل'س الإعلانات SDK (الـ WebView API للإعلانات)، لذا يتم تقديم علاماتك كإعلانات داخل التطبيق، و:

  • جوجل'س إطارات الإعلانات تُحمَّل داخل صفحتك. الإطارات من أي موقع آخر ما زالت ممنوعة، لذلك شبكات الإعلانات الأخرى' يأخذ'لا يعمل.
  • الضغط على الإعلان يفتحه في سافاري, ويبقى تطبيقك حيث كان.
  • المال يذهب إلى حسابك الخاص في جوجل, تحت سياسات جوجل الخاصة بك. Lia لا'ت عد هذه الإعلانات أو مشاركتها، ولا ينطبق قاعدة وضع الاختبار أدناه.'لإغلاقها: استخدم شبكةك'إعلانات الاختبار أثناء بنائك (في مدير الإعلانات، جوجل'وحدة العينة /6355419/Travel/Europe/France/Paris; في AdSense، data-adtest="on").
<script async src="https://securepubads.g.doubleclick.net/tag/js/gpt.js"></script>
<div id="feed-ad"></div>
<script>
  window.googletag = window.googletag || { cmd: [] };
  googletag.cmd.push(function () {
    googletag.defineSlot("/6355419/Travel/Europe/France/Paris", [300, 250], "feed-ad").addService(googletag.pubads());
    googletag.enableServices();
    googletag.display("feed-ad");
  });
</script>

يحتاج إلى Lia'س التطبيق من الإصدار التالي. العلامة نموذج SDK يملك "تحميل إعلان تجريبي هنا" زر يفعل بالضبط هذا.

#مفاتيح الاختبار تحصل دائمًا على إعلانات تجريبية

بينما يكون تطبيقك مفتوحًا في وضع الاختبار (المطورين والمختبرين الخاصين بك، باستخدام مفتاح الاختبار الخاص بك)، فإن كل إعلان Lia الذي يظهر فيه هو واحد من جوجل'إعلانات الاختبار: كامل الشاشة، الشريط العلوي والطبيعي، ما هو Lia'إعداداته الخاصة. إنهم'تم تسجيله (/ads/verify tilt يجيب عنهم) لكنه لا يُحسب أبدًا لتطبيقك'أرقامها أو دخلها. الوضع الحي يعرض الإعلانات الحقيقية.

#التحقق على خادمك

لأي مكافأة مهمة، لا'لأخذ الصفحة's watched: true على كلمته. أرسل adId إلى خادمك، واطلب من Lia مع POST /ads/verify:

{ "adId": "ad_8e1c4b0f2a9d47c6b3e15a07", "playerId": "p_3f9c0a6d1b2e4f5a6b7c", "watched": true, "watchedAt": 1761998400000 }

تحقق من أن watched هو صحيح وال playerId هو اللاعب المُرسل. Lia لا'لتحديد إعلان كمستخدم، ادفع لكل adId مرة واحدة: باستخدام ad:<adId> كما هو مفتاح المكافأة يقوم بذلك لك. إعلانات مكافأة تدفع يعرض التدفق بالكامل.

#الالتزام

تمرير onState لإخفاءه. آخر Lia.onAd(fn):

Lia.showRewardedAd({
  onState: function (state) { // "loading", "showing", "closed"
    if (state === "loading") pauseMusic();
    if (state === "closed") resumeMusic();
  },
});

#ما نوصي به الألعاب

إعلانات تجلس بجانب اللعبة، أبدًا فوقها:

  1. شريط إعلان مثبت لجميع الزيارة. مكالمة Lia.showBanner({ position: "top" }) مرة واحدة، قبل Lia.ready(), وانتظره (أو بضع ثوانٍ). Lia'محمله يغطي صفحتك حتى يتم تثبيت الشارة، لذلك لا يرى اللاعب أي حركة في التخطيط، ويظل ثابتًا أثناء اللعب. Lia'مملكتها الألعاب تثبتها في الأعلى: الحافة السفلية هي حيث تقع الأصابع والأزرار، وتحتاج لعبة تُلعب بالانحدار أو السحب إلى مساحة لعب خالية.
  2. صفحة إعلان داخل شاشة هادئة, مثل منزلك أو لوبى، مع علامة إعلان جوجل الخاصة بك (انظر إعلانات جوجل الخاصة بك). ضعها بعد الشاشة'مملكتها المحتوى، امنحها مساحة فوق أزرارك، وعلّمها "إعلان", وعرضه فقط مرة واحدة بعد ملء الإعلان. لا تضعه تحت لوح أو ساعة أو زر يضغط عليه اللاعبون بسرعة.
  3. إعلان بين الجولات (Lia.showInterstitialAd()), والتي تُنظمها Lia.

احتفظ بالبطاقة الأصلية والورقة أدناه للتطبيقات التي يكون فيها التوقف حقاً توقفًا. في لعبة، تظهر فوق العمل.

Lia.init().then(function () {
  var banner = Lia.showBanner({ position: "top" }).catch(function () {});
  Promise.race([banner, new Promise(function (r) { setTimeout(r, 2500); })]).then(function () {
    Lia.ready(); // the page shows with the banner's room already taken
  });
});

#شريط الإعلانات والإعلانات الطبيعية

منذ SDK 1.7 يمكن لتطبيقاتك أيضًا عرض شريط إعلان، وإعلان متنقل في Lia'مظهرها الخاص. AdMob يمكن'لرسمها داخل صفحة ويب، لذلك Lia ترسم هذه بشكل طبيعي، بجانب صفحتك: بجانب صفحتك بدلًا من داخلها. هذا'الحد الصادق، ويحدد كيفية عملها:

  • لا يغطون تطبيقك أبدًا. إعلان مثبت يستولي على مساحته من صفحتك: يصبح نافذة الويب أقصر، لذلك لا شيء رسمته يجلس أسفله. فقط تحتاج إلى تكييف تصميمك مع الارتفاع الذي'المحفوظات (100dvh, flexbox، أو --lia-viewport-height كلها تتبعه).
  • يمكنهم'لمسح المحتوى الخاص بك. عرض أصلي مثبت في مكان في صفحة تمرير سيتجمد ويتحرك، وهذا يبدو مكسورًا. لذلك هناك'لا "إعلان في صفحتي" slot: الإعلانات تجلس عند الحافة، أو تظهر أثناء التوقف.
مكالمةماذا يعرضه Liaجيد لـ
Lia.showBanner({ position: "bottom" })شريط تكيفي عبر الأسفل (أو "top") الحافة، يتم تحديثها بواسطة AdMob أثناء ذلك'أعلى.القوائم، الممرات، الشاشات الطويلة للقراءة.
Lia.showNativeAd({ placement: "card" })بطاقة مدمجة (أيقونة، عنوان، سطر نص، زرها) مثبتة عند الحافة السفلية، مع زر إغلاق.شاشة نتائج، نهاية جولة.
Lia.showNativeAd({ placement: "sheet" })إعلان كبير مع صورته أو فيديوه، في ورقة فوق تطبيقك، والتي تُوقف حتى ينتهي'مغلق.نقطة انقطاع طبيعية حيث يكون إعلان كامل الشاشة مفرطًا.
// A results screen: a sponsored card under it while it's up.
showResults();
Lia.showNativeAd({ placement: "card" }); // { shown: true, placement: "card", height: 118 }, or { shown: false, reason }

// The next round: the card goes, and the page gets its room back.
Lia.hideNativeAd();

ماذا يجيبون:

إجابةالمعنى
{ shown: true, position, height }الشريط الإعلاني مُفعَّل، height عالي px (حوالي 50 إلى 90).
{ shown: true, placement, height? }الإعلان الطبيعي مفتوح (بطاقة، مع ارتفاعها)، أو تم عرض الورقة وتم إغلاقها الآن.
{ shown: false, reason: "no_ad" }لا شيء تم تحميله في الوقت المحدد. استمر.
{ shown: false, reason: "too_soon" }إعلان أصلي، ولا'لأنها دوريها، فإنه يتم حلها فورًا مع
{ shown: false, reason: "off" }فريق الـ Lia أطفأ هذا النوع من الإعلانات، لتطبيقك أو لجميع الأشخاص.

شريط الإعلان والبطاقة يشتركان في الحافة السفلية. بينما تكون البطاقة مفتوحة، يتحرك الشريط السفلي جانباً (تسمع "hidden") ويعود عندما تُغلق البطاقة. يبقى الشعار العلوي.

تتبع مناطق آمنة. في الحافة حيث يتم تثبيت الإعلان، يُضيف Lia مساحة حوله (شريط المنزل، الشق)، لذلك يرسل safeAreaChanged مع الجانب الآخر في 0 و --lia-safe-area-inset-* تحديث. في وضع الشاشة الكاملة، يجلس شريط أعلى تحت Lia'أزرار الإغلاق العائمة و⋯، وتدور صفحتك أسفلها (contentSafeArea.top تصبح 0).

الالتزام. Lia.banner و Lia.nativeAd تقول ما'الآن ({ visible, position | placement, height }), --lia-banner-height تحتفظ بالشعار'ارتفاعه، و Lia.onBanner(fn) و Lia.onNativeAd(fn) يسمع كل تغيير ("loading", "shown" / "showing", "failed", "hidden" / "closed").

السرعة. الإعلانات المحلية تكون على الأقل دقيقة منفصلة لكل شخص (يمكن للفريق تغييرها)، عبر جميع التطبيقات. الشعارات ليست'لإيقافهم، ولكن لا'لإعطائها مرتين. افعلها في معاملة واحدة مع تسجيل معرف الدفع.' الإيقاف.

#ما تربحه

تحصل على 50% من ما تربحه الإعلانات في تطبيقك، بما في ذلك الإعلانات الشريطية والإعلانات الطبيعية. يحسب Lia كل إعلان يعرضه تطبيقك وما يربحه، ويُدفع جزءك شهريًا إلى رصيدك الخاص في Lia، مع مشاركتك في المبيعات. انظر الحصول على الدفع.

تم الترجمة تلقائيًا. الإنجليزية هي مصدر الحقيقة. اقرأ باللغة الإنجليزية

اكتب للبحث في كل صفحة، وطريقة ونقطة نهاية.