Method: accounts.mediationReport.generate

Belirtilen rapor özelliklerine göre bir AdMob uyumlulaştırma raporu oluşturur. Sunucu taraflı akış RPC'sinin sonucunu döndürür. Sonuç, bir dizi yanıt olarak döndürülür.

HTTP isteği

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

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
parent

string

Raporun oluşturulacağı hesabın kaynak adı. Örnek: accounts/pub-9876543210987654

İstek metni

İstek içeriği aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "reportSpec": {
    object (MediationReportSpec)
  }
}
Alanlar
reportSpec

object (MediationReportSpec)

Ağ raporu spesifikasyonu.

Yanıt metni

İlk yanıtta rapor başlığının, ardından bir dizi satır yanıtının ve son olarak da son yanıt mesajı olarak bir altbilginin yer aldığı AdMob uyumlulaştırma raporu için akış yanıtı.

Örneğin:

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

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{

  // 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.
}
Alanlar
payload birleşik alanı. Her akış yanıtı mesajı bir tür yük içerir. payload aşağıdakilerden yalnızca biri olabilir:
header

object (ReportHeader)

Raporun tarih aralığı ve yerelleştirme ayarları gibi rapor içeriklerini açıklayan rapor oluşturma ayarları.
row

object (ReportRow)

Gerçek rapor verileri.
footer

object (ReportFooter)

Oluşturulan rapor hakkında ek bilgiler (ör. verilerle ilgili uyarılar).

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

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

Daha fazla bilgi için OAuth 2.0 Overview sayfasına bakın.

MediationReportSpec

AdMob uyumlulaştırma raporu oluşturma spesifikasyonu. Örneğin, "ABD" ve "Çin" ülkeleri için gözlemlenen eBGBM'nin reklam kaynağına ve uygulamaya göre dilimlenmesini sağlayan spesifikasyon aşağıdaki örnek gibi görünebilir:

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

Daha iyi anlamak için önceki spesifikasyonu aşağıdaki sahte SQL gibi değerlendirebilirsiniz:

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

object (DateRange)

Raporun oluşturulduğu tarih aralığı.
dimensions[]

enum (Dimension)

Raporun boyutlarının listesi. Bu boyutların değer kombinasyonu, raporun satırını belirler. Boyut belirtilmezse rapor, hesabın tamamı için istenen metriklerin tek bir satırını döndürür.
metrics[]

enum (Metric)

Rapordaki metriklerin listesi. Bir raporda en az bir metrik belirtilmelidir.
dimensionFilters[]

object (DimensionFilter)

Boyut değerlerine göre hangi rapor satırlarının eşleştirileceğini açıklar.
sortConditions[]

object (SortCondition)

Rapor satırlarının sıralanmasını açıklar. Listedeki koşulun sırası, önceliğini belirler. Koşul ne kadar erken olursa önceliği o kadar yüksek olur. Sıralama koşulu belirtilmemişse satır sıralaması tanımlanmamıştır.
localizationSettings

object (LocalizationSettings)

Raporun yerelleştirme ayarları.
maxReportRows

integer

Döndürülecek maksimum rapor verisi satırı sayısı. Değer ayarlanmamışsa API, 100.000'e kadar mümkün olduğunca çok satır döndürür. Kabul edilen değerler 1-100000 arasıdır (1 ve 100000 dahil). 100.000'den büyük değerler hata döndürür.
timeZone

string

Rapor saat dilimi. "America/Los_Angeles" gibi IANA TZ adı değerlerini kabul eder. Saat dilimi tanımlanmamışsa hesap varsayılanı geçerli olur. Hesap alma işlemiyle varsayılan değeri kontrol edin.

Uyarı: Şu anda yalnızca "America/Los_Angeles" değeri desteklenmektedir.

Boyut

Uyumlulaştırma raporunun boyutları. Boyutlar, nicel ölçümleri (metrikler) reklam biçimi veya reklamın görüntülendiği platform gibi belirli özelliklere göre dökümlendirmek ya da hassaslaştırmak için kullanılan veri özellikleridir.

