Historia zmian interfejsu API podstawowego raportowania Google Analytics

Okresowo aktualizujemy interfejs Core Reporting API w Google Analytics, aby udostępniać nowe funkcje i naprawiać błędy wykryte w poprzednich wersjach. W większości przypadków zmiany te będą przejrzyste dla deweloperów korzystających z interfejsu API. Czasami musimy jednak wprowadzić zmiany, które wymagają od programistów zmodyfikowania istniejących aplikacji.

Ta strona dokumentuje wszystkie zmiany wprowadzone w interfejsie Google Analytics Core Reporting API, które mogą mieć wpływ na Twoją aplikację. Zalecamy, aby deweloperzy interfejsu API okresowo sprawdzali tę listę pod kątem nowych ogłoszeń. Możesz też zasubskrybować zmiany za pomocą kanałów wymienionych w sekcji Subskrybuj poniżej.

Subskrybuj powiązane historię zmian

Obejmuje wszystkie interfejsy API do zbierania danych, konfiguracji i raportowania.

Obejmuje interfejsy Core Reporting API, API do raportowania ścieżek wielokanałowych i interfejs API do raportowania w czasie rzeczywistym.

To jest pierwsza wersja interfejsu User Activity API

  • Interfejs User Activity API umożliwia pobieranie wszystkich danych powiązanych z jednym identyfikatorem klienta lub User-ID w danym zakresie dat. Jego głównym przeznaczeniem jest pomaganie właścicielom usług, którzy chcą zapewnić automatyczny dostęp do danych użytkownika. Więcej informacji znajdziesz w przewodniku po interfejsie User Activity API.

W tej wersji system oparty na zasobach w interfejsie API raportowania Google Analytics 4 jest dostępny dla wszystkich klientów Analytics 360 (Premium).

Ta wersja zwiększa maksymalną liczbę wierszy zwracanych w wynikach interfejsu Analytics Reporting API w wersji 4.

Maksymalna liczba wierszy zwracanych w obiekcie Analytics Reporting API w wersji 4 wzrosła z 10 000 do 100 000.

W tej wersji wprowadziliśmy podgląd systemu limitów zasobów w przypadku interfejsu Google Analytics Reporting API w wersji 4, który umożliwia używanie wyższych progów próbkowania w przypadku klientów Analytics 360 (Premium).

W tej wersji wycofaliśmy funkcję Powiązane produkty i powiązane z nią wymiary oraz dane. Pełną listę definicji znajdziesz w tym artykule. Szczegółowe informacje o usuwaniu danych znajdziesz w Zasadach wycofywania danych:

W tej wersji wycofane są te wymiary i dane:

  • ga:correlationModelId
  • ga:queryProductId
  • ga:queryProductName
  • ga:queryProductVariation
  • ga:relatedProductId
  • ga:relatedProductName
  • ga:relatedProductVariation
  • ga:correlationScore
  • ga:queryProductQuantity
  • ga:relatedProductQuantity

Ta wersja dodaje do interfejsu API nowy wymiar. Pełną listę definicji znajdziesz w przewodniku po wymiarach i danych. W tej wersji usunęliśmy też kilka wycofanych wymiarów i danych. Aby dowiedzieć się więcej o procesie usuwania danych, zapoznaj się z zasadami wycofywania danych dotyczących interfejsów API Google Analytics.

Czas

  • Nowy wymiar ga:dateHourMinute, który łączy ga:date, ga:hour i ga:minute.

Usuwanie danych

W tej wersji usunęliśmy te wycofane wymiary i dane:

  • ga:socialactivities
  • ga:socialactivityaction
  • ga:socialactivitydisplayname
  • ga:socialactivityendorsingurl
  • ga:socialactivitynetworkaction
  • ga:socialactivitypost
  • ga:socialactivitytagssummary
  • ga:socialactivitytimestamp
  • ga:socialactivityuserhandle
  • ga:socialactivityuserphotourl
  • ga:socialactivityuserprofileurl
  • ga:socialinteractionspervisit

Ta wersja aktualizuje istniejące dane i wymiary w interfejsie API. Pełną listę definicji znajdziesz w przewodniku po wymiarach i danych.

Dane o użytkownikach

Zaktualizowaliśmy dane dotyczące użytkowników i aktywnych użytkowników, aby zwiększyć liczbę użytkowników. Możesz zauważyć niewielką zmianę danych. Więcej informacji znajdziesz w sekcji Jak użytkownicy są identyfikowani na podstawie danych o użytkownikach.

Dane użytkowników, których dotyczy aktualizacja:

  • ga:users – łączna liczba użytkowników w wybranym okresie,
  • ga:1dayusers – łączna liczba użytkowników aktywnych w ciągu 1 dnia w wybranym okresie.
  • ga:7dayusers – łączna liczba użytkowników aktywnych w ciągu 7 dni w danym okresie w wybranym okresie,
  • ga:14dayusers – łączna liczba użytkowników aktywnych w ciągu 14 dni w każdym wybranym okresie.
  • ga:30dayusers – łączna liczba użytkowników aktywnych w ciągu 30 dni w danym okresie w wybranym okresie,

Unikalne zdarzenia

Zbliżamy się do końca okresu wycofania usługi ga:uniqueEvents. Po 26 marca 2017 r. zaktualizujemy definicję parametru ga:uniqueEvents, a prywatne dane ga:uniqueEventsTemporary zostaną usunięte z interfejsu API. Więcej informacji znajdziesz w artykule pomocy o niepowtarzalnych zdarzeniach.

Ta wersja dodaje do interfejsu API nowy wymiar, ulepsza komunikaty o błędach i zaczyna wprowadzać zapowiedziane wcześniej zmiany wymiarów i danych AdSense.

Wymiary użytkownika

Komunikaty o błędach

Jeśli wcześniej interfejs API zwracał nieprawidłowy komunikat o błędzie (Unknown dimension(s): lub Unknown metric(s):), gdy żądano danych z warunkami, które nie zostały spełnione, interfejs API zwraca teraz komunikat: Restricted metric(s): ... can only be queried under certain conditions.

Wymiary i dane AdSense

Widoki połączone z usługą AdSense nie będą mogły wysyłać zapytań o wymiary i dane AdSense. Zapytanie o te wymiary i dane z widokami danych połączonymi z kontami innych niż AdSense spowoduje błąd.

Jest to poprawka błędu, która rozwiązuje problem z wymiarami i danymi AdSense, a także informuje o nadchodzącej zmianie tych wymiarów i danych.

Wymiary i dane AdSense

W tej wersji rozwiązaliśmy problem, który zaczął się 7 stycznia 2017 roku. Z tego powodu wysyłanie zapytań o wymiary i dane AdSense powodowało wyświetlenie błędu „Nieznane dane” w widoku danych spoza AdSense.

Nadchodzące zmiany

Od 31 stycznia 2017 r. widoki danych połączone z kontami AdSense nie będą mogły wysyłać zapytań o wymiary i dane AdSense. Zapytanie o te wymiary i dane z widokami danych połączonymi z kontami innych niż AdSense spowoduje błąd.

W tej wersji do interfejsu API dodano następujące nowe dane. Pełną listę definicji znajdziesz w przewodniku po wymiarach i danych.

Obliczone dane

W tej wersji dodaliśmy obsługę obliczonych danych.

  • Dane – ga:calcMetric_ – wartość żądanych danych, gdzie oznacza nazwę obliczoną przez użytkownika. Należy pamiętać, że typem danych ga:calcMetric_ może być FLOAT, INTEGER, CURRENCY, TIME lub PERCENT. Więcej informacji znajdziesz w artykule Obliczone dane.

Ta wersja dodaje do interfejsu API nowe dane. Spowoduje to też wycofanie istniejących danych. Pełną listę definicji znajdziesz w przewodniku po wymiarach i danych.

Śledzenie zdarzeń

Definicja ciągu ga:uniqueEvents zmieni się, by dokładniej odzwierciedlać liczbę unikalnych zdarzeń. Aby wprowadzić tę zmianę, technicznie wycofamy bieżące dane (ga:uniqueEvents) zgodnie z zasadami wycofywania danych. Jeśli chcesz wypróbować nową definicję, możesz skorzystać z danych prywatnych ga:uniqueEventsTemporary, które dokładniej obliczają liczbę unikalnych zdarzeń. wprowadzimy też nowy wskaźnik ga:uniqueDimensionCombinations, który zachowa obecną definicję tagu ga:uniqueEvents. Po upływie odpowiedniego okresu (ok. 6 miesięcy) prywatne dane (ga:uniqueEventsTemporary) zostaną usunięte, a pierwotna wartość ga:uniqueEvents będzie prawidłowo reprezentować liczbę unikalnych zdarzeń. Więcej informacji znajdziesz w dokumentach pomocy dotyczących unikalnych zdarzeń.

Unikalne zdarzenia

  • Dane – ga:uniqueEvents: definicja ga:uniqueEvents wkrótce się zmieni, aby dokładniej odzwierciedlać liczbę unikalnych zdarzeń. Jeśli chcesz zachować obecną definicję, użyj zasady ga:uniqueDimensionCombinations. Więcej informacji znajdziesz w artykule pomocy o niepowtarzalnych zdarzeniach.
  • Dane – ga:uniqueDimensionCombinations – unikalne kombinacje wymiarów zliczają liczbę unikalnych kombinacji wymiar-wartość dla każdego wymiaru w raporcie. Dzięki temu można tworzyć połączone wymiary po zakończeniu przetwarzania, co umożliwia bardziej elastyczne raportowanie bez konieczności aktualizacji implementacji śledzenia lub korzystania z dodatkowych boksów dla niestandardowych wymiarów. Więcej informacji znajdziesz w artykule pomocy o niepowtarzalnych zdarzeniach.

Testowanie przejścia – prywatne

  • Dane – ga:uniqueEventsTemporary – liczba unikalnych zdarzeń. To będzie nowa definicja zasady ga:uniqueEvents. Możesz skorzystać z tych danych, aby zrozumieć nową definicję przed zmianą. Te dane są prywatne i nie pojawią się w wymiarach ani danych.

Ta wersja dodaje do interfejsu API nowe wymiary i dane. Pełną listę definicji znajdziesz w przewodniku po wymiarach i danych.

DoubleClick Bid Manager

  • Wymiar – ga:dbmClickAdvertiser – nazwa reklamodawcy DBM kliknięcia DoubleClick pasującego do sesji Google Analytics (tylko w Analytics 360, wymagana jest integracja z DBM).
  • Wymiar – ga:dbmClickAdvertiserId – identyfikator reklamodawcy DBM kliknięcia DBM pasującego do sesji Google Analytics (tylko Analytics 360, wymaga integracji z DBM).
  • Wymiar – ga:dbmClickCreativeId – identyfikator kreacji DBM kliknięcia DBM pasującego do sesji Google Analytics (tylko Analytics 360, wymaga integracji z DBM).
  • Wymiar – ga:dbmClickExchange – nazwa giełdy w kliknięciu DBM pasująca do sesji Google Analytics (tylko w Analytics 360, wymagana jest integracja z DBM).
  • Wymiar – ga:dbmClickExchangeId – identyfikator giełdy Exchange kliknięcia DBM pasującego do sesji Google Analytics (tylko Analytics 360, wymaga integracji z DBM).
  • Wymiar – ga:dbmClickInsertionOrder – nazwa zamówienia reklamowego DBM kliknięcia DBM pasującego do sesji Google Analytics (tylko Analytics 360, wymaga integracji z DBM).
  • Wymiar – ga:dbmClickInsertionOrderId – identyfikator zamówienia reklamowego DBM kliknięcia DBM pasującego do sesji Google Analytics (tylko w Analytics 360, wymagana jest integracja z DBM).
  • Wymiar – ga:dbmClickLineItem – nazwa elementu zamówienia DBM kliknięcia DBM pasującego do sesji Google Analytics (tylko Analytics 360 wymaga integracji z DBM).
  • Wymiar – ga:dbmClickLineItemId – identyfikator elementu zamówienia DBM kliknięcia DBM pasującego do sesji Google Analytics (tylko Analytics 360, wymaga integracji z DBM).
  • Wymiar – ga:dbmClickSite – nazwa witryny DBM, w której wyświetliła się i kliknęła kreacja DBM pasująca do sesji DBM (dotyczy tylko Analytics 360, wymaga integracji z DBM).
  • Wymiar – ga:dbmClickSiteId – identyfikator witryny DBM, w której wyświetliła się i kliknięta kreacja DBM pasująca do sesji Google Analytics (tylko w Analytics 360, wymagana jest integracja z DBM).
  • Wymiar – ga:dbmLastEventAdvertiser – nazwa reklamodawcy w DBM dla ostatniego zdarzenia DBM (wyświetlenie lub kliknięcie w ramach okresu ważności DBM) powiązanego z sesją Google Analytics (tylko w Analytics 360; wymaga integracji z DBM).
  • Wymiar – ga:dbmLastEventAdvertiserId – identyfikator reklamodawcy DBM ostatniego zdarzenia DBM (wyświetlenie lub kliknięcie w ramach okresu ważności DBM) powiązanego z sesją Google Analytics (tylko w Analytics 360; wymaga integracji z DBM).
  • Wymiar – ga:dbmLastEventCreativeId – identyfikator kreacji DBM ostatniego zdarzenia DBM (wyświetlenie lub kliknięcie w ramach okresu ważności DBM) powiązanego z sesją Google Analytics (tylko w Analytics 360; wymaga integracji z DBM).
  • Wymiar – ga:dbmLastEventExchange – nazwa giełdy w ostatnim zdarzeniu DBM (wyświetlenie lub kliknięcie w okresie ważności DBM) powiązanym z sesją Google Analytics (tylko w Analytics 360; wymaga integracji z DBM).
  • Wymiar – ga:dbmLastEventExchangeId – identyfikator giełdy DBM ostatniego zdarzenia DBM (wyświetlenie lub kliknięcie w ramach okresu ważności DBM) powiązanego z sesją Google Analytics (tylko w Analytics 360; wymaga integracji z DBM).
  • Wymiar – ga:dbmLastEventInsertionOrder – nazwa zamówienia reklamowego DBM ostatniego zdarzenia DBM (wyświetlenie lub kliknięcie w ramach okresu ważności DBM) powiązanego z sesją Google Analytics (tylko w Analytics 360; wymaga integracji z DBM).
  • Wymiar – ga:dbmLastEventInsertionOrderId – identyfikator zamówienia reklamowego DBM ostatniego zdarzenia DBM (wyświetlenie lub kliknięcie w ramach okresu ważności DBM) powiązanego z sesją Google Analytics (tylko w Analytics 360; wymaga integracji z DBM).
  • Wymiar – ga:dbmLastEventLineItem – nazwa elementu zamówienia DBM ostatniego zdarzenia DBM (wyświetlenie lub kliknięcie w ramach okresu ważności DBM) powiązanego z sesją Google Analytics (tylko w Analytics 360; wymaga integracji z DBM).
  • Wymiar – ga:dbmLastEventLineItemId – identyfikator elementu zamówienia DBM ostatniego zdarzenia DBM (wyświetlenie lub kliknięcie w ramach okresu ważności DBM) powiązanego z sesją Google Analytics (tylko w Analytics 360; wymaga integracji z DBM).
  • Wymiar – ga:dbmLastEventSite – nazwa witryny DBM, w której wyświetliła się i kliknęła kreacja DBM (ostatnie kliknięcie lub wyświetlenie w okresie ważności DBM) powiązana z sesją Google Analytics (tylko w Analytics 360, wymaga integracji z DBM).
  • Wymiar – ga:dbmLastEventSiteId – identyfikator witryny DBM, w której wyświetliła się i kliknięto ostatnie zdarzenie DBM (wyświetlenie lub kliknięcie w okresie ważności DBM) powiązanym z sesją Google Analytics (tylko w Analytics 360; wymaga integracji z DBM).
  • Dane – ga:dbmCPA – DBM – przychody z przychodów (tylko Analytics 360, wymaga integracji z DBM).
  • Dane – ga:dbmCPC – eCPC z przychodów do DBM (tylko w Analytics 360, wymagana jest integracja z DBM).
  • Dane – ga:dbmCPM – eCPM z przychodów w DBM (tylko Analytics 360, wymaga integracji z DBM).
  • Dane – ga:dbmCTR – CTR CTR (tylko Analytics 360, wymaga integracji z DBM).
  • Dane – ga:dbmClicks – łączna liczba kliknięć w DBM (tylko Analytics 360, wymaga integracji z DBM).
  • Dane – ga:dbmConversions – całkowita liczba konwersji w DBM (tylko Analytics 360, wymaga integracji z DBM).
  • Dane – ga:dbmCost – koszt DBM (tylko Analytics 360, wymaga integracji z DBM).
  • Dane – ga:dbmImpressions – całkowita liczba wyświetleń w DBM (tylko Analytics 360, wymaga integracji z DBM).
  • Dane – ga:dbmROAS – ROAS (tylko w Analytics 360, wymaga integracji z DBM).
  • Wymiar – ga:dsAdGroup – grupa reklam DS (tylko Analytics 360, wymaga integracji z DS).
  • Wymiar – ga:dsAdGroupId – identyfikator grupy reklam DS (tylko w Analytics 360, wymaga integracji z DS).
  • Wymiar – ga:dsAdvertiser – reklamodawca DS (tylko Analytics 360, wymaga integracji z DS).
  • Wymiar – ga:dsAdvertiserId – identyfikator reklamodawcy DS (tylko w Analytics 360, wymaga integracji z DS).
  • Wymiar – ga:dsAgency – agencja DS (tylko Analytics 360, wymaga integracji z DS).
  • Wymiar – ga:dsAgencyId – identyfikator agencji DS (tylko w Analytics 360, który wymaga integracji z DS).
  • Wymiar – ga:dsCampaign – kampania DS (tylko Analytics 360, wymaga integracji z DS).
  • Wymiar – ga:dsCampaignId – identyfikator kampanii DS (tylko w Analytics 360, który wymaga integracji z DS).
  • Wymiar – ga:dsEngineAccount – konto wyszukiwarki DS (tylko w Analytics 360, wymaga integracji z DS).
  • Wymiar – ga:dsEngineAccountId – identyfikator konta wyszukiwarki DS (tylko w Analytics 360; wymaga integracji z DS).
  • Wymiar – ga:dsKeyword – słowo kluczowe DS (tylko Analytics 360, wymaga integracji z DS).
  • Wymiar – ga:dsKeywordId – identyfikator słowa kluczowego DS (tylko w Analytics 360, wymaga integracji z DS).
  • ga:dsCPC – koszt kliknięcia w Search Ads dla reklamodawcy (tylko w Analytics 360, wymaga integracji z DS).
  • ga:dsCTR – współczynnik klikalności DS (tylko Analytics 360, wymaga integracji z DS).
  • ga:dsClicks – kliknięcia DS (tylko w Analytics 360, wymaga integracji z DS).
  • ga:dsCost – koszt DS (tylko w Analytics 360, wymaga integracji z DS).
  • ga:dsImpressions – wyświetlenia DS (tylko w Analytics 360, wymaga integracji z DS).
  • ga:dsProfit – DS Profie (tylko Analytics 360, wymaga integracji z DS).
  • ga:dsReturnOnAdSpend – zwrot z nakładów na reklamę w DS (tylko w Analytics 360 wymaga integracji z DS).
  • ga:dsRevenuePerClick – przychody z kliknięcia w Search Ads (tylko Analytics 360, wymaga integracji z DS).

