โฆษณาเนทีฟ

โฆษณาเนทีฟคือเนื้อหาโฆษณาที่แสดงแก่ผู้ใช้ผ่านคอมโพเนนต์ UI ซึ่ง อยู่ในแพลตฟอร์มนี้โดยตรง โฆษณาเหล่านี้แสดงโดยใช้มุมมองประเภทเดียวกันกับ ซึ่งคุณสร้างเค้าโครงไว้แล้ว และสามารถจัดรูปแบบให้ตรงกับ ในการออกแบบรูปลักษณ์ของแอป

เมื่อโฆษณาเนทีฟโหลด แอปจะได้รับออบเจ็กต์โฆษณาที่มีชิ้นงานอยู่ และแอปแทน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ทำหน้าที่แสดงแทน

พูดกว้างๆ ก็คือการใช้โฆษณาเนทีฟให้ประสบความสำเร็จแบ่งออกเป็น 2 ส่วน ดังนี้ โหลดโฆษณาโดยใช้ SDK แล้วแสดงเนื้อหาโฆษณาในแอป

หน้านี้แสดงวิธีใช้ SDK เพื่อโหลด โฆษณาเนทีฟ

ข้อกำหนดเบื้องต้น

• ทำตามคู่มือเริ่มต้นใช้งาน

ทดสอบด้วยโฆษณาทดสอบเสมอ

เมื่อสร้างและทดสอบแอป โปรดใช้โฆษณาทดสอบแทน โฆษณาที่ใช้งานจริง

วิธีที่ง่ายที่สุดในการโหลดโฆษณาทดสอบคือการใช้รหัสหน่วยโฆษณาทดสอบโดยเฉพาะของเรา สำหรับโฆษณาเนทีฟบน Android

/21775744923/example/native

อุปกรณ์นี้ได้รับการกําหนดค่ามาเป็นพิเศษให้แสดงโฆษณาทดสอบสําหรับคําขอทุกรายการ และคุณสามารถนำไปใช้ในแอปของคุณเองได้ขณะเขียนโค้ด ทดสอบ และแก้ไขข้อบกพร่อง เพียงตรวจสอบให้แน่ใจว่าคุณ แทนที่ด้วยรหัสหน่วยโฆษณาของคุณเองก่อนที่จะเผยแพร่แอป

ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีการทำงานของโฆษณาทดสอบของ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ได้ที่โฆษณาทดสอบ

โหลดโฆษณา

โฆษณาเนทีฟจะโหลดด้วย AdLoader ชั้นเรียน ซึ่งมี Builder เพื่อปรับแต่งในระหว่างการสร้างได้ เพิ่ม Listener ใน AdLoader เมื่อคุณสร้างโฆษณา แอปจะระบุประเภทของโฆษณาเนทีฟที่แอปพร้อม ได้รับ จากนั้น AdLoader จะขอเฉพาะประเภทเหล่านั้น

สร้าง AdLoader

ประเด็นหลัก: เรียกใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ทั้งหมดในชุดข้อความหลัก

โค้ดต่อไปนี้แสดงวิธีสร้าง AdLoader ที่โหลดโฆษณาเนทีฟได้ โฆษณา:

Java

AdLoader adLoader = new AdLoader.Builder(context, "/21775744923/example/native")
    .forNativeAd(new NativeAd.OnNativeAdLoadedListener() {
        @Override
        public void onNativeAdLoaded(NativeAd nativeAd) {
            // Show the ad.
        }
    })
    .withAdListener(new AdListener() {
        @Override
        public void onAdFailedToLoad(LoadAdError adError) {
            // Handle the failure by logging, altering the UI, and so on.
        }
    })
    .withNativeAdOptions(new NativeAdOptions.Builder()
            // Methods in the NativeAdOptions.Builder class can be
            // used here to specify individual options settings.
            .build())
    .build();

Kotlin

val adLoader = AdLoader.Builder(this, "/21775744923/example/native}")
    .forNativeAd { ad : NativeAd ->
        // Show the ad.
    }
    .withAdListener(object : AdListener() {
        override fun onAdFailedToLoad(adError: LoadAdError) {
            // Handle the failure.
        }
    })
    .withNativeAdOptions(NativeAdOptions.Builder()
            // Methods in the NativeAdOptions.Builder class can be
            // used here to specify individual options settings.
            .build())
    .build()

