เมื่อมีการแสดงผล Google Mobile Ads SDK จะให้ข้อมูลรายได้จากโฆษณาที่เชื่อมโยงกับการแสดงผลนั้น คุณสามารถใช้ข้อมูลนี้เพื่อคำนวณมูลค่าตลอดอายุการใช้งานของผู้ใช้ หรือส่งต่อสตรีมข้อมูลไปยังระบบอื่นๆ ที่เกี่ยวข้อง
คู่มือนี้มีจุดประสงค์เพื่อช่วยคุณใช้งานการบันทึกข้อมูลรายได้จากโฆษณาระดับการแสดงผลในโปรเจ็กต์ Unity
ข้อกำหนดเบื้องต้น
- ตรวจสอบว่าคุณได้เปิดใช้ฟีเจอร์รายได้จากโฆษณาระดับการแสดงผลใน UI ของ AdMob แล้ว
- ปลั๊กอิน Unity 5.0.0 ขึ้นไป
- ทำขั้นตอนเริ่มต้นใช้งานให้เสร็จสมบูรณ์ แอป Unity ของคุณควรมีการนำเข้า ปลั๊กอิน Unity สำหรับโฆษณาในอุปกรณ์เคลื่อนที่ของ Google อยู่แล้ว
คุณต้องใช้โฆษณาอย่างน้อย 1 รูปแบบ จึงจะรับข้อมูลรายได้จากโฆษณาระดับการแสดงผลได้
การใช้งานเครื่องจัดการเหตุการณ์ที่เสียค่าใช้จ่าย
โฆษณาแต่ละรูปแบบมีเหตุการณ์ OnPaidEvent
ในระหว่างวงจรเหตุการณ์โฆษณา SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google จะตรวจสอบเหตุการณ์การแสดงผลและเรียกตัวแฮนเดิลด้วยค่าที่ได้รับ
โค้ดด้านล่างแสดงวิธีจัดการกับเหตุการณ์ที่เสียค่าใช้จ่ายสำหรับโฆษณาที่มีการให้รางวัล
RewardedAd rewardedAd; private void RequestRewardedAd() { rewardedAd = new RewardedAd("AD_UNIT_ID"); rewardedAd.OnPaidEvent += this.HandleAdPaidEvent; AdRequest adRequest = new AdRequest(); rewardedAd.LoadAd(adRequest); } public void HandleAdPaidEvent(object sender, AdValueEventArgs args) { // TODO: Send the impression-level ad revenue information to your // preferred analytics server directly within this callback. AdValue adValue = args.AdValue; long valueMicros = adValue.Value; string currencyCode = adValue.CurrencyCode; PrecisionType precision = adValue.Precision; ResponseInfo responseInfo = rewardedAd.GetResponseInfo(); string responseId = responseInfo.GetResponseId(); AdapterResponseInfo loadedAdapterResponseInfo = responseInfo.GetLoadedAdapterResponseInfo(); string adSourceId = loadedAdapterResponseInfo.AdSourceId; string adSourceInstanceId = loadedAdapterResponseInfo.AdSourceInstanceId; string adSourceInstanceName = loadedAdapterResponseInfo.AdSourceInstanceName; string adSourceName = loadedAdapterResponseInfo.AdSourceName; string adapterClassName = loadedAdapterResponseInfo.AdapterClassName; long latencyMillis = loadedAdapterResponseInfo.LatencyMillis; Dictionary<string, string> credentials = loadedAdapterResponseInfo.AdUnitMapping; Dictionary<string, string> extras = responseInfo.GetResponseExtras(); string mediationGroupName = extras["mediation_group_name"]; string mediationABTestName = extras["mediation_ab_test_name"]; string mediationABTestVariant = extras["mediation_ab_test_variant"]; }
ดูข้อมูลเพิ่มเติมเกี่ยวกับแหล่งที่มาของโฆษณาที่ชนะได้ที่การดึงข้อมูลเกี่ยวกับการตอบกลับโฆษณา
การผสานรวมกับพาร์ทเนอร์การระบุแหล่งที่มาของแอป (AAP)
สำหรับรายละเอียดทั้งหมดเกี่ยวกับการส่งต่อข้อมูลรายได้จากโฆษณาไปยังแพลตฟอร์มการวิเคราะห์ โปรดดูคู่มือของพาร์ทเนอร์
SDK ของพาร์ทเนอร์ |
---|
Adjust |
AppsFlyer |
Singular |
Tenjin |
แนวทางปฏิบัติแนะนำสำหรับการนำไปใช้
- ตั้งค่าเหตุการณ์
OnPaidEvent
ทันทีที่คุณสร้างหรือเข้าถึงออบเจ็กต์โฆษณา และต้องทำก่อนแสดงโฆษณา ซึ่งจะช่วยให้แน่ใจได้ว่า การติดต่อกลับจะครบถ้วน - ส่งข้อมูลรายได้จากโฆษณาระดับการแสดงผลไปยังเซิร์ฟเวอร์การวิเคราะห์ที่ต้องการทันทีในเครื่องจัดการ
OnPaidEvent
การดำเนินการนี้จะช่วยป้องกันไม่ให้การเรียกกลับตกไปโดยไม่ตั้งใจ และหลีกเลี่ยงความคลาดเคลื่อนของข้อมูล
AdValue
AdValue
เป็นคลาสที่แสดงมูลค่าเงินที่ได้รับจากโฆษณา ซึ่งรวมถึงรหัสสกุลเงินของค่าและประเภทความแม่นยําที่เข้ารหัสด้านล่าง
AdValue.PrecisionType |
คำอธิบาย |
---|---|
Unknown |
ค่าโฆษณาที่ไม่รู้จัก ระบบจะแสดงผลข้อมูลนี้เมื่อเปิดใช้ Pingback ของ LTV แต่มีข้อมูลไม่เพียงพอ |
Estimated |
มูลค่าโฆษณาโดยประมาณจากข้อมูลรวม |
PublisherProvided |
ผู้เผยแพร่โฆษณาเป็นผู้ระบุมูลค่าโฆษณา เช่น CPM ที่กําหนดเองในกลุ่มสื่อกลาง |
Precise |
ค่าที่แน่นอนของโฆษณานี้ |
ในกรณีของสื่อกลาง AdMob จะพยายามระบุ ESTIMATED
ค่าสําหรับแหล่งที่มาของโฆษณาที่ได้รับการเพิ่มประสิทธิภาพ สําหรับแหล่งที่มาของโฆษณาที่ไม่ได้เพิ่มประสิทธิภาพ หรือในกรณีที่มีข้อมูลแบบรวมไม่เพียงพอที่จะรายงานค่าประมาณที่มีความหมาย ระบบจะแสดงผลค่า PUBLISHER_PROVIDED