Ta wersja dodaje do interfejsu API nowy wymiar. W tej wersji wprowadziliśmy też ograniczenia dotyczące kombinacji wymiarów, które można sprawdzić razem. Pełną listę definicji znajdziesz w przewodniku po wymiarach i danych.

Geo Network

  • Wymiar – ga:continentId – identyfikator kontynentu użytkownika określony na podstawie adresu IP użytkownika lub identyfikatora geograficznego.

Ograniczenia

Podane niżej wymiary w poniższych grupach nie mogą być używane jako wymiary w pozostałych grupach:

  • Odwiedź grupę informacyjną Zakupów Google
    • ga:checkoutOptions
    • ga:shoppingStage
  • Grupa eksperymentalna GWO
    • ga:experimentVariant
    • ga:experimentId
  • Grupa zainteresowań
    • ga:interestOtherCategory
  • Grupa na rynku
    • ga:interestInMarketCategory
  • Grupa promocji wewnętrznych:
    • ga:internalPromotionCreative
    • ga:internalPromotionId
    • ga:internalPromotionName
    • ga:internalPromotionPosition
  • Grupa zainteresowań:
    • ga:interestAffinityCategory

W tej wersji wprowadzono nowe limity. Szczegółowe informacje znajdziesz w dokumentacji dotyczącej limitów.

Zgłaszanie błędów

Ta wersja zacznie egzekwować limity nieudanych raportów (5XX).

  • 10 nieudanych żądań na projekt na godzinę.
  • 50 nieudanych żądań na projekt dziennie na profil.

Limity przestawne

W tej wersji obowiązują ograniczenia dotyczące żądań tabeli przestawnej:

  • Żądanie dotyczące raportu może zawierać teraz maksymalnie 2 tabele przestawne.
  • Tabela przestawna może mieć maksymalnie 4 wymiary.
  • Wymiary przestawne stanowią część ograniczenia łącznej liczby wymiarów dozwolonych w żądaniu.
  • Ograniczone dane stanowią część ograniczenia łącznej liczby danych dozwolonych w żądaniu.

Ta wersja dodaje do interfejsu API nowe wymiary i dane. Pełną listę definicji znajdziesz w przewodniku po wymiarach i danych.

Geo Network

  • Wymiar – ga:metroId – trzycyfrowy kod rynku docelowego (DMA), z którego pochodzi ruch, określony na podstawie adresu IP użytkownika lub identyfikatora geograficznego.

DoubleClick for Publishers

  • Dane – ga:dfpImpressions – wyświetlenie reklamy DFP jest raportowane za każdym razem, gdy w witrynie wyświetla się pojedyncza reklama. Jeśli na przykład strona zawierająca 2 jednostki reklamowe zostanie wyświetlona raz, zarejestrujemy 2 wyświetlenia (możliwość włączenia połączenia z DFP i wyłączenia włączenia funkcji Przychody z DFP).
  • Dane – ga:dfpCoverage – pokrycie to odsetek żądań reklamy, które zwróciły co najmniej 1 reklamę. Pokrycie z reguły pozwala zidentyfikować witryny, w których konto DFP nie może wyświetlać reklam kierowanych. (Wyświetlenia reklam / Łączna liczba żądań reklamy) * 100 (połączenie z DFP i nieustawione wyświetlanie przychodów z DFP)”.
  • Dane – ga:dfpMonetizedPageviews – mierzy łączną liczbę odsłon w usłudze, które zostały wyświetlone z reklamą z połączonego konta DFP. Pamiętaj, że pojedyncza strona może mieć wiele jednostek reklamowych (połączenie z DFP i nie włączono przychodów z DFP)”.
  • Dane – ga:dfpImpressionsPerSession – stosunek wyświetleń reklam DFP do sesji Analytics (Wyświetlenia reklam / Sesje Analytics) (połączenie z DFP włączone, a ukrywanie przychodów z DFP nie jest włączone)”.
  • Dane – ga:dfpViewableImpressionsPercent – odsetek widocznych wyświetleń reklamy. Wyświetlenie staje się widocznym wyświetleniem, gdy pojawia się w przeglądarce użytkownika i ma możliwość zobaczenia go (masz włączone połączenie z DFP i nie włączono funkcji ukrywania przychodów w DFP).
  • Dane – ga:dfpClicks – liczba kliknięć reklam DFP w witrynie (masz włączone połączenie z DFP i nie włączono przychodów z DFP)”.
  • Dane – ga:dfpCTR – odsetek odsłon, które doprowadziły do kliknięcia reklamy z DFP (nie włączono połączenia z DFP i nie włączono funkcji ukrywania przychodów w DFP)”.
  • Dane – ga:dfpRevenue – przychody z DFP to szacunkowa kwota łącznych przychodów z reklam obliczona na podstawie zrealizowanych wyświetleń (jeśli włączone jest połączenie z DFP i nie włączono opcji ukrywania przychodów w DFP).
  • Dane – ga:dfpRevenuePer1000Sessions – łączne szacunkowe przychody z reklam DFP na 1000 sesji Analytics. Pamiętaj, że te dane opierają się na sesjach, a nie wyświetleniach reklam (włączone jest połączenie z DFP i nie włączono funkcji ukrywania przychodów z DFP).
  • Dane – ga:dfpECPM – efektywny koszt tysiąca odsłon. Jest to przychody z DFP na 1000 wyświetleń (masz włączone połączenie z DFP i nie włączono funkcji ukrywania przychodów w DFP).
  • Dane – ga:backfillImpressions – wyświetlenia reklam zapasowych AdSense to suma wszystkich wyświetleń reklam AdSense lub reklam w usłudze Ad Exchange realizowanych w ramach DFP. Wyświetlenie reklamy jest rejestrowane za każdym razem, gdy w witrynie pojawia się pojedyncza reklama. Jeśli na przykład strona zawierająca 2 jednostki reklamowe zostanie wyświetlona raz, zarejestrujemy 2 wyświetlenia (możliwość włączenia połączenia z DFP i wyłączenia włączenia funkcji Przychody z DFP).
  • Dane – ga:backfillCoverage – Pokrycie reklam zapasowych to odsetek żądań reklam zapasowych, które zwróciły co najmniej jedną reklamę. Pokrycie może na przykład pomóc zidentyfikować witryny, w których konto wydawcy nie może wyświetlać reklam kierowanych. (Wyświetlenia reklam / łączna liczba żądań reklamy) * 100. Jeśli AdSense i Ad Exchange udostępniają reklamy zapasowe, te dane są średnią ważoną z 2 kont zapasowych (włączono połączenie z DFP i nie włączono przychodów z DFP)”.
  • Dane – ga:backfillMonetizedPageviews – mierzy łączną liczbę odsłon strony w usłudze, które zostały wyświetlone z co najmniej 1 reklamą z połączonych kont zapasowych. Pamiętaj, że pojedyncza odsłona generująca przychody może obejmować wiele wyświetleń reklam (połączenie z DFP i wyłączone ukrycie przychodów z DFP).
  • Dane – ga:backfillImpressionsPerSession – stosunek wyświetleń reklam zapasowych do sesji Analytics (Wyświetlenia reklam / Sesje Analytics). Jeśli AdSense i Ad Exchange udostępniają reklamy zapasowe, te dane to suma obydwu kont zapasowych (włączono połączenie z DFP i nie włączono przychodów z DFP)”.
  • Dane – ga:backfillViewableImpressionsPercent – odsetek widocznych wyświetleń reklam zapasowych. Wyświetlenie jest uznawane za widoczne wyświetlenie, jeśli pojawiło się w przeglądarce użytkownika i okazało się, że miało miejsce. Jeśli AdSense i Ad Exchange udostępniają reklamy zapasowe, te dane są średnią ważoną z 2 kont zapasowych (włączono połączenie z DFP i nie włączono przychodów z DFP)”.
  • Dane – ga:backfillClicks – liczba kliknięć reklam zapasowych w witrynie. Jeśli AdSense i Ad Exchange udostępniają reklamy zapasowe, te dane to suma obydwu kont zapasowych (włączono połączenie z DFP i nie włączono przychodów z DFP)”.
  • Dane – ga:backfillCTR – procent wyświetleń zapasowych, które doprowadziły do kliknięcia reklamy. Jeśli AdSense i Ad Exchange udostępniają reklamy zapasowe, te dane są średnią ważoną z 2 kont zapasowych (włączono połączenie z DFP i nie włączono przychodów z DFP)”.
  • Dane – ga:backfillRevenue – łączne szacunkowe przychody z reklam zapasowych. Jeśli AdSense i Ad Exchange udostępniają reklamy zapasowe, te dane to suma obydwu kont zapasowych (włączono połączenie z DFP i nie włączono przychodów z DFP)”.
  • Dane – ga:backfillRevenuePer1000Sessions – łączne szacunkowe przychody z reklam zapasowych na 1000 sesji Analytics. Pamiętaj, że te dane są oparte na sesjach w witrynie, a nie na wyświetleniach reklam. Jeśli AdSense i Ad Exchange udostępniają reklamy zapasowe, te dane to suma obydwu kont zapasowych (włączono połączenie z DFP i nie włączono przychodów z DFP)”.
  • Dane – ga:backfillECPM – efektywny koszt tysiąca odsłon. Jest to przychody z reklam zapasowych DFP na 1000 wyświetleń strony. Jeśli AdSense i Ad Exchange udostępniają reklamy zapasowe, te dane to suma obydwu kont zapasowych (włączono połączenie z DFP i nie włączono przychodów z DFP)”.

Jest to poprawka błędu, która usuwa błąd podczas tworzenia żądań kohorty Analytics V4 interfejsu API raportowania Analytics.

Prośby o kohortę

Prośby o kohortę mogą teraz zawierać pytania o wymiary kohorty. Wcześniej interfejs API zwracał żądanie błędu dotyczące wymiarów ga:acquisition....

Wartość od początku śledzenia – wartość od początku śledzenia

Pamiętaj, że żądania wartości od początku śledzenia mogą generować raporty wartości od początku śledzenia tylko w przypadku wyświetleń aplikacji.

W tej wersji pojawiła się nowa wersja interfejsu API Analytics Reporting API V4. Nowy interfejs API jest najbardziej zaawansowaną metodą uzyskiwania dostępu do danych raportów w Google Analytics.

Najważniejsze funkcje

Google Analytics opiera się na zaawansowanej infrastrukturze raportowania danych. Interfejs API daje deweloperom dostęp do możliwości platformy Google Analytics. Oto najważniejsze funkcje Analytics Analytics V4:

  • Wyrażenia wskaźników – interfejs API umożliwia zgłaszanie żądań nie tylko do wbudowanych wskaźników, ale także do działań matematycznych. Na przykład realizacji celu na liczbę sesji można wyrazić w żądaniu jako ga:goal1completions/ga:sessions.
  • Wiele zakresów dat – obsługa wysyłania żądań dwóch zakresów dat, co umożliwia porównywanie danych z dwóch okresów w jednym żądaniu.
  • Kohorty i wartość od początku śledzenia – interfejs API zawiera obszerne słodkości, dzięki którym można uzyskać raporty dotyczące kohorty i wartości od początku śledzenia.
  • Wiele segmentów – teraz możesz poprosić o kilka segmentów w jednym żądaniu.

