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

เลือกแพลตฟอร์ม: Android iOS Unity Android (เดิม)

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

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

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

ใช้ตัวจัดการเหตุการณ์แบบเสียค่าใช้จ่าย

โฆษณาแต่ละรูปแบบจะมีเหตุการณ์ OnPaidEvent ในระหว่างวงจรของเหตุการณ์โฆษณา Google Mobile Ads Unity Plugin จะตรวจสอบเหตุการณ์การแสดงผลและเรียกใช้แฮนเดิลด้วยมูลค่าที่ได้รับ

โค้ดด้านล่างแสดงวิธีจัดการเหตุการณ์การชําระเงินสําหรับโฆษณาที่มีการให้รางวัล

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&ltstring, string> credentials = loadedAdapterResponseInfo.AdUnitMapping;

    Dictionary&ltstring, string> extras = responseInfo.GetResponseExtras();
    string mediationGroupName = extras["mediation_group_name"];
    string mediationABTestName = extras["mediation_ab_test_name"];
    string mediationABTestVariant = extras["mediation_ab_test_variant"];
}

ดูข้อมูลเพิ่มเติมเกี่ยวกับแหล่งที่มาของโฆษณาที่ชนะได้ที่การดึงข้อมูลเกี่ยวกับการตอบกลับโฆษณา

การผสานรวมกับ App Attribution Partner (AAP)

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

SDK ของพาร์ทเนอร์
Adjust
AppsFlyer
Singular
Tenjin

แนวทางปฏิบัติแนะนำสำหรับการนำไปใช้

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

AdValue

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

AdValue.PrecisionType คำอธิบาย
Unknown ค่าโฆษณาที่ไม่รู้จัก ระบบจะแสดงข้อความนี้เมื่อเปิดใช้ Pingback ของ LTV แต่มีข้อมูลไม่เพียงพอ
Estimated มูลค่าโฆษณาโดยประมาณจากข้อมูลรวม
PublisherProvided มูลค่าโฆษณาที่ผู้เผยแพร่โฆษณาระบุ เช่น CPM แบบกำหนดเองในกลุ่มสื่อกลาง
Precise มูลค่าที่แน่นอนของโฆษณานี้

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

ทดสอบการแสดงผลจากการเสนอราคาแบบเปิด

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

  • Unknown: ระบุประเภทความแม่นยำ
  • 0: ระบุมูลค่าโฆษณา
ก่อนหน้านี้ คุณอาจเห็นประเภทความแม่นยำเป็นค่าอื่นที่ไม่ใช่ Unknown และมูลค่าโฆษณามากกว่า 0

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