Method: accounts.mediationReport.generate

Membuat laporan Mediasi AdMob berdasarkan spesifikasi laporan yang diberikan. Menampilkan hasil RPC streaming sisi server. Hasilnya ditampilkan dalam urutan respons.

Permintaan HTTP

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

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
parent

string

Nama resource akun untuk membuat laporan. Contoh: accounts/pub-9876543210987654

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON
{
  "reportSpec": {
    object (MediationReportSpec)
  }
}
Kolom
reportSpec

object (MediationReportSpec)

Spesifikasi laporan jaringan.

Isi respons

Jika berhasil, isi respons memuat data dengan struktur berikut:

Respons streaming untuk laporan Mediasi AdMob dengan respons pertama yang berisi header laporan, lalu aliran respons baris, dan terakhir footer sebagai pesan respons terakhir.

Misalnya:

[{
  "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}
}]
Representasi 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.
}
Kolom
Kolom union payload. Setiap pesan respons streaming berisi satu jenis payload. payload hanya dapat berupa salah satu dari berikut:
header

object (ReportHeader)

Setelan pembuatan laporan yang mendeskripsikan konten laporan, seperti rentang tanggal laporan dan setelan pelokalan.

row

object (ReportRow)

Data laporan aktual.

footer

object (ReportFooter)

Informasi tambahan tentang laporan yang dihasilkan, seperti peringatan tentang data.

Cakupan Otorisasi

Memerlukan salah satu cakupan OAuth berikut:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

MediationReportSpec

Spesifikasi untuk membuat laporan Mediasi AdMob. Misalnya, spesifikasi untuk mendapatkan ECPM yang diamati yang dikelompokkan menurut sumber iklan dan aplikasi untuk negara 'AS' dan 'CN' dapat terlihat seperti contoh berikut:

{
  "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"
  }
}

Untuk pemahaman yang lebih baik, Anda dapat memperlakukan spesifikasi sebelumnya seperti SQL semu berikut:

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;
Representasi JSON
{
  "dateRange": {
    object (DateRange)
  },
  "dimensions": [
    enum (Dimension)
  ],
  "metrics": [
    enum (Metric)
  ],
  "dimensionFilters": [
    {
      object (DimensionFilter)
    }
  ],
  "sortConditions": [
    {
      object (SortCondition)
    }
  ],
  "localizationSettings": {
    object (LocalizationSettings)
  },
  "maxReportRows": integer,
  "timeZone": string
}
Kolom
dateRange

object (DateRange)

Rentang tanggal saat laporan dibuat.

dimensions[]

enum (Dimension)

Daftar dimensi laporan. Kombinasi nilai dari dimensi-dimensi ini menentukan baris laporan. Jika tidak ada dimensi yang ditentukan, laporan akan menampilkan satu baris metrik yang diminta untuk seluruh akun.

metrics[]

enum (Metric)

Daftar metrik laporan. Laporan harus menentukan setidaknya satu metrik.

dimensionFilters[]

object (DimensionFilter)

Menjelaskan baris laporan mana yang akan dicocokkan berdasarkan nilai dimensinya.

sortConditions[]

object (SortCondition)

Menjelaskan pengurutan baris laporan. Urutan kondisi dalam daftar menentukan prioritasnya; semakin awal kondisi, semakin tinggi prioritasnya. Jika tidak ada kondisi pengurutan yang ditentukan, pengurutan baris tidak ditentukan.

localizationSettings

object (LocalizationSettings)

Setelan pelokalan laporan.

maxReportRows

integer

Jumlah maksimum baris data laporan yang akan ditampilkan. Jika nilai tidak ditetapkan, API akan menampilkan baris sebanyak mungkin hingga 100.000. Nilai yang dapat diterima adalah 1-100.000, inklusif. Nilai yang lebih besar dari 100.000 akan menampilkan error.

timeZone

string

Zona waktu laporan. Menerima nilai nama IANA TZ, seperti "Amerika/Los_Angeles." Jika zona waktu tidak ditentukan, default akun akan berlaku. Periksa nilai default melalui tindakan "dapatkan akun".

Peringatan: "Amerika/Los_Angeles" adalah satu-satunya nilai yang didukung saat ini.

Dimensi

Dimensi laporan mediasi. Dimensi adalah atribut data untuk menguraikan atau menyaring pengukuran kuantitatif (metrik) menurut atribut tertentu, seperti format iklan atau platform yang menampilkan iklan.

