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 metni

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

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

object (CampaignReportSpec)

Kampanya raporu spesifikasyonu.

Yanıt metni

Kampanya Raporu API 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ıdan alınan 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 sayfasına bakın.

CampaignReportSpec

Kampanya raporu oluşturma spesifikasyonu. Örneğin, GÖSTERİM ve TIKLAMA metriklerinin KAMPANYA_KİMLİĞİ'ne göre dilimlenmesini sağlayan spesifikasyon 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)

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.
languageCode

string

Geçerli boyut değerleri gibi yerelleştirilmiş metinlerde kullanılan dil. Dil etiketi, IETF BCP47'de tanımlanır. Belirtilmemişse veya geçersizse varsayılan olarak "en-US" kullanılır.

Boyut

Kampanya raporunun boyutları.

Sıralamalar
DIMENSION_UNSPECIFIED Belirtilmemiş bir boyutun varsayılan değeri. Kullanmayın.
DATE YYYYMMDD biçiminde bir tarih (örneğin, "20210701").
CAMPAIGN_ID Kampanyanın benzersiz kimliği (ör. "123456789"). Bu kimlik, kampanya listesi API'sindeki kampanya kimliğiyle tutarlıdır.
CAMPAIGN_NAME Kampanyanın adı.
AD_ID Reklamın benzersiz kimliği (ör. "123456789").
AD_NAME Reklamın adı (benzersiz olmayabilir).
PLACEMENT_ID Reklamın yerleştirildiği uygulamanın tedarikçiye özel benzersiz kimliği. Örneğin, Android için com.goog.bar, 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 (örneğin, "banner", "doğal"), bir reklam yayınlama boyutu.

Metrik

Kampanya raporunun metrikleri.

Sıralamalar
METRIC_UNSPECIFIED Ayarlanmamış bir alanın varsayılan değeri. Kullanmayın.
IMPRESSIONS Bir reklamın kullanıcıya gösterilme sayısı.
CLICKS Kullanıcıların bir reklamı tıklama sayısıdır.
CLICK_THROUGH_RATE Reklamın aldığı tıklama sayısının reklamın gösterilme sayısına bölümünden elde edilen yüzdedir.
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 maliyet, yeni bir kullanıcı edinmek için harcanan ortalama tutardır. Para birimi, kampanyaların raporlama para birimidir.
INTERACTIONS Bir kullanıcının bir reklamla etkileşime girme sayısı. Bu, tıklamalar ve etkileşimlerden oluşur.