Method: accounts.mediationReport.generate

สร้างรายงานสื่อกลาง AdMob ตามข้อกำหนดของรายงานที่ระบุไว้ แสดงผลลัพธ์ของ RPC สตรีมมิงฝั่งเซิร์ฟเวอร์ โดยผลลัพธ์จะแสดงตามลําดับการตอบกลับ

คำขอ HTTP

POST https://admob.googleapis.com/v1/{parent=accounts/*}/mediationReport:generate

URL ใช้ไวยากรณ์การแปลง gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
parent

string

ชื่อทรัพยากรของบัญชีที่จะสร้างรายงาน ตัวอย่างเช่น accounts/pub-9876543210987654

เนื้อหาของคำขอ

เนื้อหาของคำขอมีข้อมูลที่มีโครงสร้างต่อไปนี้

การแสดง JSON
{
  "reportSpec": {
    object (MediationReportSpec)
  }
}
ช่อง
reportSpec

object (MediationReportSpec)

ข้อกำหนดรายงานเครือข่าย

เนื้อหาการตอบกลับ

คําตอบแบบสตรีมสําหรับรายงานสื่อกลาง AdMob ซึ่งคําตอบแรกมีส่วนหัวของรายงาน ตามด้วยสตรีมการตอบกลับแถว และส่วนท้ายเป็นข้อความตอบกลับสุดท้าย

เช่น

[{
  "header": {
    "dateRange": {
      "startDate": {"year": 2018, "month": 9, "day": 1},
      "endDate": {"year": 2018, "month": 9, "day": 1}
    },
    "localizationSettings": {
      "currencyCode": "USD",
      "languageCode": "en-US"
    }
  }
},
{
  "row": {
    "dimensionValues": {
      "DATE": {"value": "20180918"},
      "APP": {
        "value": "ca-app-pub-8123415297019784~1001342552",
         "displayLabel": "My app name!"
      }
    },
    "metricValues": {
      "ESTIMATED_EARNINGS": {"decimal_value": "1324746"}
    }
  }
},
{
  "footer": {"matchingRowCount": 1}
}]

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON
{

  // Union field payload can be only one of the following:
  "header": {
    object (ReportHeader)
  },
  "row": {
    object (ReportRow)
  },
  "footer": {
    object (ReportFooter)
  }
  // End of list of possible types for union field payload.
}
ช่อง
ช่องการรวม payload ข้อความตอบกลับของสตรีมแต่ละรายการจะมีเพย์โหลด 1 ประเภท payload ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
header

object (ReportHeader)

การตั้งค่าการสร้างรายงานที่อธิบายเนื้อหาของรายงาน เช่น ช่วงวันที่ของรายงานและการตั้งค่าการแปล

row

object (ReportRow)

ข้อมูลรายงานจริง

footer

object (ReportFooter)

ข้อมูลเพิ่มเติมเกี่ยวกับรายงานที่สร้างขึ้น เช่น คําเตือนเกี่ยวกับข้อมูล

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

  • https://www.googleapis.com/auth/admob.readonly
  • https://www.googleapis.com/auth/admob.report

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

MediationReportSpec

ข้อกำหนดในการสร้างรายงานสื่อกลาง AdMob เช่น ข้อกําหนดในการรับ ECPM ที่พบซึ่งแบ่งตามแหล่งที่มาของโฆษณาและแอปสําหรับ "สหรัฐอเมริกา" และ "CN" ประเทศอาจมีลักษณะดังตัวอย่างต่อไปนี้

{
  "dateRange": {
    "startDate": {"year": 2021, "month": 9, "day": 1},
    "endDate": {"year": 2021, "month": 9, "day": 30}
  },
  "dimensions": ["AD_SOURCE", "APP", "COUNTRY"],
  "metrics": ["OBSERVED_ECPM"],
  "dimensionFilters": [
    {
      "dimension": "COUNTRY",
      "matchesAny": {"values": [{"value": "US", "value": "CN"}]}
    }
  ],
  "sortConditions": [
    {"dimension":"APP", order: "ASCENDING"}
  ],
  "localizationSettings": {
    "currencyCode": "USD",
    "languageCode": "en-US"
  }
}

เพื่อให้เข้าใจได้ดียิ่งขึ้น คุณจะใช้ข้อกำหนดก่อนหน้านี้ได้เหมือนกับ Pseudo SQL ต่อไปนี้

SELECT AD_SOURCE, APP, COUNTRY, OBSERVED_ECPM
FROM MEDIATION_REPORT
WHERE DATE >= '2021-09-01' AND DATE <= '2021-09-30'
    AND COUNTRY IN ('US', 'CN')
GROUP BY AD_SOURCE, APP, COUNTRY
ORDER BY APP ASC;
การแสดง JSON
{
  "dateRange": {
    object (DateRange)
  },
  "dimensions": [
    enum (Dimension)
  ],
  "metrics": [
    enum (Metric)
  ],
  "dimensionFilters": [
    {
      object (DimensionFilter)
    }
  ],
  "sortConditions": [
    {
      object (SortCondition)
    }
  ],
  "localizationSettings": {
    object (LocalizationSettings)
  },
  "maxReportRows": integer,
  "timeZone": string
}
ช่อง
dateRange