คำเตือน: การพยายามโหลดโฆษณาใหม่จากเมธอด onAdFailedToLoad() มีดังนี้ ไม่แนะนำอย่างยิ่ง หากคุณต้องโหลดโฆษณาจาก onAdFailedToLoad() ให้จำกัดการแสดงโฆษณา พยายามโหลดซ้ำเพื่อหลีกเลี่ยงคำขอโฆษณาที่ล้มเหลวอย่างต่อเนื่องในสถานการณ์ต่างๆ เช่น การเชื่อมต่อเครือข่ายที่จำกัด

วิธีการ forNativeAd() จะมีหน้าที่เตรียม AdLoader สำหรับรูปแบบ NativeAd เมื่อโฆษณาโหลดสําเร็จ ระบบจะเรียกonNativeAdLoaded() เมธอดของออบเจ็กต์ตัวฟัง

ตั้งค่า AdListener ด้วย AdLoader (ไม่บังคับ)

เมื่อสร้าง AdLoader พารามิเตอร์ withAdListener ตั้งค่าฟังก์ชัน AdListener สำหรับ ตัวโหลด เมธอดนี้รับ AdListener เป็นพารามิเตอร์โดดเดี่ยว ซึ่งจะได้รับ Callback จาก AdLoader เมื่อเหตุการณ์ในวงจรโฆษณาเกิดขึ้น

Java

.withAdListener(new AdListener() {
    // AdListener callbacks can be overridden here.
})

Kotlin

.withAdListener(object : AdListener() {
    // AdListener callbacks can be overridden here.
})

ส่งคำขอแสดงโฆษณา

เคล็ดลับ: คุณสามารถใช้การเรียกจำนวนโฆษณาเพื่อสร้างแคชของโฆษณาที่โหลดล่วงหน้าก่อนที่จะ ที่ตั้งใจจะแสดงโฆษณาเหล่านั้น เพื่อที่คุณจะสามารถแสดงโฆษณาโดยที่ไม่ต้องการตอบสนองใดๆ เมื่อจําเป็น เนื่องจากโฆษณาจะหมดอายุใน 1 ชั่วโมง คุณควรล้างแคชและโหลดซ้ำ โฆษณาในทุกๆ ชั่วโมง

เมื่อสร้าง AdLoader เสร็จแล้ว ก็ถึงเวลาใช้ AdLoader เพื่อขอโฆษณา ใช้เมธอด loadAd() ซึ่งรับออบเจ็กต์ AdManagerAdRequest เป็นพารามิเตอร์แรก นี่เหมือนเดิม มี AdManagerAdRequest คลาสที่แบนเนอร์และโฆษณาคั่นระหว่างหน้าใช้ และคุณสามารถใช้วิธีการของคลาส AdManagerAdRequest เพื่อ เพิ่มข้อมูลการกําหนดเป้าหมาย กับรูปแบบโฆษณาอื่นๆ

loadAd()

วิธีการนี้จะส่งคำขอสำหรับโฆษณาเดียว

Java

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

Kotlin

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

หมายเหตุ: Ad Manager ไม่รองรับเมธอด loadAds() และแสดงผลเพียงเมธอด โฆษณาเดียวหากใช้

Callback

หลังจากโทรหา loadAd() แล้ว ระบบจะเรียกกลับไปยังหมายเลขที่กำหนดไว้ก่อนหน้า วิธีฟังแสดงออบเจ็กต์โฆษณาเนทีฟหรือรายงานข้อผิดพลาด

ปล่อยทรัพยากร

อย่าลืมใช้เมธอด destroy() กับโฆษณาเนทีฟที่โหลด รุ่นนี้ ใช้ประโยชน์จากทรัพยากรและป้องกันการรั่วไหลของหน่วยความจำ

ประเด็นหลัก: ต้องมีการเรียก destroy() ในโฆษณาทั้งหมด แม้ว่าจะไม่มีการใช้งานก็ตาม หรืออ้างอิง

ตรวจสอบว่าได้ทำลายการอ้างอิง NativeAd ทั้งหมดในกิจกรรม onDestroy() วิธี

ในการเรียกกลับของ onNativeAdLoaded โปรดตรวจสอบว่าได้ทำลายข้อมูลที่มีอยู่ โฆษณาเนทีฟที่จะถูกยกเลิกการอ้างอิง

