Dane do raportowania dla reklamodawców, w tym:
- Dane o skuteczności na wszystkich kontach wyszukiwarek i kampaniach reklamodawcy.
- Atrybuty konfiguracji reklamodawcy.
Poproś o wyciąg
Prześlij zwykły strumień żądań Reports.request() lub Reports.generate(), ale określ "reportType": "advertiser".
{
...
"reportType": "advertiser",
"columns": [
{
"columnName":string ,
"headerText":string ,
"startDate":string ,
"endDate":string
}
],
"filters": [
{
"column": {
"columnName":string ,
},
...
},
...
],
...
}
W przypadku każdej kolumny, którą chcesz zwrócić lub odfiltrować w raporcie, określ columnName wymieniony w tabeli poniżej.
Opcjonalnie możesz też podać parametry headerText, startDate i endDate.
Pamiętaj, że niektórych kolumn nie można filtrować. Informacje o możliwości filtrowania znajdziesz w tabeli poniżej.
columnName | Opis | Zachowanie | Typ | Można filtrować |
|---|---|---|---|---|
status |
stan reklamodawcy: Active, Paused lub Removed; |
atrybut | Status |
Tak |
creationTimestamp |
Znak czasu utworzenia reklamodawcy w formacie ISO 8601. | atrybut | Timestamp |
Tak |
lastModifiedTimestamp |
Znak czasu ostatniej modyfikacji przez reklamodawcę 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 w DS. | atrybut | ID |
Tak |
dfaAdvertiserId |
Identyfikator reklamodawcy w usłudze Campaign Manager powiązany z tym reklamodawcą w usłudze Data Studio. | atrybut | ID |
Tak |
dfaNetworkId |
Identyfikator sieci Campaign Manager powiązanej z tym reklamodawcą DS. | atrybut | ID |
Tak |
dfaNetworkTimeZone |
Strefa czasowa sieci Campaign Manager powiązanej z tym reklamodawcą DS w formacie bazy danych stref czasowych IANA, np. America/New_York. |
atrybut | String |
Tak |
advertiserCurrencyCode |
Kod waluty reklamodawcy w formacie ISO 4217. | atrybut | String |
Tak |
googleAnalyticsTimeZone |
Strefa czasowa widoku Google Analytics połączonego z tym reklamodawcą w Display & Video 360. Używa formatu bazy danych stref czasowych IANA, np. America/New_York. |
atrybut | String |
Tak |
dfaActions |
Łączna liczba działań w Campaign Manager. | wskaźnik | Integer |
Tak |
dfaRevenue |
Łączne przychody wygenerowane przez transakcje w usłudze Campaign Manager. | wskaźnik | Money |
Tak |
dfaTransactions |
Łączna liczba transakcji w Campaign Manager. | 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 kampanii Campaign Manager w różnych środowiskach. | wskaźnik | Number |
Tak |
dfaRevenueCrossEnv |
Łączne przychody wygenerowane 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ń 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 wypłacony kontom 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, które reklamodawca skonfigurował do raportowania w kolumnie Konwersje w Google Ads. Po utworzeniu działania powodującego konwersję w Google Ads reklamodawca może wybrać, czy ma uwzględniać te konwersje w kolumnie „Konwersje” w raportach. | wskaźnik | Number |
Tak |
adWordsConversionValue |
Łączna wartość konwersji Google Ads. | wskaźnik | Number |
Tak |
adWordsViewThroughConversions |
Łączna liczba konwersji po obejrzeniu w Google Ads. | wskaźnik | Integer |
Tak |
visits |
Łączna liczba wizyt w DS. | wskaźnik | Integer |
Tak |
searchImpressionShare |
Dotyczy tylko Google Ads i Bing Ads. Iloraz liczby otrzymanych wyświetleń w sieci wyszukiwania i prognozowanej liczby możliwych wyświetleń. Zwracany jako liczba z zakresu 0,1–1 lub, jeśli udział jest mniejszy niż 0,1, jako ciąg znaków < 10%. |
wskaźnik | Impression share |
Tak |
searchBudgetLostImpressionShare |
Dotyczy tylko Google Ads i Bing Ads. Odsetek czasu, przez jaki reklamy nie wyświetlały się w sieci wyszukiwania z powodu niewystarczającego budżetu. Zwracany jako liczba z zakresu 0–0,9 lub, jeśli udział jest większy niż 0,9, jako ciąg znaków > 90%. |
wskaźnik | Impression share |
Tak |
searchRankLostImpressionShare |
Dotyczy tylko Google Ads i Bing Ads. Odsetek czasu, przez jaki reklamy nie wyświetlały się w sieci wyszukiwania z powodu niskiego rankingu reklamy. Zwracana jako liczba z zakresu 0–0,9 lub, jeśli udział jest większy niż 0,9, jako ciąg znaków > 90%. |
wskaźnik | Impression share |
Tak |
displayImpressionShare |
Tylko w Google Ads. Liczba otrzymanych wyświetleń w sieci reklamowej podzielona przez prognozowaną liczbę możliwych wyświetleń. Zwracany jako liczba z zakresu 0,1–1 lub, jeśli udział jest mniejszy niż 0,1, jako ciąg znaków < 10%. |
wskaźnik | Impression share |
Tak |
displayBudgetLostImpressionShare |
Tylko w Google Ads. Odsetek czasu, przez jaki reklamy nie wyświetlały się w sieci reklamowej z powodu niewystarczającego budżetu. Zwracany jako liczba z zakresu 0–0,9 lub, jeśli udział jest większy niż 0,9, jako ciąg znaków > 90%. |
wskaźnik | Impression share |
Tak |
displayRankLostImpressionShare |
Tylko w Google Ads. Odsetek czasu, przez jaki reklamy nie wyświetlały się w sieci reklamowej z powodu niskiego rankingu reklamy. Zwracana jako liczba z zakresu 0–0,9 lub, jeśli udział jest większy niż 0,9, jako ciąg znaków > 90%. |
wskaźnik | Impression share |
Tak |
qualityScoreAvg |
Dotyczy tylko Google Ads i Bing Ads. Średnia ważona wyświetleń wyniku jakości (QS) w przypadku wszystkich dni i słów kluczowych objętych zakresem raportu. | wskaźnik | Number |
Tak |
topOfPageBidAvg |
Tylko w Google Ads. W przybliżeniu odpowiada średniej stawce CPC, jaka jest wymagana w okresie objętym raportem, aby reklamy regularnie pojawiały się na najwyższych pozycjach nad wynikami wyszukiwania. | wskaźnik | Money |
Tak |
absoluteTopImpressionPercentage |
Odsetek wyświetleń reklamy jako pierwszej nad bezpłatnymi wynikami wyszukiwania. | wskaźnik | Impression share |
Tak |
searchAbsoluteTopImpressionShare |
Iloraz liczby wyświetleń na najwyższej pozycji (pierwsza reklama nad bezpłatnymi wynikami wyszukiwania) i szacowanej liczby możliwych wyświetleń na tej pozycji. | wskaźnik | Impression share |
Tak |
topImpressionPercentage |
Odsetek wyświetleń reklamy w dowolnym miejscu nad bezpłatnymi wynikami wyszukiwania. | wskaźnik | Impression share |
Tak |
searchTopImpressionShare |
Wyświetlenia reklamy u góry strony (w dowolnym miejscu powyżej bezpłatnych wyników wyszukiwania) w porównaniu z szacowaną liczbą możliwych wyświetleń u góry strony. | wskaźnik | Impression share |
Tak |
searchBudgetLostAbsoluteTopImpressionShare |
Podaje oszacowanie, jak często reklama nie była pierwszą reklamą na najwyższej pozycji nad bezpłatnymi wynikami wyszukiwania z powodu niskiego budżetu. | wskaźnik | Impression share |
Tak |
searchBudgetLostTopImpressionShare |
Podaje, jak często reklama nie wyświetliła się w dowolnym miejscu nad bezpłatnymi wynikami wyszukiwania z powodu niskiego budżetu. | wskaźnik | Impression share |
Tak |
searchRankLostAbsoluteTopImpressionShare |
Oszacowanie, jak często reklama nie wyświetliła się na pierwszej pozycji nad bezpłatnymi wynikami wyszukiwania z powodu niskiego rankingu reklamy. | wskaźnik | Impression share |
Tak |
searchRankLostTopImpressionShare |
Oszacowanie, jak często reklama nie wyświetlała się w dowolnym miejscu nad bezpłatnymi wynikami wyszukiwania z powodu niskiego rankingu reklamy. | wskaźnik | Impression share |
Tak |
date |
dzieli raport według dni – każdy wiersz i jego dane zbiorcze są dzielone na kilka wierszy, po jednym na każdy dzień; Ta kolumna zwraca datę każdego wiersza. | podziel na segmenty | Date |
Tak |
monthStart |
Dzieli raport według miesięcy. Każdy wiersz i poszczególne dane zbiorcze są dzielone na kilka wierszy, po jednym na każdy miesiąc. Ta kolumna zwraca pierwszy dzień miesiąca w każdym wierszu. | podziel na segmenty | Date |
Tak |
monthEnd |
Dzieli raport według miesięcy. Każdy wiersz i poszczególne dane zbiorcze są dzielone na kilka wierszy, po jednym na każdy miesiąc. Ta kolumna zwraca ostatni dzień miesiąca w każdym wierszu. | podziel na segmenty | Date |
Tak |
quarterStart |
Dzieli raport według kwartałów. Każdy wiersz i poszczególne dane zbiorcze są dzielone na kilka wierszy, po jednym na każdy kwartał. Ta kolumna zwraca pierwszy dzień kwartału w każdym wierszu. | podziel na segmenty | Date |
Tak |
quarterEnd |
Dzieli raport według kwartałów. Każdy wiersz i poszczególne dane zbiorcze są dzielone na kilka wierszy, po jednym na każdy kwartał. Ta kolumna zwraca ostatni dzień kwartału w każdym wierszu. | podziel na segmenty | Date |
Tak |
weekStart |
Dzieli raport na segmenty według tygodni (od niedzieli do soboty); każdy wiersz i jego dane agregacyjne są dzielone na kilka wierszy, po jednym na każdy tydzień. Ta kolumna zwraca pierwszy dzień (niedzielę) każdego wiersza. | podziel na segmenty | Date |
Tak |
weekEnd |
Dzieli raport na segmenty według tygodni (od niedzieli do soboty); każdy wiersz i jego dane agregacyjne są dzielone na kilka wierszy, po jednym na każdy tydzień. Ta kolumna zwraca ostatni dzień (sobota) każdego wiersza. | podziel na segmenty | Date |
Tak |
yearStart |
Dzieli raport według lat. Każdy wiersz i powiązane z nim dane zbiorcze są dzielone na kilka wierszy, po jednym na każdy rok. Ta kolumna zwraca pierwszy dzień roku w każdym wierszu. | podziel na segmenty | Date |
Tak |
yearEnd |
Dzieli raport według lat. Każdy wiersz i powiązane z nim dane zbiorcze są dzielone 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 |
Raport jest dzielony według urządzenia. Każdy wiersz i odpowiednie dane zbiorcze są dzielone na kilka wierszy, maksymalnie po jednym na każdy segment urządzenia. Ta kolumna zwraca segment urządzenia w każdym wierszu. | podziel na segmenty | Device segment |
Tak |
floodlightGroup |
Raport dzieli się na segmenty według grup Floodlight. Każdy wiersz i zbiorcze dane są dzielone na kilka wierszy, maksymalnie po jednym dla każdej grupy Floodlight. Ta kolumna zwraca nazwę grupy Floodlight w każdym wierszu. Pamiętaj, że niektóre dane, np. kliknięcia i wizyty, nie mają wartości podzielonych na segmenty Floodlight. | podziel na segmenty | String |
Tak |
floodlightGroupId |
Raport dzieli się na segmenty według grup Floodlight. Każdy wiersz i zbiorcze dane są dzielone na wiele wierszy, maksymalnie po jednym dla każdej grupy Floodlight. Ta kolumna zwraca identyfikator grupy DS Floodlight każdego wiersza. Pamiętaj, że niektóre dane, np. kliknięcia i wizyty, nie mają wartości podzielonych na segmenty Floodlight. | podziel na segmenty | ID |
Tak |
floodlightGroupTag |
Raport dzieli się na segmenty według grup Floodlight. Każdy wiersz i zbiorcze dane są dzielone na wiele wierszy, maksymalnie po jednym dla każdej grupy Floodlight. Ta kolumna zwraca tag grupy Floodlight w każdym wierszu. Pamiętaj, że niektóre dane, np. kliknięcia i wizyty, nie mają wartości podzielonych na segmenty Floodlight. | podziel na segmenty | String |
Tak |
floodlightActivity |
Raport dzieli się na segmenty według aktywności Floodlight. Każdy wiersz i zbiorcze dane w nim są dzielone na kilka 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, np. kliknięcia i wizyty, nie mają wartości podzielonych na segmenty Floodlight. | podziel na segmenty | String |
Tak |
floodlightActivityId |
Raport dzieli się na segmenty według aktywności Floodlight. Każdy wiersz i zbiorcze dane są dzielone na kilka wierszy, maksymalnie po jednym dla każdej aktywności Floodlight. Ta kolumna zwraca identyfikator aktywności DS Floodlight w każdym wierszu. Pamiętaj, że niektóre dane, np. kliknięcia i wizyty, nie mają wartości podzielonych na segmenty Floodlight. | podziel na segmenty | ID |
Tak |
floodlightActivityTag |
Raport dzieli się na segmenty według aktywności Floodlight. Każdy wiersz i zbiorcze dane w nim są dzielone na kilka 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, np. kliknięcia i wizyty, nie mają wartości podzielonych na segmenty Floodlight. | podziel na segmenty | String |
Tak |