تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

النماذج الأصلية

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

باستخدام الإعلانات المدمجة مع المحتوى، يمكنك تخصيص إعلاناتك بما يؤدي إلى تحسين تجربة المستخدم. يمكن لتجارب المستخدمين الأفضل أن تزيد من تفاعل المستخدمين وتحسن إجمالي أرباحك.

لتحقيق أقصى استفادة من الإعلانات المدمجة مع المحتوى، من المهم تعديل نمط تنسيقات إعلاناتك بحيث تبدو وكأنها إضافة طبيعية لتطبيقك. لمساعدتك في البدء، أنشأنا نماذج مدمجة مع المحتوى.

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

يتم توفير نماذجنا الأصلية كوحدة "استوديو Android"، لذا من السهل تضمينها في مشروعك واستخدامها كيفما تشاء.

أحجام النماذج

هناك نموذجان: صغير ومتوسط. يستخدم كلاهما الفئة TemplateView ولكل منهما نسبة عرض إلى ارتفاع ثابتة. سيتم تغيير حجمها لملء عرض وجهات نظر الوالدين.

نموذج صغير

@layout/gnt_small_template_view

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

نموذج Medium

@layout/gnt_medium_template_view

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

لا تتردد في تجربة موضع الإعلان. بالطبع، يمكنك أيضًا تغيير رمز المصدر وملفات XML بما يتناسب مع متطلباتك.

تثبيت نماذج الإعلانات المدمجة مع المحتوى

لتثبيت النماذج الأصلية، ما عليك سوى تنزيل ملف ZIP (باستخدام خيار نسخ أو تنزيل على GitHub) واستيراد الوحدة إلى مشروع "استوديو Android" الحالي.

اختر ملف > جديد > وحدة استيراد.
اختَر المجلد nativetemplates.

أضِف السطر التالي إلى ملف build.gradle على مستوى التطبيق:

dependencies {
        ...
        implementation project(':nativetemplates')
        ...
}

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

يمكنك استخدام النموذج في أي ملف XML للتنسيق، مثل أي مجموعة طرق عرض أخرى.

إضافة نموذج إلى التنسيق

استخدام القوالب عملية مكونة من خطوتين:

أولاً، تحتاج إلى تضمين القالب كجزء من التخطيط الخاص بك.

<LinearLayout
   xmlns:android="http://schemas.android.com/apk/res/android"
   xmlns:app="http://schemas.android.com/apk/res-auto"
   xmlns:tools="http://schemas.android.com/tools"
   android:layout_width="match_parent"
   android:layout_height="match_parent"
   tools:context=".MainActivity"
   tools:showIn="@layout/activity_main" >

<!--  This is your template view -->
<com.google.android.ads.nativetemplates.TemplateView
   android:id="@+id/my_template"
   <!-- this attribute determines which template is used. The other option is
    @layout/gnt_medium_template_view -->
   app:gnt_template_type="@layout/gnt_small_template_view"
   android:layout_width="match_parent"
   android:layout_height="match_parent" />

...
</LinearLayout>

بعد ذلك، عليك تخصيص إعلانك المدمج مع المحتوى للنموذج عند تحميله:

MobileAds.initialize(this);
AdLoader adLoader = new AdLoader.Builder(this, "/6499/example/native")
    .forNativeAd(new NativeAd.OnNativeAdLoadedListener() {
        @Override
        public void onNativeAdLoaded(NativeAd nativeAd) {
            NativeTemplateStyle styles = new
              NativeTemplateStyle.Builder().withMainBackgroundColor(background).build();
            TemplateView template = findViewById(R.id.my_template);
            template.setStyles(styles);
            template.setNativeAd(nativeAd);
        }
     })
     .build();

adLoader.loadAd(new AdManagerAdRequest.Builder().build());

مفاتيح قاموس الأنماط

هناك طريقتان لتصميم النموذج: استخدام تنسيق XML التقليدي، واستخدام كائن NativeTemplateStyle.Builder. يوضّح نموذج الرمز البرمجي أعلاه كيفية استخدام الكائن NativeTemplateStyle.Builder لضبط لون الخلفية الرئيسي، ولكن هناك مجموعة متنوّعة من الخيارات الأخرى أيضًا. فيما يلي جميع طرق الإنشاء المتاحة. تعرض أداة الإنشاء كائن NativeTemplateStyle الذي يلغي أي نمط تنسيق XML. يستخدم تنسيقا XML gnt_small_template.xml وgnt_medium_template.xml نفس معلمات تصميم Android المألوفة لك من قبل.

طرق إنشاء نمط النماذج المدمجة مع المحتوى
`withCallToActionTextTypeface`	`Typeface callToActionTextTypeface` الخط الطباعي لعبارة الحث على اتخاذ إجراء.
`withCallToActionTextSize`	`float callToActionTextSize` حجم نص عبارة الحث على اتخاذ إجراء.
`withCallToActionTypefaceColor`	`int callToActionTypefaceColor` لون نص عبارة الحث على اتخاذ إجراء.
`withCallToActionBackgroundColor`	`ColorDrawable callToActionBackgroundColor` لون الخلفية لعبارة الحث على اتخاذ إجراء.
`withPrimaryTextTypeface`	`Typeface primaryTextTypeface` الخط الطباعي للصف الأول من النص.
`withPrimaryTextSize`	`float primaryTextSize` حجم الصف الأول من النص.
`withPrimaryTextTypefaceColor`	`int primaryTextTypefaceColor` لون الصف الأول من النص
`withPrimaryTextBackgroundColor`	`ColorDrawable primaryTextBackgroundColor` لون الخلفية للصف الأول من النص
`withSecondaryTextTypeface`	`Typeface secondaryTextTypeface` الخط الطباعي للصف الثاني من النص.
`withSecondaryTextSize`	`float secondaryTextSize` حجم الصف الثاني من النص.
`withSecondaryTextTypefaceColor`	`int secondaryTextTypefaceColor` لون النص للصف الثاني من النص
`withSecondaryTextBackgroundColor`	`ColorDrawable secondaryTextBackgroundColor` لون الخلفية للصف الثاني من النص
`withTertiaryTextTypeface`	`Typeface tertiaryTextTypeface` الخط الطباعي للصف الثالث من النص.
`withTertiaryTextSize`	`float tertiaryTextSize` حجم الصف الثالث من النص.
`withTertiaryTextTypefaceColor`	`int tertiaryTextTypefaceColor` لون النص للصف الثالث من النص
`withTertiaryTextBackgroundColor`	`ColorDrawable tertiaryTextBackgroundColor` لون خلفية الصف الثالث من النص
`withMainBackgroundColor`	`ColorDrawable mainBackgroundColor` لون الخلفية الرئيسية

المساهمة

لقد أنشأنا نماذج مدمجة مع المحتوى لمساعدتك على تطوير الإعلانات المدمجة مع المحتوى بسرعة. يسعدنا أن نرى مشاركتك في مستودعنا GitHub لإضافة نماذج أو ميزات جديدة. أرسل إلينا طلب سحب وسنلقي نظرة عليه.