object (DateRange)

ช่วงวันที่ที่จะสร้างรายงาน

dimensions[]

enum (Dimension)

รายการมิติข้อมูลของรายงาน ชุดค่าผสมของมิติข้อมูลเหล่านี้เป็นตัวกําหนดแถวของรายงาน หากไม่ได้ระบุมิติข้อมูล รายงานจะแสดงเมตริกที่ขอแถวเดียวสำหรับทั้งบัญชี

metrics[]

enum (Metric)

รายการเมตริกของรายงาน รายงานต้องระบุเมตริกอย่างน้อย 1 รายการ

dimensionFilters[]

object (DimensionFilter)

อธิบายว่าแถวรายงานใดที่ควรจับคู่โดยพิจารณาจากค่ามิติข้อมูล

sortConditions[]

object (SortCondition)

อธิบายการจัดเรียงแถวในรายงาน ลำดับของเงื่อนไขในรายการจะกำหนดลำดับความสำคัญ ยิ่งเงื่อนไขมาก่อน จะยิ่งมีลำดับความสำคัญสูง หากไม่ได้ระบุเงื่อนไขการจัดเรียงไว้ จะไม่มีการระบุลำดับแถว

localizationSettings

object (LocalizationSettings)

การตั้งค่าการแปลของรายงาน

maxReportRows

integer

จำนวนแถวข้อมูลรายงานสูงสุดที่จะแสดงผล หากไม่ได้ตั้งค่าไว้ API จะแสดงผลแถวมากที่สุด 100,000 แถว โดยค่าที่ยอมรับคือ 1-100, 000 ค่าที่มากกว่า 100000 จะแสดงข้อผิดพลาด

timeZone

string

เขตเวลาของรายงาน ยอมรับค่าชื่อ TZ ของ IANA เช่น "America/Los_Angeles" หากไม่ได้กำหนดเขตเวลาไว้ ระบบจะใช้ค่าเริ่มต้นของบัญชี ตรวจสอบค่าเริ่มต้นตามการดำเนินการรับบัญชี

คำเตือน: "America/Los_Angeles" เป็นค่าเดียวที่รองรับในขณะนี้

มิติข้อมูล

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

Enum
DIMENSION_UNSPECIFIED ค่าเริ่มต้นสำหรับช่องที่ไม่ได้ตั้งค่า โปรดอย่าใช้
DATE วันที่ในรูปแบบ ปปปปดดวว (เช่น "20210701") คำขอสามารถระบุมิติข้อมูลเวลาได้สูงสุด 1 รายการ
MONTH เดือนในรูปแบบ YYYYMM (เช่น "202107") คำขอสามารถระบุมิติข้อมูลเวลาได้สูงสุด 1 รายการ
WEEK วันที่วันแรกของสัปดาห์ในรูปแบบ ปปปปดดวว (เช่น "20210701") คำขอสามารถระบุมิติข้อมูลเวลาได้สูงสุด 1 รายการ
AD_SOURCE รหัสที่ไม่ซ้ำกันของแหล่งที่มาของโฆษณา (เช่น "5450213213286189855" และ "เครือข่าย AdMob" เป็นค่าป้ายกำกับ)
AD_SOURCE_INSTANCE รหัสที่ไม่ซ้ำกันของอินสแตนซ์แหล่งที่มาของโฆษณา (เช่น "ca-app-pub-1234:asi:5678" และ "AdMob (ค่าเริ่มต้น)" เป็นค่าป้ายกำกับ)
AD_UNIT รหัสที่ไม่ซ้ำกันของหน่วยโฆษณา (เช่น "ca-app-pub-1234/8790") หากระบุมิติข้อมูล AD_UNIT ไว้ ระบบจะรวม APP ไว้โดยอัตโนมัติ
APP รหัสที่ไม่ซ้ำกันของแอปพลิเคชันบนอุปกรณ์เคลื่อนที่ (เช่น "ca-app-pub-1234~1234")
MEDIATION_GROUP รหัสที่ไม่ซ้ำกันของกลุ่มสื่อกลาง (เช่น "ca-app-pub-1234:mg:1234" และ "AdMob (ค่าเริ่มต้น)" เป็นค่าป้ายกำกับ)
COUNTRY รหัสประเทศ CLDR ของสถานที่ที่มีการดู/คลิกโฆษณาเกิดขึ้น (เช่น "US" หรือ "FR") นี่คือมิติข้อมูลภูมิศาสตร์
FORMAT รูปแบบของหน่วยโฆษณา (เช่น "แบนเนอร์" "เนทีฟ") มิติข้อมูลการแสดงโฆษณา
PLATFORM แพลตฟอร์มระบบปฏิบัติการบนอุปกรณ์เคลื่อนที่ของแอป (เช่น "Android" หรือ "iOS")
MOBILE_OS_VERSION เวอร์ชันของระบบปฏิบัติการบนอุปกรณ์เคลื่อนที่ เช่น "iOS 13.5.1"
GMA_SDK_VERSION เวอร์ชัน GMA SDK เช่น "iOS 7.62.0"
APP_VERSION_NAME สำหรับ Android คุณสามารถดูชื่อเวอร์ชันของแอปได้ใน versionName ใน PackageInfo สำหรับ iOS คุณสามารถดูชื่อเวอร์ชันของแอปได้ใน CFBundleShortVersionString
SERVING_RESTRICTION โหมดการจำกัดการแสดงโฆษณา (เช่น "โฆษณาที่ไม่ได้ปรับตามโปรไฟล์ของผู้ใช้")

