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.
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ą 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 |