Reklam Etkinliği Raporu Alfa API'si

Dikkat: Reklam Etkinliği Raporu alfa sürümüne katıldığınız için teşekkür ederiz. İlgili içeriği oluşturmak için kullanılan Reklam Etkinliği raporunun alfa sürümünden çıkma planı yoktur ve artık desteklenmemektedir. Lütfen Uyumlulaştırma Raporu API'sini kullanın . Bir alfa sürümünün kararlılık kısıtlamaları hakkında daha fazla bilgi kanala gidin.

Önemli: Yeni kullanıcı rolleri ve izinleri, verileri etkileyecek döndüren tüm verileri bulabilirsiniz. Daha fazla bilgi

Reklam Etkinliği raporu, merkezi bir görünüm elde eder. Verileri, metrikleri ve hem ağ raporu API'sinden hem de uyumlulaştırma raporu API'sinden teklif verilerini tek bir birleştirilmiş rapora dönüştürmenize olanak tanır.

Ads Activity Report API'si, Uyumlulaştırmaya yönelik ek iyileştirmeler sunar. Aşağıdaki tabloda görüldüğü gibi Rapor API'si ve Ağ Raporu API'si:

	Ağ Raporu API'si	Uyumlulaştırma Raporu API'si	Reklam Etkinliği Raporu API'si
Ağ performansı	✅	✅	✅
Şelale performansı		✅	✅
Teklif performansı			✅
Uyumlulaştırma A/B Denemesi performansı			✅
Saatlik raporlama			✅
Rapor boyutu	100 B	100 B	500 B

Metrikler, boyutlar ve boyut filtreleri

Aşağıdaki metrikler Reklam Etkinliği Raporu API'sine eklendi Network Report API'de bulunan metriklerin birçoğu ve Uyumlulaştırma Raporu API'si.

Metrik	Açıklama
BID_REQUEST	Teklifli sistem reklam kaynağına gönderilen isteklerin sayısıdır.
BIDS_IN_AUCTION	Teklifli sistem açık artırmalarına katılan reklam kaynağı tarafından gönderilen tekliflerin sayısıdır.
WINNING_BIDS	Bir teklifli sistem açık artırmasını kazanan tekliflerin sayısıdır.

Aşağıdaki yeni boyutlar Reklam Etkinliği Raporu API'sine dahil edilmiştir.

Boyut	Açıklama
HAFTA	Haftanın ilk gününün tarihi (dil seçeneğine göre) YYYYAAGG biçiminde belirtilen (yerelleştirme ayarlarında belirtilen kod) Örneğin, "20210701"). İstekler DATE, WEEK veya MONTH değerlerinden yalnızca birini belirtebilir zaman boyutunuz.
SAAT	PST saatiyle SS biçiminde saat. Örneğin, "05" 05:00 PST için, "13" 13:00 PST için. İstekte DATE boyutu da belirtilmelidir. CEVAP SAAT boyutu belirtildiğinde en fazla 28 günlük veri döndürülür. Geçerli tarihten 28 gün öncesinin tarih aralığı başlangıç tarihleri bir hata döndürür.
MEDIATION_AB_TEST (deneme adı)	Performansı uyumlulaştırma A/B testine göre görüntüleyin. Bunu belirtmek zorunludur değeri belirtilir.
MEDIATION_AB_TEST_VARIANT (Varyant A, Varyant B)	Performansı uyumlulaştırma A/B testi varyantına göre görüntüleyin.

Not: Reklam Etkinliği raporundaki tüm boyutlar boyut olarak desteklenir filtrelerine dokunun. _NAME ve _ID son eklerine sahip değerler için _ID son eki desteklenen filtre değerini belirtin. Örneğin, reklam birimlerine göre filtreleme yapmak için AD_UNIT_ID boyutunu boyut filtresi olarak kullanabilirsiniz.

Uyumlulaştırma Raporu API'sindeki boyut adı	Reklam Etkinliği Raporu API'sindeki boyut adı	Açıklama
REKLAM_BİRİMİ^1	AD_UNIT_ID	Reklam biriminin benzersiz kimliği (örneğin, "123456789").
	AD_UNIT_NAME	Reklam biriminin adı.
UYGULAMA^1	APP_ID	Mobil uygulamanın benzersiz kimliği (örneğin, "1234567890").
	APP_NAME	Uygulamanın adı.
AD_SOURCE^1	AD_SOURCE_ID	Reklam kaynağının benzersiz kimliği (ör. "1234567890123456789").
	AD_SOURCE_NAME	Reklam kaynağının adı (örneğin "AdMob Ağı").
