Method: accounts.networkReport.generate

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

คำขอ HTTP

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

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

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

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

string

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

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

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

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

object (NetworkReportSpec)

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

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

คําตอบแบบสตรีมสําหรับรายงานเครือข่าย 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": {"microsValue": 6500000}
    }
  }
},
{
  "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

NetworkReportSpec

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

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

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

SELECT DATE, APP, COUNTRY, CLICKS, ESTIMATED_EARNINGS
FROM NETWORK_REPORT
WHERE DATE >= '2021-09-01' AND DATE <= '2021-09-30'
    AND COUNTRY IN ('US', 'CN')
GROUP BY DATE, APP, COUNTRY
ORDER BY APP ASC, CLICKS DESC;
การแสดง 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_UNIT รหัสที่ไม่ซ้ำกันของหน่วยโฆษณา (เช่น "ca-app-pub-1234/1234") หากระบุมิติข้อมูล AD_UNIT ไว้ ระบบจะรวม APP ไว้โดยอัตโนมัติ
APP รหัสที่ไม่ซ้ำกันของแอปพลิเคชันบนอุปกรณ์เคลื่อนที่ (เช่น "ca-app-pub-1234~1234")
AD_TYPE

ประเภทของโฆษณา (เช่น "ข้อความ" หรือ "รูปภาพ") ซึ่งเป็นมิติข้อมูลการแสดงโฆษณา

คำเตือน: มิติข้อมูลไม่สามารถใช้ร่วมกับเมตริก AD_REQUESTS, MATCH_RATE และ IMPRESSION_RPM ได้

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

จำนวนคำขอโฆษณา ค่าเป็นจำนวนเต็ม

คำเตือน: เมตริกไม่สามารถใช้ร่วมกับมิติข้อมูล AD_TYPE ได้

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

รายได้โดยประมาณต่อการแสดงโฆษณาพันครั้ง ค่าเป็นไมโคร เช่น $1.03 จะแสดงเป็น 1030000 เทียบเท่ากับ eCPM ใน UI ของ AdMob

คำเตือน: เมตริกไม่สามารถใช้ร่วมกับมิติข้อมูล AD_TYPE ได้

MATCHED_REQUESTS จำนวนครั้งที่มีการแสดงโฆษณาตามคำขอ ค่าเป็นจำนวนเต็ม
MATCH_RATE

อัตราส่วนของคำขอโฆษณาที่ตรงกันเทียบกับคำขอโฆษณาทั้งหมด ค่านี้คือค่าทศนิยมของความแม่นยำสองเท่า (โดยประมาณ)

คำเตือน: เมตริกไม่สามารถใช้ร่วมกับมิติข้อมูล AD_TYPE ได้

SHOW_RATE อัตราส่วนของโฆษณาที่แสดงเหนือโฆษณาที่มีการแสดงผล ซึ่งระบุเป็นการแสดงผล / คำขอที่ตรงกัน ค่านี้คือค่าทศนิยมของความแม่นยำสองเท่า (โดยประมาณ)

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)

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