Enumerasi
DIMENSION_UNSPECIFIED Nilai default untuk kolom yang tidak ditetapkan. Jangan gunakan.
DATE Tanggal dalam format YYYYMMDD (misalnya, "20210701"). Permintaan dapat menentukan maksimal satu dimensi waktu.
MONTH Satu bulan dalam format YYYYMM (misalnya, "202107"). Permintaan dapat menentukan maksimal satu dimensi waktu.
WEEK Tanggal hari pertama dalam format YYYYMMDD (misalnya, "20210701"). Permintaan dapat menentukan maksimal satu dimensi waktu.
AD_SOURCE ID unik sumber iklan (misalnya, "5450213213286189855" dan "Jaringan AdMob" sebagai nilai label).
AD_SOURCE_INSTANCE ID unik instance sumber iklan (misalnya, "ca-app-pub-1234:asi:5678" dan "AdMob (default)" sebagai nilai label).
AD_UNIT ID unik unit iklan (misalnya, "ca-app-pub-1234/8790"). Jika dimensi AD_UNIT ditentukan, APP akan disertakan secara otomatis.
APP ID unik aplikasi seluler (misalnya, "ca-app-pub-1234~1234").
MEDIATION_GROUP ID unik grup mediasi (misalnya, "ca-app-pub-1234:mg:1234" dan "AdMob (default)" sebagai nilai label).
COUNTRY Kode negara CLDR tempat penayangan/klik iklan terjadi (misalnya, "AS" atau "FR"). Ini adalah dimensi geografi.
FORMAT Format unit iklan (misalnya, "banner", "native"), dimensi penayangan iklan.
PLATFORM Platform OS seluler aplikasi (misalnya "Android" atau "iOS").
MOBILE_OS_VERSION Versi sistem operasi seluler, mis. "iOS 13.5.1". Peringatan: Dimensi ini tidak kompatibel dengan metrik challengeName_EARNINGS, dan OBSERVED_ECPM.
GMA_SDK_VERSION Versi GMA SDK, misalnya "iOS 7.62.0". Peringatan: Dimensi ini tidak kompatibel dengan metrik challengeName_EARNINGS, dan OBSERVED_ECPM.
APP_VERSION_NAME Untuk Android, nama versi aplikasi dapat ditemukan di versionName di PackageInfo. Untuk iOS, nama versi aplikasi dapat ditemukan di CFBundleShortVersionString. Peringatan: Dimensi ini tidak kompatibel dengan metrik challengeName_EARNINGS, dan OBSERVED_ECPM.
SERVING_RESTRICTION Mode pembatasan untuk penayangan iklan (mis. "Iklan yang tidak dipersonalisasi"). Peringatan: Dimensi tidak kompatibel dengan metrik Forecast_EARNINGS.

Metrik

Metrik laporan mediasi. Metrik adalah pengukuran kuantitatif yang menunjukkan performa bisnis penayang. Peristiwa tersebut digabungkan dari setiap peristiwa iklan dan dikelompokkan menurut dimensi laporan. Nilai metrik adalah bilangan bulat, atau desimal (tanpa pembulatan).

Enumerasi
METRIC_UNSPECIFIED Nilai default untuk kolom yang tidak ditetapkan. Jangan gunakan.
AD_REQUESTS Jumlah permintaan. Nilainya adalah bilangan bulat.
CLICKS Frekuensi pengguna mengklik iklan. Nilainya adalah bilangan bulat.
ESTIMATED_EARNINGS

Estimasi penghasilan penayang AdMob. Unit mata uang (USD, EUR, atau lainnya) dari metrik penghasilan ditentukan oleh setelan pelokalan untuk mata uang. Jumlahnya dalam mikro. Misalnya, $6,50 akan direpresentasikan sebagai 6500000.

Estimasi penghasilan per grup mediasi dan per tingkat instance sumber iklan didukung sejak tanggal 20 Oktober 2019. Estimasi penghasilan pihak ketiga akan menampilkan 0 untuk tanggal sebelum 20 Oktober 2019.

IMPRESSIONS Total jumlah iklan yang ditampilkan kepada pengguna. Nilainya adalah bilangan bulat.
IMPRESSION_CTR Rasio klik terhadap tayangan. Nilainya adalah nilai desimal presisi ganda (perkiraan).
MATCHED_REQUESTS Frekuensi iklan ditampilkan sebagai respons terhadap permintaan. Nilainya adalah bilangan bulat.
MATCH_RATE Rasio permintaan iklan yang cocok terhadap total permintaan iklan. Nilainya adalah nilai desimal presisi ganda (perkiraan).
OBSERVED_ECPM

Perkiraan eCPM rata-rata jaringan iklan pihak ketiga. Unit mata uang (USD, EUR, atau lainnya) dari metrik penghasilan ditentukan oleh setelan pelokalan untuk mata uang. Jumlahnya dalam mikro. Misalnya, $2,30 akan direpresentasikan sebagai 2300000.

Perkiraan eCPM rata-rata per grup mediasi dan per tingkat instance sumber iklan didukung sejak tanggal 20 Oktober 2019. Estimasi eCPM rata-rata pihak ketiga akan menampilkan 0 untuk tanggal sebelum 20 Oktober 2019.

FilterDimensi

Menjelaskan baris laporan mana yang akan dicocokkan berdasarkan nilai dimensinya.

Representasi JSON
{
  "dimension": enum (Dimension),
  "matchesAny": {
    object (StringList)
  }
}
Kolom
dimension

enum (Dimension)

Menerapkan kriteria filter ke dimensi yang ditentukan.

matchesAny

object (StringList)

Cocok dengan baris jika nilainya untuk dimensi yang ditentukan ada dalam salah satu nilai yang ditentukan dalam kondisi ini.

UrutkanKondisi

Arah pengurutan yang akan diterapkan pada dimensi atau metrik.

Representasi 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.
}
Kolom
order

enum (SortOrder)

Urutan dimensi atau metrik.

Kolom union sort_on. Mengidentifikasi nilai yang akan diurutkan. sort_on hanya dapat berupa salah satu dari berikut:
dimension

enum (Dimension)

Urutkan menurut dimensi yang ditentukan.

metric

enum (Metric)

Urutkan menurut metrik yang telah ditentukan.