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

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

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

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

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

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

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

private void LoadRewardedAd()
{
   // Send the request to load the ad.
   AdRequest adRequest = new AdRequest();
   RewardedAd.Load("AD_UNIT_ID", adRequest, (RewardedAd rewardedAd, LoadAdError error) =>
   {
      // If the operation failed with a reason.
      if (error != null)
      {
         Debug.LogError("Rewarded ad failed to load an ad with error : " + error);
         return;
      }

      rewardedAd.OnAdPaid += this.HandleAdPaidEvent;
   });
}

public void HandleAdPaidEvent(AdValue adValue)
{
    // TODO: Send the impression-level ad revenue information to your
    // preferred analytics server directly within this callback.

    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"];
}

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

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

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

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

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

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

AdValue

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

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

ในกรณีของสื่อกลาง AdMob จะพยายามระบุEstimatedมูลค่าสําหรับแหล่งที่มาของโฆษณาที่เพิ่มประสิทธิภาพแล้ว สําหรับแหล่งที่มาของโฆษณาที่ไม่ได้เพิ่มประสิทธิภาพ หรือในกรณีที่มีข้อมูลรวมไม่เพียงพอที่จะรายงานค่าประมาณที่มีความหมาย ระบบจะแสดงค่า PublisherProvided

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

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

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

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

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