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

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

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

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

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

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

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

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

Swift

rewardedAd?.paidEventHandler = { adValue in
  // 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)."
  )
}
ImpressionLevelAdRevenueSnippets.swift

Objective-C

rewardedAd.paidEventHandler = ^(GADAdValue *_Nonnull 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);
};
ImpressionLevelAdRevenueSnippets.m

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

สําหรับแหล่งที่มาของโฆษณาเหตุการณ์ที่กําหนดเอง 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
}
ResponseInfoSnippets.swift

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;
}
ResponseInfoSnippets.m

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

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

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

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

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

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

GADAdValue

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

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

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

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

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

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

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