Pierwsze kroki

Więcej informacji o pierwszych krokach z interfejsem API znajdziesz w dokumentacji dla programistów.

Zasady dotyczące limitów

Interfejs Analytics Reporting API V4 ma własne limity i limity. Ponieważ jest to nowy interfejs API, te limity mogą ulec zmianie.

Migracja

Razem z przewodnikiem po migracji udostępniamy też bibliotekę zgodności z językami Python w GitHubie.

Wymiary i dane

W tej wersji dodano też zestaw wymiarów i danych specyficznych dla interfejsu Analytics Reporting API V4. Pełną listę definicji znajdziesz w eksploratorze wymiarów i danych.

  • Wymiar – ga:cohort – nazwa kohorty, do której należy użytkownik, na podstawie definicji kohort. W zależności od sposobu określenia kohorty użytkownik może należeć do wielu kohort, podobnie jak użytkownik może należeć do wielu segmentów.

  • Wymiar – ga:cohortNthDay – przesunięcie dnia o 0 w stosunku do daty definicji kohorty. Jeśli na przykład kohorta została określona jako pierwsza wizyta 2015-09-01, w dniu 2015-09-04 ga:cohortNthDay będzie mieć wartość 3.

  • ga:cohortNthMonth – przesunięcie miesiąca o 0 w stosunku do daty definicji kohorty.

  • Wymiar – ga:cohortNthWeek – przesunięcie tygodnia na podstawie 0 w stosunku do daty definicji kohorty.

  • Wymiar – ga:acquisitionTrafficChannel – kanał wizyt, dzięki któremu udało się pozyskać użytkownika. Jest on wyodrębniany z pierwszej sesji użytkownika. Kanał ruchu jest obliczany na podstawie domyślnych reguł grupowania kanałów (na poziomie widoku danych, jeśli są dostępne) w momencie pozyskania użytkownika.

  • Wymiar – ga:acquisitionSource – źródło, dzięki któremu udało się pozyskać użytkownika. Pochodzące z pierwszej sesji użytkownika.

  • Wymiar – ga:acquisitionMedium – medium, dzięki któremu udało się pozyskać użytkownika. Pochodzące z pierwszej sesji użytkownika.

  • Wymiar – ga:acquisitionSourceMedium – łączna wartość ga:userAcquisitionSource i ga:Acquisitionmedium.

  • Wymiar – ga:acquisitionCampaign kampania, dzięki której udało się pozyskać użytkownika. Pochodzące z pierwszej sesji użytkownika.

  • Dane – ga:cohortActiveUsers – te dane są istotne w kontekście wymiarów przesunięcia opartych na 0 (ga:cohortNthDay, ga:cohortNthWeek lub ga:cohortNthMonth). Wskazuje on liczbę użytkowników w kohorcie, którzy są aktywni w okresie odpowiadającym n-tym dniu/tygodniu/miesiącowi. Na przykład w przypadku ga:cohortNthWeek = 1 liczba użytkowników (w kohorcie) aktywnych w 2 tygodniu. Jeśli żądanie nie zawiera żadnych parametrów ga:cohortNthDay, ga:cohortNthWeek ani ga:cohortNthMonth, te dane mają taką samą wartość jak ga:cohortTotalUsers.

  • Dane – ga:cohortTotalUsers – liczba użytkowników należących do kohorty, nazywana też rozmiarem kohorty.

  • Dane – ga:cohortAppviewsPerUser – wyświetlenia aplikacji na użytkownika w kohorcie.

  • Dane – ga:cohortGoalCompletionsPerUser – realizacje celu na użytkownika w kohorcie.

  • Dane – ga:cohortPageviewsPerUser – liczba wyświetleń strony na użytkownika w kohorcie.

  • Wskaźnik – ga:cohortRetentionRate – współczynnik utrzymania kohorty.

  • Dane – ga:cohortRevenuePerUser – przychody na użytkownika dla kohorty.

  • Dane – ga:cohortVisitDurationPerUser – czas trwania sesji na użytkownika w kohorcie.

  • Dane – ga:cohortSessionsPerUser – liczba sesji na użytkownika w ramach kohorty.

  • Dane – ga:cohortTotalUsersWithLifetimeCriteria – dotyczy kontekstu w kontekście żądania, które ma wymiary ga:acquisitionTrafficChannel, ga:acquisitionSource, ga:acquisitionMedium lub ga:acquisitionCampaign. Odzwierciedla on liczbę użytkowników w kohortach, które zostały pozyskane za pomocą bieżącego kanału, źródła, medium lub kampanii. Na przykład w przypadku ga:acquisitionTrafficChannel=Direct reprezentuje liczbę użytkowników w kohorcie, którzy zostali pozyskani bezpośrednio. Jeśli nie istnieje żaden z wymienionych wymiarów, jego wartość jest równa ga:cohortTotalUsers.

  • Dane – ga:cohortAppviewsPerUserWithLifetimeCriteria – wyświetlenia aplikacji na użytkownika w ramach wymiaru pozyskania w kohorcie.

  • Dane – ga:cohortGoalCompletionsPerUserWithLifetimeCriteria – realizacje celu na użytkownika w ramach wymiaru pozyskania w kohorcie.

  • Dane – ga:cohortPageviewsPerUserWithLifetimeCriteria – liczba wyświetleń strony na użytkownika w ramach wymiaru pozyskania w kohorcie.

  • Dane – ga:cohortRevenuePerUserWithLifetimeCriteria – przychody na użytkownika dla wymiaru pozyskania kohorty.

  • Dane – ga:cohortSessionsPerUserWithLifetimeCriteria – czas trwania sesji na użytkownika dla wymiaru pozyskiwania w kohorcie.

Wycofaliśmy wymiary i dane z Centrum danych społecznościowych, które będą widoczne od 30 kwietnia 2016 roku. Po tej dacie nie będą się pojawiać żadne nowe dane. Zgodnie z zasadami wycofywania danych te wymiary i dane zostaną usunięte po 30 września 2016 r.

Pełną listę definicji znajdziesz w przewodniku po wymiarach i danych.

Działania społecznościowe

Te wymiary i dane zostały wycofane i zostaną usunięte po 30 września 2016 r. Szczegółowe informacje o usuwaniu danych znajdziesz w Zasadach wycofywania danych:

  • Wymiar – ga:socialActivityEndorsingUrl – w przypadku centrum danych społecznościowych jest to adres URL działania społecznościowego (np. adres URL posta w Google+, adres URL komentarza na blogu itd.).
  • Wymiar – ga:socialActivityDisplayName – w przypadku centrum danych społecznościowych jest to nazwa działania społecznościowego opublikowane przez użytkowników sieci społecznościowej.
  • Wymiar – ga:socialActivityPost – w przypadku centrum danych społecznościowych to treść aktywności w mediach społecznościowych (np. wiadomość opublikowana w Google+) opublikowana przez użytkowników sieci społecznościowej.
  • Wymiar – ga:socialActivityTimestamp – w przypadku centrum danych społecznościowych oznacza to czas wystąpienia aktywności w sieciach społecznościowych.
  • Wymiar – ga:socialActivityUserHandle – w przypadku centrum danych społecznościowych jest to nick sieci społecznościowej (np. nazwa lub identyfikator) użytkowników, którzy zainicjowali działanie społecznościowe.”
  • Wymiar – ga:socialActivityUserPhotoUrl – w przypadku aktywności centrum danych społecznościowych jest to adres URL zdjęcia powiązanego z profilami w sieciach społecznościowych użytkowników.
  • Wymiar – ga:socialActivityUserProfileUrl – w przypadku aktywności centrum danych społecznościowych jest to adres URL profili sieci społecznościowych powiązanych użytkowników.
  • Wymiar – ga:socialActivityTagsSummary – w przypadku aktywności centrum danych społecznościowych jest to zestaw rozdzielonych przecinkami tagów powiązanych z aktywnością w mediach społecznościowych”.
  • Wymiar – ga:socialActivityAction – w przypadku aktywności centrum danych społecznościowych reprezentuje typ działania społecznościowego (np. głosowanie, komentarz, +1-ki itd.) związane z aktywnością.
  • Wymiar – ga:socialActivityNetworkAction – w przypadku aktywności centrum danych społecznościowych jest to typ interakcji społecznościowej i sieć społecznościowa, z której ona pochodzi.
  • Wymiar – ga:socialActivityContentUrl – w przypadku aktywności centrum danych społecznościowych jest to URL udostępniony przez powiązanych użytkowników sieci społecznościowych.
  • Dane – ga:socialActivities – całkowita liczba działań, w przypadku których adres URL treści został udostępniony lub wspomniany w sieci partnera centrum danych społecznościowych.

Ta wersja dodaje do interfejsu API nowy wymiar. Pełną listę definicji znajdziesz w przewodniku po wymiarach i danych.

Platforma lub urządzenie

  • Wymiar – ga:browserSize – rozmiar widocznego obszaru przeglądarek użytkowników. Rozmiar przeglądarki to wymiar o zakresie ograniczonym do sesji, który wskazuje początkowe wymiary widocznego obszaru w pikselach i jest sformatowany jako szerokość X wysokość. np. 1920 x 960.

Ta wersja dodaje nowy parametr do interfejsu API.

Uwzględnij puste wiersze

  • Ta wersja dodaje nowy opcjonalny parametr include-empty-rows. Jeśli jest ustawiony na false wierszy bez danych, zostaną one pominięte w odpowiedzi. Wartością domyślną jest true, która nie wprowadza zmian. W związku z tym nie powinna wymagać aktualizacji kodu. Więcej informacji znajdziesz w dokumentacji dotyczącej interfejsu API do raportowania podstawowego.

Ta wersja dodaje nowe dane do interfejsu API. Pełną listę definicji znajdziesz w przewodniku po wymiarach i danych.

Użytkownik

  • Dane – ga:1dayUsers – łączna liczba użytkowników aktywnych w ciągu 1 dnia w wybranym okresie. Co najmniej jedną z wartości ga:nthDay, ga:date lub ga:day musisz określić jako wymiar, aby wysyłać zapytania. Zwrócona wartość będzie łączną liczbą unikalnych użytkowników w danym dniu zakończonym w danym dniu.
  • Dane – ga:7dayUsers – łączna liczba użytkowników aktywnych w ciągu 7 dni w danym dniu w wybranym okresie. Co najmniej jedną z wartości ga:nthDay, ga:date lub ga:day musisz określić jako wymiar, aby wysyłać zapytania. Zwrócona wartość to łączna liczba unikalnych użytkowników w danym dniu (w ciągu 7 dni).
  • Dane – ga:14dayUsers – łączna liczba użytkowników aktywnych w ciągu 14 dni każdego dnia w wybranym okresie. Co najmniej jedną z wartości ga:nthDay, ga:date lub ga:day musisz określić jako wymiar, aby wysyłać zapytania. Zwracaną wartością będzie łączna liczba unikalnych użytkowników w danym dniu dla okresu 14 dni zakończonych.
  • Dane – ga:30dayUsers – łączna liczba użytkowników aktywnych w ciągu 30 dni w wybranym okresie. Co najmniej jedną z wartości ga:nthDay, ga:date lub ga:day musisz określić jako wymiar, aby wysyłać zapytania. Zwracana wartość będzie łączną liczbą unikalnych użytkowników w danym okresie 30 dni zakończonym w danym dniu.

Ta wersja dodaje nowe dane do interfejsu API. Pełną listę definicji znajdziesz w przewodniku po wymiarach i danych.

DoubleClick Ad Exchange (AdX)

  • Dane – ga:adxCTR – odsetek odsłon, które doprowadziły do kliknięcia reklamy AdX.
  • Dane – ga:adxClicks – liczba kliknięć reklam AdX w witrynie.
  • Dane – ga:adxCoverage – pokrycie to odsetek żądań reklamy, które zwróciły co najmniej 1 reklamę. Pokrycie z reguły pozwala zidentyfikować witryny, w których konto AdX nie może wyświetlać reklam kierowanych. (Wyświetlenia reklamy / Łączna liczba żądań reklamy) * 100
  • Dane – ga:adxECPM – efektywny koszt tysiąca odsłon. Jest to przychód z 1000 wyświetleń strony w Ad Exchange.
  • Dane – ga:adxImpressions – wyświetlenie reklamy AdX jest raportowane za każdym razem, gdy w witrynie wyświetla się pojedyncza reklama. Jeśli na przykład strona zawierająca 2 jednostki reklamowe zostanie wyświetlona raz, zarejestrujemy 2 wyświetlenia.
  • Dane – ga:adxImpressionsPerSession – stosunek wyświetleń reklam AdX do sesji Analytics (Wyświetlenia reklam / Sesje Analytics).
  • Dane – ga:adxMonetizedPageviews – liczba wyświetleń stron generujących przychody wskazuje łączną liczbę odsłon w Twojej usłudze, które wyświetliły się z reklamy z połączonego konta AdX. Uwaga: pojedyncza strona może zawierać wiele jednostek reklamowych.
  • Dane – ga:adxRevenue – łączne szacunkowe przychody z reklam AdX.
  • Dane – ga:adxRevenuePer1000Sessions – łączne szacunkowe przychody z reklam AdX na 1000 sesji Analytics. Pamiętaj, że podstawą dla tego wyliczenia jest liczba sesji w witrynie, a nie liczba wyświetleń reklam.
  • Dane – ga:adxViewableImpressionsPercent – odsetek wyświetleń reklam, które były widoczne. Wyświetlenie staje się widocznym wyświetleniem, gdy pojawiło się w wyszukiwarce użytkownika, który miał okazję je zobaczyć.

Ta wersja wycofuje istniejące wymiary i dane. Pełną listę definicji znajdziesz w przewodniku po wymiarach i danych.

Wycofane wymiary

Te wymiary zostały wycofane. Szczegółowe informacje o usuwaniu danych znajdziesz w Zasadach wycofywania danych:

  • Wymiar – ga:adSlotPosition – użyj zasady ga:adSlot.
  • Wymiar – ga:nextPagePath – użyj zasady ga:pagePath.
  • Wymiar – ga:nextContentGroupXX – użyj zasady ga:contentGroupXX.

Ta wersja dodaje do interfejsu API nowy wymiar. Pełną listę wymiarów i danych znajdziesz w artykule Wymiary i dane.

AdWords

  • Wymiar – ga:adQueryWordCount – liczba słów w zapytaniu.

Ta wersja dodaje do interfejsu API nowe wymiary. Pełną listę wymiarów i danych znajdziesz w artykule Wymiary i dane.

Platforma lub urządzenie

  • Wymiar – ga:dataSource – źródło danych działania. Działania wysyłane z tagu ga.js i analytics.js są rejestrowane jako „internet”, a działania wysyłane z pakietów SDK – jako „aplikacja”. Te wartości można zastąpić.
  • Wymiar – ga:searchAfterDestinationPage – strona, którą odwiedził użytkownik po przeprowadzeniu wewnętrznego wyszukiwania w witrynie.

