Method: accounts.campaignReport.generate

Generuje raport 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 dotyczącego 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 do raportu o kampanii pochodzące od określonego wydawcy. Interfejs API zwróci maksymalnie 10 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 artykule Omówienie protokołu OAuth 2.0.

CampaignReportSpec

Specyfikacja generowania raportu kampanii. Na przykład specyfikacja umożliwiająca posegmentowanie WYŚWIETLEŃ WYŚWIETLEŃ i KLIKNIĘĆ według parametru CAMPAIGN_ID 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 został wygenerowany 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 pojedynczy wiersz żądanych danych dla całego konta.
metrics[]

enum (Metric)

Lista danych raportu. Raport musi zawierać co najmniej jeden rodzaj danych.
languageCode

string

Język używany w zlokalizowanym tekście, np. w przypadku określonych wartości wymiarów. Tag języka jest zdefiniowany w dokumencie BCP47 IETF. Jeśli nie określono lub jest nieprawidłowa, wartość domyślna to „en-US”.

Wymiar

Wymiary raportu 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 nie może być niepowtarzalna.
PLACEMENT_ID Unikalny identyfikator dostawcy, w którym umieszczona jest reklama. np. com.goog.bar w przypadku Androida i 123456789 w przypadku aplikacji na iOS.
PLACEMENT_NAME Nazwa aplikacji, w której umieszczona jest reklama.
PLACEMENT_PLATFORM Platforma aplikacji, na której umieszczona jest reklama.
COUNTRY Nazwa kraju docelowego.
FORMAT Format jednostki reklamowej (np. „baner”, „natywna”) – wymiar wyświetlania reklam.

Dane

Dane raportu dotyczącego kampanii.

Wartości w polu enum
METRIC_UNSPECIFIED Wartość domyślna nieskonfigurowanego pola. 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świetlenia reklamy z kampanii zamiast reklamy, która generuje przychody. Waluta to waluta raportów dotyczących kampanii.
AVERAGE_CPI Średni koszt instalacji. Jest to średnia kwota wydana na pozyskanie nowego użytkownika. Waluta to waluta raportów dotyczących kampanii.
INTERACTIONS Liczba interakcji użytkownika z reklamą. Składa się ona z kliknięć i interakcji.