Dane o skuteczności i atrybuty konfiguracji słów kluczowych.
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": "keyword".
{
...
"reportType": "keyword",
"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 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 |
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 |
keywordId |
Identyfikator słowa kluczowego DS. Wartość 0 oznacza, że słowo kluczowe jest nieprzypisane. | 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 maks. CPC grupy reklam i określa maksymalną kwotę, jaką chcesz płacić, gdy ktoś kliknie reklamę związaną z tym słowem kluczowym. Jeśli to pole będzie puste, słowo kluczowe będzie korzystać z maks. CPC grupy reklam. | atrybut | Money |
Tak |
effectiveKeywordMaxCpc |
Maksymalny CPC (maksymalny koszt kliknięcia) obowiązujący dla danego słowa kluczowego. Będzie to ta sama wartość co maksymalny CPC grupy reklam lub, jeśli słowo kluczowe zastępuje ustawienie grupy reklam, własny maks. CPC słowa kluczowego. | atrybut | Money |
Tak |
keywordLandingPage |
Końcowy adres URL strony, na którą wejdzie użytkownik po kliknięciu Twojej reklamy. Zobacz Adresy URL stron docelowych i serwera kliknięć. | atrybut | String |
Tak |
keywordClickserverUrl |
Adres URL, którego DS używa do śledzenia aktywności. Użytkownik, który kliknie reklamę, najpierw odwiedza adres URL serwera kliknięć, a następnie zostaje przekierowany na ostateczną stronę docelową. Zobacz Adresy URL stron docelowych i serwera kliknięć. | atrybut | String |
Tak |
isDisplayKeyword |
Wskazuje, czy jest to zastępcze słowo kluczowe, które jest używane do raportowania danych o sieci reklamowej i miejscach docelowych. | atrybut | Boolean |
Tak |
keywordMaxBid |
Jeśli to słowo kluczowe jest zarządzane przez strategię ustalania stawek DS, strategia ta nigdy nie podniesie stawek powyżej tego limitu. Zobacz Stosowanie strategii ustalania stawek do słów kluczowych. | atrybut | Money |
Tak |
keywordMinBid |
Jeśli to słowo kluczowe jest zarządzane przez strategię ustalania stawek DS, nigdy nie będzie ona obniżać stawek poniżej tego limitu. Zobacz Stosowanie strategii ustalania stawek do słów kluczowych. | atrybut | Money |
Tak |
keywordUrlParams |
Do strony docelowej dodano dodatkowe parametry adresu URL. Patrz 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; dziedziczone etykiety nie są uwzględniane. | atrybut | String list |
Tak |
qualityScoreCurrent |
Dotyczy tylko Google Ads i Bing Ads. Najnowsza wartość wyniku jakości (WJ) wyszukiwarki dla 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 górnych pozycjach powyżej wyników wyszukiwania. Pamiętaj, że ta kolumna zawsze zawiera wartość CPC, która jest obecnie potrzebna, niezależnie od zakresu czasowego raportu. | atrybut | Money |
Tak |
effectiveBidStrategyId |
Identyfikator DS strategii ustalania stawek przypisanej do tego elementu lub odziedziczony przez ten element. | atrybut | ID |
Tak |
effectiveBidStrategy |
Nazwa strategii ustalania stawek przypisanej do tego elementu lub odziedziczona przez ten element. | atrybut | String |
Tak |
bidStrategyInherited |
Wskazuje, czy strategia ustalania stawek tego elementu jest dziedziczona. | atrybut | Boolean |
Tak |
effectiveLabels |
Nazwy wszystkich etykiet odziedziczonych lub przypisanych bezpośrednio 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 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 |
qualityScoreAvg |
Dotyczy tylko Google Ads i Bing Ads. Średnia ważona według wyświetleń wyniku jakości wyszukiwarki dla wszystkich dni i słów kluczowych objętych raportem. | wskaźnik | Number |
Tak |
topOfPageBidAvg |
Dotyczy tylko Google Ads. Wyświetla przybliżoną średnią stawkę CPC, która była potrzebna, by w okresie objętym raportem Twoje reklamy regularnie wyświetlały się na górnych pozycjach powyżej wyników wyszukiwania. | wskaźnik | Money |
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 |
ad |
segmentowanie raportu według reklam; każdy wiersz i jego dane zbiorcze są dzielone na wiele wierszy, po maksymalnie 1 na każdą reklamę. Ta kolumna zawiera nazwę reklamy z każdego wiersza. | podziel na segmenty | String |
Tak |
adId |
segmentowanie raportu według reklam; każdy wiersz i jego dane zbiorcze są dzielone na wiele wierszy, po maksymalnie 1 na każdą reklamę. Ta kolumna zwraca identyfikator DS reklamy w każdym wierszu. | podziel na segmenty | ID |
Tak |
isUnattributedAd |
segmentowanie raportu według reklam; każdy wiersz i jego dane zbiorcze są dzielone na wiele wierszy, po maksymalnie 1 na każdą reklamę. Ta kolumna wskazuje, czy dane w tym wierszu są niepowiązane z konkretną reklamą. | podziel na segmenty | Boolean |
Tak |
adHeadline |
segmentowanie raportu według reklam; każdy wiersz i jego dane zbiorcze są dzielone na wiele wierszy, po maksymalnie 1 na każdą reklamę. Ta kolumna zwraca nagłówek reklamy z każdego wiersza. | podziel na segmenty | String |
Tak |
adHeadline2 |
segmentowanie raportu według reklam; każdy wiersz i jego dane zbiorcze są dzielone na wiele wierszy, po maksymalnie 1 na każdą reklamę. Ta kolumna zwraca nagłówek 2 reklamy z każdego wiersza. Niedostępne w przypadku niektórych wyszukiwarek. | podziel na segmenty | String |
Tak |
adHeadline3 |
segmentowanie raportu według reklam; każdy wiersz i jego dane zbiorcze są dzielone na wiele wierszy, po maksymalnie 1 na każdą reklamę. Ta kolumna zwraca nagłówek 3 reklamy z każdego wiersza. Niedostępne w przypadku niektórych wyszukiwarek. | podziel na segmenty | String |
Tak |
adDescription1 |
segmentowanie raportu według reklam; każdy wiersz i jego dane zbiorcze są dzielone na wiele wierszy, po maksymalnie 1 na każdą reklamę. Ta kolumna zwraca linię tekstu 1 reklamy z każdego wiersza. | podziel na segmenty | String |
Tak |
adDescription2 |
segmentowanie raportu według reklam; każdy wiersz i jego dane zbiorcze są dzielone na wiele wierszy, po maksymalnie 1 na każdą reklamę. Ta kolumna zwraca drugą linię tekstu reklamy z każdego wiersza. | podziel na segmenty | String |
Tak |
adDisplayUrl |
segmentowanie raportu według reklam; każdy wiersz i jego dane zbiorcze są dzielone na wiele wierszy, po maksymalnie 1 na każdą reklamę. Ta kolumna zwraca wyświetlany URL reklamy z każdego wiersza. | podziel na segmenty | String |
Tak |
adLandingPage |
segmentowanie raportu według reklam; każdy wiersz i jego dane zbiorcze są dzielone na wiele wierszy, po maksymalnie 1 na każdą reklamę. W tej kolumnie wyświetlana jest strona docelowa reklamy z każdego wiersza. | podziel na segmenty | String |
Tak |
adType |
segmentowanie raportu według reklam; każdy wiersz i jego dane zbiorcze są dzielone na wiele wierszy, po maksymalnie 1 na każdą reklamę. Ta kolumna zwraca typ reklamy z każdego wiersza: Text lub Product. |
podziel na segmenty | Ad type |
Tak |
adPromotionLine |
segmentowanie raportu według reklam; każdy wiersz i jego dane zbiorcze są dzielone na wiele wierszy, po maksymalnie 1 na każdą reklamę. Ta kolumna zwraca wiersz promocyjny reklamy produktu z każdego wiersza. | podziel na segmenty | String |
Tak |