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ıyla birlikte veriler 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ıdan alınan kampanya rapor 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'a Genel Bakış başlıklı makaleye bakın.

CampaignReportSpec

Kampanya raporu oluşturmaya ilişkin spesifikasyon. Örneğin, CAMPAIGN_ID tarafından dilimlenmiş GÖSTERİM SAYISI ve TIKLAMA SAYISI spesifikasyonu aşağıdaki örnekte olduğu 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. Bir raporda en az bir metrik belirtilmelidir.
languageCode

string

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

Boyut

Kampanya raporunun boyutları.

Sıralamalar
DIMENSION_UNSPECIFIED Belirtilmemiş bir boyutun varsayılan değeri. Kullanmayın.
DATE YYYYAAGG biçimindeki tarih (ör. "20210701").
CAMPAIGN_ID Kampanyanın benzersiz kimliği (ör. "123456789"). Bu, kampanya listesi API'sindeki kampanya kimliğiyle tutarlıdır.
CAMPAIGN_NAME Kampanyanın adı.
AD_ID Reklamın benzersiz kimliği; örneğin "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ği. Ö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 uygulama platformu.
COUNTRY Hedeflenen ülkenin adı.
FORMAT Reklam biriminin biçimi (örneğin, "banner", "yerel"), bir reklam yayını boyutu.

Metrik

Kampanya raporunun metrikleri.

Sıralamalar
METRIC_UNSPECIFIED Ayarlanmamış bir alan için varsayılan değer. Kullanmayın.
IMPRESSIONS Bir reklamın kullanıcıya gösterilme sayısı.
CLICKS Kullanıcının bir reklamı tıklama sayısı.
CLICK_THROUGH_RATE 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, kampanyalara ilişkin raporlama para birimidir.
AVERAGE_CPI Yükleme başına ortalama maliyet. Bu, yeni bir kullanıcı edinmek için harcanan ortalama tutar anlamına gelir. Para birimi, kampanyalara ilişkin raporlama para birimidir.
INTERACTIONS Kullanıcının bir reklamla etkileşimde bulunma sayısı. Tıklama ve etkileşimlerden oluşur.