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

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

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

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

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

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

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

  • แบนเนอร์
  • โฆษณาคั่นระหว่างหน้า
  • โฆษณาที่มีการให้รางวัล
  • โฆษณาคั่นระหว่างหน้าที่มีการให้รางวัล
  • เนทีฟ

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

โฆษณาแต่ละรูปแบบจะมีเหตุการณ์ 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 เป็นมูลค่าขนาดเล็กที่แสดงมูลค่าของโฆษณาแต่ละรายการ ตัวอย่างเช่น มูลค่า 5,000 แสดงว่าโฆษณานี้มีมูลค่าโดยประมาณ 0.005 ดอลลาร์

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

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

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

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

• Unknown: ระบุประเภทความแม่นยำ

• 0: ระบุมูลค่าโฆษณา

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

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