Ta wersja dodaje do interfejsu API nowe wymiary i dane i wycofuje 2 istniejące dane. Pełną listę definicji znajdziesz w przewodniku po wymiarach i danych.

E-commerce

  • Dane – ga:transactionsPerUser – łączna liczba transakcji podzielona przez łączną liczbę użytkowników.
  • Dane – ga:revenuePerUser – łączne przychody ze sprzedaży podane w transakcji, z wyłączeniem dostawy i podatku, podzielone przez łączną liczbę użytkowników.

Użytkownik

  • Dane – ga:sessionsPerUser – łączna liczba sesji podzielona przez łączną liczbę użytkowników.

Geo Network

  • Wymiar – ga:cityId – identyfikatory miast użytkowników uzyskane z adresów IP lub identyfikatorów geograficznych
  • Wymiar – ga:countryIsoCode – kod kraju użytkownika zgodnie z adresem IP lub identyfikatorem geograficznym. Wartości są podawane jako kod ISO-3166-1 alfa-2.
  • Wymiar – ga:regionId – identyfikator regionu użytkowników pochodzący z adresów IP lub identyfikatorów geograficznych. W Stanach Zjednoczonych region to stan, np. Nowy Jork.
  • Wymiar – ga:regionIsoCode – kod ISO regionu użytkowników pochodzący z adresów IP lub identyfikatorów geograficznych. Wartości są podawane jako kod ISO-3166-2.
  • Wymiar – ga:subContinentCode – kod subkontynentu pochodzący z adresów IP lub identyfikatorów geograficznych. Na przykład Polinezja lub Europa Północna. Wartości są podawane w formie kodu UN M.49.

DoubleClick Campaign Manager

  • Dane – ga:dcmROAS – zwrot z nakładów na reklamę (ROAS) w DCM (tylko premium).

Wycofane dane

Te dane zostały wycofane. Zapoznaj się z zasadami wycofywania danych, by dowiedzieć się więcej o usuwaniu danych – + dane – ga:dcmROI – użyj zasady ga:dcmROAS. + Dane – ga:dcmMargen – użyj zasady ga:dcmROAS.

Ta wersja dodaje do interfejsu API nowe dane i wycofuje 2 istniejące dane. Pełną listę definicji znajdziesz w materiałach referencyjnych dotyczących wymiarów i danych.

AdWords

  • Dane – ga:ROAS – zwrot z nakładów na reklamę (ROAS) to łączne przychody z transakcji i wartość celu podzielona przez koszt reklamy.

Wycofane wymiary i dane

Te wymiary i dane zostały wycofane. Zapoznaj się z zasadami wycofywania danych, by dowiedzieć się więcej o usuwaniu danych – + dane – ga:ROI – użyj zasady ga:ROAS. + Dane – ga:margin – użyj zasady ga:ROAS.

Ta wersja dodaje nowe dane do interfejsu API. Pełną listę definicji znajdziesz w materiałach referencyjnych dotyczących wymiarów i danych.

AdSense

  • Dane – ga:adsenseCoverage, odsetek żądań reklamy, które zwróciły co najmniej jedną reklamę.
  • Dane – ga:adsenseViewableImpressionPercent – odsetek wyświetleń, które były widoczne.

W tej wersji dodaliśmy nowe dane sesji, nowy wymiar Źródła wizyt oraz nowe wymiary i dane DoubleClick Campaign Manager.

Wymiary i dane

Pełną listę definicji znajdziesz w przewodniku po wymiarach i danych.

Sesja

  • Wskaźnik – ga:hits – łączna liczba działań przesłanych do Google Analytics. Te dane uwzględniają wszystkie typy działań (np.odsłona, zdarzenie, czas itp.).

Źródła wizyt

  • Wymiar – ga:campaignCode – w przypadku ręcznego śledzenia kampanii wartość parametru śledzenia kampanii utm_id.

DoubleClick Campaign Manager

  • Wymiar – ga:dcmClickAd – nazwa reklamy DCM kliknięcia DCM pasującego do sesji Google Analytics (tylko premium).
  • Wymiar – ga:dcmClickAdId – identyfikator reklamy DCM kliknięcia DCM pasującego do sesji Google Analytics (tylko premium).
  • Wymiar – ga:dcmClickAdType – nazwa typu reklamy DCM kliknięcia DCM pasującego do sesji Google Analytics (tylko premium).
  • Wymiar – ga:dcmClickAdTypeId – identyfikator typu reklamy DCM kliknięcia DCM pasującego do sesji Google Analytics (tylko premium).
  • Wymiar – ga:dcmClickAdvertiser – nazwa reklamodawcy DCM kliknięcia DCM pasującego do sesji Google Analytics (tylko premium).
  • Wymiar – ga:dcmClickAdvertiserId – identyfikator reklamodawcy DCM kliknięcia DCM pasującego do sesji Google Analytics (tylko premium).
  • Wymiar – ga:dcmClickCampaign – nazwa kampanii DCM kliknięcia DCM pasującego do sesji Google Analytics (tylko premium).
  • Wymiar – ga:dcmClickCampaignId – identyfikator kampanii w Menedżerze kliknięć DCM odpowiadający sesji Google Analytics (tylko w wersji premium).
  • Wymiar – ga:dcmClickCreative – nazwa kreacji DCM kliknięcia DCM pasującego do sesji Google Analytics (tylko premium).
  • Wymiar – ga:dcmClickCreativeId – identyfikator kreacji DCM kliknięcia DCM pasującego do sesji Google Analytics (tylko premium).
  • Wymiar – ga:dcmClickCreativeType – nazwa typu kreacji DCM kliknięcia DCM pasującego do sesji Google Analytics (tylko premium).
  • Wymiar – ga:dcmClickCreativeTypeId – identyfikator typu kreacji DCM kliknięcia DCM pasującego do sesji Google Analytics (tylko premium).
  • Wymiar – ga:dcmClickCreativeVersion – wersja kreacji Campaign Manager związana z kliknięciem DCM odpowiada sesji Google Analytics (tylko w wersji premium).
  • Wymiar – ga:dcmClickRenderingId – identyfikator renderowania DCM kliknięcia DCM odpowiadający sesji Google Analytics (tylko premium).
  • Wymiar – ga:dcmClickSite – nazwa witryny, w której wyświetliła się kreacja DCM i która została kliknięta w przypadku kliknięcia DCM odpowiadającego sesji Google Analytics (tylko w wersji premium).
  • Wymiar – ga:dcmClickSiteId – identyfikator witryny w DCM, w której wyświetliła się kreacja z Campaign Managera i została ona kliknięta po kliknięciu DCM pasującego do sesji Google Analytics (tylko w wersji premium).
  • Wymiar – ga:dcmClickSitePlacement – nazwa miejsca docelowego w witrynie DCM odpowiadającego kliknięciu DCM pasującemu do sesji Google Analytics (tylko w wersji premium).
  • Wymiar – ga:dcmClickSitePlacementId – identyfikator miejsca docelowego w witrynie z kliknięciami w DCM pasujący do sesji Google Analytics (tylko w wersji premium).
  • Wymiar – ga:dcmClickSpotId – identyfikator konfiguracji Floodlight w Menedżerze kliknięć DoubleClick odpowiadający sesji w Google Analytics (tylko w wersji premium).
  • Wymiar – ga:dcmFloodlightActivity – nazwa aktywności Floodlight w DCM powiązana z konwersją Floodlight (tylko premium).
  • Wymiar – ga:dcmFloodlightActivityAndGroup – nazwa aktywności Floodlight w DCM i nazwa grupy powiązanej z konwersją Floodlight (tylko premium).
  • Wymiar – ga:dcmFloodlightActivityGroup – nazwa grupy aktywności Floodlight Floodlight powiązanej z konwersją Floodlight (tylko premium).
  • Wymiar – ga:dcmFloodlightActivityGroupId – identyfikator grupy aktywności Floodlight Floodlight powiązany z konwersją Floodlight (tylko premium).
  • Wymiar – ga:dcmFloodlightActivityId – identyfikator aktywności Floodlight w DCM powiązany z konwersją Floodlight (tylko premium).
  • Wymiar – ga:dcmFloodlightAdvertiserId – identyfikator reklamodawcy Floodlight w DCM powiązany z konwersją Floodlight (tylko premium).
  • Wymiar – ga:dcmFloodlightSpotId – identyfikator konfiguracji Floodlight Floodlight powiązany z konwersją Floodlight (tylko premium).
  • Wymiar – ga:dcmLastEventAd – nazwa reklamy z ostatniego zdarzenia DCM (wyświetlenie lub kliknięcie w okresie ważności DCM) powiązana z sesją Google Analytics (tylko w wersji premium).
  • Wymiar – ga:dcmLastEventAdId – identyfikator reklamy z ostatniego zdarzenia DCM (wyświetlenie lub kliknięcie w okresie ważności DCM) powiązane z sesją Google Analytics (tylko w wersji premium).
  • Wymiar – ga:dcmLastEventAdType – nazwa typu reklamy z ostatniego zdarzenia DCM (wyświetlenie lub kliknięcie w okresie ważności DCM) powiązana z sesją Google Analytics (tylko w wersji premium).
  • Wymiar – ga:dcmLastEventAdTypeId – identyfikator typu reklamy z ostatniego zdarzenia DCM (wyświetlenie lub kliknięcie w okresie ważności DCM), który jest powiązany z sesją Google Analytics (tylko w wersji premium).
  • Wymiar – ga:dcmLastEventAdvertiser – nazwa reklamodawcy w DCM jako ostatnie zdarzenie (wyświetlenie lub kliknięcie w okresie ważności DCM) powiązane z sesją Google Analytics (tylko w wersji premium).
  • Wymiar – ga:dcmLastEventAdvertiserId – identyfikator reklamodawcy w DCM z ostatniego zdarzenia DCM (wyświetlenie lub kliknięcie w okresie ważności DCM) powiązane z sesją Google Analytics (tylko w wersji premium).
  • Wymiar – ga:dcmLastEventAttributionType – istnieją 2 możliwe wartości (Po kliknięciu i Po obejrzeniu). Jeśli ostatnie zdarzenie DCM powiązane z sesją Google Analytics było kliknięciem, wartość będzie wynosić ClickThrough (Kliknięcie). Jeśli ostatnie zdarzenie DCM powiązane z sesją Google Analytics było wyświetleniem reklamy, wartość będzie wynosić ViewThrough (tylko premium).
  • Wymiar – ga:dcmLastEventCampaign – nazwa kampanii w DCM jako ostatnie zdarzenie (wyświetlenie lub kliknięcie w okresie ważności DCM) powiązane z sesją Google Analytics (tylko w wersji premium).
  • Wymiar – ga:dcmLastEventCampaignId – identyfikator kampanii w DCM jako ostatnie zdarzenie (wyświetlenie lub kliknięcie w okresie ważności DCM) powiązane z sesją Google Analytics (tylko w wersji premium).
  • Wymiar – ga:dcmLastEventCreative – nazwa kreacji w ostatnim zdarzeniu DCM (wyświetlenie lub kliknięcie w okresie ważności DCM) powiązanym z sesją Google Analytics (tylko w wersji premium).
  • Wymiar – ga:dcmLastEventCreativeId – identyfikator kreacji DCM ostatniego zdarzenia DCM (wyświetlenie lub kliknięcie w okresie ważności DCM) powiązane z sesją Google Analytics (tylko w wersji premium).
  • Wymiar – ga:dcmLastEventCreativeType – nazwa typu kreacji z ostatniego zdarzenia DCM (wyświetlenie lub kliknięcie w okresie ważności DCM) powiązana z sesją Google Analytics (tylko w wersji premium).
  • Wymiar – ga:dcmLastEventCreativeTypeId – identyfikator typu kreacji z ostatniego zdarzenia DCM (wyświetlenie lub kliknięcie w okresie ważności DCM) powiązanego z sesją Google Analytics (tylko w wersji premium).
  • Wymiar – ga:dcmLastEventCreativeVersion – wersja kreacji w ostatnim zdarzeniu DCM (wyświetlenie lub kliknięcie w okresie ważności DCM) powiązanym z sesją Google Analytics (tylko w wersji premium).
  • Wymiar – ga:dcmLastEventRenderingId – identyfikator renderowania DCM ostatniego zdarzenia (wyświetlenia lub kliknięcia w okresie ważności DCM) powiązanego z sesją Google Analytics (tylko w wersji premium).
  • Wymiar – ga:dcmLastEventSite – nazwa witryny, w której wyświetliła się i kliknięto kreację DCM (ostatnie wyświetlenie lub kliknięcie w okresie ważności DCM), powiązana z sesją Google Analytics (tylko w wersji premium).
  • Wymiar – ga:dcmLastEventSiteId – identyfikator witryny z DCM, na której wyświetliła się i kliknęła kreacja z ostatniego zdarzenia DCM (wyświetlenie lub kliknięcie w okresie ważności DCM), powiązana z sesją Google Analytics (tylko w wersji premium).
  • Wymiar – ga:dcmLastEventSitePlacement – nazwa miejsca docelowego w witrynie z ostatniego zdarzenia DCM (wyświetlenie lub kliknięcie w okresie ważności DCM) powiązanego z sesją Google Analytics (tylko w wersji premium).
  • Wymiar – ga:dcmLastEventSitePlacementId – identyfikator miejsca docelowego witryny z ostatniego zdarzenia DCM (wyświetlenie lub kliknięcie w okresie ważności DCM) powiązanego z sesją Google Analytics (tylko w wersji premium).
  • Wymiar – ga:dcmLastEventSpotId – identyfikator konfiguracji Floodlight ostatniego zdarzenia DCM (wyświetlenie lub kliknięcie w okresie ważności DCM) powiązane z sesją Google Analytics (tylko w wersji premium).
  • Dane – ga:dcmFloodlightQuantity – liczba konwersji Floodlight w DCM (tylko premium).
  • Dane – dcmFloodlightRevenue – przychody Floodlight z DCM (tylko premium).

Ta wersja zawiera nowe wymiary i dane grupowania treści.

Wymiary i dane

Pełną listę definicji znajdziesz w przewodniku po wymiarach i danych.

Grupowanie treści

  • Wymiar – ga:landingContentGroupXX – pierwsza pasująca grupa treści w sesji użytkownika.
  • Wymiar – ga:nextContentGroupXX – odnosi się do grupy treści, która była odwiedzana po innej grupie treści.
  • Wymiar – ga:contentGroupXX – grupa treści w usłudze. Grupa treści to zbiór treści mających logiczną strukturę, która może być określona przez kod śledzenia, dopasowanie do wyrażenia strony/wyrażenia regularnego lub zdefiniowane wstępnie reguły.
  • Wymiar – ga:previousContentGroupXX – odnosi się do grupy treści, która była odwiedzana przed inną grupą treści.
  • Dane – ga:contentGroupUniqueViewsXX – liczba różnych (unikalnych) stron w sesji w ramach określonej grupy treści. Bierze pod uwagę zarówno parametr pagePath, jak i pageTitle, aby określić unikalność.

W tej wersji wprowadziliśmy nowy warunek dateOfSession dla segmentów oraz nowe wymiary i dane Ulepszonego e-commerce.

