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

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

คู่มือนี้มีไว้เพื่อช่วยคุณติดตั้งใช้งานการบันทึกข้อมูล LTV ในแอป iOS

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

จัดการกิจกรรมแบบชำระเงิน

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

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

Swift

func ad(_ ad: FullScreenPresentingAd, didRecordPaidEventWith adValue: AdValue) {
  // TODO: Send the impression-level ad revenue information to your preferred
  // analytics server directly within this callback.

  // Extract the impression-level ad revenue data.
  let value = adValue.value
  let currencyCode = adValue.currencyCode
  let precision = adValue.precision

  print(
    "Ad paid event. Value: \(value) \(currencyCode), with precision: \(precision)."
  )
}

Objective-C

- (void)ad:(id<GADFullScreenPresentingAd>)ad didRecordPaidEventWithAdValue:(GADAdValue *)adValue {
  // TODO: Send the impression-level ad revenue information to your preferred
  // analytics server directly within this callback.

  // Extract the impression-level ad revenue data.
  NSDecimalNumber *value = adValue.value;
  NSString *currencyCode = adValue.currencyCode;
  GADAdValuePrecision precision = adValue.precision;

  NSLog(@"Ad paid event. Value: %@ %@, with precision: %ld.", value, currencyCode, (long)precision);
}

ระบุชื่อแหล่งที่มาของโฆษณาเหตุการณ์ที่กำหนดเอง

สําหรับแหล่งที่มาของโฆษณาเหตุการณ์ที่กําหนดเอง พร็อพเพอร์ตี้ adSourceName จะให้ชื่อแหล่งที่มาของโฆษณา Custom event หากคุณใช้เหตุการณ์ที่กำหนดเองหลายรายการ ชื่อแหล่งที่มาของโฆษณาจะไม่ละเอียดพอที่จะแยกความแตกต่างระหว่างเหตุการณ์ที่กำหนดเองหลายรายการ หากต้องการค้นหาเหตุการณ์ที่กำหนดเองที่เฉพาะเจาะจง ให้ทำตามขั้นตอนต่อไปนี้

  1. รับพร็อพเพอร์ตี้ adNetworkClassName
  2. ตั้งชื่อแหล่งที่มาของโฆษณาที่ไม่ซ้ำกัน

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

Swift

func uniqueAdSourceName(for loadedAdNetworkResponseInfo: AdNetworkResponseInfo) -> String {
  var adSourceName: String = loadedAdNetworkResponseInfo.adSourceName ?? ""
  if adSourceName == "Custom Event" {
    if loadedAdNetworkResponseInfo.adNetworkClassName
      == "MediationExample.SampleCustomEventSwift"
    {
      adSourceName = "Sample Ad Network (Custom Event)"
    }
  }
  return adSourceName
}

Objective-C

- (NSString *)uniqueAdSourceNameForAdNetworkResponseInfo:
    (GADAdNetworkResponseInfo *)loadedAdNetworkResponseInfo {
  NSString *adSourceName = loadedAdNetworkResponseInfo.adSourceName;
  if ([adSourceName isEqualToString:@"Custom Event"]) {
    if ([loadedAdNetworkResponseInfo.adNetworkClassName isEqualToString:@"SampleCustomEvent"]) {
      adSourceName = @"Sample Ad Network (Custom Event)";
    }
  }
  return adSourceName;
}

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

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

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

GADAdValue

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

GADAdValuePrecision คำอธิบาย
GADAdValuePrecisionUnknown ค่าโฆษณาที่ไม่รู้จัก ระบบจะแสดงข้อความนี้เมื่อเปิดใช้ Pingback ของ LTV แต่มีข้อมูลไม่เพียงพอ
GADAdValuePrecisionEstimated มูลค่าโฆษณาโดยประมาณจากข้อมูลรวม
GADAdValuePrecisionPublisherProvided มูลค่าโฆษณาที่ผู้เผยแพร่โฆษณาระบุ เช่น CPM แบบกำหนดเองในกลุ่มสื่อกลาง
GADAdValuePrecisionPrecise มูลค่าที่ตรงกับค่าใช้จ่ายโฆษณานี้

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

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

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

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