Sıralamalar
DIMENSION_UNSPECIFIED Ayarlanmamış bir alanın varsayılan değeri. Kullanmayın.
DATE YYYYMMDD biçiminde bir tarih (örneğin, "20210701"). İsteklerde en fazla bir zaman boyutu belirtilebilir.
MONTH YYYYAA biçiminde bir ay (örneğin, "202107"). İsteklerde en fazla bir zaman boyutu belirtilebilir.
WEEK Bir haftanın ilk gününün YYYYAAGG biçimindeki tarihi (ör. "20210701"). İsteklerde en fazla bir zaman boyutu belirtilebilir.
AD_SOURCE Reklam kaynağının benzersiz kimliği (örneğin, "5450213213286189855" ve etiket değeri olarak "AdMob Ağı").
AD_SOURCE_INSTANCE Reklam kaynağı örneğinin benzersiz kimliği (örneğin, "ca-app-pub-1234:asi:5678" ve etiket değeri olarak "AdMob (varsayılan)").
AD_UNIT Reklam biriminin benzersiz kimliği (örneğin, "ca-app-pub-1234/8790"). AD_UNIT boyutu belirtilirse APP otomatik olarak dahil edilir.
APP Mobil uygulamanın benzersiz kimliği (ör. "ca-app-pub-1234~1234").
MEDIATION_GROUP Uyumlulaştırma grubunun benzersiz kimliği (örneğin, etiket değeri olarak "ca-app-pub-1234:mg:1234" ve "AdMob (varsayılan)").
COUNTRY Reklam görüntülemelerinin/tıklamalarının gerçekleştiği yerin CLDR ülke kodu (örneğin, "US" veya "FR"). Bu bir coğrafya boyutudur.
FORMAT Reklam biriminin biçimi (örneğin, "banner", "doğal"), bir reklam yayınlama boyutu.
PLATFORM Uygulamanın mobil işletim sistemi platformu (örneğin, "Android" veya "iOS").
MOBILE_OS_VERSION Mobil işletim sistemi sürümü (ör. "iOS 13.5.1").
GMA_SDK_VERSION GMA SDK sürümü (ör. "iOS 7.62.0").
APP_VERSION_NAME Android'de uygulama sürümü adı, PackageInfo'daki versionName içinde bulunabilir. iOS'te uygulama sürümü adı CFBundleShortVersionString'de bulunabilir.
SERVING_RESTRICTION Reklam yayınlama için kısıtlama modu (ör. "Kişiselleştirilmemiş reklamlar").

Metrik

Uyumlulaştırma raporunun metrikleri. Metrikler, yayıncı işletmesinin nasıl performans gösterdiğini belirten nicel ölçümlerdir. Bu metrikler, tek tek reklam etkinliklerinden toplanır ve rapor boyutlarına göre gruplandırılır. Metrik değeri tam sayı veya ondalık sayıdır (yuvarlama olmadan).

Sıralamalar
METRIC_UNSPECIFIED Ayarlanmamış bir alanın varsayılan değeri. Kullanmayın.
AD_REQUESTS İstek sayısı. Değer bir tam sayıdır.
CLICKS Kullanıcıların bir reklamı tıklama sayısıdır. Değer bir tam sayıdır.
ESTIMATED_EARNINGS

AdMob yayıncısının tahmini kazançları. Kazanç metriklerinin para birimi (ABD doları, avro vb.), para biriminin yerelleştirme ayarına göre belirlenir. Tutar, mikro cinsindendir. Örneğin 6,50 ABD doları, 6500000 olarak gösterilir.

Uyumlulaştırma grubu ve reklam kaynağı örneği düzeyinde tahmini kazançlar, 20 Ekim 2019'dan itibaren desteklenir. Üçüncü taraf tahmini kazançları, 20 Ekim 2019'dan önceki tarihler için 0 olarak gösterilir.
IMPRESSIONS Kullanıcılara gösterilen toplam reklam sayısıdır. Değer bir tam sayıdır.
IMPRESSION_CTR Tıklama sayısının gösterim sayısına oranı. Değer, çift duyarlıklı (yaklaşık) bir ondalık değerdir.
MATCHED_REQUESTS İsteğe yanıt olarak reklamların döndürülme sayısıdır. Değer bir tam sayıdır.
MATCH_RATE Eşleşen reklam isteklerinin toplam reklam isteklerine oranıdır. Değer, çift duyarlıklı (yaklaşık) bir ondalık değerdir.
OBSERVED_ECPM

Üçüncü taraf reklam ağının tahmini ortalama eBGBM'si. Kazanç metriklerinin para birimi (ABD doları, avro vb.), para biriminin yerelleştirme ayarına göre belirlenir. Tutar, mikro cinsindendir. Örneğin, 2,30 ABD doları 2300000 olarak gösterilir.

Uyumlulaştırma grubu ve reklam kaynağı örneği düzeyinde tahmini ortalama eBGBM, 20 Ekim 2019'dan itibaren desteklenir. Üçüncü taraf tahmini ortalama eBGBM, 20 Ekim 2019'dan önceki tarihler için 0 olarak gösterilir.

DimensionFilter

Boyut değerlerine göre hangi rapor satırlarının eşleştirileceğini açıklar.

JSON gösterimi 
{
  "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.
}
Alanlar
dimension

enum (Dimension)

Filtre ölçütünü belirtilen boyuta uygular.
operator birleşik alanı. Uygulanacak filtre operatörü. operator aşağıdakilerden yalnızca biri olabilir:
matchesAny

object (StringList)

Belirtilen boyut için değeri bu koşulda belirtilen değerlerden biriyse satırla eşleşir.

SortCondition

Bir boyuta veya metriğe uygulanacak sıralama yönü.

JSON gösterimi 
{
  "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.
}
Alanlar
order

enum (SortOrder)

Boyutun veya metriğin sıralama düzeni.
sort_on birleşik alanı. Hangi değerlere göre sıralama yapılacağını tanımlar. sort_on aşağıdakilerden yalnızca biri olabilir:
dimension

enum (Dimension)

Belirtilen boyuta göre sıralayın.
metric

enum (Metric)

Belirtilen metriğe göre sıralayın.