Method: accounts.mediationReport.generate

Sağlanan rapor spesifikasyonuna göre bir AdMob Uyumlulaştırması raporu oluşturur. Sunucu tarafı akış RPC'sinin sonucunu döndürür. Sonuç, bir dizi yanıt halinde döndürülür.

HTTP isteği

POST https://admob.googleapis.com/v1/{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 içeriği

İstek gövdesi, aşağıdaki yapıya sahip verileri içerir:

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

object (MediationReportSpec)

Ağ raporu spesifikasyonu.

Yanıt gövdesi

AdMob Uyumlulaştırması raporu için, ilk yanıtın rapor üstbilgisini, ardından bir satır yanıtı akışını ve son yanıt mesajı olarak bir altbilgiyi içerdiği 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
Birleştirme alanı payload. Her akış yanıt mesajı bir yük türü içerir. payload şunlardan yalnızca biri olabilir:
header

object (ReportHeader)

Rapor tarih aralığı ve yerelleştirme ayarları gibi rapor içeriğini 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 (OAuth 2.0'a Genel Bakış) sayfasına göz atın.

MediationReportSpec

AdMob Uyumlulaştırması raporu oluşturma spesifikasyonu. Örneğin, gözlemlenen EBGBM'nin "ABD" için reklam kaynağına ve uygulamaya göre ayrılmış şekilde alınmasıyla ilgili spesifikasyon ve 'CN' aşağıdaki örnekteki gibi görünür:

{
  "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 sözde SQL gibi kullanabilirsiniz:

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)

Rapor boyutlarının listesi. Bu boyutların değer kombinasyonu, rapor satırını belirler. Hiçbir boyut belirtilmezse rapor, hesabın tamamı için istenen metriklerin tek bir satırını döndürür.

metrics[]

enum (Metric)

Rapor metriklerinin listesi. 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ıralamasını açıklar. Listedeki koşulun sırası, koşulunun önceliğini tanımlar; koşul ne kadar erken olursa önceliği o kadar yüksektir. Sıralama koşulu belirtilmezse satır sıralaması tanımsız olur.

localizationSettings

object (LocalizationSettings)

Raporun yerelleştirme ayarları.

maxReportRows

integer

Döndürülecek maksimum rapor verisi satırı sayısı. Değer ayarlanmazsa API mümkün olduğunca çok sayıda satır döndürür (en fazla 100.000). 1-100.000 dahil olmak üzere kabul edilebilir değerlerdir. 100.000'den büyük değerler hata döndürür.

timeZone

string

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

Uyarı: "America/Los_Angeles" şu anda desteklenen tek değerdir.

Boyut

Uyumlulaştırma raporunun boyutları. Boyutlar, niceliksel ölçümlerin (metriklerin) reklam biçimi veya reklamın görüntülendiği platform gibi belirli özelliklere göre dökümünü almak veya hassaslaştırmak için kullanılan veri özellikleridir.

Sıralamalar
DIMENSION_UNSPECIFIED Ayarlanmamış bir alan için varsayılan değerdir. Kullanmayın.
DATE YYYYAAGG biçiminde bir tarih (ör. "20210701"). İstekler en fazla bir zaman boyutu belirtebilir.
MONTH YYYYAA biçiminde bir ay (ör. "202107"). İstekler en fazla bir zaman boyutu belirtebilir.
WEEK Haftanın ilk gününün YYYYAAGG biçimindeki tarihi (örneğin, "20210701"). İstekler en fazla bir zaman boyutu belirtebilir.
AD_SOURCE Reklam kaynağının benzersiz kimliği (örneğin, etiket değeri olarak "5450213213286189855" ve "AdMob Ağı").
AD_SOURCE_INSTANCE Reklam kaynağı örneğinin benzersiz kimliği (örneğin, etiket değeri olarak "ca-app-pub-1234:asi:5678" ve "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 (örneğin, "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ğrafi boyuttur.
FORMAT Reklam biriminin biçimi (ör. "banner", "yerel"), bir reklam yayınlama boyutudur.
PLATFORM Uygulamanın mobil işletim sistemi platformu (ör. "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 için uygulama sürümü adı, PackageInfo'daki versionName içinde bulunabilir. iOS için uygulama sürümü adı, CFBundleShortVersionString içinde bulunabilir.
SERVING_RESTRICTION Reklam yayını 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 gösteren niceliksel ölçümlerdir. Bu veriler 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 için varsayılan değerdir. Kullanmayın.
AD_REQUESTS İstek sayısı. Değer tam sayı olmalıdır.
CLICKS Bir kullanıcının bir reklamı tıklama sayısı. Değer tam sayı olmalıdır.
ESTIMATED_EARNINGS

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

Uyumlulaştırma grubu ve reklam kaynağı örneği düzeyi başına tahmini kazançlar, 20 Ekim 2019 tarihine kadar desteklenmektedir. Üçü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ı. Değer tam sayı olmalıdır.
IMPRESSION_CTR Tıklama sayısının gösterimlere oranı. Bu değer, çift duyarlıklı (yaklaşık) ondalık bir değerdir.
MATCHED_REQUESTS Bir isteğe yanıt olarak reklamların döndürülme sayısı. Değer tam sayı olmalıdır.
MATCH_RATE Eşleşen reklam isteklerinin toplam reklam isteklerine oranı. Bu değer, çift duyarlıklı (yaklaşık) ondalık bir değerdir.
OBSERVED_ECPM

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

Uyumlulaştırma grubu ve reklam kaynağı örneği düzeyi başına tahmini ortalama eBGBM, 20 Ekim 2019 tarihine kadar desteklenir. Üçüncü taraf tahmini ortalama eBGBM'si 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.

Birleştirme alanı operator. Uygulanacak filtre operatörü. operator şunlardan yalnızca biri olabilir:
matchesAny

object (StringList)

Belirtilen boyut için değeri bu koşulda belirtilen değerlerden birindeyse bir 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)

Boyut veya metriğin sıralama ölçütü.

Birleştirme alanı sort_on. Hangi değerlere göre sıralama yapılacağını tanımlar. sort_on şunlardan yalnızca biri olabilir:
dimension

enum (Dimension)

Belirtilen boyuta göre sıralayın.

metric

enum (Metric)

Belirtilen metriğe göre sırala.