30 czerwca 2024 r. wycofamy poprzednią wersję Search Ads 360 Reporting API. Pamiętaj, że nie dotyczy to interfejsu Search Ads 360 Conversion API, który nadal będzie obsługiwany. Podczas programowania raportów w nowej wersji Search Ads 360 należy używać nowego interfejsu Search Ads 360 Reporting API.

Od kwietnia 2024 r. po wysłaniu żądania raportu będzie zwracany błąd nieobsługiwanej wersji ApiVersion. Więcej informacji znajdziesz tutaj.

Zdecydowanie zalecamy też przeniesienie wszystkich istniejących implementacji Search Ads 360 do nowego interfejsu API. Więcej informacji znajdziesz w artykułach Wprowadzenie i Przewodnik po migracji do nowego interfejsu Search Ads 360 Reporting API.

Ta strona została przetłumaczona przez Cloud Translation API.

Typ raportu: słowo kluczowe

Dane o skuteczności i atrybuty konfiguracji słów kluczowych

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": "keyword".

{
...
  "reportType": "keyword",
  "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 słowa kluczowego: `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 słowa kluczowego na zewnętrznym koncie wyszukiwarki. Możliwe stany (w zależności od typu konta zewnętrznego) to `criterion rarely served`, `criterion below first page bid`, `criterion low quality score`, `review`, `campaign paused` itp.	atrybut	`String`	Tak
`creationTimestamp`	Sygnatura czasowa utworzenia słowa kluczowego w formacie ISO 8601.	atrybut	`Timestamp`	Tak
`lastModifiedTimestamp`	Sygnatura czasowa ostatniej modyfikacji słowa kluczowego 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
`keywordId`	Identyfikator słowa kluczowego DS. Wartość 0 oznacza, że słowo kluczowe nie jest przypisane.	atrybut	`ID`	Tak
`keywordMatchType`	Typ dopasowania słowa kluczowego: `Broad`, `Exact`, `Phrase` lub `Content`.	atrybut	`Match type`	Tak
`keywordText`	Tekst słowa kluczowego.	atrybut	`String`	Tak
`keywordEngineId`	Identyfikator słowa kluczowego na zewnętrznym koncie wyszukiwarki.	atrybut	`ID`	Tak
`keywordMaxCpc`	Zastępuje maksymalny CPC grupy reklam i określa maksymalną kwotę, jaką chcesz zapłacić za kliknięcie reklamy dla tego słowa kluczowego. Jeśli to pole będzie puste, słowo kluczowe będzie korzystać z maksymalnego CPC grupy reklam.	atrybut	`Money`	Tak
`effectiveKeywordMaxCpc`	Maksymalny CPC (maksymalny koszt kliknięcia) obowiązujący dla danego słowa kluczowego. Jest to ta sama wartość, co maksymalny CPC grupy reklam, lub – jeśli słowo kluczowe zastępuje ustawienie grupy reklam – maksymalny CPC słowa kluczowego.	atrybut	`Money`	Tak
`keywordLandingPage`	Końcowy adres URL, który odwiedza użytkownik po kliknięciu reklamy. Zobacz Adresy URL strony docelowej i serwera kliknięć.	atrybut	`String`	Tak
`keywordClickserverUrl`	Adres URL używany przez DS do śledzenia aktywności. Użytkownik, który kliknie reklamę, najpierw odwiedzi adres URL serwera kliknięć, a potem zostanie przekierowany na ostateczną stronę docelową. Zobacz Adresy URL strony docelowej i serwera kliknięć.	atrybut	`String`	Tak
`isDisplayKeyword`	Wskazuje, czy to zastępcze słowo kluczowe jest używane w raportach dotyczących miejsc docelowych i reklam displayowych.	atrybut	`Boolean`	Tak
`keywordMaxBid`	Jeśli tym słowem kluczowym zarządza strategia ustalania stawek DS, strategia nigdy nie podnosi stawek powyżej tego limitu. Zobacz Stosowanie strategii ustalania stawek do słów kluczowych.	atrybut	`Money`	Tak
`keywordMinBid`	Jeśli tym słowem kluczowym zarządza strategia ustalania stawek DS, strategia nigdy nie obniża stawek poniżej tego limitu. Zobacz Stosowanie strategii ustalania stawek do słów kluczowych.	atrybut	`Money`	Tak
`keywordUrlParams`	Dodatkowe parametry adresu URL dodane do strony docelowej. Zobacz Dodawanie parametrów adresu URL.	atrybut	`String`	Tak
`bingKeywordParam2`	Parametr 2 słowa kluczowego Bing Ads.	atrybut	`String`	Tak
`bingKeywordParam3`	Parametr 3 słowa kluczowego Bing Ads.	atrybut	`String`	Tak
`keywordLabels`	Nazwy etykiet bezpośrednio przypisanych do tego słowa kluczowego nie są uwzględniane.	atrybut	`String list`	Tak
`qualityScoreCurrent`	Dotyczy tylko Google Ads i Bing Ads. Najnowsza wartość wyniku jakości (QS) wyszukiwarki danego słowa kluczowego. Pamiętaj, że ta kolumna zawsze zawiera najnowszy wynik jakości słowa kluczowego, niezależnie od zakresu czasowego raportu.	atrybut	`Integer`	Tak
`topOfPageBidCurrent`	Dotyczy tylko Google Ads. Wyświetla przybliżoną stawkę CPC potrzebną do regularnego wyświetlania reklamy na najwyższych pozycjach nad wynikami wyszukiwania. Pamiętaj, że ta kolumna zawsze zawiera aktualną stawkę CPC niezależnie od zakresu czasowego raportu.	atrybut	`Money`	Tak
`effectiveBidStrategyId`	Identyfikator strategii ustalania stawek DS przypisany do tego elementu lub odziedziczony przez ten element.	atrybut	`ID`	Tak
`effectiveBidStrategy`	Nazwa strategii ustalania stawek przypisana do tego elementu lub odziedziczona przez ten element.	atrybut	`String`	Tak
`bidStrategyInherited`	Wskazuje, czy strategia ustalania stawek tego podmiotu jest dziedziczona.	atrybut	`Boolean`	Tak
`effectiveLabels`	Nazwy wszystkich etykiet odziedziczonych lub bezpośrednio przypisanych do tego słowa kluczowego.	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
`qualityScoreAvg`	Dotyczy tylko Google Ads i Bing Ads. Średnia ważona na podstawie wyniku jakości (QS) wyszukiwarki z uwzględnieniem wszystkich dni i słów kluczowych w zakresie raportu.	wskaźnik	`Number`	Tak
`topOfPageBidAvg`	Dotyczy tylko Google Ads. Zawiera przybliżoną średnią stawkę CPC, która była potrzebna, by w raportach regularnie wyświetlały się reklamy na najwyższych pozycjach nad wynikami wyszukiwania.	wskaźnik	`Money`	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
`ad`	Podział raportu na segmenty według reklam; każdy wiersz i dane zbiorcze są podzielone na kilka wierszy, po jednym dla każdej reklamy. Ta kolumna zawiera nazwę reklamy w każdym wierszu.	podziel na segmenty	`String`	Tak
`adId`	Podział raportu na segmenty według reklam; każdy wiersz i dane zbiorcze są podzielone na kilka wierszy, po jednym dla każdej reklamy. Ta kolumna zwraca identyfikator DS reklamy w każdym wierszu.	podziel na segmenty	`ID`	Tak
`isUnattributedAd`	Podział raportu na segmenty według reklam; każdy wiersz i dane zbiorcze są podzielone na kilka wierszy, po jednym dla każdej reklamy. Ta kolumna pokazuje, czy dane w tym wierszu nie są przypisane do konkretnej reklamy.	podziel na segmenty	`Boolean`	Tak
`adHeadline`	Podział raportu na segmenty według reklam; każdy wiersz i dane zbiorcze są podzielone na kilka wierszy, po jednym dla każdej reklamy. Ta kolumna zwraca nagłówek reklamy w każdym wierszu.	podziel na segmenty	`String`	Tak
`adHeadline2`	Podział raportu na segmenty według reklam; każdy wiersz i dane zbiorcze są podzielone na kilka wierszy, po jednym dla każdej reklamy. Ta kolumna zwraca nagłówek 2 reklamy w każdym wierszu. Ta funkcja jest niedostępna w niektórych wyszukiwarkach.	podziel na segmenty	`String`	Tak
`adHeadline3`	Podział raportu na segmenty według reklam; każdy wiersz i dane zbiorcze są podzielone na kilka wierszy, po jednym dla każdej reklamy. Ta kolumna zwraca nagłówek 3 reklamy w każdym wierszu. Ta funkcja jest niedostępna w niektórych wyszukiwarkach.	podziel na segmenty	`String`	Tak
`adDescription1`	Podział raportu na segmenty według reklam; każdy wiersz i dane zbiorcze są podzielone na kilka wierszy, po jednym dla każdej reklamy. Ta kolumna zwraca pierwszą linię tekstu reklamy w każdym wierszu.	podziel na segmenty	`String`	Tak
`adDescription2`	Podział raportu na segmenty według reklam; każdy wiersz i dane zbiorcze są podzielone na kilka wierszy, po jednym dla każdej reklamy. Ta kolumna zwraca drugą linię tekstu reklamy w każdym wierszu.	podziel na segmenty	`String`	Tak
`adDisplayUrl`	Podział raportu na segmenty według reklam; każdy wiersz i dane zbiorcze są podzielone na kilka wierszy, po jednym dla każdej reklamy. Ta kolumna zwraca wyświetlany adres URL reklamy w każdym wierszu.	podziel na segmenty	`String`	Tak
`adLandingPage`	Podział raportu na segmenty według reklam; każdy wiersz i dane zbiorcze są podzielone na kilka wierszy, po jednym dla każdej reklamy. Ta kolumna zwraca stronę docelową reklamy w każdym wierszu.	podziel na segmenty	`String`	Tak
`adType`	Podział raportu na segmenty według reklam; każdy wiersz i dane zbiorcze są podzielone na kilka wierszy, po jednym dla każdej reklamy. Ta kolumna zawiera typ reklamy w każdym wierszu: `Text` lub `Product`.	podziel na segmenty	`Ad type`	Tak
`adPromotionLine`	Podział raportu na segmenty według reklam; każdy wiersz i dane zbiorcze są podzielone na kilka wierszy, po jednym dla każdej reklamy. Ta kolumna wyświetla wiersz promocji reklamy produktu w każdym wierszu.	podziel na segmenty	`String`	Tak