รายได้จากโฆษณาระดับการแสดงผล

เมื่อมีการแสดงผล Google Mobile Ads SDK for React Native จะให้ข้อมูลรายได้จากโฆษณาที่เชื่อมโยงกับการแสดงผลนั้น ใช้ข้อมูลนี้เพื่อคำนวณมูลค่าตลอดช่วงชีวิตของลูกค้า (LTV) หรือส่งต่อข้อมูลไปยังแพลตฟอร์มการวิเคราะห์หรือพาร์ทเนอร์ด้านการระบุแหล่งที่มาบุคคลที่สาม

คู่มือนี้ครอบคลุมการใช้การบันทึกข้อมูลรายได้จากโฆษณาระดับการแสดงผลในแอป React Native

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

โปรดทำสิ่งต่อไปนี้ก่อนดำเนินการต่อ

โฆษณาแต่ละรูปแบบรองรับการเรียกกลับเหตุการณ์ onAdPaid ในระหว่างวงจรของโฆษณา Google Mobile Ads SDK for React Native จะตรวจสอบเหตุการณ์การแสดงผลและเรียกใช้ตัวแฮนเดิลด้วยเพย์โหลด AdValue ที่ได้รับ

ตัวอย่างต่อไปนี้จะลงทะเบียน Listener เหตุการณ์การชําระเงินในโฆษณาที่มีการให้รางวัล บันทึกข้อมูลรายได้จากโฆษณาที่ได้รับ และแสดงโฆษณา

const rewarded = await RewardedAd.load(adRequest);

rewarded.adEventCallback = {
  onAdPaid(adValue: AdValue) {
    const revenue = adValue.amountMicros / 1000000;
    console.log(`Earned ad revenue: ${revenue} ${adValue.currencyCode}`);
    console.log(`Precision level: ${adValue.precision}`);
  },
};

rewarded.show();

เราขอแนะนำให้คุณทำดังนี้

  • สําหรับโฆษณาแบบเต็มหน้าจอ ให้ตั้งค่า Listener ในออบเจ็กต์โฆษณาหลังจากโหลดโฆษณาและก่อนแสดงโฆษณา สำหรับโฆษณาแบนเนอร์และโฆษณาเนทีฟ ให้ส่ง Callback onAdPaid เป็นพร็อพไปยังคอมโพเนนต์ <BannerAdView /> หรือ <NativeAdView /> กระบวนการนี้ช่วยให้คุณไม่พลาด Callback ของเหตุการณ์ที่มีการชำระเงิน

  • ส่งข้อมูลรายได้จากโฆษณาระดับการแสดงผลไปยังเซิร์ฟเวอร์ Analytics ที่ต้องการเมื่อ Google Mobile Ads SDK for React Native เรียกใช้ Callback onAdPaid กระบวนการนี้ช่วยให้มั่นใจได้ว่าคุณจะไม่พลาดการติดต่อกลับและทำให้ข้อมูลของคุณสอดคล้องกัน

ดูข้อมูลเกี่ยวกับการผสานรวม AAP

ดูรายละเอียดเกี่ยวกับการส่งต่อข้อมูลรายได้จากโฆษณาไปยังแพลตฟอร์มการวิเคราะห์ได้ที่คู่มือ App Attribution Partner (AAP) ต่อไปนี้

ทำความเข้าใจออบเจ็กต์ AdValue

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

พร็อพเพอร์ตี้ คำอธิบาย
amountMicros รายได้จากโฆษณาในหน่วยไมโคร โดยที่ 1000000 ไมโครเท่ากับสกุลเงิน 1 หน่วย เช่น US$1.00 หรือ €1.00
currencyCode รหัสสกุลเงิน ISO 4217 ของมูลค่าโฆษณา เช่น USD หรือ EUR
precision ระดับความแม่นยําของมูลค่าโฆษณา รายการต่อไปนี้แสดงรายละเอียดความแม่นยำแต่ละระดับ
  • UNKNOWN: ค่าโฆษณาที่ไม่รู้จัก ค่านี้จะแสดงผลเมื่อเปิดใช้คําสั่ง pingback ของ LTV โดยมีข้อมูลไม่เพียงพอ
  • ESTIMATED: มูลค่าโฆษณาโดยประมาณจากข้อมูลรวม
  • PUBLISHER_PROVIDED: มูลค่าโฆษณาที่ผู้เผยแพร่โฆษณาระบุ เช่น CPM ที่กำหนดเองในกลุ่มสื่อกลาง
  • PRECISE: มูลค่าที่ตรงกับค่าใช้จ่ายโฆษณา

ในสื่อกลาง AdMob นั้น AdMob จะพยายามระบุค่า ESTIMATED สำหรับแหล่งที่มาของโฆษณาที่ได้รับการเพิ่มประสิทธิภาพ ดูรายละเอียดได้ที่หัวข้อเพิ่มประสิทธิภาพแหล่งที่มาของโฆษณาสื่อกลางตามลำดับขั้นในสื่อกลาง หากแหล่งที่มาของโฆษณาไม่ได้รับการเพิ่มประสิทธิภาพ หรือมีข้อมูลรวมไม่เพียงพอสำหรับการประมาณ Google Mobile Ads SDK for React Native จะแสดงผลประเภทความแม่นยำเป็นPUBLISHER_PROVIDED

ทดสอบการแสดงผลจากแหล่งที่มาของโฆษณาซึ่งใช้การเสนอราคา

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

  • UNKNOWN: ระบุประเภทความแม่นยำ
  • 0: ระบุค่าโฆษณา

ดูรายละเอียดเกี่ยวกับการส่งคำขอโฆษณาทดสอบได้ที่เปิดใช้อุปกรณ์ทดสอบ