ผสานรวม Nend กับสื่อกลาง

คู่มือนี้จะแสดงวิธีใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เพื่อโหลดและแสดงโฆษณาจากโฆษณาโดยใช้สื่อกลาง ซึ่งครอบคลุมการผสานรวม Waterfall โดยจะครอบคลุมวิธีการเพิ่ม Nend ลงในการกำหนดค่าสื่อกลางของหน่วยโฆษณา และวิธีผสานรวม SDK และอะแดปเตอร์ Nend เข้ากับแอป Unity

อินเทอร์เฟซแดชบอร์ดสำหรับ Nend ใช้ข้อความภาษาญี่ปุ่นสำหรับป้ายกำกับ ปุ่ม และคำอธิบาย และภาพหน้าจอที่แสดงด้านล่างยังไม่ได้รับการแปล แต่ในข้อความของคู่มือนี้ ป้ายกำกับและปุ่มต่างๆ จะอ้างถึงด้วยชื่อภาษาอังกฤษ ตัวอย่างเช่น "URL 삭ーム" เป็น "รูปแบบ URL" เป็นต้น

การผสานรวมที่รองรับและรูปแบบโฆษณา

การผสานรวม
การเสนอราคา
น้ำตก
รูปแบบ
แบนเนอร์
โฆษณาคั่นระหว่างหน้า
ได้รับรางวัลแล้ว

ข้อกำหนด

  • Unity 4 ขึ้นไป
  • SDK โฆษณาบนอุปกรณ์เคลื่อนที่ของ Google ล่าสุด
  • เพื่อทำให้ใช้งานได้ใน Android
    • Android API ระดับ 19 ขึ้นไป
  • เพื่อทำให้ใช้งานได้ใน iOS
    • เป้าหมายการติดตั้งใช้งาน iOS 12.0 ขึ้นไป
  • โปรเจ็กต์ Unity ที่ใช้งานได้ซึ่งกำหนดค่าด้วย SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google โปรดดูรายละเอียดในเริ่มต้นใช้งาน
  • ทำตามคู่มือเริ่มต้นใช้งานสื่อกลาง

ขั้นตอนที่ 1: ตั้งการกำหนดค่าใน Nend UI

ลงชื่อสมัครใช้หรือลงชื่อเข้าใช้บัญชี Nend ของคุณ

หากต้องการเพิ่มแอปพลิเคชันไปยังแดชบอร์ด "เพิ่ม" ก่อนอื่นให้คลิกแท็บการจัดการตำแหน่ง แล้วเลือกเว็บไซต์/แอป คลิกปุ่มเพิ่มแอปเพื่อเพิ่มแอปไปยังปลายทาง

สร้างแอปพลิเคชัน

ป้อนชื่อแอปและเลือกแพลตฟอร์มของแอปเป็นประเภทแอปพลิเคชัน ป้อน URL และตรวจสอบว่าแอปของคุณแสดงใน App Store ที่เหมาะสมหรือไม่

(ดูคำถามที่พบบ่อยเกี่ยวกับแอปที่ยังไม่เปิดตัวหากแอปของคุณยังไม่ได้เปิดตัว) เลือกหมวดหมู่สำหรับแอป แล้วคลิกสร้างเมื่อทำเสร็จแล้ว

Android

iOS

แอปพลิเคชันของคุณจะปรากฏบนหน้าแดชบอร์ดเมื่อสร้างแล้ว

Android

iOS

สร้างตำแหน่ง

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

เลือกแอปในเมนูแบบเลื่อนลง จากนั้น ทำตามคำแนะนำด้านล่างสำหรับ รูปแบบโฆษณาที่คุณต้องการ

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

โฆษณาคั่นระหว่างหน้า

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

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

ได้รับรางวัลแล้ว

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

ในส่วนการตั้งค่ารางวัล ให้เลือกเนื้อหารางวัลโดยใช้รายการแบบเลื่อนลง ป้อนชื่อสกุลเงินเสมือนที่ต้องการ เมื่อเสร็จแล้ว คลิกปุ่มสร้างเพื่อสร้างตำแหน่ง

เนทีฟ

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

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

ในส่วนการตั้งค่าโฆษณาเนทีฟ ให้เลือกการวางแนวโฆษณาวิดีโอและประเภทโฆษณาเนทีฟจากรายการ เมื่อเสร็จแล้ว คลิกปุ่มสร้างเพื่อสร้างตำแหน่ง

หากต้องการตั้งค่า AdMob หน่วยโฆษณาในส่วนถัดไป คุณจะต้องมี apiKey และ spotID สำหรับแต่ละตำแหน่ง หากต้องการดูตำแหน่งดังกล่าว ให้ไปที่แท็บการจัดการตำแหน่ง และเลือกปุ่ม SDK ใต้ชื่อแอป

