Typ raportu: reklama

Dane o skuteczności i atrybuty konfiguracji reklam.

Ten raport może zostać zwrócony tylko przez żądanie asynchroniczne (tzn. za pomocą funkcji Reports.request()).

Poproś o fragment

Wysyłaj regularnie Reports.request() treści żądania, ale określ "reportType": "ad".

{
...
  "reportType": "ad",
  "columns": [
    {
      "columnName": string,
      "headerText": string,
      "startDate": string,
      "endDate": string
    }
  ],
  "filters": [
    {
      "column": {
        "columnName": string,
      },
      ...
    },
    ...
  ],
...
}

Dla każdej kolumny, którą chcesz zwracać lub odfiltrować w raporcie, określ columnName wymienione w tabeli poniżej. Możesz też opcjonalnie określić headerText startDate, i endDate. Pamiętaj, że niektórych kolumn nie można filtrować. odnosi się do kategorii „Można filtrować”. w tabeli poniżej.

columnNameOpisZachowanieTypMożna filtrować
status Stan reklamy: Active, Paused lub Removed. Pamiętaj, że kampanie, grupy reklam, słowa kluczowe i reklamy mają własny stan. Sprawdź stan. atrybut Status Tak
engineStatus Dodatkowy stan reklamy na zewnętrznym koncie wyszukiwarki. Możliwe stany (w zależności od typu konta zewnętrznego) to active, eligible, creative deleted, creative approved family safe itd. atrybut String Tak
creationTimestamp Sygnatura czasowa utworzenia reklamy podana w formacie ISO 8601. atrybut Timestamp Tak
lastModifiedTimestamp Sygnatura czasowa ostatniej modyfikacji reklamy podana w formacie ISO 8601. atrybut Timestamp Tak
agency Nazwa agencji. atrybut String Tak
agencyId Identyfikator agencji w DS. atrybut ID Tak
advertiser Nazwa reklamodawcy. atrybut String Tak
advertiserId Identyfikator reklamodawcy DS. atrybut ID Tak
account Nazwa konta wyszukiwarki. atrybut String Tak
accountId Identyfikator konta wyszukiwarki DS. atrybut ID Tak
accountEngineId Identyfikator konta na zewnętrznym koncie wyszukiwarki. atrybut String Tak
accountType Rodzaj konta wyszukiwarki: Google AdWords, Bing Ads, Yahoo Japan Listing Ads, Yahoo Search Marketing, Yahoo Gemini, Baidu lub Comparison Shopping. atrybut Engine type Tak
campaign Nazwa kampanii. atrybut String Tak
campaignId Identyfikator kampanii DS. atrybut ID Tak
campaignStatus Stan kampanii zawierającej ten element. atrybut Status Tak
adGroup Nazwa grupy reklam. atrybut String Tak
adGroupId Identyfikator grupy reklam DS. atrybut ID Tak
adGroupStatus Stan grupy reklam zawierającej ten element. atrybut Status Tak
ad Nazwa reklamy. atrybut String Tak
adId Identyfikator reklamy DS. Wartość 0 oznacza, że reklama jest nieprzypisana. atrybut ID Tak
adEngineId Identyfikator reklamy na zewnętrznym koncie wyszukiwarki. atrybut ID Tak
isUnattributedAd Wskazuje, czy dane w tym wierszu nie są przypisane do konkretnej reklamy. Na przykład reklama o nieobsługiwanym formacie lub błędnym adresie URL serwera kliknięć może uniemożliwić DS przypisanie danych do reklamy. atrybut Boolean Tak
adHeadline Nagłówek reklamy. atrybut String Tak
adHeadline2 Nagłówek reklamy 2; niedostępne w niektórych wyszukiwarkach. atrybut String Tak
adHeadline3 Nagłówek reklamy 3; niedostępne w niektórych wyszukiwarkach. atrybut String Tak
adDescription1 Pierwsza linia tekstu reklamy. atrybut String Tak
adDescription2 2. linia tekstu reklamy; niedostępne w niektórych wyszukiwarkach. atrybut String Tak
adDisplayUrl Wyświetlany URL reklamy. atrybut String Tak
adLandingPage Strona docelowa reklamy. Zobacz Adresy URL stron docelowych i serwera kliknięć. atrybut String Tak
adType Typ reklamy: Text, Product, Dynamic search, Mobile app install, Call-Only, Expanded text lub Expanded dynamic search. atrybut Ad type Tak
adPromotionLine Hasło promocyjne reklamy. Krótki komunikat promocyjny w reklamie produktu. atrybut String Tak
adLabels nazwy etykiet przypisanych bezpośrednio do tej reklamy; dziedziczone etykiety nie są uwzględniane. atrybut String list Tak
adPathField1 Pole ścieżki reklamy 1. Pola 1 i 2 ścieżki są łączone z parametrem adDisplayUrl, by utworzyć adres URL, który pokazuje się w reklamie. atrybut String Tak
adPathField2 Pole ścieżki reklamy 2. Pola 1 i 2 ścieżki są łączone z parametrem adDisplayUrl, by utworzyć adres URL, który pokazuje się w reklamie. atrybut String Tak
effectiveLabels Nazwy wszystkich etykiet odziedziczonych lub przypisanych bezpośrednio do tej reklamy. atrybut String list Tak
dfaActions Łączna liczba działań w usłudze Campaign Manager. wskaźnik Integer Tak
dfaRevenue Zbiorcze przychody generowane przez transakcje Campaign Managera. wskaźnik Money Tak
dfaTransactions Łączna liczba transakcji Campaign Managera. wskaźnik Integer Tak
dfaWeightedActions Ważona suma działań w usłudze Campaign Manager. wskaźnik Number Tak
dfaActionsCrossEnv Łączna liczba działań w usłudze Campaign Manager w różnych środowiskach. wskaźnik Number Tak
dfaRevenueCrossEnv Zbiorcze przychody generowane przez transakcje Campaign Managera w różnych środowiskach. wskaźnik Money Tak
dfaTransactionsCrossEnv Łączna liczba transakcji Campaign Manager w różnych środowiskach. wskaźnik Number Tak
dfaWeightedActionsCrossEnv Ważona suma działań Menedżera kampanii w różnych środowiskach. wskaźnik Number Tak
avgCpc Średni koszt kliknięcia. wskaźnik Money Tak
avgCpm Średni koszt tysiąca wyświetleń. wskaźnik Money Tak
avgPos Średnia pozycja. wskaźnik Number Tak
clicks Zbiorcze kliknięcia. wskaźnik Integer Tak
cost Łączny koszt zapłacony na konta wyszukiwarki. wskaźnik Money Tak
ctr Średni współczynnik klikalności wskaźnik Number Tak
impr Łączna liczba wyświetleń. wskaźnik Integer Tak
adWordsConversions Dane skonfigurowane przez reklamodawcę pod kątem raportowania w kolumnie Konwersje Google Ads. Po utworzeniu działania powodującego konwersję w Google Ads reklamodawca może wybrać, czy chcesz zliczać te konwersje w kolumnie raportowania Konwersje. wskaźnik Number Tak
adWordsConversionValue Zbiorcza wartość konwersji Google Ads. wskaźnik Number Tak
adWordsViewThroughConversions Łączna liczba konwersji po wyświetleniu w Google Ads. wskaźnik Integer Tak
visits Łączna liczba wizyt DS. wskaźnik Integer Tak
date segmentuje raport według dni; każdy wiersz i jego dane zbiorcze są dzielone na wiele wierszy, po jednym dla każdego dnia. Ta kolumna zawiera datę każdego wiersza. podziel na segmenty Date Tak
monthStart segmentuje raport według miesięcy; każdy wiersz i jego dane zbiorcze są dzielone na wiele wierszy, po jednym dla każdego miesiąca. Ta kolumna zwraca pierwszy dzień miesiąca każdego wiersza. podziel na segmenty Date Tak
monthEnd segmentuje raport według miesięcy; każdy wiersz i jego dane zbiorcze są dzielone na wiele wierszy, po jednym dla każdego miesiąca. Ta kolumna zwraca ostatni dzień miesiąca każdego wiersza. podziel na segmenty Date Tak
quarterStart segmentowanie raportu według kwartałów; każdy wiersz i jego dane zbiorcze są dzielone na wiele wierszy, po jednym na każdy kwartał. Ta kolumna zwraca pierwszy dzień każdego kwartału. podziel na segmenty Date Tak
quarterEnd segmentowanie raportu według kwartałów; każdy wiersz i jego dane zbiorcze są dzielone na wiele wierszy, po jednym na każdy kwartał. Ta kolumna zwraca ostatni dzień kwartału każdego wiersza. podziel na segmenty Date Tak
weekStart Segmentacja raportu według tygodni (od niedzieli do soboty); każdy wiersz i jego dane zbiorcze są dzielone na wiele wierszy, po jednym na każdy tydzień. Ta kolumna zwraca pierwszy dzień (niedzielę) każdego wiersza. podziel na segmenty Date Tak
weekEnd Segmentacja raportu według tygodni (od niedzieli do soboty); każdy wiersz i jego dane zbiorcze są dzielone na wiele wierszy, po jednym na każdy tydzień. Ta kolumna zawiera ostatni dzień (sobota) każdego wiersza. podziel na segmenty Date Tak
yearStart segmentuje raport według lat; każdy wiersz i jego dane zbiorcze są dzielone na wiele wierszy, po jednym na każdy rok. Ta kolumna zwraca pierwszy dzień roku każdego wiersza. podziel na segmenty Date Tak
yearEnd segmentuje raport według lat; każdy wiersz i jego dane zbiorcze są dzielone na wiele wierszy, po jednym na każdy rok. Ta kolumna zawiera ostatni dzień roku każdego wiersza. podziel na segmenty Date Tak
deviceSegment segmentuje raport według urządzenia; każdy wiersz i jego dane zbiorcze są dzielone na wiele wierszy, po maksymalnie 1 dla każdego segmentu urządzeń. Ta kolumna zwraca segment urządzeń każdego wiersza. podziel na segmenty Device segment Tak
floodlightGroup segmentuje raport według grup Floodlight; każdy wiersz i jego dane zbiorcze są dzielone na wiele wierszy, po maksymalnie po jednym dla każdej grupy Floodlight. Ta kolumna zwraca nazwę grupy Floodlight w każdym wierszu. Pamiętaj, że niektóre dane nie mają posegmentowanych wartości Floodlight (np. liczby kliknięć i wizyt). podziel na segmenty String Tak
floodlightGroupId segmentuje raport według grup Floodlight; każdy wiersz i jego dane zbiorcze są dzielone na wiele wierszy, po maksymalnie po jednym dla każdej grupy Floodlight. Ta kolumna zwraca identyfikator grupy Floodlight DS dla każdego wiersza. Pamiętaj, że niektóre dane nie mają posegmentowanych wartości Floodlight (np. liczby kliknięć i wizyt). podziel na segmenty ID Tak
floodlightGroupTag segmentuje raport według grup Floodlight; każdy wiersz i jego dane zbiorcze są dzielone na wiele wierszy, po maksymalnie po jednym dla każdej grupy Floodlight. Ta kolumna zwraca tag grupy Floodlight każdego wiersza. Pamiętaj, że niektóre dane nie mają posegmentowanych wartości Floodlight (np. liczby kliknięć i wizyt). podziel na segmenty String Tak
floodlightActivity segmentuje raport według aktywności Floodlight; każdy wiersz i jego dane zbiorcze są dzielone na wiele wierszy, po maksymalnie 1 dla każdej aktywności Floodlight. Ta kolumna zwraca nazwę aktywności Floodlight dla każdego wiersza. Pamiętaj, że niektóre dane nie mają posegmentowanych wartości Floodlight (np. liczby kliknięć i wizyt). podziel na segmenty String Tak
floodlightActivityId segmentuje raport według aktywności Floodlight; każdy wiersz i jego dane zbiorcze są dzielone na wiele wierszy, po maksymalnie 1 dla każdej aktywności Floodlight. Ta kolumna zwraca identyfikator aktywności Floodlight DS dla każdego wiersza. Pamiętaj, że niektóre dane nie mają posegmentowanych wartości Floodlight (np. liczby kliknięć i wizyt). podziel na segmenty ID Tak
floodlightActivityTag segmentuje raport według aktywności Floodlight; każdy wiersz i jego dane zbiorcze są dzielone na wiele wierszy, po maksymalnie 1 dla każdej aktywności Floodlight. Ta kolumna zwraca tag aktywności Floodlight każdego wiersza. Pamiętaj, że niektóre dane nie mają posegmentowanych wartości Floodlight (np. liczby kliknięć i wizyt). podziel na segmenty String Tak