Segmenty

Segmenty obsługują teraz nowy warunek dateOfSession, który może ograniczać segment do grupy użytkowników, którzy zainicjowali sesję w wybranym zakresie dat. Więcej informacji znajdziesz w Przewodniku dla programistów segmentów.

Wymiary i dane

Pełną listę definicji Ulepszonego e-commerce znajdziesz w przewodniku po wymiarach i danych.

Ulepszone e-commerce

  • Wymiar – ga:internalPromotionCreative – zawartość kreacji przeznaczona na potrzeby promocji.
  • Wymiar – ga:internalPromotionId – identyfikator używany dla danej promocji.
  • Wymiar – ga:internalPromotionName – nazwa promocji.
  • Wymiar – ga:internalPromotionPosition – pozycja promocji na stronie lub ekranie aplikacji.
  • Wymiar – ga:orderCouponCode – kod kuponu zamówienia.
  • Wymiar – ga:productBrand – nazwa marki, pod którą produkt jest sprzedawany.
  • Wymiar – ga:productCategoryHierarchy – hierarchiczna kategoria, w której produkt jest sklasyfikowany (Ulepszony e-commerce).
  • Wymiar – ga:productCategoryLevelXX – poziom (1–5) w hierarchii kategorii produktów, począwszy od góry.
  • Wymiar – ga:productCouponCode – kod kuponu na poziomie produktu
  • Wymiar – ga:productListName – nazwa listy produktów, na której pojawia się produkt.
  • Wymiar – ga:productListPosition – pozycja produktu na liście produktów.
  • Wymiar – ga:productVariant – konkretna wersja produktu, np. XS, S, M i L w przypadku rozmiaru lub czerwony, niebieski, zielony i czarny w przypadku koloru.
  • Wymiar – ga:checkoutOptions – opcje użytkownika określone podczas procesu płatności, np. Opcje dostawy to FedEx, DHL, UPS, a w przypadku płatności kartą Visa, MasterCard, AmEx. Ten wymiar powinien być zawsze używany wraz z Etapem zakupów.
  • Wymiar – ga:shoppingStage – różne etapy interakcji z zakupem, które użytkownicy ukończyli podczas sesji, np. Product_VIEW, ADD_TO_CART, checkoutOUT itp.
  • Dane – ga:internalPromotionCTR – szybkość, z jaką użytkownicy klikali, aby zobaczyć promocję wewnętrzną (liczba kliknięć / liczba wyświetleń promocji).
  • Dane – ga:internalPromotionClicks – liczba kliknięć promocji wewnętrznej.
  • Dane – ga:internalPromotionViews – liczba wyświetleń promocji wewnętrznej.
  • Dane – ga:localProductRefundAmount – kwota zwrotu środków za dany produkt w walucie lokalnej.
  • Dane – ga:localRefundAmount – łączna kwota zwrotu za transakcję w walucie lokalnej.
  • Dane – ga:productAddsToCart – liczba wyświetleń produktu w koszyku.
  • Dane – ga:productCheckouts – liczba przypadków uwzględniania produktu w procesie płatności.
  • Dane – ga:productDetailViews – liczba wyświetleń strony z informacjami o produkcie.
  • Dane – ga:productListClicks – liczba kliknięć produktu przez użytkowników po jego pojawieniu się na liście produktów.
  • Dane – ga:productListViews – liczba wyświetleń produktu na liście produktów.
  • Dane – ga:productListCTR – liczba kliknięć produktu na liście produktów.
  • Dane – ga:productRefunds – liczba zwrotów środków za produkt.
  • Dane – ga:productRefundAmount – łączna kwota zwrotu środków za produkt.
  • Dane – ga:productRemovesFromCart – liczba przypadków usunięcia produktu z koszyków.
  • Dane – ga:productRevenuePerPurchase – średnie przychody z produktu na zakup (często używane z kodem kuponu produktu).
  • Dane – ga:buyToDetailRate – unikalne zakupy podzielone przez liczbę wyświetleń stron ze szczegółami produktu.
  • Dane – ga:cartToDetailRate – produkty dodane przez liczbę wyświetleń szczegółów produktu.
  • Dane – ga:quantityAddedToCart – liczba jednostek produktów dodanych do koszyka.
  • Dane – ga:quantityCheckedOut – liczba jednostek produktu uwzględnionych w wymeldowaniu.
  • Dane – ga:quantityRefunded – liczba jednostek, za które zwrócono środki.
  • Dane – ga:quantityRemovedFromCart – liczba jednostek produktu usuniętych z koszyka.
  • Dane – ga:refundAmount – kwota waluty zwrócona za transakcję.
  • Dane – ga:totalRefunds – liczba zrealizowanych zwrotów środków.

Ta wersja zawiera poprawkę błędu w nagłówkach kolumn oraz nowe wymiary i dane.

Wymiary i dane

Pełną listę definicji znajdziesz w przewodniku po wymiarach i danych.

System

  • Wymiar – ga:sourcePropertyDisplayName – wyświetlana nazwa usługi źródłowej usług o pełnym zakresie. Dotyczy to tylko usług o pełnym zakresie.
  • Wymiar – ga:sourcePropertyTrackingId – identyfikator śledzenia usługi źródłowej dla usług o pełnym zakresie. Dotyczy to tylko usług o pełnym zakresie

Grupowanie kanałów

  • Wymiar – ga:channelGrouping – domyślne grupowanie kanałów współdzielone w widoku danych (profil).
  • Wymiar – ga:correlationModelId – identyfikator modelu korelacji dla powiązanych produktów.
  • Wymiar – ga:queryProductId – identyfikator produktu, którego dotyczy zapytanie.
  • Wymiar – ga:queryProductName – nazwa produktu, którego dotyczy zapytanie.
  • Wymiar – ga:queryProductVariation – odmiana produktu, którego dotyczy zapytanie.
  • Wymiar – ga:relatedProductId – identyfikator powiązanego produktu.
  • Wymiar – ga:relatedProductName – nazwa powiązanego produktu.
  • Wymiar – ga:relatedProductVariation – odmiana powiązanego produktu.
  • Dane – ga:correlationScore – wynik korelacji dla powiązanych produktów.
  • Dane – ga:queryProductQuantity – ilość produktu, którego dotyczy zapytanie.
  • Dane – ga:relatedProductQuantity – liczba powiązanych produktów

Korekta nazwy kolumny nagłówka

  • W wersji 16.04.2014 wystąpił błąd. Jeśli wyślesz zapytanie o wycofany wymiar lub dane, interfejs API zwróci nagłówki kolumn z wymiarem lub danymi zastępczymi. Teraz prawidłowo zwraca tę samą nazwę wymiaru lub rodzaju danych, która została użyta w żądaniu.

W tej wersji dodajemy nowe wymiary i nazwy oraz zmieniamy ich nazwy. Pełną listę definicji znajdziesz w przewodniku po wymiarach i danych.

Nowe wymiary i dane

Do interfejsu Core Reporting API dodaliśmy te wymiary:

AdWords

  • Wymiar – ga:isTrueViewVideoAdYes lub No – wskazuje, czy reklama jest reklamą wideo TrueView w AdWords.

Czas

  • Wymiar – ga:nthHour – indeks dla każdej godziny w wybranym zakresie dat. Indeks dotyczący pierwszej godziny (tj. daty rozpoczęcia) w zakresie dat wynosi 0, 1 dla następnej godziny itd.

Zmiana nazw wymiarów i danych

Nazwa wszystkich wymiarów i danych związanych z użytkownikami i wizytą została zmieniona na użytkownik i sesja.

Zmieniliśmy nazwy tych wymiarów i danych. Szczegółowe informacje o zmianach nazw nazw znajdziesz w Zasadach wycofywania danych:

Odbiorców

  • Wymiar – ga:visitorAgeBracket – użyj zasady ga:userAgeBracket.
  • Wymiar – ga:visitorGender – użyj zasady ga:userGender.

E-commerce

  • Wskaźnik – ga:transactionRevenuePerVisit – zamiast tego użyj ga:transactionRevenuePerSession.
  • Wskaźnik – ga:transactionsPerVisit – zamiast tego użyj ga:transactionsPerSession.

Śledzenie zdarzeń

  • Wskaźnik – ga:eventsPerVisitWithEvent – zamiast tego użyj ga:eventsPerSessionWithEvent.
  • Wskaźnik – ga:visitsWithEvent – zamiast tego użyj ga:sessionsWithEvent.

Konwersje celu

  • Wskaźnik – ga:goalValuePerVisit – zamiast tego użyj ga:goalValuePerSession.
  • Wskaźnik – ga:percentVisitsWithSearch – zamiast tego użyj ga:percentSessionsWithSearch.
  • Wskaźnik – ga:searchVisits – zamiast tego użyj ga:searchSessions.

Śledzenie strony

  • Wskaźnik – ga:pageviewsPerVisit – zamiast tego użyj ga:pageviewsPerSession.

Sesja

  • Wymiar – ga:visitLength – użyj zasady ga:sessionDurationBucket.
  • Wskaźnik – ga:avgTimeOnSite – zamiast tego użyj ga:avgSessionDuration.
  • Wskaźnik – ga:timeOnSite – zamiast tego użyj ga:sessionDuration.
  • Wskaźnik – ga:visitBounceRate – zamiast tego użyj ga:bounceRate.
  • Wskaźnik – ga:visits – zamiast tego użyj ga:sessions.

Interakcje społecznościowe

  • Wymiar – ga:socialInteractionNetworkActionVisit – użyj zasady ga:socialInteractionNetworkActionSession.
  • Wskaźnik – ga:socialInteractionsPerVisit – zamiast tego użyj ga:socialInteractionsPerSession.

Użytkownik

  • Wymiar – ga:daysSinceLastVisit – użyj zasady ga:daysSinceLastSession.
  • Wymiar – ga:visitCount – użyj zasady ga:sessionCount.
  • Wymiar – ga:visitorType – użyj zasady ga:userType.
  • Wymiar – ga:visitsToTransaction – użyj zasady ga:sessionsToTransaction.
  • Wskaźnik – ga:newVisits – zamiast tego użyj ga:newUsers.
  • Wskaźnik – ga:percentNewVisits – zamiast tego użyj ga:percentNewSessions.
  • Wskaźnik – ga:visitors – zamiast tego użyj ga:users.

Segmenty: Core Reporting API 2.4 & v3.0

Obsługa nowych segmentów w interfejsie Core Reporting API.

  • Parametr segment obsługuje teraz segmenty użytkowników i sekwencji. Zapytania dotyczące segmentów na poziomie użytkownika i poziomu sesji utworzonych w interfejsie internetowym możesz wysyłać przy użyciu parametru segment.
  • Dla parametru dynamicznego możesz używać nowej składni, której możesz używać z parametrem segment. Więcej informacji znajdziesz w przewodniku dla programistów dotyczącym segmentów.
  • Prefiks dynamic:: został wycofany. Zalecamy jak najszybsze przejście na nową składnię.

W tej wersji wprowadziliśmy nowy format odpowiedzi w tabeli danych oraz możliwość dodawania i wycofywania wymiarów i danych (pełną listę definicji znajdziesz w artykule Wymiary i dane).

Dane wyjściowe tabeli danych

Aby ułatwić renderowanie danych Google Analytics za pomocą wizualizacji w Grafach Google, interfejs API może w odpowiedzi zwrócić obiekt typu tabela danych.

  • Do interfejsu API został dodany opcjonalny parametr zapytania output. Możesz jej użyć, aby wybrać format wyjściowy danych Analytics w odpowiedzi, który jest domyślnie JSON. Jeśli jest ustawiona na datatable, odpowiedź zawiera właściwość dataTable zawierającą obiekt tabeli danych. Tego obiektu można używać bezpośrednio z Grafami Google. Więcej informacji znajdziesz w dokumentacji interfejsu API do raportowania podstawowego.

Nowe wymiary i dane

Do interfejsu Core Reporting API zostały dodane te wymiary i dane:

Czas

  • Wymiar – ga:minute – zwraca minutę w ciągu godziny. Możliwe wartości muszą się mieścić w przedziale od 00 do 59.
  • Wymiar – ga:nthMinute – indeks dla każdej minuty w wybranym zakresie dat. Indeks dla pierwszej minuty pierwszego dnia (tj. daty rozpoczęcia) w zakresie dat wynosi 0, 1 przez następną minutę itd.

Odbiorców

  • Wymiar – ga:visitorAgeBracket – przedział wiekowy użytkownika.
  • Wymiar – ga:visitorGender – płeć użytkownika.
  • Wymiar – ga:interestAffinityCategory – wskazuje, że użytkownicy są bardziej zainteresowani uzyskaniem informacji o określonej kategorii.
  • Wymiar – ga:interestInMarketCategory – wskazuje, że użytkownicy są bardziej skłonni do zakupu produktów lub usług z określonej kategorii.
  • Wymiar – ga:interestOtherCategory – wskazuje, że użytkownicy chętniej interesują się określoną kategorią i są bardziej skłonni do zakupu.

Wymiary i dane dozwolone w segmentach

W segmentach można teraz używać tych wymiarów i danych:

  • Wymiar – ga:sourceMedium – połączone wartości ga:source i ga:medium.
  • Dane – ga:localItemRevenue – przychody z produktu w walucie lokalnej.

Wycofane wymiary i dane

Te wymiary i dane zostały wycofane. Szczegółowe informacje o usuwaniu danych znajdziesz w Zasadach wycofywania danych:

  • Wymiar – ga:isMobile – użyj zamiast niego ga:deviceCategory (np. ga:deviceCategory==mobile).
  • Wymiar – ga:isTablet – użyj zamiast niego ga:deviceCategory (np. ga:deviceCategory==tablet).
  • Wskaźnik – ga:entranceBounceRate – zamiast tego użyj ga:visitBounceRate.

Ta wersja dodaje do interfejsu API nowe wymiary i dane. Pełną listę definicji znajdziesz w materiałach referencyjnych dotyczących wymiarów i danych.

