Dane o skuteczności i atrybuty konfiguracji reklam.
Ten raport może być zwracany tylko przez żądanie asynchroniczne (czyli za pomocą metody Reports.request()).
Poproś o wyciąg
Prześlij zwykły strumień danych Reports.request(), ale określ parametr "reportType": "ad".
{
...
"reportType": "ad",
"columns": [
{
"columnName":string ,
"headerText":string ,
"startDate":string ,
"endDate":string
}
],
"filters": [
{
"column": {
"columnName":string ,
},
...
},
...
],
...
}
W przypadku każdej kolumny, którą chcesz zwrócić lub odfiltrować w raporcie, określ columnName wymieniony w tabeli poniżej.
Opcjonalnie możesz też podać parametry headerText, startDate i endDate.
Pamiętaj, że niektórych kolumn nie można filtrować. Informacje o możliwości filtrowania znajdziesz w tabeli poniżej.
columnName | Opis | Zachowanie | Typ | Można filtrować |
|---|---|---|---|---|
status |
Stan reklamy: Active, Paused lub Removed. Pamiętaj, że kampanie, grupy reklam, słowa kluczowe i reklamy mają swój własny stan. Sprawdź stan. |
atrybut | Status |
Tak |
engineStatus |
Dodatkowy stan reklamy na koncie zewnętrznej 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 |
Znak czasu utworzenia reklamy w formacie ISO 8601. | atrybut | Timestamp |
Tak |
lastModifiedTimestamp |
Znak czasu ostatniej modyfikacji reklamy w formacie ISO 8601. | atrybut | Timestamp |
Tak |
agency |
Nazwa agencji. | atrybut | String |
Tak |
agencyId |
Identyfikator agencji DS. | atrybut | ID |
Tak |
advertiser |
Nazwa reklamodawcy. | atrybut | String |
Tak |
advertiserId |
Identyfikator reklamodawcy w DS. | atrybut | ID |
Tak |
account |
Nazwa konta wyszukiwarki. | atrybut | String |
Tak |
accountId |
Identyfikator konta wyszukiwarki DS. | atrybut | ID |
Tak |
accountEngineId |
Identyfikator konta w zewnętrznym koncie wyszukiwarki. | atrybut | String |
Tak |
accountType |
Typ konta silnika: 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, która zawiera ten element. | atrybut | Status |
Tak |
adGroup |
Nazwa grupy reklam. | atrybut | String |
Tak |
adGroupId |
Identyfikator grupy reklam 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 DS. Wartość 0 oznacza, że reklama nie jest przypisana. | atrybut | ID |
Tak |
adEngineId |
Identyfikator reklamy na koncie zewnętrznej wyszukiwarki. | atrybut | ID |
Tak |
isUnattributedAd |
Wskazuje, czy dane w tym wierszu nie można przypisać do konkretnej reklamy. Na przykład reklama o nieobsługiwanym formacie lub z nieprawidłowym adresem 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ępny w przypadku niektórych wyszukiwarek. | atrybut | String |
Tak |
adHeadline3 |
Nagłówek reklamy 3; niedostępny w przypadku niektórych wyszukiwarek. | 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 adres URL reklamy. | atrybut | String |
Tak |
adLandingPage |
strona docelowa reklamy; Zobacz artykuł 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 |
Hasło promocyjne reklamy. Krótki komunikat promocyjny w reklamie produktu. | atrybut | String |
Tak |
adLabels |
Nazwy etykiet bezpośrednio przypisanych do tej reklamy; nie uwzględnia etykiet odziedziczonych. | atrybut | String list |
Tak |
adPathField1 |
Pole ścieżki reklamy 1. Pola Ścieżka 1 i Ścieżka 2 są łączone z polem adDisplayUrl, tworząc adres URL, który jest wyświetlany w reklamie. | atrybut | String |
Tak |
adPathField2 |
Pole ścieżki reklamy 2. Pola ścieżki 1 i 2 są łączone z polem adDisplayUrl, tworząc adres URL, który wyświetla się 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 Campaign Manager. | wskaźnik | Integer |
Tak |
dfaRevenue |
Łączne przychody wygenerowane przez transakcje w usłudze Campaign Manager. | wskaźnik | Money |
Tak |
dfaTransactions |
Łączna liczba transakcji w Campaign Manager. | 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 kampanii Campaign Manager w różnych środowiskach. | wskaźnik | Number |
Tak |
dfaRevenueCrossEnv |
Łączne przychody wygenerowane 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ń 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 wypłacony kontom 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, które reklamodawca skonfigurował do raportowania w kolumnie Konwersje w Google Ads. Po utworzeniu działania powodującego konwersję w Google Ads reklamodawca może określić, czy ma uwzględniać te konwersje w kolumnie raportowania Konwersje. | wskaźnik | Number |
Tak |
adWordsConversionValue |
Łączna wartość konwersji Google Ads. | wskaźnik | Number |
Tak |
adWordsViewThroughConversions |
Łączna liczba konwersji po obejrzeniu w Google Ads. | wskaźnik | Integer |
Tak |
visits |
Łączna liczba wizyt w DS. | wskaźnik | Integer |
Tak |
date |
dzieli raport według dni – każdy wiersz i jego dane zbiorcze są dzielone na kilka wierszy, po jednym na każdy dzień; Ta kolumna zwraca datę każdego wiersza. | podziel na segmenty | Date |
Tak |
monthStart |
Dzieli raport według miesięcy. Każdy wiersz i poszczególne dane zbiorcze są dzielone na kilka wierszy, po jednym na każdy miesiąc. Ta kolumna zwraca pierwszy dzień miesiąca w każdym wierszu. | podziel na segmenty | Date |
Tak |
monthEnd |
Dzieli raport według miesięcy. Każdy wiersz i poszczególne dane zbiorcze są dzielone na kilka wierszy, po jednym na każdy miesiąc. Ta kolumna zwraca ostatni dzień miesiąca w każdym wierszu. | podziel na segmenty | Date |
Tak |
quarterStart |
Dzieli raport według kwartałów. Każdy wiersz i poszczególne dane zbiorcze są dzielone na kilka wierszy, po jednym na każdy kwartał. Ta kolumna zwraca pierwszy dzień kwartału w każdym wierszu. | podziel na segmenty | Date |
Tak |
quarterEnd |
Dzieli raport według kwartałów. Każdy wiersz i poszczególne dane zbiorcze są dzielone na kilka wierszy, po jednym na każdy kwartał. Ta kolumna zwraca ostatni dzień kwartału w każdym wierszu. | podziel na segmenty | Date |
Tak |
weekStart |
Dzieli raport na segmenty według tygodni (od niedzieli do soboty); każdy wiersz i jego dane agregacyjne są dzielone na kilka wierszy, po jednym na każdy tydzień. Ta kolumna zwraca pierwszy dzień (niedzielę) każdego wiersza. | podziel na segmenty | Date |
Tak |
weekEnd |
Dzieli raport na segmenty według tygodni (od niedzieli do soboty); każdy wiersz i jego dane agregacyjne są dzielone na kilka wierszy, po jednym na każdy tydzień. Ta kolumna zwraca ostatni dzień (sobota) każdego wiersza. | podziel na segmenty | Date |
Tak |
yearStart |
Dzieli raport według lat. Każdy wiersz i powiązane z nim dane zbiorcze są dzielone na kilka wierszy, po jednym na każdy rok. Ta kolumna zwraca pierwszy dzień roku w każdym wierszu. | podziel na segmenty | Date |
Tak |
yearEnd |
Dzieli raport według lat. Każdy wiersz i powiązane z nim dane zbiorcze są dzielone 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 |
Raport jest dzielony według urządzenia. Każdy wiersz i odpowiednie dane zbiorcze są dzielone na kilka wierszy, maksymalnie po jednym na każdy segment urządzenia. Ta kolumna zwraca segment urządzenia w każdym wierszu. | podziel na segmenty | Device segment |
Tak |
floodlightGroup |
Raport dzieli się na segmenty według grup Floodlight. Każdy wiersz i zbiorcze dane są dzielone na wiele wierszy, maksymalnie po jednym dla każdej grupy Floodlight. Ta kolumna zwraca nazwę grupy Floodlight w każdym wierszu. Pamiętaj, że niektóre dane, np. kliknięcia i wizyty, nie mają wartości podzielonych na segmenty Floodlight. | podziel na segmenty | String |
Tak |
floodlightGroupId |
Raport dzieli się na segmenty według grup Floodlight. Każdy wiersz i zbiorcze dane są dzielone na wiele wierszy, maksymalnie po jednym dla każdej grupy Floodlight. Ta kolumna zwraca identyfikator grupy DS Floodlight każdego wiersza. Pamiętaj, że niektóre dane, np. kliknięcia i wizyty, nie mają wartości podzielonych na segmenty Floodlight. | podziel na segmenty | ID |
Tak |
floodlightGroupTag |
Raport dzieli się na segmenty według grup Floodlight. Każdy wiersz i zbiorcze dane są dzielone na wiele wierszy, maksymalnie po jednym dla każdej grupy Floodlight. Ta kolumna zwraca tag grupy Floodlight w każdym wierszu. Pamiętaj, że niektóre dane, np. kliknięcia i wizyty, nie mają wartości podzielonych na segmenty Floodlight. | podziel na segmenty | String |
Tak |
floodlightActivity |
Raport dzieli się na segmenty według aktywności Floodlight. Każdy wiersz i zbiorcze dane w nim są dzielone na kilka 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, np. kliknięcia i wizyty, nie mają wartości podzielonych na segmenty Floodlight. | podziel na segmenty | String |
Tak |
floodlightActivityId |
Raport dzieli się na segmenty według aktywności Floodlight. Każdy wiersz i zbiorcze dane w nim są dzielone na kilka wierszy, maksymalnie po jednym dla każdej aktywności Floodlight. Ta kolumna zwraca identyfikator aktywności Floodlight DS każdego wiersza. Pamiętaj, że niektóre dane, np. kliknięcia i wizyty, nie mają wartości podzielonych na segmenty Floodlight. | podziel na segmenty | ID |
Tak |
floodlightActivityTag |
Raport dzieli się na segmenty według aktywności Floodlight. Każdy wiersz i zbiorcze dane w nim są dzielone na kilka 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, np. kliknięcia i wizyty, nie mają wartości podzielonych na segmenty Floodlight. | podziel na segmenty | String |
Tak |