การตรวจสอบคีย์อื่นคือหากกิจกรรมถูกทำลายแล้ว หากเป็นเช่นนั้น ให้เรียกใช้ destroy() โฆษณาที่แสดงและส่งคืนทันที:

Java

final AdLoader adLoader = new AdLoader.Builder(this, "/21775744923/example/native")
        .forNativeAd(new NativeAd.OnNativeAdLoadedListener() {
    @Override
    public void onNativeAdLoaded(NativeAd nativeAd) {
        // If this callback occurs after the activity is destroyed, you
        // must call destroy and return or you may get a memory leak.
        // Note `isDestroyed()` is a method on Activity.
        if (isDestroyed()) {
            nativeAd.destroy();
            return;
        }
        ...
    }
}).build();

Kotlin

lateinit var adLoader: AdLoader
...
adLoader = AdLoader.Builder(this, "/21775744923/example/native")
    .forNativeAd { nativeAd ->
        // If this callback occurs after the activity is destroyed, you
        // must call destroy and return or you may get a memory leak.
        // Note `isDestroyed` is a method on Activity.
        if (isDestroyed) {
            nativeAd.destroy()
            return@forNativeAd
        }
        ...
    }.build()

แนวทางปฏิบัติแนะนำ

ทำตามกฎเหล่านี้ขณะโหลดโฆษณา

• แอปที่ใช้โฆษณาเนทีฟในรายการควรแคชรายการโฆษณาไว้ล่วงหน้า

• เมื่อแคชโฆษณาล่วงหน้า ให้ล้างแคชและโหลดซ้ำหลังจากผ่านไป 1 ชั่วโมง

• อย่าโทรหา loadAd() ที่AdLoader จนกว่าจะถึงช่วงแรก โหลดคำขอเสร็จ

การเร่งฮาร์ดแวร์สำหรับโฆษณาวิดีโอ

เพื่อให้โฆษณาวิดีโอแสดง ในการดูโฆษณาเนทีฟได้สำเร็จ ฮาร์ดแวร์ การเร่งความเร็ว ต้องเปิดใช้งาน

การเร่งฮาร์ดแวร์จะเปิดใช้โดยค่าเริ่มต้น แต่บางแอปอาจเลือกให้ ปิดใช้ หากการตั้งค่านี้มีผลกับแอปของคุณ เราขอแนะนำให้เปิดใช้ฮาร์ดแวร์ การเร่งความเร็วสำหรับคลาสกิจกรรมที่ใช้โฆษณา

การเปิดใช้การเร่งฮาร์ดแวร์

หากแอปทำงานไม่ถูกต้องเมื่อเปิดการเร่งฮาร์ดแวร์ ทั่วโลก คุณสามารถควบคุมแต่ละกิจกรรมได้ด้วย หากต้องการเปิดใช้หรือ ปิดใช้การเร่งฮาร์ดแวร์ ใช้แอตทริบิวต์ android:hardwareAccelerated สำหรับ <application> และ <activity> องค์ประกอบใน AndroidManifest.xml ของคุณ ตัวอย่างต่อไปนี้เปิดใช้ฮาร์ดแวร์ การเร่งความเร็วสำหรับทั้งแอป แต่ปิดใช้ในกิจกรรมเดียว

<application android:hardwareAccelerated="true">
    <!-- For activities that use ads, hardwareAcceleration should be true. -->
    <activity android:hardwareAccelerated="true" />
    <!-- For activities that don't use ads, hardwareAcceleration can be false. -->
    <activity android:hardwareAccelerated="false" />
</application>

ดู การเร่งความเร็ว HW guideสำหรับ ข้อมูลเพิ่มเติมเกี่ยวกับตัวเลือกในการควบคุมการเร่งฮาร์ดแวร์ หมายเหตุ คุณจะไม่สามารถเปิดใช้การเร่งฮาร์ดแวร์หากการดูโฆษณาแต่ละรายการ กิจกรรมถูกปิดใช้ ดังนั้นกิจกรรมจะต้องเร่งฮาร์ดแวร์ เปิดอยู่

แสดงโฆษณา

เมื่อคุณโหลดโฆษณาแล้ว ที่เหลือก็คือการแสดงโฆษณาแก่ผู้ใช้ของคุณ ไปที่เนทีฟขั้นสูง เพื่อดูวิธีการ