AdSense

  • Dostęp do danych AdSense został dodany:

    • Meta–ga:adsenseRevenue – łączne przychody z reklam AdSense.
    • Meta–ga:adsenseAdUnitsViewed – liczba wyświetlonych jednostek reklamowych AdSense. Jednostka reklamowa to zestaw reklam wyświetlanych na podstawie jednego kodu reklamy AdSense. Szczegółowe informacje: https://support.google.com/adsense/answer/32715.
    • Meta – ga:adsenseAdsViewed – liczba wyświetlonych reklam AdSense. W jednostce reklamowej może być wyświetlanych wiele reklam.
    • Meta – ga:adsenseAdsClicks – liczba kliknięć reklam AdSense w Twojej witrynie.
    • Meta – ga:adsensePageImpressions – liczba wyświetleń strony, w czasie których reklama AdSense została wyświetlona. Wyświetlenie strony może mieć wiele jednostek reklamowych.
    • Meta – ga:adsenseCTR – procent wyświetleń strony, które zakończyły się kliknięciem reklamy AdSense. (ga:adsenseAdsClicks/ga:adsensePageImpressions)
    • Meta–ga:adsenseECPM – szacowany koszt tysiąca wyświetleń strony. Jest to wartość przychodów z AdSense na 1000 wyświetleń. (ga:adsenseRevenue/(ga:adsensePageImpression/1000).
    • Meta – ga:adsenseExits – liczba sesji, które zakończyły się z powodu kliknięcia reklamy przez użytkownika AdSense.

Czas

  • Przyciemnienie – ga:isoYear – rok ISO wizyty. Szczegółowe informacje: http://en.wikipedia.org/wiki/ISO_week_date ga:isoYear powinien być używany tylko z atrybutem ga:isoWeek, ponieważ ga:week odpowiada kalendarzowi gregoriańskiemu.
  • Przyciemnienie – ga:isoYearIsoWeek – połączone wartości ga:isoYear i ga:isoWeek.

AdWords

  • W raportach AdWords znajdziesz te dane:

    • Przyciemnienie – ga:adKeywordMatchType – typy dopasowania zastosowane do słów kluczowych (do wyrażenia, ścisłe, przybliżone). Więcej informacji: Omówienie raportu wyszukiwanych haseł.

Nowe funkcje kontroli wielkości próbki i daty względne

Względne daty
  • Do interfejsu Core Reporting API dodaliśmy obsługę dat względnych. today, yesterday i NdaysAgo to teraz prawidłowe wartości parametrów zapytania start-date i end-date.
  • Używanie tych wartości automatycznie określa zakres dat na podstawie bieżącej daty wykonania zapytania oraz strefy czasowej widoku (profilu) określonego w zapytaniu. Więcej informacji znajdziesz w dokumentacji API.
Poziom próbkowania
  • Wprowadziliśmy nowy parametr samplingLevel, który umożliwia ustawienie poziomu próbkowania (tj. liczby wizyt używanych do obliczenia wyniku) dla zapytania raportowania. Dozwolone wartości to DEFAULT, FASTER i HIGHER_PRECISION.
  • Do odpowiedzi interfejsu API dodano 2 nowe pola: sampleSize i sampleSpace. Korzystając z tych wartości, możesz obliczyć odsetek wizyt uwzględnionych w próbkowanej odpowiedzi.
  • Więcej informacji znajdziesz w artykułach Dokumentacja API i Próbkowanie.

Poprawki błędów

  • ga:adwordsCustomerID prawidłowo zwraca 10-cyfrowy identyfikator klienta AdWords odpowiadający interfejsowi API AdWords AccountInfo.customerId. Ta poprawka umożliwia łączenie danych Analytics z wieloma kontami AdWords.

Wraz z wprowadzeniem nowych segmentów wprowadzimy w interfejsie Core Reporting API te zmiany.

  • Parametr segment obsługuje teraz nowy identyfikator alfanumeryczny dla niestandardowych segmentów zaawansowanych, który jest zwracany w kolekcji segmentów interfejsu API zarządzania Google Analytics.
  • Bieżące identyfikatory numeryczne segmentów niestandardowych są w trakcie wycofywania. Starsza wersja identyfikatorów będzie nadal obsługiwana przez 6 miesięcy. Zalecamy przełączenie aplikacji, które zapisują identyfikatory segmentów użytkowników, na nowe identyfikatory alfanumeryczne. Po upływie okresu wycofywania zapytania zawierające stare identyfikatory numeryczne będą zwracać błąd.
  • Obecnie za pomocą parametru segment można wysyłać zapytania tylko o segmenty na poziomie wizyty utworzone w interfejsie internetowym.
  • Nie będzie to miało wpływu na istniejące segmenty domyślne z ujemnymi wartościami liczbowymi. Nowe segmenty domyślne nie są jednak obsługiwane.

Ta wersja dodaje do interfejsu API nowe wymiary i dane. Pełną listę definicji znajdziesz w materiałach referencyjnych dotyczących wymiarów i danych.

Śledzenie aplikacji

  • Dane te można znaleźć w raportach profilu aplikacji:
    • Przyciemnienie – ga:appId – identyfikator aplikacji.
    • Przyciemnienie – ga:appInstallerId – identyfikator instalatora (np. Sklepu Google Play), z którego aplikacja została pobrana. Domyślnie identyfikator instalatora aplikacji jest ustawiany za pomocą metody PackageManager#getInstallerPackageName.
    • Przyciemnienie – ga:appName – nazwa aplikacji.
    • Przyciemnienie – ga:appVersion – wersja aplikacji.
    • Przyciemnienie – ga:exitScreenName – nazwa ekranu po zamknięciu aplikacji przez użytkownika.
    • Przyciemnienie – ga:landingScreenName – nazwa pierwszego wyświetlonego ekranu.
    • Przyciemnienie – ga:screenDepth – liczba wyświetleń ekranu na sesję raportowana jako ciąg znaków. Może być przydatna do tworzenia histogramów.
    • Przyciemnienie – ga:screenName – nazwa ekranu.
    • Meta – ga:avgScreenviewDuration – średni czas spędzony przez użytkowników na ekranie w sekundach.
    • Meta–ga:timeOnScreen – czas przeglądania bieżącego ekranu.
    • Meta – ga:screenviews – łączna liczba wyświetleń ekranu. Używaj tej metody zamiast aplikacji ga:appviews.
    • Metka – ga:uniqueScreenviews – liczba różnych (unikalnych) ga:screenviews w sesji. Używaj tej metody zamiast aplikacji ga:uniqueAppviews.
    • Meta–ga:screenviewsPerSession – średnia liczba ga:screenviews na sesję. Używaj tej metody zamiast aplikacji ga:appviewsPerVisit.

Wycofano

Te dane zostały wycofane. Użyj nowej nazwy danych.

  • Meta – ga:appviews – zamiast tego użyj ga:screenviews.
  • Meta – ga:uniqueAppviews – zamiast tego użyj ga:uniqueScreenviews.
  • Meta – ga:appviewsPerVisit – zamiast tego użyj ga:screenviewsPerSession.

Zmienne niestandardowe lub kolumny

  • Dostęp do wymiarów i danych niestandardowych:

    • Przyciemnienie – ga:dimensionXX – nazwa żądanego wymiaru niestandardowego, gdzie XX odnosi się do liczby lub indeksu wymiaru niestandardowego.
    • Meta–ga:metricXX – nazwa żądanych danych niestandardowych, gdzie XX oznacza numer/indeks tych danych.

Zmiany w dokumentacji

Zmieniliśmy nazwy wymiarów i danych zmiennej niestandardowej. Jest to tylko zmiana w dokumentacji, która nie wymaga aktualizacji zapytań.

  • ga:customVarName(n)ga:customVarNameXX
  • ga:customVarValue(n)ga:customVarValueXX

E-commerce

  • Przyciemnienie – ga:currencyCode – kod waluty lokalnej transakcji zgodnie ze standardem ISO 4217.
  • Meta – ga:localItemRevenue – przychody z produktu w walucie lokalnej.
  • Meta – ga:localTransactionRevenue – Przychody z transakcji w walucie lokalnej.
  • Meta – ga:localTransactionShipping – Koszt transakcji w walucie lokalnej.
  • Meta – ga:localTransactionTax – Podatek od transakcji w walucie lokalnej.

Wyjątki

  • Dane te pochodzą ze śledzenia wyjątków.
    • Przyciemnienie – ga:exceptionDescription – opis wyjątku.
    • Metoda – ga:exceptionsPerScreenview – liczba wyjątków, które zostały podzielone przez liczbę wyświetleń ekranu.
    • Meta–ga:fatalExceptionsPerScreenview – liczba wyjątków krytycznych podzielona przez liczbę wyświetleń ekranu.

Konwersje celu

  • Przyciemnienie – ga:goalCompletionLocation – ścieżka strony lub nazwa ekranu pasujące do dowolnego celu związanego z danym miejscem docelowym.
  • Przyciemnienie – ga:goalPreviousStep1 – ścieżka strony lub nazwa ekranu dopasowana do dowolnego typu celu miejsca docelowego, jeden krok przed lokalizacją realizacji celu.
  • Przyciemnienie – ga:goalPreviousStep2 – ścieżka strony lub nazwa ekranu pasujące do dowolnego celu typu miejsca docelowego, na 2 kroki przed lokalizacją realizacji celu.
  • Przyciemnienie – ga:goalPreviousStep3 – ścieżka strony lub nazwa ekranu pasujące do dowolnego celu typu miejsca docelowego, na 3 kroki przed lokalizacją realizacji celu.

Zmiany w dokumentacji

Zmieniliśmy nazwy wymiarów i danych konwersji celu. Jest to tylko zmiana w dokumentacji, która nie wymaga aktualizacji zapytań.

  • ga:goal(n)AbandonRatega:goalXXAbandonRate
  • ga:goal(n)Abandonsga:goalXXAbandons
  • ga:goal(n)Completionsga:goalXXCompletions
  • ga:goal(n)ConversionRatega:goalXXConversionRate
  • ga:goal(n)Startsga:goalXXStarts
  • ga:goal(n)Valuega:goalXXValue
  • ga:searchGoal(n)ConversionRatega:searchGoalXXConversionRate
  • Metoda – ga:percentSearchRefinements – odsetek przypadków zawężenia (tj. przejścia) między słowami kluczowymi w wyszukiwarce wewnętrznej w ramach sesji.

Śledzenie strony

  • Meta–ga:pageValue – średnia wartość tej strony lub zestawu stron. Wartość strony to ((przychody z transakcji + całkowita wartość celu) podzielona przez liczbę niepowtarzalnych odsłon strony lub zestawu stron).

Platforma lub urządzenie

  • Dane te pochodzą z ciągu znaków klienta użytkownika HTTP.

    • Przyciemnienie – ga:deviceCategory – typ urządzenia: komputer, tablet lub telefon komórkowy.
    • Przyciemnienie – ga:isTablet – wskazuje użytkowników tabletu. Możliwe wartości to Yes lub No.
    • Przyciemnienie – ga:mobileDeviceMarketingName – nazwa marketingowa urządzenia mobilnego.

Interakcje społecznościowe

  • Dane te pochodzą ze śledzenia interakcji społecznościowych w witrynie.

    • Przyciemnienie – ga:socialEngagementType – typ zaangażowania. Możliwe wartości: Socially Engaged lub Not Socially Engaged.

Czas

  • Przyciemnienie – ga:dateHour – połączone wartości ga:date i ga:hour.
  • Przyciemnienie – ga:dayOfWeekName – nazwa dnia tygodnia (w języku angielskim).
  • Ciemna – ga:isoWeek – numer tygodnia w standardzie ISO, gdzie każdy tydzień zaczyna się od poniedziałku. Szczegółowe informacje: http://en.wikipedia.org/wiki/ISO_week_date
  • Przyciemnienie – ga:yearMonth – połączone wartości ga:year i ga:month.
  • Przyciemnienie – ga:yearWeek – połączone wartości ga:year i ga:week.

Źródła wizyt

  • Przyciemnienie – ga:fullReferrer – pełny adres URL strony odsyłającej razem z nazwą hosta i ścieżką.
  • Przyciemnienie – ga:sourceMedium – łączne wartości ga:source i ga:medium.
  • W tej wersji dodaliśmy 5 nowych wskaźników szybkości witryny:
    • ga:domInteractiveTime
    • ga:avgDomInteractiveTime
    • ga:domContentLoadedTime
    • ga:avgDomContentLoadedTime
    • ga:domLatencyMetricsSample
  • W tej wersji dodano nowy segment domyślny dla ruchu z tabletów: gaid::-13.

Ta wersja dodaje do interfejsu API nowe wymiary i dane. Definicje znajdziesz tutaj.

Śledzenie aplikacji

  • Dane te można znaleźć w raportach pakietu SDK do śledzenia aplikacji mobilnych:
    • Meta – ga:uniqueAppviews – liczba wyświetleń aplikacji na sesję.
    • Meta – 'ga:appviews – łączna liczba wyświetleń aplikacji.
    • Meta – ga:appviewsPerVisit – średnia liczba wyświetleń aplikacji na sesję.

Źródła wizyt

  • Przyciemnienie – ga:socialNetwork – ciąg znaków reprezentujący nazwę sieci społecznościowej. Może to być powiązane z odsyłającą siecią społecznościową dla źródeł wizyt lub społecznością związaną z centrum danych społecznościowych. Np. Google+, Blogger, reddit itp.
  • Przyciemnienie – ga:hasSocialSourceReferral oznacza wizyty w witrynie społecznościowej (np. z Google+, Facebooka, Twittera itp.). Możliwe wartości to Tak lub Nie. Pierwsza litera musi być wielka.

Działania społecznościowe

  • Te dane pochodzą z aktywności poza witryną zaimportowanej od partnerów centrum danych społecznościowych.
    • Przyciemnienie – ga:socialActivityDisplayName – w przypadku aktywności centrum danych społecznościowych ten ciąg reprezentuje tytuł aktywności w mediach społecznościowych opublikowanej przez użytkownika.
    • Przyciemnienie – ga:socialActivityEndorsingUrl – w przypadku aktywności w centrum danych społecznościowych ten ciąg reprezentuje adres URL działania społecznościowego (np. adres URL posta w Google+, adres URL komentarza na blogu itd.)
    • Przyciemnienie – ga:socialActivityPost – w przypadku aktywności centrum danych społecznościowych ten ciąg reprezentuje treść działania społecznościowego opublikowanego przez użytkownika sieci społecznościowej (np.treść wiadomości w poście w Google+).
    • Przyciemnienie – ga:socialActivityTimestamp – w przypadku aktywności centrum danych społecznościowych ten ciąg znaków wskazuje, kiedy aktywność społecznościowa pojawiła się w sieci społecznościowej.
    • Przyciemnienie – ga:socialActivityUserPhotoUrl – w przypadku aktywności centrum danych społecznościowych ten ciąg reprezentuje adres URL zdjęcia powiązanego z profilem sieci społecznościowej użytkownika.
    • Przyciemnienie – ga:socialActivityUserProfileUrl – w przypadku aktywności centrum danych społecznościowych ten ciąg reprezentuje adres URL profilu sieci społecznościowej użytkownika.
    • Przyciemnienie – ga:socialActivityContentUrl – w przypadku aktywności centrum danych społecznościowych ten ciąg reprezentuje adres URL udostępniony przez powiązanego użytkownika sieci społecznościowej.
    • Przyciemnienie – ga:socialActivityTagsSummary – w przypadku aktywności centrum danych społecznościowych jest to zestaw rozdzielonych przecinkami tagów powiązanych z aktywnością w mediach społecznościowych.
    • Przyciemnienie – ga:socialActivityUserHandle – w przypadku aktywności centrum danych społecznościowych ten ciąg reprezentuje nazwę sieci społecznościowej (tzn. nazwę) użytkownika, który zainicjował działanie społecznościowe.
    • Przyciemnienie – ga:socialActivityAction – w przypadku aktywności centrum danych społecznościowych ten ciąg reprezentuje typ interakcji społecznościowej powiązanej z aktywnością (np. zagłosowanie, dodanie komentarza, +1 itp.).
    • Przyciemnienie – ga:socialActivityNetworkAction – w przypadku aktywności centrum danych społecznościowych ten ciąg reprezentuje typ interakcji społecznościowej i sieć społecznościową, z której ona pochodzi.
    • Meta – ga:socialActivities – liczba działań, w których dany adres URL treści został udostępniony lub wspomniany w sieci partnera z centrum danych społecznościowych.

Interakcje społecznościowe

  • Dane te pochodzą ze śledzenia interakcji społecznościowych w witrynie.
    • Przyciemnienie – ga:socialInteractionAction – w przypadku interakcji społecznościowych ciąg znaków, który odzwierciedla śledzone działanie społecznościowe (np. +1-ka, polubienie, zakładka)
    • Przyciemnienie – ga:socialInteractionNetwork – w przypadku interakcji społecznościowych ciąg znaków reprezentujący sieć społecznościową, którą chcesz śledzić (np. Google, Facebook, Twitter, LinkedIn)
    • Przyciemnienie – ga:socialInteractionNetworkAction – w przypadku interakcji społecznościowych ciąg znaków reprezentujący połączenie śledzonych wartości ga:socialInteractionNetwork i ga:socialInteractionAction (np. Google: +1, Facebook: polubienia)
    • Przyciemnienie – ga:socialInteractionTarget – w przypadku interakcji społecznościowych ciąg znaków reprezentujący adres URL (lub zasób), który otrzymuje działanie w sieci społecznościowej.
    • Meta–ga:socialInteractions – łączna liczba interakcji społecznościowych w Twojej witrynie.
    • Meta–ga:uniqueSocialInteractions – łączna liczba unikalnych interakcji społecznościowych w Twojej witrynie. Na podstawie pary wartości ga:socialInteractionNetwork i ga:socialInteractionAction
    • Meta – ga:socialInteractionsPerVisitga:socialInteractions / ga:uniqueSocialInteractions. Średnia liczba interakcji społecznościowych podczas wizyty w Twojej witrynie.

Dane geograficzne / sieć

  • Przyciemnienie – ga:metro – rynek docelowy (DMA), z którego pochodzi ruch.

Śledzenie strony

  • Przyciemnienie – ga:pagePathLevel1 – ten wymiar przenosi wszystkie wartości parametru pagePath w pierwszym poziomie hierarchii w ścieżce pagePath.
  • Przyciemnienie – ga:pagePathLevel2 – ten wymiar obejmuje wszystkie ścieżki pagePath na drugim poziomie hierarchii w ścieżce pagePath.
  • Przyciemnienie – ga:pagePathLevel3 – ten wymiar obejmuje wszystkie ścieżki pagePath na trzecim poziomie hierarchii w ścieżce pagePath.
  • Przyciemnienie – ga:pagePathLevel4 – ten wymiar obejmuje wszystkie ścieżki pagePath na 4. poziomie hierarchii w ścieżce pagePath. Wszystkie dodatkowe poziomy w hierarchii pagePath są również zbierane w tym wymiarze.

Śledzenie wyjątków

  • Dane te pochodzą z danych śledzenia wyjątków.

    • Metka – ga:exceptions – liczba wyjątków wysłanych do Google Analytics.
    • Metoda – ga:fatalExceptions – liczba wyjątków, gdzie isFatal ma wartość true (prawda).

Czas działań użytkownika

  • Te dane pochodzą z danych o czasie użytkownika.

    • Przyciemnienie – ga:userTimingCategory – ciąg umożliwiający sklasyfikowanie wszystkich zmiennych czasu użytkownika w grupy logiczne, co ułatwia raportowanie.
    • Przyciemnienie – ga:userTimingLabel – ciąg określający nazwę działania śledzonego zasobu.
    • Przyciemnienie – ga:userTimingVariable – ciąg, którego można użyć do wizualizacji czasu użytkownika w raportach.
    • Przyciemnienie – ga:userTimingValue liczba milisekund w czasie, który upłynął do wysłania do Google Analytics.
    • Metka – ga:userTimingSample – liczba wysłanych próbek.
    • Meta – ga:avgUserTimingValue – średnia wartość czasu użytkownika. ga:userTimiingValue / ga:userTimiingSample.

Urządzenie / platforma

  • Dane te pochodzą od klienta użytkownika zebranych danych.
    • Przyciemnienie – ga:mobileDeviceBranding – nazwa producenta telefonu lub marka (na przykład: Samsung, HTC, Verizon, T-Mobile).
    • Przyciemnienie – ga:mobileDeviceModel – model urządzenia mobilnego (przykład: Nexus S)
    • Przyciemnienie – ga:mobileInputSelector – selektor używany na urządzeniu mobilnym (np. ekran dotykowy, joystick, kółko do kliknięcia, rysik).
    • Dim - ga:mobileDeviceInfo – marka, model i nazwa marketingowa, dzięki którym można zidentyfikować urządzenie mobilne.

Poprawki błędów

  • Interfejs API prawidłowo obsługuje znaki UTF-8 w filtrze lub segmencie dynamicznym.

Dzięki tej wersji konta premium Google Analytics mają dostęp do maksymalnie 50 zmiennych niestandardowych.

W tej wersji poprawiono 2 błędy:

Poprawki błędów

  • Filtry zapytań zawierające znaki specjalne wewnątrz wyrażeń regularnych nie zwracają już błędów serwera.

  • Łączenie filtra danych z segmentem zaawansowanym nie powoduje już błędu.

W tej wersji do interfejsu API dodano nowe dane o szybkości witryny.

Nowe dane

  • Dodaliśmy te dane dotyczące szybkości witryny:
    • ga:speedMetricsSample
    • ga:domainLookupTime
    • ga:pageDownloadTime
    • ga:redirectionTime
    • ga:serverConnectionTime
    • ga:serverResponseTime
    • ga:avgDomainLookupTime
    • ga:avgPageDownloadTime
    • ga:avgRedirectionTime
    • ga:avgServerConnectionTime
    • ga:avgServerResponseTime

Definicje znajdziesz tutaj.

Przypomnienie o wycofaniu interfejsu API w wersji 2.3

  • Interfejs API eksportu danych w wersji 2.3 został wycofany od 2 miesięcy. Za około 4 miesiące wyłączymy tę usługę i będziemy obsługiwać tylko nową wersję 3.0 i wersję 2.4 interfejsu API podstawowego raportowania.

  • Zdecydowanie zalecamy migrację aplikacji do wersji 3.0.

  • W ciągu 4 miesięcy żądania do starszej wersji pliku danych w formacie XML 2.3 zostaną przekazane do wersji 2.4 i zostaną zwrócone odpowiedź XML w wersji 2.4. Od tego momentu wszystkie zasady dotyczące limitu wersji 2.4 będą miały zastosowanie do żądań wersji 2.3.

  • Wszystkie żądania dotyczące kodu JSON w wersji 2.3 lub biblioteki klienta JavaScript danych Google korzystających z danych wyjściowych JSON w wersji 2.3 będą zwracać kody stanu 404.

  • Aby uzyskać pełny limit, zarówno w wersji 3.0, jak i 2.4, musisz zarejestrować aplikację w konsoli interfejsów API Google i używać klucza interfejsu API (lub tokena OAuth 2.0) w każdym żądaniu.

Naprawiliśmy mały błąd z usługą ga:visitLength. Ten wymiar zwraca teraz prawidłowe dane.

Ta wersja dotyczy wszystkich deweloperów interfejsu Google Analytics API. Ogłosa 2 nowe wersje interfejsu API, wymaga aplikacji do rejestracji, wprowadza nową zasadę dotyczącą limitu oraz zmienia nazwę interfejsu API na interfejs Core Reporting API. W końcu wycofamy istniejący interfejs Data Export API w wersji 2.3.

Versja 3.0

  • Interfejs Core Reporting API 3.0 to najnowsza główna wersja interfejsu API, która nie jest zgodna wstecznie. Wszystkie przyszłe zmiany interfejsu API będą realizowane w tej wersji.

  • Nowe funkcje

  • Aktualizacje

    • Nowy adres URL do przesyłania żądań: https://www.googleapis.com/analytics/v3/data/ga….
    • Tokeny rejestracji i dewelopera są wymagane.
    • Żądania danych konfiguracji należy dokonywać za pomocą interfejsu API do zarządzania.

Wersja 2.4

  • Interfejs Core Reporting API w wersji 2.4 to drobna aktualizacja, która jest głównie zgodna wstecznie z dotychczasową wersją interfejsu Data Export API w wersji 2.3.

  • Aktualizacje

    • Nowy adres URL do przesyłania żądań: https://www.googleapis.com/analytics/v2.4/data…
    • Tokeny rejestracji i dewelopera są wymagane.
    • Format XML jest zgodny z wersją 2.3, więc pozostałe biblioteki klienta danych Google będą nadal działać.
    • Kod błędu błędów limitu został zmieniony z 503 na 403
    • Odpowiedzi JSON nie są obsługiwane.
    • Biblioteka klienta JavaScript danych Google nie jest obsługiwana.
    • Brak pliku danych na koncie. Żądania danych konfiguracji należy dokonywać za pomocą interfejsu API do zarządzania.

Rejestracja

  • Wszystkie aplikacje utworzone przy użyciu interfejsu API Google Analytics muszą być zarejestrowane jako projekt w konsoli Google API.

  • Każde żądanie do interfejsu API musi zawierać klucz interfejsu API lub OAuth 2.0 (identyfikator klienta i tajny klucz klienta).

Zasady dotyczące limitów

  • Ten limit dotyczy zarówno interfejsów API Anlaytics, jak i interfejsu Data Management API

    • 50 tys. żądań na projekt dziennie
    • 10 zapytań na sekundę (QPS) na adres IP.
  • Poniższe limity dotyczą interfejsu Data Export API

    • 10 000 żądań na profil dziennie
    • 10 równoczesnych żądań na profil
  • W przypadku niezarejestrowanych aplikacji oferujemy bardzo niski limit prolongaty, aby obsłużyć niewielką liczbę testów.

Wycofywanie

  • Ogłosiliśmy też wycofanie wersji 2.3 i nadchodzącego wyłączenia pliku danych na koncie w interfejsie API eksportu danych. Za 6 miesięcy:

    • Żądania do pliku danych w formacie 2.3 XML będą przekierowywane do wersji 2.4 i zwracane w ten sposób odpowiedzi. Od tego momentu wszystkie zasady dotyczące limitu wersji 2.4 będą miały zastosowanie do żądań wersji 2.3.

    • Żądania wysyłane do danych JSON w wersji 2.3 nie będą obsługiwane w odpowiedzi na tę wersję i będą zwracać kody stanu 404 Not Found. Jeśli potrzebujesz odpowiedzi JSON, przejdź na wersję 3.0.

    • Żądania przesłane do pliku danych na koncie w interfejsie Data Export API będą zwracać kody stanu (404 Not Found). Żądania danych konfiguracji należy dokonywać za pomocą interfejsu API do zarządzania.

W tej wersji udostępniamy najnowsze dane AdWords i więcej kombinacji wymiarów i danych AdWords.

  • Dane AdWords są teraz aktualizowane w ciągu godziny. Zanim dane zostały zaktualizowane codziennie.

  • Złagodziliśmy liczne prawidłowe ograniczenia kombinacji danych AdWords.

Kilka tygodni temu wprowadziliśmy zmianę zabraniającą wysyłania zapytań do interfejsu API z prośbą o ga:adGroup lub ga:adContent przy użyciu ga:impressions, ponieważ ta kombinacja zwraca 0. Dzięki tej zmianie ta kombinacja jest już z powrotem i naprawiła błąd.

W tej wersji poprawiono niektóre nieprawidłowe kombinacje wymiarów i danych.

Poprawiono nieprawidłowe kombinacje danych i wymiarów.

  • W zeszłym miesiącu ogłosiliśmy nadchodzące zmiany w interfejsie API, aby zapobiec wyświetlaniu niektórych nieprawidłowych zapytań w plikach danych, które nie zwracają żadnych danych. Wprowadziliśmy te zmiany w interfejsie API, a te kombinacje są nieprawidłowe:

    • Wymiarów produktu nie można łączyć z danymi transakcji.
    • ga:adContent lub ga:adGroup nie można połączyć z ga:impressions.

    Zamiast zwracać odpowiedź z 0 wynikami, interfejs API zwraca teraz 400 kodu błędu w przypadku wszystkich zapytań, które proszą o te kombinacje.

Ta wersja wycofa wartość przedziału ufności w danych.

Wycofanie przedziału ufności

  • Przestań stosować wartości przedziału ufności danych. W tej wersji plik danych do interfejsu Data Export API zwraca wartość 0, 0 dla wszystkich wartości przedziału ufności. Za około miesiąc usuniemy ten atrybut ze wszystkich elementów.

    Aby określić, czy odpowiedź jest próbkowana, użyj w niej pola containSampledData.

W tej wersji dodano 3 nowe dane i zaktualizowano wartość zwrotną równą 2.

Nowe aktualizacje danych

  • Dodaliśmy do interfejsu API 3 nowe dane dotyczące szybkości witryny:
    • ga:pageLoadSample
    • ga:pageLoadTime
    • ga:avgPageLoadTime

Aktualizacje danych

  • Aby określić wartości waluty w filtrach, musisz podać faktyczną wartość przekazaną z kodu śledzenia (np. 1 jednostka będzie teraz oznaczona jako 1).

  • ga:CTR zwraca teraz rzeczywisty procent (np. wartość 2% jest zwracana jako 2).

Ta wersja poprawia wydajność pliku danych i dodaje nowe dane:

Poprawa wydajności

  • Ta wersja zwiększa opóźnienie pliku danych o 30–35%.

Nowe aktualizacje danych

  • Zaktualizowaliśmy listę wymiarów i danych, które są dozwolone w segmentach zaawansowanych. Sprawdź na zaktualizowanej liście, czy Twoje żądania są prawidłowe.

Nadchodzące zmiany

  • Obecnie musisz określić wartość filtra walut w mikrojednostkach (np.1 jednostka waluty jest podawana jako 1000000). W najbliższej przyszłości konieczne będzie określenie rzeczywistej wartości przekazanej z kodu śledzenia (np. 1 jednostka będzie teraz oznaczona jako 1).

  • Obecnie ga:CTR to percent i zwraca wartość 0, 02. W najbliższej przyszłości liczba ta będzie się zwracała do wartości procentowej (np. 2).

Ta wersja zawiera więcej danych w pliku danych:

Nowe aktualizacje danych

  • Dodano ten wymiar Czas: ga:dayOfWeek

  • Dodano te dane dotyczące wyszukiwania wewnętrznego: ga:percentVisitsWithSearch

  • Dodano te dane śledzenia zdarzeń:

    • ga:visitsWithEvent
    • ga:eventsPerVisitWithEvent

Nadchodzące zmiany

Obecnie interfejs API zwraca 401 kod stanu dla różnych problemów z autoryzacją. W ciągu kilku najbliższych tygodni stan 401 będzie używany tylko w przypadku nieprawidłowych tokenów, dzięki czemu deweloperzy będą mogli naprawić ten konkretny wyjątek.

Ta wersja zawiera znacznie więcej danych w pliku danych:

Nowe aktualizacje danych

  • Zmieniliśmy obliczenie wartości ga:visitors, by zwracać liczbę unikalnych użytkowników w zakresie dat. Obsługujemy też więcej kombinacji wymiarów i danych.

  • Dodano 10 nowych wymiarów AdWords: ga:adDistributionNetwork, ga:adMatchType, ga:adMatchedQuery, ga:adPlacementDomain, ga:adPlacementUrl, ga:adFormat, ga:adTargetingType, ga:adTargetingOption, ga:adDisplayUrl, ga:adDestinationUrl.

  • Dane ga:organicSearches zostały dodane do grupy kampanii.

  • Dane ga:searchResultViews zostały dodane do wewnętrznej grupy wyszukiwań w witrynie.

  • Dodano 3 nowe wymiary na podstawie czasu: ga:nthDay, ga:nthWeek, ga:nthMonth.

  • Grupowanie wymiarów i danych zostało lepiej dopasowane do funkcji, które reprezentują.

Nowe obliczone dane

Poniższe obliczone dane pochodzą z obliczeń przy użyciu danych podstawowych. Uwaga: każda nazwa z (n) obsługuje wartości 1–20.

  • Oparte na celu: ga:costPerConversion, ga:costPerGoalConversion, ga:costPerTransaction, ga:goal(n)AbandonRate, ga:goal(n)Abandons, ga:goal(n)ConversionRate, ga:goalAbandonRateAll, ga:goalAbandonsAll, ga:goalConversionRateAll, ga:goalValueAllPerSearch, ga:goalValuePerVisit.

  • Na podstawie treści: ga:entranceBounceRate, ga:visitBounceRate, ga:entranceRate, ga:exitRate, ga:pageviewsPerVisit, ga:avgTimeOnPage, ga:avgTimeOnSite, ga:avgEventValue.

  • Na podstawie wewnętrznej wyszukiwarki w witrynie: ga:avgSearchDepth, ga:avgSearchDuration, ga:avgSearchResultViews, ga:searchGoalConversionRateAll, ga:searchGoal(n)ConversionRate, ga:searchExitRate.

  • E-commerce oparte na: ga:itemsPerPurchase, ga:margin, ga:percentNewVisits, ga:revenuePerItem, ga:revenuePerTransaction, ga:ROI, ga:RPC, ga:totalValue, ga:transactionRevenuePerVisit, ga:transactionsPerVisit.

W tej wersji dodaliśmy nową funkcję do pliku danych:

Nowe funkcje

  • Dodaliśmy nowy element XML, który informuje użytkowników o spróbkowaniu danych. true. Ten element zawsze zwraca informację o tym, czy dane są próbkowane, czy nie za pomocą typu true lub false. Biblioteki Java i JavaScript zostały też zaktualizowane o metody pomocnicze, aby uzyskać dostęp do tego elementu.

W tej wersji poprawiono 2 błędy:

Poprawki błędów

  • Wcześniej dodano do operatora filtr operatora LUB z wymiarem (np. ga:keyword==store,ga:keyword==bar) mogłoby uzyskać inne wartości niż te, które byłyby stosowane w przypadku wielu zapytań. Rozwiązaliśmy już ten problem, a operator OR zwraca teraz spójne wartości.

  • Niektóre komunikaty o błędach interfejsu API dotyczące nieprawidłowych filtrów zostały zaktualizowane tak, aby NIE zawierały informacji o filtrze wymiaru lub danych, które spowodowały błąd (chociaż same wyrażenie filtra nadal będzie zwracane).

W tej wersji poprawiono 3 błędy:

Poprawki błędów

  • Problem z kodowaniem w Bibliotece klienta JavaScript został rozwiązany. Narzędzie do śledzenia problemów z Analytics

  • Naprawiliśmy błąd, który uniemożliwiał zwracanie pliku danych konta, gdy nazwa celu, ścieżka celu, wartość porównawcza celu lub typ porównania celów była nieprawidłowo ustawiona.

  • Nieprawidłowa wartość LUB dla wymiaru lub danych w parametrze filtra zapytania w pliku danych. Na przykład: ga:source==google,ga:visits>5. Komunikat o błędzie dotyczący tego nieprawidłowego zapytania został zmieniony: Cannot OR dimension filter(s) with metric filter.

Ta wersja dodaje nowe dane i poprawia błąd:

Nowe funkcje

  • W nowej kategorii D8. Adwords dodaliśmy 5 wymiarów:

    • ga:adwordsAdGroupId: odpowiada identyfikatorowi AdGroup.id interfejsu API AdWords
    • ga:adwordsCampaignId: odpowiada identyfikatorowi Campaign.id interfejsu API AdWords
    • ga:adwordsCreativeId: odpowiada identyfikatorowi Ad.id interfejsu API AdWords
    • ga:adwordsCriteriaId: odpowiada atrybutowi criteria.id interfejsu API AdWords
    • ga:adwordsCustomerId: odpowiada adresowi AccountInfo.customerId interfejsu API AdWords

Poprawki błędów

  • Naprawiliśmy problem polegający na tym, że plik danych konta nie zwracał danych, jeśli jeden z profili miał błędnie skonfigurowany cel lub krok.

W tej wersji dodaliśmy kilka nowych funkcji i naprawiliśmy błąd:

Nowe funkcje

  • Domyślny segment iPhone'a (gaid::-11) został rozszerzony o raporty na wszystkich urządzeniach mobilnych. Identyfikator jest taki sam jak wcześniej (-11), ale nazwa segmentu to teraz Mobile Traffic.

  • Częstotliwość próbkowania używana przez interfejs API jest teraz taka sama jak w interfejsie internetowym. Spowoduje to wstawienie danych z próbkowanych raportów w interfejsie internetowym i zwiększy spójność między nimi.

  • Zaktualizowaliśmy zasady dotyczące limitów, aby zapewnić wszystkim użytkownikom równy dostęp do zasobów. Więcej informacji znajdziesz w dokumentacji zasad limitu. Nowe zasady:

    • Pojedyncza usługa internetowa może wysłać maksymalnie 10 000 żądań w ciągu 24 godzin.
    • Aplikacja może wysłać tylko 10 żądań w ciągu 1 sekundy.
    • Aplikacja może mieć jednocześnie maksymalnie 4 oczekujące prośby.
  • Niektóre ograniczenia wymiarów i danych zostały złagodzone. ga:nextPagePath i ga:previousPagePath należą teraz do grupy D3. Content. Grupa D8. Custom Variable to teraz grupa D6. Custom Variable. Informacje o tych nowych kombinacjach znajdziesz w zaktualizowanym przewodniku.

Poprawki błędów

  • Naprawiliśmy błąd polegający na tym, że interfejs API raportował wartość confidenceInterval danych. Wcześniej przedziały ufności mogą mieć wartość INF lub liczbę z zakresu od 0 do 1. Teraz wszystkie przedziały ufności będą mieć wartość INF lub liczbę większą lub równą 0.

  • Reguły ga:itemQuantity i ga:uniquePurchases były wcześniej zamieniane i zwracały wartość. Są już naprawione i zwracają prawidłowe dane.

Wycofanie wymiarów i danych

  • Przerwij używanie dotychczasowych wymiarów i danych

W tej wersji wprowadzono wiele nowych funkcji:

Ta wersja zwiększa numer wersji głównej do 2

  • Niektóre funkcje wymagają korzystania z najnowszych bibliotek klienta. oficjalnie obsługujemy: Java & JavaScript. Biblioteki innych firm mogą nie być jeszcze aktualizowane.

    • Aby poprosić o wersję 2, dodaj nagłówek GData-Version: 2 do każdego konta lub żądania pliku danych. Więcej informacji znajdziesz w dokumentacji.
    • Nowa przestrzeń nazw XML została dodana do konta i plików danych:
      xmlns:ga='http://schemas.google.com/ga/2009'
  • Interfejs API obsługuje teraz wersję 2 protokołu danych Google.

Zaawansowana obsługa segmentacji

  • Parametr zapytania segmentów dynamicznych:

    • ...&segment=dynamic::wyrażenie
    • umożliwia tworzenie zaawansowanych segmentów na bieżąco.
    • wyrażenie może być dowolnym wymiarem lub danymi i powinno mieć taką samą składnię jak filtry.
  • Domyślny i niestandardowy segment zapytań:

    • ...&segment=gaid::numer
    • gdzie liczba to identyfikator odnoszący się do zaawansowanego segmentu zdefiniowanego w interfejsie internetowym Google Analytics.
    • Identyfikator znajdziesz w pliku danych na koncie.
  • Plik danych na koncie opisuje dane segmentu za pomocą tych elementów i atrybutów XML:

    • ga:visitorType==Returning Visitor
  • Plik danych zawiera też element XML, który wskazuje, czy segment został zastosowany w żądaniu interfejsu API.

  • Więcej informacji o segmentach zaawansowanych znajdziesz w dokumentacji.

Dostępne są nowe dane celów

  • Cele związane z miejscami docelowymi i typami zaangażowania dostępne w pliku danych na koncie:

  • W celach 5–20 dodaliśmy 48 nowych danych zgodnych z konwencją goal(n)Completions, gdzie (n) to liczba z zakresu od 1 do 20.

    • ga:goal(n)Completions
    • ga:goal(n)Starts
    • ga:goal(n)Value
  • Zaktualizowano cel GoalCompletionAll, GoalStartsAll i GoalValueAll, by uwzględnić nowe dane celu.

Nowe dane zmiennej niestandardowej

  • Wszystkie zmienne niestandardowe zebrane przez każdy profil zostały dodane jako nowy element XML do pliku danych na koncie:

  • Dodaliśmy 10 nowych wymiarów zmiennych niestandardowych. Są one zgodne z konwencją customVar(n), gdzie (n) może być liczbą od 1 do 5.

    • ga:customVarName(n)
    • ga:customVarValue(n)

Wycofany wymiar & dane do usunięcia!

  • Jeśli Twoje wymiary i dane nie są już używane, przestań ich używać. Zostaną one wkrótce usunięte i w razie potrzeby zwrócą błędy z naszego interfejsu API.

    • ga:countOfVisits
    • ga:countOfVisitsToATransaction
    • ga:sourceMedium
    • ga:percentNewVisits
  • Nazwy tych wymiarów zostały zmienione:

    • ga:countOfVisits to teraz ga:visitCount
    • ga:countOfVisitsToATransaction to teraz ga:visitsToTransaction

W tej wersji dodaliśmy nowe funkcje i wycofaliśmy niektóre stare funkcje:

  • Te wymiary i dane zostały wycofane. Za miesiąc usuniemy je z interfejsu API. Zaktualizuj kod, aby aplikacje nie ulegały awarii:

    • ga:countOfWizyty
    • ga:countOfvisitsAATransakcja
    • ga:sourceMedium
    • ga:percentNewVisits
  • Zmieniły się nazwy tych wymiarów:

    • ga:countOfvisits to teraz ga:visitCount
    • ga:countOfvisitsToATransaction to teraz ga:visitsToTransaction
  • Wszystkie dane śledzenia zdarzeń są teraz wyświetlane jako 2 nowe grupy:

    D7. Zdarzenia (Wymiary) * ga:eventCategory * ga:eventAction * ga:eventLabel

    M7. Zdarzenia (dane) * ga:eventValue * ga:totalEvents * ga:unikalne zdarzenia

  • Ogólne dane nawigacji w witrynie są teraz wyświetlane w tych wymiarach:

    D6. Nawigacja * ga:previousPagePath * ga:nextPagePath

  • Nawigacja na stronie docelowej wyświetla się teraz w tych wymiarach:

    D3. Treść * ga:landingPagePath * ga:secondPagePath

  • Maksymalna długość wyrażenia regularnego w parametrze filtra pliku danych została zwiększona z 32 do 128 znaków.

  • Raport Długość wizyty (dostępny w interfejsie użytkownika w sekcji „Użytkownicy – lojalność użytkowników”) jest teraz dostępny w nowym wymiarze:

    • ga:visitLength

Ta wersja aktualizuje interfejs API eksportu danych Google Analytics w ten sposób:

  • Niektóre ograniczenia wymiarów i danych zostały złagodzone. Teraz możesz wysyłać zapytania dotyczące większości treści i wymiarów na poziomie użytkownika, np. ga:pagePath i ga:source są teraz prawidłową kombinacją. Zapoznaj się ze zaktualizowanym przewodnikiem po tych nowych kombinacjach: http://code.google.com/apis/analytics/docs/gdata/gdataReferencevalidCombos.html

  • Zwiększyliśmy liczbę wierszy, o które można wysłać w jednym żądaniu, do 10 000. Domyślna liczba zwróconych wierszy to nadal 1000,ale można ją zwiększyć, ustawiając parametr zapytania max-results.

  • Plik danych konta zawiera teraz 2 nowe elementy danych dla każdego identyfikatora tabeli (waluta i strefa czasowa).

  • Obecnie egzekwujemy, że zapytania o dane muszą zawierać co najmniej 1 prawidłowy rodzaj danych.

  • Zmiany dotyczące wycofywania zostały zastosowane.

Ta wersja usuwa wycofane funkcje z naszej prywatnej wersji beta:

  • Żądania dotyczące pliku danych na koncie nie będą już obsługiwać nazw użytkowników. Zamiast tego będą akceptować prośby tylko w tym formacie:
    https://www.google.com/analytics/feeds/accounts/default

  • Poniższe dane są usuwane i przestaną działać. Zamiast tego postępuj zgodnie z instrukcjami dotyczącymi obliczania tych wartości tutaj: http://code.google.com/apis/analytics/docs/gdata/gdataReferenceCommonCalculations.html

    • ga:avgPageDuration
    • ga:śr. odsłon
    • ga:avgSessionTime
    • ga:bounceRate
    • ga:exitRate
    • ga:costPerConversion
    • ga:costPerGoalConversion
    • ga:costPerTransaction
    • ga:przychodyNakliknięcie
    • ga:revenuePerTransaction
    • ga:przychodyNa wizytę
    • ga:abandonedFunnel1
    • ga:abandonedFunnels2
    • ga:abandonedFunnels3
    • ga:abandonedFunnels4
    • ga:goalConversionRate
    • ga:goalConversionRate1,
    • ga:goalConversionRate2,
    • ga:goalConversionRate3,
    • ga:goalConversionRate4
    • ga:goalValuePerVisit
  • Zmieniliśmy nazwy tych wymiarów i danych. Stare nazwy przestaną działać. Upewnij się, że używasz oficjalnych nazw w naszej dokumentacji tutaj: http://code.google.com/apis/analytics/docs/gdata/gdataReferenceMetricMetrics.html

    Jaki jest zamieszku na takim na swojej takim Upewnij takim na Śmiem swojej takim Śmiem zamiast swojej lepsze najlepsze lepsze takie znajduje swoje swoje swoje swoje działa uzyskać swoje przez swojemu rozmu Opcja swoje swojemu swojego swojemu swojego za swojego swojego swoje swoje zawsze dodatek,, danej, danej, należy, należy składa za można danej wdrażania,, danej, danej, danej, Użytkownicy, można, można danej danej, wybranej, wybranej, wybranej, wybranej, wybranej, wybranej, wybranej, wybranej,eksekseksulej,krej każdej, zakłada wyłączyć każdej wyłączyć wyłączyć wyłączyć znaleźć żadna znaleźć, szczegółowe, znaleźć specjalisty,......... można znaleźć znaleźć znaleźć za.k.......

    jak działają,