จด apiKey และ spotID

คุณจะต้องใช้คีย์ API สำหรับ Reporting API ของ Nend ซึ่งเรียกกันว่า API Key for Scraping เครื่องมือนี้อยู่บนแท็บเครื่องมือ

ขั้นตอนที่ 2: ตั้งค่าความต้องการเริ่มต้นใน AdMob UI

กำหนดการตั้งค่าสื่อกลางสำหรับหน่วยโฆษณา

Android

ดูวิธีการได้ที่ขั้นตอนที่ 2 ในคู่มือสําหรับ Android

iOS

โปรดดูวิธีการในขั้นตอนที่ 2 ในคู่มือสำหรับ iOS

ขั้นตอนที่ 3: นำเข้า SDK และอะแดปเตอร์ Nend

ดาวน์โหลดปลั๊กอินสื่อกลางโฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชันล่าสุดสำหรับ nend จากลิงก์ดาวน์โหลดใน Changelog และแยกแพ็กเกจ GoogleMobileAdsNendMediation.unitypackage ออกจากไฟล์ zip

ในเครื่องมือแก้ไขโปรเจ็กต์ Unity ให้เลือกเนื้อหา > นำเข้าแพ็กเกจ > แพ็กเกจที่กำหนดเอง แล้วค้นหาไฟล์ GoogleMobileAdsNendMediation.unitypackage ที่ดาวน์โหลดไว้ ตรวจสอบว่าได้เลือกไฟล์ทั้งหมดแล้ว จากนั้นคลิกนำเข้า

จากนั้นเลือกเนื้อหา > ตัวแก้ไขบริการ Google Play > ตัวแก้ไข Android > บังคับให้แก้ไข ไลบรารีของตัวแปลค่าบริการ Google Play ของ Unity จะดำเนินการแก้ปัญหา Dependency ตั้งแต่ต้นและคัดลอกทรัพยากร Dependency ที่ประกาศไว้ในไดเรกทอรี Assets/Plugins/Android ของแอป Unity

ขั้นตอนที่ 4: เพิ่มโค้ดที่จำเป็น

Android

ไม่จำเป็นต้องใช้โค้ดเพิ่มเติมสำหรับการผสานรวม Nend

iOS

การผสานรวม SKAdNetwork

ทำตามเอกสารประกอบของ Nend เพื่อเพิ่มตัวระบุ SKAdNetwork ลงในไฟล์ Info.plist ของโปรเจ็กต์

ขั้นตอนที่ 5: ทดสอบการใช้งาน

เปิดใช้โฆษณาทดสอบ

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

ยืนยันโฆษณาทดสอบ

ในการยืนยันว่าคุณได้รับโฆษณาทดสอบจาก nend ให้เปิดใช้ การทดสอบแหล่งที่มาของโฆษณาแหล่งเดียว ในเครื่องมือตรวจสอบโฆษณาโดยใช้ nend (Waterfall) แหล่งที่มาของโฆษณา

รหัสข้อผิดพลาด

หากอะแดปเตอร์ไม่ได้รับโฆษณาจาก Nend ผู้เผยแพร่โฆษณาสามารถตรวจสอบข้อผิดพลาดที่มีอยู่จากการตอบกลับโฆษณาโดยใช้ ResponseInfo ภายใต้คลาสต่อไปนี้

Android

com.google.ads.mediation.nend.NendAdapter
com.google.ads.mediation.nend.NendRewardedAdapter
com.google.ads.mediation.nend.NendMediationAdapter

iOS

GADMAdapterNend
GADMAdapterNend
GADMAdapterNendRewarded
GADMediationAdapterNend

ต่อไปนี้คือโค้ดและข้อความประกอบที่อะแดปเตอร์ส่งเมื่อโหลดโฆษณาไม่สำเร็จ

Android

