Dane o skuteczności i atrybuty konfiguracji celów produktowych. Kampanie PLA używały celów produktowych do określania, które produkty na koncie Google Merchant Center mają wyzwalać wyświetlanie reklam z listą produktów (reklam produktowych) w powiązanych wyszukiwaniach w Google. Cele produktowe i kampanie PLA zostały zastąpione kampaniami produktowymi Google Ads. W DS nadal możesz prosić o raporty z danymi historycznymi przypisanymi do kampanii PLA przed wprowadzeniem kampanii produktowych.
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": "productTarget".
{
...
"reportType": "productTarget",
"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 celu produktowego: Active, Paused lub Removed. Pamiętaj, że kampanie, grupy reklam, cele produktowe i reklamy mają własny stan. Sprawdź stan. |
atrybut | Status |
Tak |
engineStatus |
Dodatkowy stan celu produktowego 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 celu produktowego w formacie ISO 8601. | atrybut | Timestamp |
Tak |
lastModifiedTimestamp |
Sygnatura czasowa ostatniej modyfikacji celu produktowego 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 |
productTargetId |
Identyfikator celu produktowego DS. | atrybut | ID |
Tak |
productTargetFilter |
Filtruje produkty na koncie Google Merchant Center z tym celem produktowym. Możesz określić kryteria dopasowania za pomocą takich atrybutów jak identyfikatory produktów, marka itp. | atrybut | String |
Nie |
productTargetEngineId |
Identyfikator celu produktowego na zewnętrznym koncie wyszukiwarki. | atrybut | ID |
Tak |
productTargetLandingPage |
Wartość wskazująca końcowy adres URL, który użytkownik odwiedził po kliknięciu reklamy produktowej. Zobacz Strony docelowe reklam produktowych. | atrybut | String |
Tak |
productTargetClickserverUrl |
Adres URL, którego DS używa do śledzenia aktywności. Użytkownik, który kliknie reklamę produktową, najpierw odwiedza adres URL serwera kliknięć, a następnie zostaje przekierowany na ostateczną stronę docelową. Zobacz Strony docelowe reklam produktowych. | atrybut | String |
Tak |
productTargetLabels |
Nazwy etykiet bezpośrednio przypisanych do danego celu produktowego; dziedziczone etykiety nie są uwzględniane. | atrybut | String list |
Tak |
productTargetMaxCpc |
Zastępuje maksymalny CPC grupy reklam i określa maksymalną kwotę, jaką chcesz płacić, gdy ktoś kliknie reklamę produktu związaną z danym celem produktowym. Jeśli to pole jest puste, cel produktowy użyje maksymalnego CPC grupy reklam. | atrybut | Money |
Tak |
effectiveProductTargetMaxCpc |
Maksymalny CPC (maksymalny koszt kliknięcia) obowiązujący dla danego celu produktowego. 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 |
productTargetMaxBid |
Jeśli ten cel produktowy jest zarządzany przez strategię ustalania stawek DS, strategia ta nigdy nie podniesie stawek powyżej tego limitu. Przeczytaj artykuł Stosowanie strategii ustalania stawek do celów produktowych. | atrybut | Money |
Tak |
productTargetMinBid |
Jeśli ten cel produktowy jest zarządzany przez strategię ustalania stawek DS, nigdy nie obniża ona stawek poniżej tego limitu. Przeczytaj artykuł Stosowanie strategii ustalania stawek do celów produktowych. | 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 danego celu produktowego. | 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 |