Method: accounts.campaignReport.generate

Belirtilen özelliklere göre kampanya raporu oluşturur.

HTTP isteği

POST https://admob.googleapis.com/v1beta/{parent=accounts/*}/campaignReport: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 (CampaignReportSpec)
  }
}
Alanlar
reportSpec

object (CampaignReportSpec)

Kampanya raporu spesifikasyonu.

Yanıt gövdesi

Kampanya Raporu API'si yanıtı.

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

JSON gösterimi 
{
  "rows": [
    {
      object (ReportRow)
    }
  ]
}
Alanlar
rows[]

object (ReportRow)

Belirtilen yayıncıya ait kampanya raporu verileri. API'den en fazla 100.000 satır döndürülür.

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.

CampaignReportSpec

Kampanya raporu oluşturma spesifikasyonu. Örneğin, CAMPAIGN_ID parametresine göre bölümlenmiş IMPRESSIONS ve CLICKS verilerini alma spesifikasyonu aşağıdaki örnek gibi görünebilir:

{
  "dateRange": {
    "startDate": {"year": 2021, "month": 12, "day": 1},
    "endDate": {"year": 2021, "month": 12, "day": 30}
  },
  "dimensions": ["CAMPAIGN_ID"],
  "metrics": ["IMPRESSIONS", "CLICKS"],
}
JSON gösterimi 
{
  "dateRange": {
    object (DateRange)
  },
  "dimensions": [
    enum (Dimension)
  ],
  "metrics": [
    enum (Metric)
  ],
  "languageCode": string
}
Alanlar
dateRange

object (DateRange)

Raporun oluşturulduğu tarih aralığı. Maksimum aralık 30 gündür.
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.
languageCode

string

Belirli geçerli boyut değerleri gibi yerelleştirilmiş metinler için kullanılan dil. Dil etiketi, IETF BCP47'de tanımlanmıştır. Varsayılan olarak "en-US" kullanılır belirtilmiyorsa veya geçersizse.

Boyut

Kampanya raporunun boyutları.

Sıralamalar
DIMENSION_UNSPECIFIED Belirtilmemiş bir boyutun varsayılan değeri. Kullanmayın.
DATE YYYYAAGG biçiminde bir tarih (ör. "20210701").
CAMPAIGN_ID Kampanyanın benzersiz kimliği (ör. kampanya listesi API'sindeki kampanya kimliğiyle tutarlı "123456789").
CAMPAIGN_NAME Kampanyanın adı.
AD_ID Reklamın benzersiz kimliğidir (ör. "123456789").
AD_NAME Reklamın adı. Bu ad benzersiz olmayabilir.
PLACEMENT_ID Reklamın yerleştirildiği uygulamanın tedarikçi firmaya özgü benzersiz kimliğidir. Örneğin, Android için com.goog.bar ve iOS uygulamaları için 123456789.
PLACEMENT_NAME Reklamın yerleştirildiği uygulamanın adı.
PLACEMENT_PLATFORM Reklamın yerleştirildiği uygulamanın platformu.
COUNTRY Hedeflenen ülkenin adı.
FORMAT Reklam biriminin biçimi (ör. "banner", "yerel"), bir reklam yayınlama boyutudur.

Metrik

Kampanya raporunun metrikleri.

Sıralamalar
METRIC_UNSPECIFIED Ayarlanmamış bir alan için varsayılan değerdir. Kullanmayın.
IMPRESSIONS Bir reklamın kullanıcıya gösterilme sayısı.
CLICKS Bir kullanıcının bir reklamı tıklama sayısı.
CLICK_THROUGH_RATE Bir reklamın aldığı tıklama sayısının reklamın gösterilme sayısına bölünmesiyle elde edilen orandır.
INSTALLS Uygulamaların cihazlara indirilme sayısı.
ESTIMATED_COST Gelir sağlayan bir reklam yerine kampanya reklamı yayınlamanın tahmini maliyeti. Para birimi, kampanyaların raporlama para birimidir.
AVERAGE_CPI Yükleme başına ortalama maliyet. Bu, yeni bir kullanıcı edinmek için harcanan ortalama tutardır. Para birimi, kampanyaların raporlama para birimidir.
INTERACTIONS Kullanıcının bir reklamla etkileşimde bulunma sayısı. Bu metrik, tıklamalardan ve etkileşimlerden oluşur.