เมตริก

เมตริกของรายงานสื่อกลาง เมตริกคือการวัดเชิงปริมาณที่บ่งชี้ประสิทธิภาพธุรกิจของผู้เผยแพร่โฆษณา โดยรวบรวมจากเหตุการณ์โฆษณาแต่ละรายการและจัดกลุ่มตามมิติข้อมูลรายงาน ค่าเมตริกอาจเป็นจำนวนเต็มหรือทศนิยม (โดยไม่ต้องปัดเศษ)

Enum
METRIC_UNSPECIFIED ค่าเริ่มต้นสำหรับช่องที่ไม่ได้ตั้งค่า โปรดอย่าใช้
AD_REQUESTS จำนวนคำขอ ค่าเป็นจำนวนเต็ม
CLICKS จำนวนครั้งที่ผู้ใช้คลิกโฆษณา ค่าเป็นจำนวนเต็ม
ESTIMATED_EARNINGS

รายได้โดยประมาณของผู้เผยแพร่โฆษณา AdMob หน่วยสกุลเงิน (USD, EUR หรืออื่นๆ) ของเมตริกรายได้จะกำหนดโดยการตั้งค่าการแปลสำหรับสกุลเงิน จำนวนเงินเป็นไมโคร ตัวอย่างเช่น $6.50 จะแสดงเป็น 6500000

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

IMPRESSIONS จำนวนโฆษณาทั้งหมดที่แสดงต่อผู้ใช้ ค่าเป็นจำนวนเต็ม
IMPRESSION_CTR อัตราส่วนของจำนวนคลิกต่อการแสดงผล ค่านี้คือค่าทศนิยมของความแม่นยำสองเท่า (โดยประมาณ)
MATCHED_REQUESTS จำนวนครั้งที่มีการแสดงโฆษณาตามคำขอ ค่าเป็นจำนวนเต็ม
MATCH_RATE อัตราส่วนของคำขอโฆษณาที่ตรงกันเทียบกับคำขอโฆษณาทั้งหมด ค่านี้คือค่าทศนิยมของความแม่นยำสองเท่า (โดยประมาณ)
OBSERVED_ECPM

eCPM เฉลี่ยโดยประมาณของเครือข่ายโฆษณาบุคคลที่สาม หน่วยสกุลเงิน (USD, EUR หรืออื่นๆ) ของเมตริกรายได้จะกำหนดโดยการตั้งค่าการแปลสำหรับสกุลเงิน จำนวนเงินเป็นไมโคร ตัวอย่างเช่น $2.30 จะแสดงเป็น 2300000

ระบบรองรับ eCPM เฉลี่ยโดยประมาณต่อกลุ่มสื่อกลางและระดับอินสแตนซ์ของแหล่งที่มาของโฆษณาตั้งแต่วันที่ 20 ตุลาคม 2019 eCPM เฉลี่ยโดยประมาณของบุคคลที่สามจะแสดงเป็น 0 สำหรับวันที่ก่อนวันที่ 20 ตุลาคม 2019

DimensionFilter

อธิบายว่าแถวรายงานใดที่ควรจับคู่โดยพิจารณาจากค่ามิติข้อมูล

การแสดง JSON
{
  "dimension": enum (Dimension),

  // Union field operator can be only one of the following:
  "matchesAny": {
    object (StringList)
  }
  // End of list of possible types for union field operator.
}
ช่อง
dimension

enum (Dimension)

ใช้เกณฑ์ตัวกรองกับมิติข้อมูลที่ระบุ

ช่องการรวม operator โอเปอเรเตอร์ตัวกรองที่จะใช้ operator ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
matchesAny

object (StringList)

จับคู่แถวหากค่าของมิติข้อมูลสำหรับมิติข้อมูลที่ระบุอยู่ในค่าใดค่าหนึ่งที่ระบุในเงื่อนไขนี้

SortCondition

ทิศทางการจัดเรียงที่จะใช้กับมิติข้อมูลหรือเมตริก

การแสดง JSON
{
  "order": enum (SortOrder),

  // Union field sort_on can be only one of the following:
  "dimension": enum (Dimension),
  "metric": enum (Metric)
  // End of list of possible types for union field sort_on.
}
ช่อง
order

enum (SortOrder)

ลำดับการจัดเรียงของมิติข้อมูลหรือเมตริก

ช่องการรวม sort_on ระบุว่าจะจัดเรียงค่าใด sort_on ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
dimension

enum (Dimension)

จัดเรียงตามมิติข้อมูลที่ระบุ

metric

enum (Metric)

จัดเรียงตามเมตริกที่ระบุ