Dane skuteczności i atrybuty konfiguracji reklam.
Ten raport może zostać zwrócony tylko przez żądanie asynchroniczne (czyli metodą Reports.request()).
Poproś o fragment
Wyślij standardową treść żądania Reports.request(), ale określ "reportType": "ad".
{
...
"reportType": "ad",
"columns": [
{
"columnName": string,
"headerText": string,
"startDate": string,
"endDate": string
}
],
"filters": [
{
"column": {
"columnName": string,
},
...
},
...
],
...
}
W każdej kolumnie, którą chcesz zwrócić lub odfiltrować w raporcie, określ columnName w tabeli poniżej.
Możesz też określić właściwości headerText, startDate i endDate.
Pamiętaj, że niektórych kolumn nie można filtrować. Więcej informacji znajdziesz w tabeli „Filtrowalne”.
columnName | opis, | Sposób działania | Typ | Możliwe do filtrowania |
|---|---|---|---|---|
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 itp. |
atrybut | String |
Tak |
creationTimestamp |
Sygnatura czasowa utworzenia reklamy w formacie ISO 8601. | atrybut | Timestamp |
Tak |
lastModifiedTimestamp |
Sygnatura czasowa ostatniej modyfikacji reklamy 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 |
Typ 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 dany element. | atrybut | Status |
Tak |
adGroup |
Nazwa grupy reklam. | atrybut | String |
Tak |
adGroupId |
Identyfikator grupy reklam w DS. | atrybut | ID |
Tak |
adGroupStatus |
Stan grupy reklam, która zawiera ten element. | atrybut | Status |
Tak |
ad |
Nazwa reklamy. | atrybut | String |
Tak |
adId |
Identyfikator reklamy w DS. Wartość 0 oznacza, że reklama nie jest przypisana. | 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 z nieobsługiwanym formatem lub błędnym adresem URL serwera kliknięć może uniemożliwić przypisywanie danych do reklamy przez DS. | atrybut | Boolean |
Tak |
adHeadline |
Nagłówek reklamy. | atrybut | String |
Tak |
adHeadline2 |
Nagłówek reklamy 2; niedostępny w niektórych wyszukiwarkach. | atrybut | String |
Tak |
adHeadline3 |
Nagłówek reklamy 3; niedostępny w niektórych wyszukiwarkach. | atrybut | String |
Tak |
adDescription1 |
Pierwsza linia tekstu reklamy | atrybut | String |
Tak |
adDescription2 |
Linia tekstu 2 reklamy; niedostępna w przypadku niektórych wyszukiwarek. | atrybut | String |
Tak |
adDisplayUrl |
Wyświetlany URL reklamy | atrybut | String |
Tak |
adLandingPage |
Strona docelowa reklamy. Zobacz Adresy URL strony docelowej 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 |
Wiersz promocji reklamy. Krótki komunikat promocyjny dla reklamy produktu. | atrybut | String |
Tak |
adLabels |
Nazwy etykiet bezpośrednio przypisanych do tej reklamy nie są dołączane. | atrybut | String list |
Tak |
adPathField1 |
Pole ścieżki reklamy 1. Pola ścieżki 1 i 2 są łączone z adDisplayUrl, aby utworzyć adres URL wyświetlany w reklamie. | atrybut | String |
Tak |
adPathField2 |
Pole ścieżki reklamy 2. Pola ścieżki 1 i 2 są łączone z adDisplayUrl, aby utworzyć adres URL wyświetlany w reklamie. | atrybut | String |
Tak |
effectiveLabels |
Nazwy wszystkich etykiet odziedziczonych lub bezpośrednio przypisanych do tej reklamy. | atrybut | String list |
Tak |
dfaActions |
Łączna liczba działań w usłudze Campaign Manager. | wskaźnik | Integer |
Tak |
dfaRevenue |
Zbiorcze przychody uzyskane z transakcji w usłudze Campaign Manager. | wskaźnik | Money |
Tak |
dfaTransactions |
Łączna liczba transakcji w usłudze Campaign Manager. | wskaźnik | Integer |
Tak |
dfaWeightedActions |
Ważona suma działań Campaign Managera. | wskaźnik | Number |
Tak |
dfaActionsCrossEnv |
Łączna liczba działań Campaign Manager w różnych środowiskach. | wskaźnik | Number |
Tak |
dfaRevenueCrossEnv |
Zbiorcze przychody uzyskane z transakcji Campaign Manager 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ń Campaign Managera 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 |
Łączna liczba kliknięć. | wskaźnik | Integer |
Tak |
cost |
Łączny koszt poniesiony na kontach wyszukiwarek. | 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ę w kolumnie Konwersje Google Ads. Po utworzeniu działania powodującego konwersję w Google Ads reklamodawca może zdecydować, czy chcesz zliczać te konwersje w kolumnie raportowania Konwersje. | wskaźnik | Number |
Tak |
adWordsConversionValue |
Zagregowana 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 |
Podziel raport na segmenty według dni. Każdy wiersz i dane zbiorcze są podzielone na kilka wierszy, po jednym dla każdego dnia. Ta kolumna zawiera datę każdego wiersza. | podziel na segmenty | Date |
Tak |
monthStart |
Podziel raport na segmenty według miesięcy. Każdy wiersz i dane zbiorcze są podzielone na kilka wierszy, po jednym dla każdego miesiąca. Ta kolumna zwraca pierwszy dzień miesiąca każdego wiersza. | podziel na segmenty | Date |
Tak |
monthEnd |
Podziel raport na segmenty według miesięcy. Każdy wiersz i dane zbiorcze są podzielone na kilka wierszy, po jednym dla każdego miesiąca. Ta kolumna zwraca ostatni dzień miesiąca każdego wiersza. | podziel na segmenty | Date |
Tak |
quarterStart |
Podział raportu na segmenty według kwartałów. Każdy wiersz i dane zbiorcze są podzielone na kilka wierszy, po jednym na każdy kwartał. Ta kolumna zwraca pierwszy dzień kwartału każdego wiersza. | podziel na segmenty | Date |
Tak |
quarterEnd |
Podział raportu na segmenty według kwartałów. Każdy wiersz i dane zbiorcze są podzielone na kilka wierszy, po jednym na każdy kwartał. Ta kolumna zwraca ostatni dzień kwartału każdego wiersza. | podziel na segmenty | Date |
Tak |
weekStart |
Segmentuje raport według tygodni (od niedzieli do soboty). Każdy wiersz i dane zbiorcze są podzielone na kilka wierszy, po jednym na każdy tydzień. Ta kolumna zwraca pierwszego dnia (niedzielę) każdego wiersza. | podziel na segmenty | Date |
Tak |
weekEnd |
Segmentuje raport według tygodni (od niedzieli do soboty). Każdy wiersz i dane zbiorcze są podzielone na kilka wierszy, po jednym na każdy tydzień. Ta kolumna zwraca ostatni dzień (sobota) każdego wiersza. | podziel na segmenty | Date |
Tak |
yearStart |
Segmentuje raport według lat. Każdy wiersz i dane zbiorcze są podzielone na kilka 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 dane zbiorcze są podzielone na kilka wierszy, po jednym na każdy rok. Ta kolumna zwraca ostatni dzień roku w każdym wierszu. | podziel na segmenty | Date |
Tak |
deviceSegment |
Podział raportu na segmenty według urządzenia – każdy wiersz i dane zbiorcze są podzielone na kilka wierszy, po jednym dla każdego segmentu urządzeń. Ta kolumna zwraca segment urządzeń w każdym wierszu. | podziel na segmenty | Device segment |
Tak |
floodlightGroup |
Podział raportu na segmenty według grup Floodlight. Każdy wiersz i dane zbiorcze są podzielone na kilka wierszy (po jednym na każdą grupę Floodlight). Ta kolumna zwraca nazwę grupy Floodlight w każdym wierszu. Pamiętaj, że niektóre dane nie mają wartości podzielonych na segmenty, np. kliknięć i wizyt. | podziel na segmenty | String |
Tak |
floodlightGroupId |
Podział raportu na segmenty według grup Floodlight. Każdy wiersz i dane zbiorcze są podzielone na kilka wierszy (po jednym na każdą grupę Floodlight). Ta kolumna zwraca identyfikator grupy Floodlight w każdym wierszu. Pamiętaj, że niektóre dane nie mają wartości podzielonych na segmenty, np. kliknięć i wizyt. | podziel na segmenty | ID |
Tak |
floodlightGroupTag |
Podział raportu na segmenty według grup Floodlight. Każdy wiersz i dane zbiorcze są podzielone na kilka wierszy (po jednym na każdą grupę Floodlight). Ta kolumna zwraca tag grupy Floodlight w każdym wierszu. Pamiętaj, że niektóre dane nie mają wartości podzielonych na segmenty, np. kliknięć i wizyt. | podziel na segmenty | String |
Tak |
floodlightActivity |
Podział raportu na segmenty według aktywności Floodlight. Każdy wiersz i dane zbiorcze są podzielone na wiele wierszy, maksymalnie po jednym dla każdej aktywności Floodlight. Ta kolumna zwraca nazwę aktywności Floodlight w każdym wierszu. Pamiętaj, że niektóre dane nie mają wartości podzielonych na segmenty, np. kliknięć i wizyt. | podziel na segmenty | String |
Tak |
floodlightActivityId |
Podział raportu na segmenty według aktywności Floodlight. Każdy wiersz i dane zbiorcze są podzielone na wiele wierszy, maksymalnie po jednym dla każdej aktywności Floodlight. Ta kolumna zwraca identyfikator aktywności Floodlight DS w każdym wierszu. Pamiętaj, że niektóre dane nie mają wartości podzielonych na segmenty, np. kliknięć i wizyt. | podziel na segmenty | ID |
Tak |
floodlightActivityTag |
Podział raportu na segmenty według aktywności Floodlight. Każdy wiersz i dane zbiorcze są podzielone na wiele wierszy, maksymalnie po jednym dla każdej aktywności Floodlight. Ta kolumna zwraca tag aktywności Floodlight w każdym wierszu. Pamiętaj, że niektóre dane nie mają wartości podzielonych na segmenty, np. kliknięć i wizyt. | podziel na segmenty | String |
Tak |