AD_SOURCE_INSTANCE^1	AD_SOURCE_INSTANCE_ID	Reklam kaynağı örneğinin benzersiz kimliği (ör. "123456789012").
	AD_SOURCE_INSTANCE_NAME	Reklam kaynağı örneğinin adı (örneğin, "AdMob (varsayılan)").
MEDIATION_GROUP^1	MEDIATION_GROUP_ID	Uyumlulaştırma grubunun benzersiz kimliği (ör. "1234567890").
	MEDIATION_GROUP_NAME	Uyumlulaştırma grubunun benzersiz kimliği (ör. "AdMob (varsayılan)").

¹: Daha fazla bilgi için Scalars bölümüne bakın.

Aşağıdaki boyutların biçimi güncellenmiş.

Uyumlulaştırma Raporu API'sindeki boyut adı	Uyumlulaştırma Raporu API'sindeki açıklama	Ads Activity Report API'deki açıklama
ESTIMATED_EARNINGS	AdMob yayıncısının tahmini kazançları. Para birimi (USD, EUR veya diğer) yapılan işlemlerde, yerelleştirmeye göre belirlenir. para birimi ayarı. Tutar, mikro cinsindendir. Örneğin; 6, 50 TL; 6500000 olarak temsil edilir. Uyumlulaştırma grubu ve reklam kaynağı örnek düzeyi başına tahmini kazançlar: desteklenmeye başlandı. Üçüncü taraf tahmini kazançları 20 Ekim 2019'dan önceki tarihler için 0 değerini gösterir.	AdMob yayıncısının tahmini kazançları. Para birimi (USD, EUR veya diğer) yapılan işlemlerde, yerelleştirmeye göre belirlenir. para birimi ayarı.
OBSERVED_ECPM	Üçüncü taraf reklam ağının tahmini ortalama eBGBM'si. Para birimi (USD, EUR veya diğer) kazanç metrikleri, yerelleştirme tarafından belirlenir. para birimi ayarı. Tutar, mikro cinsindendir. Örneğin, 2,30 TL sizin için 2300.000 olarak temsil edilir. Uyumlulaştırma grubu başına ve reklam kaynağı örneği düzeyi başına tahmini ortalama eBGBM 20 Ekim 2019 tarihine kadar desteklenir. Üçüncü taraf tahmini ortalaması eBGBM, 20 Ekim 2019'dan önceki tarihler için 0 değerini gösterir.	Tüm reklamlar için ortalama eBGBM. Para birimi (USD, EUR veya diğer) kazanç metrikleri, para biriminin yerelleştirme ayarına göre belirlenir. Uyumlulaştırma grubu ve reklam kaynağı örneği düzeyi başına ortalama eBGBM: desteklenir. OBSERVED_ECPM tarihler için 0 değerini gösterir kontrol edin.

Scalars

Aşağıdaki boyutlar Reklam Etkinliği Raporu API'sinde şu şekilde güncellenmiştir: skaler değerler kullanmayı deneyin. Bu da yanıtı sadeleştirerek gerekir.

Uyumlulaştırma Raporu API'si ve Ağ Raporu API'sinden etkilenen boyutlar:

• AD_UNIT
• APP
• AD_SOURCE
• AD_SOURCE_INSTANCE
• MEDIATION_GROUP

Örnek rapor yanıtı verileri
Uyumlulaştırma / Ağ API'si boyut biçimi	"AD_UNIT": { "value":"ca-app-pub-XXXXXXXXXXXXXXXXX/YYYYYYYYYY", "displayLabel": "Test ad unit name" }
AAR API'si boyut biçimi	"AD_UNIT_NAME": "Test ad unit name", "AD_UNIT_ID": "ca-app-pub-XXXXXXXXXXXXXXXXX/YYYYYYYYYY"

Saatlik raporlama

Artık AdMob API'de performansı saate göre görüntüleyebilirsiniz. Saatlik raporlama (şimdiki değeri) 28 gün boyunca kullanılabilir.

Saatlik alma işlemi için istekte DATE boyutu da belirtilmelidir. dışı verilerdir. SAAT boyutu şöyle olduğunda, en fazla 28 günlük veri döndürülür. belirtiliyor. Şu tarihten 28 gün önce olan tarih aralığı başlangıç tarihleri: hata döndürür.

Önemli Bilgi: Son iki saate ait veriler eksik olabilir.

Daha büyük rapor boyutu