รหัสข้อผิดพลาด โดเมน เหตุผล
101 com.google.ads.mediation.nend ต้องการบริบทกิจกรรมเพื่อโหลดและแสดงโฆษณา
102 com.google.ads.mediation.nend พารามิเตอร์เซิร์ฟเวอร์ Nend ที่กำหนดค่าใน AdMob UI ขาดหายไป/ไม่ถูกต้อง
103 com.google.ads.mediation.nend nend ad ยังไม่พร้อมแสดง
104 com.google.ads.mediation.nend Nend ไม่สามารถเล่นโฆษณา
105 com.google.ads.mediation.nend ขนาดโฆษณาที่ขอไม่ตรงกับขนาดแบนเนอร์ที่สนับสนุน Nend
106 com.google.ads.mediation.nend การอ้างอิงออบเจ็กต์บริบทคือ null และ/หรือเพิ่งปล่อยออกจากหน่วยความจำ
200-299 net.nend.android nend SDK แสดงข้อผิดพลาดเกี่ยวกับการโหลดโฆษณาคั่นระหว่างหน้า ดูรายละเอียดเพิ่มเติมได้ที่รหัส
300-399 net.nend.android nend SDK แสดงข้อผิดพลาดเกี่ยวกับโฆษณาคั่นระหว่างหน้า ดูรายละเอียดเพิ่มเติมได้ที่รหัส
400-499 net.nend.android nend SDK แสดงข้อผิดพลาดเกี่ยวกับโฆษณา ดูรายละเอียดเพิ่มเติมได้ที่รหัส

iOS

รหัสข้อผิดพลาด โดเมน เหตุผล
101 com.google.mediation.nend nend SDK แสดงผลการเรียกกลับล้มเหลวในการโหลดโดยไม่มีข้อมูลข้อผิดพลาดเพิ่มเติม
102 com.google.mediation.nend nend SDK แสดงผลการเรียกกลับที่ล้มเหลวโดยไม่มีข้อมูลข้อผิดพลาดเพิ่มเติม
103 com.google.mediation.nend พารามิเตอร์เซิร์ฟเวอร์ Nend ที่กำหนดค่าใน AdMob UI ขาดหายไป/ไม่ถูกต้อง
104 com.google.mediation.nend ไม่สามารถโหลดชิ้นงานรูปภาพของโฆษณาเนทีฟ
105 com.google.mediation.nend ไม่สามารถแสดงโฆษณา "Nend" เนื่องจากโฆษณาไม่พร้อม
106 com.google.mediation.nend ขนาดโฆษณาแบนเนอร์ที่ขอไม่ตรงกับขนาดแบนเนอร์ที่รองรับ Nend
200-699 ส่งโดย Nend SDK nend SDK แสดงผลข้อผิดพลาด ดูรายละเอียดเพิ่มเติมได้ในเอกสารของ Nend

บันทึกการเปลี่ยนแปลงปลั๊กอิน Unity Mediation

เวอร์ชัน 8.0.0

เวอร์ชัน 7.0.0

เวอร์ชัน 6.0.1

เวอร์ชัน 6.0.0

เวอร์ชัน 5.2.0

เวอร์ชัน 5.1.0

เวอร์ชัน 5.0.0

เวอร์ชัน 4.0.1

เวอร์ชัน 4.0.0

เวอร์ชัน 3.0.0

เวอร์ชัน 2.3.0

เวอร์ชัน 2.2.0

เวอร์ชัน 2.1.0

  • อัปเดตปลั๊กอินเพื่อรองรับ API ที่มีการให้รางวัลใหม่
  • รองรับอะแดปเตอร์ Android เวอร์ชัน 5.1.0.2
  • รองรับอะแดปเตอร์ iOS เวอร์ชัน 5.1.1.0

เวอร์ชัน 2.0.3

  • รองรับอะแดปเตอร์ Android เวอร์ชัน 5.0.2.1
  • รองรับอะแดปเตอร์ iOS เวอร์ชัน 5.0.2.0

เวอร์ชัน 2.0.2

  • รองรับอะแดปเตอร์ Android เวอร์ชัน 5.0.2.0
  • รองรับอะแดปเตอร์ iOS เวอร์ชัน 5.0.2.0

เวอร์ชัน 2.0.1

  • รองรับอะแดปเตอร์ Android เวอร์ชัน 5.0.2.0
  • รองรับอะแดปเตอร์ iOS เวอร์ชัน 5.0.1.0

เวอร์ชัน 2.0.0

  • รองรับอะแดปเตอร์ Android เวอร์ชัน 5.0.0.0
  • รองรับอะแดปเตอร์ iOS เวอร์ชัน 5.0.0.0

เวอร์ชัน 1.0.2

  • รองรับอะแดปเตอร์ Android เวอร์ชัน 4.0.5.0
  • รองรับอะแดปเตอร์ iOS เวอร์ชัน 4.0.6.0

เวอร์ชัน 1.0.1

  • รองรับ Android SDK เวอร์ชัน 4.0.4
  • รองรับ iOS SDK เวอร์ชัน 4.0.4

เวอร์ชัน 1.0.0

  • เปิดตัวครั้งแรก!
  • รองรับ Android SDK เวอร์ชัน 4.0.2
  • รองรับ iOS SDK เวอร์ชัน 4.0.2