- HTTP isteği
- Yol parametreleri
- İstek metni
- Yanıt metni
- Yetkilendirme kapsamları
- MediationReportSpec
- Boyut
- Metrik
- DimensionFilter (Boyut Filtresi)
- SortCondition
- Örnekler
- Deneyin.
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 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 |
Raporun oluşturulacağı hesabın kaynak adı. Örnek: accounts/pub-9876543210987654 |
İstek içeriği
İsteğin gövdesi, aşağıdaki yapıya sahip veriler içerir:
JSON gösterimi |
---|
{
"reportSpec": {
object ( |
Alanlar | |
---|---|
reportSpec |
Ağ raporu özellikleri. |
Yanıt gövdesi
İlk yanıtın rapor başlığını, ardından satır yanıtlarının akışını ve son yanıt mesajı olarak bir altbilgiyi içerdiği AdMob Uyumlulaştırması 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 |
Alanlar | |
---|---|
Birleştirme alanı payload . Her akış yanıtı mesajı bir yük türü içerir. payload şunlardan yalnızca biri olabilir: |
|
header |
Rapor tarih aralığı ve yerelleştirme ayarları gibi rapor içeriklerini açıklayan rapor oluşturma ayarları. |
row |
Gerçek rapor verileri. |
footer |
Oluşturulan raporla ilgili 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'a Genel Bakış başlıklı makaleye bakın.
MediationReportSpec
AdMob Uyumlulaştırması raporu oluşturmaya ilişkin spesifikasyon. Örneğin, gözlemlenen EBGBM'nin "ABD" ve "CN" ülkeleri için reklam kaynağı ve uygulamaya göre ayrılmış şekilde alınmasıyla ilgili spesifikasyon aşağıdaki örnekteki 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 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 ( |
Alanlar | |
---|---|
dateRange |
Raporun oluşturulduğu tarih aralığı. |
dimensions[] |
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[] |
Rapor metriklerinin listesi. Bir raporda en az bir metrik belirtilmelidir. |
dimensionFilters[] |
Boyut değerlerine göre hangi rapor satırlarının eşleneceğini açıklar. |
sortConditions[] |
Rapor satırlarının sıralamasını açıklar. Koşulun listedeki sırası kendi önceliğini tanımlar; koşul ne kadar erken olursa önceliği o kadar yüksek olur. Herhangi bir sıralama koşulu belirtilmezse satır sıralaması tanımsız olur. |
localizationSettings |
Raporun yerelleştirme ayarları. |
maxReportRows |
Döndürülecek maksimum rapor verisi satırı sayısı. Değer ayarlanmazsa API, en fazla 100.000 satır olacak şekilde mümkün olduğunca çok satır döndürür. Kabul edilebilir değerler 1-100.000'dir (1-100.000 dahil). 100.000'den büyük değerler hata döndürür. |
timeZone |
Rapor saat dilimi. "America/Los_Angeles" gibi IANA TZ ad değerlerini kabul eder. Saat dilimi tanımlanmazsa hesabın varsayılan ayarı geçerli olur. "Hesabı al" 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, nicel ölçümleri (metrikleri) reklam biçimi veya reklamın görüntülendiği platform gibi belirli özelliklere göre ayırmak veya hassaslaştırmak için kullanılan veri özellikleridir.
Sıralamalar | |
---|---|
DIMENSION_UNSPECIFIED |
Ayarlanmamış bir alan için varsayılan değer. Kullanmayın. |
DATE |
YYYYAAGG biçimindeki tarih (örneğin, "20210701"). İstekler en fazla bir defalık boyut belirtebilir. |
MONTH |
YYYYAA biçiminde bir ay (örneğin, "202107"). İstekler en fazla bir defalık boyut belirtebilir. |
WEEK |
YYYYAAGG biçimindeki haftanın ilk gününün tarihi (örneğin, "20210701"). İstekler en fazla bir defalık boyut 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 belirtilmişse 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ğrafi boyuttur. |
FORMAT |
Reklam biriminin biçimi (örneğin, "banner", "yerel"), reklam yayınlama boyutu. |
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 alanında bulunabilir. iOS için uygulama sürümü adını CFBundleShortVersionString alanında bulabilirsiniz. |
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 belirten nicel ölçümlerdir. Bunlar, tek tek reklam etkinliklerinden toplanır ve rapor boyutlarına göre gruplandırılır. Metrik değeri tamsayıdır veya ondalıktır (yuvarlama olmadan).
Sıralamalar | |
---|---|
METRIC_UNSPECIFIED |
Ayarlanmamış bir alan için varsayılan değer. Kullanmayın. |
AD_REQUESTS |
İstek sayısı. Değer, bir tam sayıdır. |
CLICKS |
Bir kullanıcının bir reklamı tıklama sayısı. Değer, bir tam sayı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 cinsinden gösterilir. Ö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österilecektir. |
IMPRESSIONS |
Kullanıcılara gösterilen toplam reklam sayısı. Değer, bir tam sayıdır. |
IMPRESSION_CTR |
Tıklamaların gösterimlere oranı. 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, bir tam sayıdır. |
MATCH_RATE |
Eşleşen reklam isteklerinin toplam reklam isteklerine oranı. Değer, çift duyarlıklı (yaklaşık) ondalık bir değerdir. |
OBSERVED_ECPM |
Üçüncü taraf reklam ağının tahmini ortalama eBGBM değeri. Kazanç metriklerinin para birimi (USD, EUR veya diğer), para biriminin yerelleştirme ayarına göre belirlenir. Tutar, mikro cinsinden gösterilir. Örneğin, 2,30 ABD doları, 2300000 olarak temsil edilir. Uyumlulaştırma grubu ve reklam kaynağı örnek düzeyi başına tahmini ortalama eBGBM, 20 Ekim 2019 tarihine kadar desteklenmektedir. Üçü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şleneceğini açıklar.
JSON gösterimi |
---|
{ "dimension": enum ( |
Alanlar | |
---|---|
dimension |
Filtre ölçütünü belirtilen boyuta uygular. |
Birleştirme alanı operator . Uygulanacak filtre operatörü. operator şunlardan yalnızca biri olabilir: |
|
matchesAny |
Belirtilen boyut için değeri bu koşulda belirtilen değerlerden birindeyse satırla eşleşir. |
SortCondition
Bir boyuta veya metriğe uygulanacak sıralama yönü.
JSON gösterimi |
---|
{ "order": enum ( |
Alanlar | |
---|---|
order |
Boyut veya metriğin sıralama düzeni. |
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 |
Belirtilen boyuta göre sıralayın. |
metric |
Belirtilen metriğe göre sıralayın. |