Ads Activity Report API'si toplam 500.000 satır almanızı sağlar. Örneğin, ek bilgi için kota kılavuzuna göz atın.

İstekte bulunun

İstekte bulunmak için aşağıdaki adımları uygulayın.

curl (komut satırı)

Curl kullanan istekler

1. İstemci gizli anahtarı dosyasını yükleyin ve yetkilendirme kimlik bilgilerini oluşturun.

   Bu adımı ilk kez gerçekleştirdiğinizde bir yetkilendirme istemi görürsünüz. Kabul etmeden önce AdMob API'ye erişimi olan bir Google Hesabı ile oturum açıldığında. Sizin uygulama, veri erişimini elinde bulunduran kişi veya şirket adına hesabına şu anda giriş yapılmış.

   Kimlik doğrulama ve yetkilendirme için oauth2l, JavaScript'inizin tüm işlevleri için Google OAuth 2.0 ile deneyin. oauth2l'yi yükleyin ve komutu aşağıdaki kodu kullanarak path_to_credentials_json bölümünü bir yol ile değiştirin kaydederken indirdiğiniz bir credentials.json dosyasına bulut uygulaması. İlk çalıştırmada komut size OAuth 2.0 yetkilendirme akışı. Sonraki çalıştırmalar jetonu yenile otomatik olarak oluşturur.

   ~/go/bin/oauth2l header --json path_to_credentials_json \
           https://www.googleapis.com/auth/admob.readonly
   

2. Reklam etkinliği raporu oluşturun.

   curl -X POST https://admob.googleapis.com/v1alpha/accounts/pub-XXXXXXXXXXXXXXXX/adsActivityReport:generate \
        -H "Content-Type: application/json" \
        -H "$(~/go/bin/oauth2l header --json path_to_credentials_json https://www.googleapis.com/auth/admob.readonly)"  --data @- << EOF
         {
           "report_spec": {
           "date_range": {
             "start_date": {"year": 2023, "month": 1, "day": 1},
             "end_date": {"year": 2023, "month": 1, "day": 2}
           },
           "dimensions": ["DATE", "HOUR", "MEDIATION_AB_TEST", "VARIANT", "AD_SOURCE_ID", "AD_SOURCE_NAME"],
           "metrics": ["CLICKS", "BID_REQUEST","WINNING_BIDS", "IMPRESSIONS", "ESTIMATED_EARNINGS" ],
           "dimension_filters": [{"dimension": "COUNTRY", "matches_any": {"values": ["US"]}}],
           "sort_conditions": [{"metric":"CLICKS", "order": "DESCENDING"}],
           "localization_settings": {"currency_code": "USD", "language_code": "en-US"}
           }
         }
   EOF
   

   Örnek yanıt:

   {
   "rows": [
     {
       "dimensionValues": {
         "DATE": {
           "value": "20221102"
         },
         "HOUR": {
           "value": "23"
         },
         "MEDIATION_AB_TEST": {
           "value": "Mediation AB Test"
         },
         "VARIANT": {
           "value": "Variant A"
         },
         "AD_SOURCE_ID": {
           "value": "5450213213286189855"
         },
         "AD_SOURCE_NAME": {
           "value": "AdMob Network"
         }
       },
       "metricValues": {
         "CLICKS": {
           "doubleValue": 0
         },
         "BID_REQUEST": {
           "integerValue": "27"
         },
         "WINNING_BIDS": {
           "doubleValue": 0.1111111111111111
         },
         "IMPRESSIONS": {
           "integerValue": "2"
         },
         "ESTIMATED_EARNINGS": {
           "doubleValue": 0
         }
       }
     },
   {
       "dimensionValues": {
         "DATE": {
           "value": "20221102"
         },
         "HOUR": {
           "value": "23"
         },
         "MEDIATION_AB_TEST": {
           "value": "Mediation AB Test"
         },
         "VARIANT": {
           "value": "Variant B"
         },
         "AD_SOURCE_ID": {
           "value": "5450213213286189855"
         },
         "AD_SOURCE_NAME": {
           "value": "AdMob Network"
         }
       },
       "metricValues": {
         "CLICKS": {
           "doubleValue": 1
         },
         "BID_REQUEST": {
           "integerValue": "6"
         },
         "WINNING_BIDS": {
           "doubleValue": 1
         },
         "IMPRESSIONS": {
           "integerValue": "3"
         },
         "ESTIMATED_EARNINGS": {
           "doubleValue": 0.000427519
         }
       }
     }
   ]}