Dane dotyczące skuteczności i atrybuty konfiguracji grup produktów. Raporty dotyczące grup produktów różnią się od raportów słów kluczowych pod kilkoma względami: Dowiedz się więcej.
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": "productGroup".
{
...
"reportType": "productGroup",
"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 grupy produktów. To zawsze Active. |
atrybut | Status |
Tak |
engineStatus |
Dodatkowy stan grupy produktów na zewnętrznym koncie wyszukiwarki. Możliwe stany (w zależności od typu konta zewnętrznego) to review, campaign paused itd. |
atrybut | String |
Tak |
creationTimestamp |
Sygnatura czasowa utworzenia grupy produktów podana w formacie ISO 8601. | atrybut | Timestamp |
Tak |
lastModifiedTimestamp |
Sygnatura czasowa ostatniej modyfikacji grupy produktów 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 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 |
productGroupId |
Identyfikator grupy produktów w DS. DS generuje te identyfikatory, które mogą się zmienić, mimo że powstałe w ten sposób drzewo grup produktów nie uległo zmianie. Więcej informacji | atrybut | ID |
Tak |
productGroup |
Kryteria użyte do zdefiniowania grupy produktów, np. AND(CATEGORY="Elektronika",BRAND = "przykład"). | atrybut | String |
Nie |
productGroupPartitionType |
Typ podziału grupy produktów: Subdivided, Excluded lub Biddable. |
atrybut | Product group partition type |
Tak |
productGroupLandingPage |
Strona docelowa grupy produktów. Zobacz Adresy URL stron docelowych i serwera kliknięć. | atrybut | String |
Tak |
productGroupClickserverUrl |
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 |
productGroupMaxCpc |
Zwraca maksymalny CPC ustawiony dla danej grupy produktów (jeśli istnieje). Jeśli maksymalny CPC nie został ustawiony dla danej grupy produktów, to pole jest puste, a grupa produktów dziedziczy jego ustawienie z grupy reklam. | atrybut | Money |
Tak |
effectiveProductGroupMaxCpc |
Maksymalny CPC (maksymalny koszt kliknięcia), który obowiązuje dla tej grupy produktów. Będzie to ta sama wartość co maksymalny CPC grupy reklam lub, jeśli cel produktowy zastępuje ustawienie grupy reklam, własny maks. CPC celu produktowego. | atrybut | Money |
Tak |
productGroupMaxBid |
Jeśli tą grupą produktów zarządza strategia ustalania stawek DS, strategia ta nigdy nie podniesie stawek powyżej tego limitu. Zobacz Stosowanie strategii ustalania stawek do grupy produktów. | atrybut | Money |
Tak |
productGroupMinBid |
Jeśli tę grupę produktów zarządza strategia ustalania stawek DS, nigdy nie obniża ona stawek poniżej tego limitu. Zobacz Stosowanie strategii ustalania stawek do grupy produktów. | 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 danej grupy produktów. | 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 |