Method: accounts.campaignReport.generate

Generuje raport o kampanii na podstawie podanych specyfikacji.

Żądanie HTTP

POST https://admob.googleapis.com/v1beta/{parent=accounts/*}/campaignReport:generate

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
parent

string

Nazwa zasobu konta, dla którego ma zostać wygenerowany raport. Przykład: accounts/pub-9876543210987654

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "reportSpec": {
    object (CampaignReportSpec)
  }
}
Pola
reportSpec

object (CampaignReportSpec)

Specyfikacja raportu kampanii.

Treść odpowiedzi

Odpowiedź interfejsu Campaign Report API.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "rows": [
    {
      object (ReportRow)
    }
  ]
}
Pola
rows[]

object (ReportRow)

Dane raportu kampanii od określonego wydawcy. Interfejs API zwróci maksymalnie 100 000 wierszy.

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

  • https://www.googleapis.com/auth/admob.readonly
  • https://www.googleapis.com/auth/admob.report

Więcej informacji znajdziesz w sekcji OAuth 2.0 Overview.

CampaignReportSpec

Specyfikacja generowania raportu o kampanii. Na przykład specyfikacja pobierania danych o WYŚWIETLENIACH i KLIKNIĘCIACH podzielonych według IDENTYFIKATORA_KAMPANII może wyglądać tak:

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

object (DateRange)

Zakres dat, dla którego generowany jest raport. Maksymalny zakres to 30 dni.
dimensions[]

enum (Dimension)

Lista wymiarów raportu. Kombinacja wartości tych wymiarów określa wiersz raportu. Jeśli nie określisz żadnych wymiarów, raport zwróci jeden wiersz z żądanymi wartościami dla całego konta.
metrics[]

enum (Metric)

Lista danych w raporcie. Raport musi zawierać co najmniej 1 rodzaj danych.
languageCode

string

Język używany w przypadku zlokalizowanego tekstu, np. niektórych odpowiednich wartości wymiarów. Tag języka jest zdefiniowany w standardzie IETF BCP47. Jeśli wartość jest nieprawidłowa lub nie została podana, domyślnie przyjmuje się „en-US”.

Wymiar

Wymiary raportu o kampanii.

Wartości w polu enum
DIMENSION_UNSPECIFIED Wartość domyślna nieokreślonego wymiaru. Nie używać.
DATE Data w formacie RRRRMMDD (np. „20210701”).
CAMPAIGN_ID Unikalny identyfikator kampanii, np. „123456789”, który jest zgodny z identyfikatorem kampanii z interfejsu API listy kampanii.
CAMPAIGN_NAME Nazwa kampanii
AD_ID Unikalny identyfikator reklamy, np. „123456789”.
AD_NAME Nazwa reklamy, która może nie być unikalna.
PLACEMENT_ID Unikalny identyfikator aplikacji, w której wyświetla się reklama, przypisany przez dostawcę. Na przykład com.goog.bar w przypadku aplikacji na Androida i 123456789 w przypadku aplikacji na iOS.
PLACEMENT_NAME Nazwa aplikacji, w której wyświetla się reklama.
PLACEMENT_PLATFORM Platforma aplikacji, w której umieszczona jest reklama.
COUNTRY Nazwa kraju docelowego.
FORMAT Format jednostki reklamowej (np. „baner”, „reklama natywna”), wymiar wyświetlania reklam.

Dane

Dane w raporcie kampanii.

Wartości w polu enum
METRIC_UNSPECIFIED Wartość domyślna pola, które nie zostało skonfigurowane. Nie używać.
IMPRESSIONS Liczba wyświetleń reklamy użytkownikowi.
CLICKS Liczba kliknięć reklamy przez użytkownika.
CLICK_THROUGH_RATE Liczba kliknięć reklamy podzielona przez liczbę jej wyświetleń.
INSTALLS Liczba pobrań aplikacji na urządzenia.
ESTIMATED_COST Szacowany koszt wyświetlania reklamy z kampanii zamiast reklamy, która generuje przychody. Waluta jest walutą raportowania kampanii.
AVERAGE_CPI Średni koszt instalacji. To średnia kwota wydana na pozyskanie nowego użytkownika. Waluta jest walutą raportowania kampanii.
INTERACTIONS Liczba interakcji użytkownika z reklamą. Obejmuje to kliknięcia i wyświetlenia angażujące.