Historia zmian interfejsu API podstawowego raportowania Google Analytics

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

Na tej stronie znajdziesz wszystkie zmiany wprowadzone w interfejsie Google Analytics Core Reporting API, które mogą mieć wpływ na Twoją aplikację. Zalecamy, aby deweloperzy interfejsów 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.

Zasubskrybuj powiązane dzienniki zmian

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

Obejmuje interfejs API podstawowego raportowania, interfejs 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 pojedynczym identyfikatorem Client-ID lub User-ID w wybranym zakresie dat. Jest ona przeznaczona przede wszystkim dla właścicieli usług, którzy chcą zapewnić automatyczny dostęp do danych użytkownika bezpośrednio tym użytkownikom. Więcej informacji znajdziesz w przewodniku po interfejsie User Activity API.

W tej wersji system limitów opartych na zasobach na potrzeby interfejsu Google Analytics Reporting API w wersji 4 jest dostępny dla wszystkich klientów Analytics 360 (Premium).

W tej wersji zwiększa się maksymalna liczba wierszy zwracanych w zestawie wyników interfejsu Analytics Reporting API w wersji 4.

Maksymalna liczba wierszy zwracanych w obiekcie Analytics Reporting API w wersji 4 została zwiększona z 10 000 do 100 000.

W tej wersji dodaliśmy podgląd systemu limitów opartego na zasobach do interfejsu Google Analytics Reporting API w wersji 4, który umożliwia korzystanie z wyższych progów próbkowania w przypadku klientów Analytics 360 (Premium).

W tej wersji wycofujemy funkcję Produkty powiązane oraz powiązane z nią wymiary i dane. Pełną listę definicji znajdziesz w dokumentacji wymiarów i danych. Szczegółowe informacje o usuwaniu danych znajdziesz w zasadach wycofywania danych:

W tej wersji zostały wycofane te wymiary i dane:

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

W tej wersji dodaliśmy nowy wymiar do interfejsu API. Pełną listę definicji znajdziesz w dokumentacji wymiarów i danych. W tej wersji usunięto również kilka wycofanych wymiarów i danych. Aby zapoznać się z pełnym procesem usuwania danych, zapoznaj się z Zasadami wycofywania danych dla interfejsów API Google Analytics.

Godzina

  • Nowy wymiar ga:dateHourMinute, który łączy wymiary 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 dokumentacji wymiarów i danych.

Dane o użytkownikach

Sposób obliczania danych Użytkownicy i Aktywni użytkownicy został zaktualizowany, aby efektywniej zliczać użytkowników. Możesz zauważyć niewielką zmianę w danych. Więcej informacji znajdziesz w artykule Jak identyfikujemy użytkowników na potrzeby danych o użytkownikach.

Dane o użytkownikach, na które wpływa aktualizacja obliczeń:

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

Unikalne zdarzenia

Zbliża się koniec okresu wycofywania interfejsu ga:uniqueEvents. Po 26 marca 2017 r. definicja wskaźnika ga:uniqueEvents zostanie zaktualizowana, a prywatne dane ga:uniqueEventsTemporary zostaną usunięte z interfejsu API. Więcej informacji znajdziesz w dokumentacji pomocy dotyczącej unikalnych zdarzeń.

W tej wersji dodaliśmy nowy wymiar do interfejsu API, ulepszyliśmy komunikaty o błędach i zaczęliśmy egzekwować zapowiedziane wcześniej zmiany w wymiarach i danych AdSense.

Wymiary użytkownika

  • Wymiar – ga:userBucket – w przypadku danego użytkownika wymiar Grupa użytkowników (wartości od 1 do 100) wskazuje grupę, do której został on przypisany. Więcej informacji znajdziesz w artykule o testowaniu kampanii remarketingowych.

Komunikaty o błędach

Wcześniej interfejs API zwracał błędny komunikat o błędzie (Unknown dimension(s): lub Unknown metric(s): w przypadku żądania danych z niespełnionymi warunkami), a teraz zwraca komunikat: Restricted metric(s): ... can only be queried under certain conditions.

Wymiary i dane AdSense

Od tej pory w widokach danych niepołączonych z AdSense nie będzie można wysyłać zapytań dotyczących wymiarów i danych AdSense. Zapytanie o te wymiary i dane w widokach niepołączonych z AdSense spowoduje błąd.

Jest to wersja z poprawką błędów, która rozwiązuje problem z wymiarami i danymi AdSense oraz informuje o nadchodzącej zmianie tych wymiarów i danych.

Wymiary i dane AdSense

W tej wersji rozwiązaliśmy problem, który pojawił się 7 stycznia 2017 r. związany z wysyłaniem zapytań o wymiary i dane AdSense w przypadku widoków danych niepołączonych z AdSense.

Nadchodzące zmiany

Od 31 stycznia 2017 r. nie będzie można wysyłać zapytań o wymiary i dane AdSense dla widoków danych niepołączonych z AdSense. Zapytanie o te wymiary i dane w widokach niepołączonych z AdSense spowoduje błąd.

Ta wersja dodaje do interfejsu API podane niżej nowe dane. Pełną listę definicji znajdziesz w dokumentacji wymiarów i danych.

Obliczone dane

Ta wersja dodaje obsługę obliczonych danych.

  • Dane – ga:calcMetric_ – wartość żądanych obliczonych danych, gdzie to zdefiniowana przez użytkownika nazwa obliczonych danych. Typy danych ga:calcMetric_ mogą być typu FLOAT, INTEGER, CURRENCY, TIME lub PERCENT. Więcej informacji znajdziesz w artykule Obliczone dane.

W tej wersji dodaliśmy nowe dane do interfejsu API. Wycofuje też istniejące dane. Pełną listę definicji znajdziesz w dokumentacji wymiarów i danych.

Śledzenie zdarzeń

Definicja zdarzenia ga:uniqueEvents zmieni się, aby bardziej precyzyjnie odzwierciedlała liczbę niepowtarzalnych zdarzeń. Aby wpłynąć na tę zmianę, zgodnie z naszymi zasadami wycofywania danych wycofamy obecny typ danych ga:uniqueEvents. Jeśli chcesz wypróbować nową definicję, możesz odwołać się do danych prywatnych ga:uniqueEventsTemporary, które dokładniej obliczają liczbę niepowtarzalnych zdarzeń. Wprowadzimy również nowy wskaźnik ga:uniqueDimensionCombinations, który zachowuje obecną definicję wskaźnika ga:uniqueEvents. Po odpowiednim okresie wycofania (około 6 miesięcy) dane prywatne ga:uniqueEventsTemporary zostaną usunięte, a pierwotny wskaźnik ga:uniqueEvents będzie prawidłowo odzwierciedlać liczbę unikalnych zdarzeń. Więcej informacji znajdziesz w dokumentach pomocy dotyczących unikalnych zdarzeń.

Unikalne zdarzenia

  • Dane – ga:uniqueEvents – definicja wskaźnika ga:uniqueEvents wkrótce się zmieni, aby dokładniej odzwierciedlała liczbę unikalnych zdarzeń. Jeśli chcesz zachować istniejącą definicję, użyj zamiast niej ga:uniqueDimensionCombinations. Więcej informacji znajdziesz w dokumentacji pomocy dotyczącej unikalnych zdarzeń.
  • Dane – ga:uniqueDimensionCombinations – Unikalne kombinacje wymiarów zliczają liczbę unikalnych kombinacji wymiarów i wartości 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 dokumentacji pomocy dotyczącej unikalnych zdarzeń.

Testowanie przejścia – prywatne

  • Dane – ga:uniqueEventsTemporary – liczba unikalnych zdarzeń; to będzie nowa definicja zdarzenia ga:uniqueEvents. Dzięki tym danym możesz poznać nową definicję przed wprowadzeniem zmiany. Pamiętaj, że te dane są prywatne i nie będą widoczne w narzędziu do sprawdzania wymiarów i danych.

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

DoubleClick Bid Manager

  • Wymiar – ga:dbmClickAdvertiser – nazwa reklamodawcy DBM powiązanego z kliknięciem DBM odpowiadającym sesji Google Analytics (tylko Analytics 360, wymaga integracji z DBM).
  • Wymiar – ga:dbmClickAdvertiserId – identyfikator reklamodawcy DBM, którego dotyczy kliknięcie DBM pasujące do sesji Google Analytics (tylko Analytics 360, wymaga integracji z DBM).
  • Wymiar – ga:dbmClickCreativeId – identyfikator kreacji DBM powiązany z kliknięciem DBM odpowiadającym sesji Google Analytics (tylko Analytics 360, wymaga integracji z DBM).
  • Wymiar – ga:dbmClickExchange – nazwa giełdy DBM odpowiadającej kliknięciu DBM odpowiadającemu sesji Google Analytics (tylko Analytics 360, wymaga integracji z DBM).
  • Wymiar – ga:dbmClickExchangeId – identyfikator giełdy DBM odpowiadający kliknięciu DBM odpowiadającemu sesji Google Analytics (tylko Analytics 360, wymaga integracji z DBM).
  • Wymiar – ga:dbmClickInsertionOrder – nazwa zamówienia reklamowego DBM powiązanego z kliknięciem DBM odpowiadającym sesji Google Analytics (tylko Analytics 360, wymaga integracji z DBM).
  • Wymiar – ga:dbmClickInsertionOrderId – identyfikator zamówienia reklamowego DBM powiązanego z kliknięciem DBM odpowiadającym sesji Google Analytics (tylko Analytics 360, wymaga integracji z DBM).
  • Wymiar – ga:dbmClickLineItem – nazwa elementu zamówienia DBM powiązanego z kliknięciem DBM odpowiadającym sesji Google Analytics (tylko Analytics 360, wymaga integracji z DBM).
  • Wymiar – ga:dbmClickLineItemId – identyfikator elementu zamówienia DBM, którego dotyczy kliknięcie DBM pasujące do sesji Google Analytics (tylko Analytics 360, wymaga integracji z DBM).
  • Wymiar – ga:dbmClickSite – nazwa witryny DBM, w której została wyświetlona i kliknięta kreacja DBM w przypadku kliknięcia DBM pasującego do sesji Google Analytics (tylko Analytics 360, wymaga integracji z DBM).
  • Wymiar – ga:dbmClickSiteId – identyfikator witryny DBM, w której została wyświetlona i kliknięta kreacja DBM w przypadku kliknięcia DBM pasującego do sesji Google Analytics (tylko Analytics 360, wymaga integracji z DBM).
  • Wymiar – ga:dbmLastEventAdvertiser – nazwa reklamodawcy DBM w ostatnim zdarzeniu DBM (wyświetlenie lub kliknięcie w okresie ważności DBM) powiązanym z sesją Google Analytics (tylko Analytics 360, wymaga integracji z DBM).
  • Wymiar – ga:dbmLastEventAdvertiserId – identyfikator reklamodawcy DBM w ostatnim zdarzeniu DBM (wyświetlenie lub kliknięcie w okresie ważności DBM) powiązanym z sesją Google Analytics (tylko Analytics 360, wymaga integracji z DBM).
  • Wymiar – ga:dbmLastEventCreativeId – identyfikator kreacji DBM w ostatnim zdarzeniu DBM (wyświetlenie lub kliknięcie w okresie ważności DBM) powiązanym z sesją Google Analytics (tylko Analytics 360, wymaga integracji z DBM).
  • Wymiar – ga:dbmLastEventExchange – nazwa giełdy DBM ostatniego zdarzenia DBM (wyświetlenie lub kliknięcia w okresie ważności DBM) powiązanego z sesją Google Analytics (tylko Analytics 360, wymaga integracji z DBM).
  • Wymiar – ga:dbmLastEventExchangeId – identyfikator giełdy DBM ostatniego zdarzenia DBM (wyświetlenia lub kliknięcia w okresie ważności DBM) powiązanego z sesją Google Analytics (tylko Analytics 360, wymaga integracji z DBM).
  • Wymiar – ga:dbmLastEventInsertionOrder – nazwa zamówienia reklamowego DBM ostatniego zdarzenia DBM (wyświetlenie lub kliknięcia w okresie ważności DBM) powiązanego z sesją Google Analytics (tylko Analytics 360, wymaga integracji z DBM).
  • Wymiar – ga:dbmLastEventInsertionOrderId – identyfikator zamówienia reklamowego DBM ostatniego zdarzenia DBM (wyświetlenie lub kliknięcie w okresie ważności DBM) powiązanego z sesją Google Analytics (tylko Analytics 360, wymaga integracji z DBM).
  • Wymiar – ga:dbmLastEventLineItem – nazwa elementu zamówienia DBM ostatniego zdarzenia DBM (wyświetlenia lub kliknięcia w okresie ważności DBM) powiązanego z sesją Google Analytics (tylko Analytics 360, wymaga integracji z DBM).
  • Wymiar ga:dbmLastEventLineItemId – identyfikator elementu zamówienia DBM ostatniego zdarzenia DBM (wyświetlenia lub kliknięcia w okresie ważności DBM) powiązanego z sesją Google Analytics (tylko Analytics 360, wymaga integracji z DBM).
  • Wymiar – ga:dbmLastEventSite – nazwa witryny DBM, w której została wyświetlona i kliknięta kreacja DBM w ramach ostatniego zdarzenia DBM (wyświetlenia lub kliknięcia w okresie ważności DBM) powiązanego z sesją Google Analytics (tylko Analytics 360, wymaga integracji z DBM).
  • Wymiar – ga:dbmLastEventSiteId – identyfikator witryny DBM, w której została wyświetlona i kliknięta kreacja DBM w ostatnim zdarzeniu DBM (wyświetlenie lub kliknięcie w okresie ważności DBM) powiązanym z sesją Google Analytics (tylko Analytics 360, wymaga integracji z DBM).
  • Dane – ga:dbmCPA – DBM – eCPA z przychodów (tylko Analytics 360, wymaga integracji z DBM).
  • Dane – ga:dbmCPC – eCPC z przychodów w DBM (tylko Analytics 360, wymaga integracji z DBM).
  • Dane – ga:dbmCPM – eCPM z przychodów w DBM (tylko Analytics 360, wymaga integracji z DBM).
  • Dane – ga:dbmCTR – CTR w DBM (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 – Łączna 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 – łączna liczba wyświetleń w DBM (tylko Analytics 360, wymaga integracji z DBM).
  • Dane – ga:dbmROAS – ROAS w DBM (tylko 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 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 Analytics 360, wymaga integracji z DS).
  • Wymiar – ga:dsAgency – agencja DS (tylko Analytics 360, wymaga integracji z DS).
  • Wymiar: ga:dsAgencyId – identyfikator agencji w DS (tylko Analytics 360, wymaga integracji z DS).
  • Wymiar – ga:dsCampaign – kampania DS (tylko Analytics 360, wymaga integracji z DS).
  • Wymiar: ga:dsCampaignId – identyfikator kampanii DS (tylko Analytics 360, wymaga integracji z DS).
  • Wymiar – ga:dsEngineAccount – konto wyszukiwarki DS (tylko Analytics 360, wymaga integracji z DS).
  • Wymiar: ga:dsEngineAccountId – identyfikator konta wyszukiwarki DS (tylko 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 w DS (tylko Analytics 360, wymaga integracji z DS).
  • ga:dsCPC – koszt kliknięcia przez reklamodawcę w DS (tylko Analytics 360, wymaga integracji z DS).
  • ga:dsCTR – współczynnik klikalności DS (tylko Analytics 360, wymaga integracji z DS).
  • ga:dsClicks – kliknięcia z DS (tylko Analytics 360, wymaga integracji z DS).
  • ga:dsCost – koszt DS (tylko Analytics 360, wymaga integracji z DS).
  • ga:dsImpressions – wyświetlenia z DS (tylko 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 Analytics 360, wymaga integracji z DS).
  • ga:dsRevenuePerClick – przychody z kliknięcia w DS (tylko Analytics 360, wymagają integracji z DS).

Ta wersja wprowadza nowy wymiar interfejsu API. W tej wersji wprowadzono też pewne ograniczenia dotyczące kombinacji wymiarów, których można używać w zapytaniach. Pełną listę definicji znajdziesz w dokumentacji wymiarów i danych.

Geo Network

  • Wymiar ga:continentId – identyfikator kontynentu użytkownika pobrany z adresu IP użytkownika lub jego identyfikatora geograficznego.

Ograniczenia

W zapytaniach dotyczących wymiarów z pozostałych grup nie można wysyłać zapytań dotyczących tych wymiarów w poniższych grupach:

  • Otwórz grupę informacyjną Zakupów Google
    • ga:checkoutOptions
    • ga:shoppingStage
  • Grupa eksperymentalna GWO
    • ga:experimentVariant
    • ga:experimentId
  • Grupa zainteresowań
    • ga:interestOtherCategory
  • grupa interesów na rynku
    • ga:interestInMarketCategory
  • Grupa reklam wewnętrznych:
    • ga:internalPromotionCreative
    • ga:internalPromotionId
    • ga:internalPromotionName
    • ga:internalPromotionPosition
  • Grupa zainteresowań związanych z marką:
    • ga:interestAffinityCategory

W tej wersji wprowadziliśmy nowe limity. Więcej informacji znajdziesz w dokumentacji limitów i limitów.

Zgłaszanie błędów

Ta wersja zaczyna egzekwować limity dotyczące nieudanych żądań raportowania (5XX).

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

Limity dotyczące przestawienia

Ta wersja zaczyna egzekwować limity dotyczące żądań przestawnych:

  • Żądanie raportu może teraz mieć maksymalnie 2 przestawienia.
  • Tabela przestawna może mieć maksymalnie 4 wymiary.
  • Wymiary w przestawieniu są częścią ograniczenia dotyczącego łącznej liczby wymiarów dozwolonych w żądaniu.
  • metrics przestawne są częścią ograniczenia łącznej liczby danych dozwolonych w żądaniu.

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

Geo Network

  • Wymiar – ga:metroId – trzycyfrowy kod rynku docelowego (DMA), z którego pochodzi ruch, podany na podstawie adresów IP użytkowników lub identyfikatorów geograficznych.

DoubleClick for Publishers

  • Dane – ga:dfpImpressions – wyświetlenie reklamy DFP jest odnotowywane po każdorazowym wyświetleniu pojedynczej reklamy w witrynie. Jeśli na przykład strona z 2 jednostkami reklamowymi zostanie wyświetlona raz, zarejestrujemy 2 wyświetlenia (włączone łączenie z kontem DFP i Nie włączono opcji Ukryj przychody z Ad Managera).
  • 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 zapewnić kierowanych reklam. (Wyświetlenia reklam / łączna liczba żądań reklamy) * 100 (łączenie z kontem DoubleClick jest włączone, a ukryte przychody z tej usługi nie są włączone)”.
  • Dane – ga:dfpMonetizedPageviews – mierzy łączną liczbę odsłon w usłudze, które zawierały reklamę z połączonego konta DFP. Pamiętaj, że pojedyncza strona może mieć wiele jednostek reklamowych (łączenie kont DFP jest włączone i nie włączono opcji Ukryj przychody z Google Ad Managera).
  • Dane – ga:dfpImpressionsPerSession – stosunek wyświetleń reklam z Ad Managera do sesji Analytics (Wyświetlenia reklam / sesje Analytics) (włączone połączenie z Ad Managerem, a ukryte przychody z Ad Managera wyłączone).
  • Dane – ga:dfpViewableImpressionsPercent – odsetek widocznych wyświetleń reklam. Wyświetlenie uznajemy za widoczne, gdy pojawiło się w przeglądarce użytkownika i ma szansę być dla niego widoczne (łączenie z kontem DFP jest włączone, a ukryte przychody z Ad Managera nie są włączone).
  • Dane – ga:dfpClicks – liczba kliknięć reklam DFP w witrynie (łączenie z kontem DFP włączone i wyłączone opcję Ukryj przychody z Google Ad Managera).
  • Dane – ga:dfpCTR – odsetek odsłon, które zakończyły się kliknięciem reklamy DFP (łączenie z kontem DFP włączone, a nie włączono opcję Ukryj przychody z Google Ad Managera).
  • Dane – ga:dfpRevenue – przychody z DFP to oszacowanie łącznych przychodów z reklam na podstawie zrealizowanych wyświetleń (łączenie kont DFP jest włączone i nie włączono opcji Ukryj przychody z DFP).
  • Dane – ga:dfpRevenuePer1000Sessions – łączne szacunkowe przychody z reklam DFP na 1000 sesji Analytics. Pamiętaj, że te dane są oparte na sesjach w witrynie, a nie na wyświetleniach reklam (włączono łączenie z kontem DFP i nie włączono opcji Ukryj przychody z Google Ad Managera).
  • Dane – ga:dfpECPM – efektywny koszt tysiąca odsłon. Są to przychody z Google Ad Managera na 1000 odsłon (włączone łączenie z kontem DFP i nie włączono opcji Ukryj przychody z Google Ad Managera).
  • Dane – ga:backfillImpressions – wyświetlenia zapasowe to suma wszystkich wyświetleń reklam AdSense lub Ad Exchange przeprowadzonych jako reklamy zapasowe przez DFP. Wyświetlenie reklamy jest odnotowywane za każdym razem, gdy pojedyncza reklama zostanie wyświetlona w witrynie. Jeśli na przykład strona z 2 jednostkami reklamowymi zostanie wyświetlona raz, zarejestrujemy 2 wyświetlenia (włączone łączenie z kontem DFP i Nie włączono opcji Ukryj przychody z Ad Managera).
  • Dane – ga:backfillCoverage – Pokrycie reklam zapasowych to odsetek żądań reklam zapasowych, które zwróciły co najmniej 1 reklamę. Pokrycie z reguły pozwala zidentyfikować witryny, w których konto wydawcy nie może zapewnić kierowanych reklam. (Wyświetlenia reklam / łączna liczba żądań reklamy) * 100. Jeśli zarówno AdSense, jak i Ad Exchange udostępniają reklamy zapasowe, te dane są średnią ważoną z dwóch kont zapasowych (łączenie z kontem DFP jest włączone i nie włączono opcji Ukryj przychody z Google Ad Managera).
  • Dane – ga:backfillMonetizedPageviews – łączna liczba odsłon w usłudze, które wyświetliły się z co najmniej 1 reklamą z połączonych kont zapasowych. Pamiętaj, że jedna odsłona generująca przychody może obejmować wiele wyświetleń reklam (łączenie z kontem DFP jest włączone i nie włączono opcji Ukryj przychody z Google Ad Managera).
  • Dane – ga:backfillImpressionsPerSession – stosunek wyświetleń reklam zapasowych do sesji Analytics (Wyświetlenia reklam / sesje Analytics). Jeśli zarówno AdSense, jak i Ad Exchange udostępniają reklamy zapasowe, te dane to suma wartości z dwóch kont zapasowych (łączenie kont DFP włączone i wyłączone opcję Ukryj przychody z Ad Exchange).
  • Dane – ga:backfillViewableImpressionsPercent – odsetek wyświetleń reklam zapasowych, które były widoczne. Wyświetlenie uznajemy za widoczne, gdy pojawiło się w przeglądarce użytkownika, który miał okazję je zobaczyć. Jeśli AdSense i Ad Exchange udostępniają reklamy zapasowe, te dane są średnią ważoną z dwóch kont zapasowych (łączenie kont DFP jest włączone i nie włączono opcji Ukryj przychody z Ad Managera).
  • Dane – ga:backfillClicks – liczba kliknięć reklam zapasowych w witrynie. Jeśli AdSense i Ad Exchange udostępniają reklamy zapasowe, te dane to suma danych z dwóch kont zapasowych (łączenie kont DFP włączone i wyłączone opcję Ukryj przychody z Ad Managera).
  • Dane – ga:backfillCTR – odsetek wyświetleń zapasowych, które zakończyły się kliknięciem reklamy. Jeśli AdSense i Ad Exchange udostępniają reklamy zapasowe, te dane są średnią ważoną z dwóch kont zapasowych (łączenie kont DFP jest włączone i nie włączono opcji Ukryj przychody z Ad Managera).
  • Dane – ga:backfillRevenue – łączne szacunkowe przychody z reklam zapasowych. Jeśli AdSense i Ad Exchange udostępniają reklamy zapasowe, te dane to suma danych z dwóch kont zapasowych (łączenie kont DFP włączone i wyłączone opcję Ukryj przychody z Ad Managera).
  • Dane – ga:backfillRevenuePer1000Sessions – łączne szacunkowe przychody z reklam zapasowych na 1000 sesji Analytics. Pamiętaj, że ta wartość jest obliczana na podstawie liczby sesji w witrynie, a nie wyświetleń reklam. Jeśli zarówno AdSense, jak i Ad Exchange udostępniają reklamy zapasowe, te dane to suma wartości z dwóch kont zapasowych (łączenie kont DFP włączone i wyłączone opcję Ukryj przychody z Ad Exchange).
  • Dane – ga:backfillECPM – efektywny koszt tysiąca odsłon. Obliczany przez podział przychodów z reklam zapasowych DFP na 1000 odsłon. Jeśli zarówno AdSense, jak i Ad Exchange udostępniają reklamy zapasowe, te dane to suma wartości z dwóch kont zapasowych (łączenie kont DFP włączone i wyłączone opcję Ukryj przychody z Ad Exchange).

Jest to wersja z poprawką błędów, która rozwiązuje problem z segmentami i próbkowaniem.

Segmenty

W tej wersji rozwiązaliśmy problem, który powodował, że podzbiór żądań z segmentem Wszyscy użytkownicy (gaid::-1) był niedoszacowany w interfejsie API podstawowego raportowania w wersji 3 i był podzielony na 2 segmenty w interfejsie Analytics Reporting API w wersji 4.

Próbkowanie

W tej wersji rozwiązano problem, który powodował, że podzbiór żądań z tabel niestandardowych zwracał próbkowane dane.

To jest wersja z poprawką błędów, która rozwiązała problem podczas tworzenia żądań do kohorty interfejsu Analytics Reporting API w wersji 4.

Prośby dotyczące kohorty

Żądania kohorty mogą teraz prosić o zgodę na wszystkie wymiary kohorty. Wcześniej interfejs API zwracał błąd przy wysyłaniu żądania dotyczącego ga:acquisition... wymiarów.

Wartość od początku śledzenia – wartość od początku śledzenia w przypadku żądania wartości od początku śledzenia

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

W tej wersji przedstawiamy nową wersję interfejsu API – Analytics Reporting API V4. Nowy interfejs API jest najbardziej zaawansowaną metodą automatyzacji dostępu do danych raportów w Google Analytics.

Najważniejsze funkcje

Usługa Google Analytics opiera się na zaawansowanej infrastrukturze raportowania danych. Interfejs API daje programistom dostęp do potęgi platformy Google Analytics. Kluczowe funkcje interfejsu Analytics Reporting API w wersji 4 to m.in.:

  • Wyrażenia wskaźników – interfejs API umożliwia wysyłanie żądań nie tylko do wbudowanych wskaźników, ale także do wyrażeń matematycznych. Na przykład realizacje celu na liczbę sesji można zapisać w żądaniu jako ga:goal1completions/ga:sessions.
  • Wiele zakresów dat – obsługa żądania dwóch zakresów dat, co umożliwia porównanie danych z dwóch okresów w jednym żądaniu.
  • Kohorty i wartość od początku śledzenia – interfejs API ma bogaty asortyment raportów dotyczących kohorty i wartości od początku śledzenia.
  • Wiele segmentów – możesz teraz wysyłać żądania dotyczące wielu segmentów w jednym żądaniu.

Pierwsze kroki

Szczegółowe informacje o pierwszych krokach z interfejsem API znajdziesz w dokumentacji dla programistów.

Zasady dotyczące limitów

Analytics Reporting API V4 ma własne limity, ponieważ jest to nowy interfejs API, więc limity mogą ulec zmianie.

Migracja

Oprócz przewodnika po migracji udostępniamy też na GitHubie bibliotekę zgodności z Pythonem.

Wymiary i dane

Dodaliśmy również zestaw wymiarów i danych przeznaczonych specjalnie do interfejsu Analytics Reporting API w wersji 4. Pełne definicje list znajdziesz w eksploratorze wymiarów i danych.

  • Wymiar – ga:cohort – nazwa kohorty, do której należy użytkownik, określona na podstawie definicji kohorty. W zależności od tego, jak zostały zdefiniowane kohorty, użytkownik może należeć do wielu kohort, podobnie jak w przypadku jego przynależności do wielu segmentów.

  • Wymiar – ga:cohortNthDay – przesunięcie dnia o 9 sekund względem daty definicji kohorty. Jeśli np. kohorta jest zdefiniowana z datą pierwszej wizyty, czyli 1 września 2015 r., a 4.09.2015 r., atrybut ga:cohortNthDay będzie mieć wartość 3.

  • ga:cohortNthMonth – przesunięcie miesiąca o wartości 0 względem daty definicji kohorty.

  • Wymiar – ga:cohortNthWeek – przesunięcie tygodniowe o tyle dni względem daty definicji kohorty.

  • Wymiar ga:acquisitionTrafficChannel – kanał ruchu, dzięki któremu udało się pozyskać użytkownika. Jest wyodrębniane 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 chwili pozyskania użytkowników.

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

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

  • Wymiar – ga:acquisitionSourceMedium – łączna wartość parametrów ga:userAcquisitionSource i ga:AcquisitionMedium.

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

  • Dane – ga:cohortActiveUsers – te dane mają zastosowanie w kontekście wymiarów przesunięcia, które są równe 0 (ga:cohortNthDay, ga:cohortNthWeek lub ga:cohortNthMonth). Wskazuje liczbę użytkowników w kohorcie aktywnych w przedziale czasowym odpowiadającym n-tym dniu/tygodniowi/miesiącowi kohorty odpowiadającej n-tym dniu/tygodniowi/miesiącu. Na przykład w przypadku ga:cohortNthWeek = 1 jest to liczba użytkowników (w kohorcie), którzy są aktywni w drugim tygodniu. Jeśli żądanie nie zawiera żadnej z tych wartości: ga:cohortNthDay, ga:cohortNthWeek ani ga:cohortNthMonth, te dane będą miały tę samą wartość co 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 – odsłony na użytkownika w kohorcie.

  • Dane – ga:cohortRetentionRate – współczynnik utrzymania kohorty.

  • Dane – ga:cohortRevenuePerUser – przychody na użytkownika w kohorcie.

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

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

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

  • Dane – ga:cohortAppviewsPerUserWithLifetimeCriteria – wyświetlenia aplikacji na użytkownika w przypadku wymiaru pozyskiwania w przypadku kohorty.

  • Dane – ga:cohortGoalCompletionsPerUserWithLifetimeCriteria – realizacje celu na użytkownika w wymiarze pozyskiwania w danej kohorcie.

  • Dane – ga:cohortPageviewsPerUserWithLifetimeCriteria – odsłony na użytkownika w wymiarze pozyskiwania w danej kohorcie.

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

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

Wymiary i dane Centrum danych społecznościowych zostały wycofane. Od 30 kwietnia 2016 r. będą w nich uwzględniane tylko dane historyczne. Po tej dacie nie będą już wyświetlane ż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 dokumentacji wymiarów 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 działania w centrum danych społecznościowych jest to adres URL tego działania (np. URL posta w Google+, URL komentarza na blogu itp.).
  • Wymiar ga:socialActivityDisplayName – w przypadku działania w centrum danych społecznościowych jest to tytuł działania społecznościowego opublikowany przez użytkowników sieci społecznościowej.
  • Wymiar ga:socialActivityPost – w przypadku działania w centrum danych społecznościowych jest to zawartość działania społecznościowego (np. wiadomości opublikowanej w Google+) opublikowanej przez użytkowników sieci społecznościowych.
  • Wymiar ga:socialActivityTimestamp – w przypadku działania w centrum danych społecznościowych jest to czas, w którym działanie społecznościowe miało miejsce w sieci społecznościowej.
  • Wymiar – ga:socialActivityUserHandle – w przypadku działania w centrum danych społecznościowych jest to uchwyt sieci społecznościowej (np. nazwa lub identyfikator) użytkowników, którzy zainicjowali działanie społecznościowe.
  • Wymiar ga:socialActivityUserPhotoUrl – w przypadku działania w centrum danych społecznościowych jest to adres URL zdjęcia powiązanego z profilami użytkowników w sieciach społecznościowych”.
  • Wymiar – ga:socialActivityUserProfileUrl – w przypadku działania w centrum danych społecznościowych jest to adres URL profili powiązanych użytkowników w sieciach społecznościowych.
  • Wymiar – ga:socialActivityTagsSummary – w przypadku działania w centrum danych społecznościowych jest to rozdzielany przecinkami zestaw tagów powiązanych z działaniem społecznościowym.
  • Wymiar ga:socialActivityAction – w przypadku działania w centrum danych społecznościowych wskazuje typ interakcji społecznościowej (np. głosu, komentarza, +1-ki) powiązanej z danym działaniem.
  • Wymiar – ga:socialActivityNetworkAction – w przypadku działania w centrum danych społecznościowych jest to typ interakcji społecznościowej i sieci społecznościowej, z której ono pochodzi.
  • Wymiar – ga:socialActivityContentUrl – w przypadku działania w centrum danych społecznościowych jest to adres URL udostępniany przez powiązanych użytkowników sieci społecznościowych.
  • Dane – ga:socialActivities – łączna liczba działań, w przypadku których adres URL treści został udostępniony lub wspomniany w sieci partnerskiej centrum danych społecznościowych.

Ta wersja wprowadza nowy wymiar interfejsu API. Pełną listę definicji znajdziesz w dokumentacji wymiarów i danych.

Platforma lub urządzenie

  • Wymiar – ga:browserSize – rozmiar widocznego obszaru w przeglądarkach użytkowników. Rozmiar przeglądarki to wymiar ograniczony do sesji, który uwzględnia początkowe wymiary widocznego obszaru w pikselach i jest sformatowany jako szerokość x wysokość. Na przykład 1920 x 960.

Ta wersja dodaje do interfejsu API nowy parametr.

Uwzględnij puste wiersze

  • W tej wersji dodaliśmy nowy opcjonalny parametr include-empty-rows, który jeśli ustawisz w odpowiedzi false wierszy bez danych, zostanie on pominięty. Wartość domyślna to true, nie jest to zmiana powodująca niezgodności i dlatego nie powinna wymagać aktualizacji kodu. Więcej informacji znajdziesz w dokumentacji interfejsu API podstawowego raportowania.

Ta wersja dodaje do interfejsu API nowe wskaźniki. Pełną listę definicji znajdziesz w dokumentacji wymiarów i danych.

Użytkownik

  • Dane – ga:1dayUsers – łączna liczba użytkowników aktywnych w ciągu 1 dnia na każdy dzień w wybranym okresie. Aby wysyłać zapytania o te dane, należy określić co najmniej jeden z parametrów ga:nthDay, ga:date lub ga:day. Dla danego dnia zwracana wartość będzie łączną liczbą unikalnych użytkowników w okresie 1 dnia kończącym się w tym dniu.
  • Dane – ga:7dayUsers – łączna liczba użytkowników aktywnych w ciągu 7 dni na każdy dzień w wybranym okresie. Aby wysyłać zapytania o te dane, należy określić co najmniej jeden z parametrów ga:nthDay, ga:date lub ga:day. Dla danego dnia zwracana wartość będzie łączną liczbą unikalnych użytkowników w okresie 7 dni kończącym się w danym dniu.
  • Dane – ga:14dayUsers – łączna liczba użytkowników aktywnych w ciągu 14 dni na każdy dzień w wybranym okresie. Aby wysyłać zapytania o te dane, należy określić co najmniej jeden z parametrów ga:nthDay, ga:date lub ga:day. Dla danego dnia zwracana wartość będzie łączną liczbą unikalnych użytkowników w okresie 14 dni kończącym się w danym dniu.
  • Dane – ga:30dayUsers – łączna liczba użytkowników aktywnych w ciągu 30 dni na każdy dzień w wybranym okresie. Aby wysyłać zapytania o te dane, należy określić co najmniej jeden z parametrów ga:nthDay, ga:date lub ga:day. Dla danej daty zwracana wartość będzie łączną liczbą unikalnych użytkowników w okresie 30 dni kończącym się w danym dniu.

Ta wersja dodaje do interfejsu API nowe wskaźniki. Pełną listę definicji znajdziesz w dokumentacji wymiarów i danych.

DoubleClick Ad Exchange (AdX)

  • Dane – ga:adxCTR – odsetek odsłon, które zakończyły się kliknięciem reklamy AdX.
  • Dane – ga:adxClicks – liczba kliknięć reklam AdX w Twojej 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 zapewnić kierowanych reklam. (Wyświetlenia reklam / łączna liczba żądań reklamy) * 100
  • Dane – ga:adxECPM – efektywny koszt tysiąca odsłon. Obliczany przez podział przychodów z AdX na 1000 odsłon.
  • Dane – ga:adxImpressions – wyświetlenie reklamy AdX jest odnotowywane po każdorazowym wyświetleniu w Twojej witrynie pojedynczej reklamy. Jeśli np. strona zawierająca 2 jednostki reklamowe zostanie wyświetlona raz, zarejestrujemy 2 wyświetlenia.
  • Dane – ga:adxImpressionsPerSession – stosunek wyświetleń reklam AdX do liczby sesji Analytics (Wyświetlenia reklam / sesje Analytics).
  • Dane – ga:adxMonetizedPageviews – odsłony generujące przychód to łączna liczba odsłon w Twojej usłudze, które zawierały reklamę 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 dotychczasowe wymiary lub dane. Pełną listę definicji znajdziesz w dokumentacji wymiarów i danych.

Wycofane wymiary

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

  • Wymiar – ga:adSlotPosition – zamiast niego użyj wymiaru ga:adSlot.
  • Wymiar – ga:nextPagePath – zamiast niego użyj wymiaru ga:pagePath.
  • Wymiar – ga:nextContentGroupXX – zamiast niego użyj wymiaru ga:contentGroupXX.

Ta wersja wprowadza nowy wymiar interfejsu API. Pełną listę wymiarów i danych znajdziesz w artykule Dokumentacja wymiarów i danych.

AdWords

  • Wymiar – ga:adQueryWordCount – liczba słów w wyszukiwanym haśle.

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

Platforma lub urządzenie

  • Wymiar – ga:dataSource – źródło danych działania. Działania wysyłane z tagów ga.js i analytics.js są raportowane jako „internet”, a działania wysyłane z mobilnych pakietów SDK są raportowane jako „aplikacja”. Wartości te można zastępować.
  • Wymiar ga:searchAfterDestinationPage – strona odwiedzona przez użytkownika po przeprowadzeniu wewnętrznego wyszukiwania w Twojej witrynie.

W tej wersji dodaliśmy nowe wymiary i dane do interfejsu API oraz wycofaliśmy 2 dotychczasowe rodzaje danych. Pełną listę definicji znajdziesz w dokumentacji wymiarów i danych.

ECommerce

  • Dane – ga:transactionsPerUser – łączna liczba transakcji podzielona przez łączną liczbę użytkowników.
  • Dane – ga:revenuePerUser – łączne przychody ze sprzedaży podane w transakcji bez kosztów 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 na podstawie adresów IP lub identyfikatorów geograficznych.
  • Wymiar – ga:countryIsoCode – kod ISO kraju użytkowników pobrany na podstawie adresów IP lub identyfikatorów geograficznych. Wartości są podane w formacie ISO-3166-1 alfa-2.
  • Wymiar ga:regionId – identyfikator regionu użytkowników pobrany na podstawie 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 pobrany na podstawie adresów IP lub identyfikatorów geograficznych. Wartości są podane w formacie ISO-3166-2.
  • Wymiar ga:subContinentCode – kod subkontynentu użytkowników pobrany na podstawie adresów IP lub identyfikatorów geograficznych. Na przykład Polinezja lub Europa Północna. Wartości są podane jako kod UN M.49.

DoubleClick Campaign Manager

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

Wycofane wskaźniki

Te dane zostały wycofane. Szczegółowe informacje o usuwaniu danych znajdziesz w Zasadach wycofywania danych: + Dane – ga:dcmROI – Zamiast nich użyj parametru ga:dcmROAS. + Dane – ga:dcmMargen – zamiast tego użyj wymiaru ga:dcmROAS.

W tej wersji dodaliśmy do interfejsu API nowe dane i wycofano 2 dotychczasowe rodzaje danych. Pełną listę definicji znajdziesz w dokumentacji wymiarów i danych.

AdWords

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

Wycofane wymiary i dane

Te wymiary i dane zostały wycofane. Szczegółowe informacje o usuwaniu danych znajdziesz w Zasadach wycofywania danych: + Dane – ga:ROI – Zamiast nich użyj parametru ga:ROAS. + Dane – ga:margin – zamiast tego użyj wymiaru ga:ROAS.

Ta wersja dodaje do interfejsu API nowe wskaźniki. Pełną listę definicji znajdziesz w dokumentacji wymiarów i danych.

AdSense

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

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

Wymiary i dane

Pełną listę definicji znajdziesz w dokumentacji wymiarów i danych.

Sesja

  • Dane – ga:hits – łączna liczba działań wysłanych do Google Analytics. Te dane sumują wszystkie typy działań (np. odsłona, zdarzenie, czas itp.)

Źródła wizyt

  • Wymiar – ga:campaignCode – wartość parametru śledzenia kampanii utm_id, jeśli używasz ręcznego śledzenia kampanii.

DoubleClick Campaign Manager

  • Wymiar – ga:dcmClickAd – nazwa reklamy DCM wywołana przez kliknięcie DCM odpowiadające sesji Google Analytics (tylko w wersji premium).
  • Wymiar – ga:dcmClickAdId – identyfikator reklamy DCM powiązany z kliknięciem DCM odpowiadającym sesji Google Analytics (tylko w wersji premium).
  • Wymiar – ga:dcmClickAdType – nazwa typu reklamy DCM kliknięcia DCM odpowiadającego sesji Google Analytics (tylko premium).
  • Wymiar – ga:dcmClickAdTypeId – identyfikator typu reklamy DCM, którego dotyczyło kliknięcie DCM odpowiadające sesji Google Analytics (tylko w wersji premium).
  • Wymiar – ga:dcmClickAdvertiser – nazwa reklamodawcy DCM, którego dotyczyło kliknięcie DCM odpowiadające sesji Google Analytics (tylko w wersji premium).
  • Wymiar – ga:dcmClickAdvertiserId – identyfikator reklamodawcy DCM, którego dotyczyło kliknięcie DCM odpowiadające sesji Google Analytics (tylko w wersji premium).
  • Wymiar – ga:dcmClickCampaign – nazwa kampanii DCM, której dotyczyło kliknięcie DCM odpowiadające sesji Google Analytics (tylko w wersji premium).
  • Wymiar – ga:dcmClickCampaignId – identyfikator kampanii DCM, którego dotyczyło kliknięcie DCM odpowiadające sesji Google Analytics (tylko w wersji premium).
  • Wymiar – ga:dcmClickCreative – nazwa kreacji DCM wynikająca z kliknięcia DCM pasującego do sesji Google Analytics (tylko w wersji premium).
  • Wymiar – ga:dcmClickCreativeId – identyfikator kreacji DCM powiązany z kliknięciem DCM odpowiadającym sesji Google Analytics (tylko w wersji premium).
  • Wymiar – ga:dcmClickCreativeType – nazwa typu kreacji DCM uruchomionej po kliknięciu DCM odpowiadającego sesji Google Analytics (tylko w wersji premium).
  • Wymiar – ga:dcmClickCreativeTypeId – identyfikator typu kreacji DCM wywołanego przez kliknięcie DCM odpowiadające sesji Google Analytics (tylko w wersji premium).
  • Wymiar – ga:dcmClickCreativeVersion – wersja kreacji DCM powiązana z kliknięciem w DCM pasującym do sesji Google Analytics (tylko w wersji premium).
  • Wymiar – ga:dcmClickRenderingId – identyfikator renderowania DCM kliknięcia DCM pasującego do sesji Google Analytics (tylko w wersji premium).
  • Wymiar – ga:dcmClickSite – nazwa witryny, w której wyświetliła się kreacja DCM i została kliknięta w przypadku kliknięcia DCM odpowiadającego sesji Google Analytics (tylko w wersji premium).
  • Wymiar – ga:dcmClickSiteId – identyfikator witryny DCM, w której wyświetliła się kreacja DCM i kliknęła ją w przypadku kliknięcia DCM odpowiadającego sesji Google Analytics (tylko w wersji premium).
  • Wymiar – ga:dcmClickSitePlacement – nazwa miejsca docelowego w witrynie DCM, której dotyczyło kliknięcie DCM odpowiadające sesji Google Analytics (tylko premium).
  • Wymiar – ga:dcmClickSitePlacementId – identyfikator miejsca docelowego w witrynie DCM, którego dotyczyło kliknięcie DCM odpowiadające sesji Google Analytics (tylko w wersji premium).
  • Wymiar – ga:dcmClickSpotId – identyfikator konfiguracji Floodlight w DCM, którego dotyczyło kliknięcie DCM odpowiadające sesji Google Analytics (tylko w wersji premium).
  • Wymiar – ga:dcmFloodlightActivity – nazwa aktywności Floodlight w DCM powiązana z konwersją Floodlight (tylko w wersji Premium).
  • Wymiar – ga:dcmFloodlightActivityAndGroup – nazwa aktywności Floodlight w DCM i nazwa grupy powiązane z konwersją Floodlight (tylko w wersji Premium).
  • Wymiar – ga:dcmFloodlightActivityGroup – nazwa grupy aktywności Floodlight w DCM powiązana z konwersją Floodlight (tylko w wersji Premium).
  • Wymiar – ga:dcmFloodlightActivityGroupId – identyfikator grupy aktywności Floodlight w DCM powiązany z konwersją Floodlight (tylko w wersji Premium).
  • Wymiar – ga:dcmFloodlightActivityId – identyfikator aktywności Floodlight w DCM powiązany z konwersją Floodlight (tylko w wersji Premium).
  • Wymiar – ga:dcmFloodlightAdvertiserId – identyfikator reklamodawcy Floodlight w DCM powiązany z konwersją Floodlight (tylko w wersji Premium).
  • Wymiar – ga:dcmFloodlightSpotId – identyfikator konfiguracji Floodlight w DCM powiązany z konwersją Floodlight (tylko w wersji Premium).
  • Wymiar – ga:dcmLastEventAd – nazwa reklamy DCM ostatniego zdarzenia DCM (wyświetlenia lub kliknięcia w okresie ważności DCM) powiązanego z sesją Google Analytics (tylko w wersji premium).
  • Wymiar – ga:dcmLastEventAdId – identyfikator reklamy DCM ostatniego zdarzenia DCM (wyświetlenia lub kliknięcia w okresie ważności DCM) powiązanego z sesją Google Analytics (tylko w wersji premium).
  • Wymiar – ga:dcmLastEventAdType – nazwa typu reklamy DCM ostatniego zdarzenia DCM (wyświetlenia lub kliknięcia w okresie ważności DCM) powiązanego z sesją Google Analytics (tylko w wersji premium).
  • Wymiar – ga:dcmLastEventAdTypeId – identyfikator typu reklamy DCM ostatniego zdarzenia DCM (wyświetlenia lub kliknięcia w okresie ważności DCM) powiązanego z sesją Google Analytics (tylko w wersji premium).
  • Wymiar – ga:dcmLastEventAdvertiser – nazwa reklamodawcy DCM w ostatnim zdarzeniu DCM (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 DCM 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:dcmLastEventAttributionType – dostępne są 2 wartości (po kliknięciu i po wyświetleniu). Jeśli ostatnie zdarzenie DCM powiązane z sesją Google Analytics było kliknięciem, to wartością będzie kliknięcie. Jeśli ostatnie zdarzenie DCM powiązane z sesją Google Analytics było wyświetleniem reklamy, to wartością będzie wartość Po wyświetleniu (tylko w wersji Premium).
  • Wymiar – ga:dcmLastEventCampaign – nazwa kampanii DCM 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:dcmLastEventCampaignId – identyfikator kampanii DCM 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:dcmLastEventCreative – nazwa kreacji DCM 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świetlenia lub kliknięcia w okresie ważności DCM) powiązanego z sesją Google Analytics (tylko w wersji premium).
  • Wymiar – ga:dcmLastEventCreativeType – nazwa typu kreacji DCM ostatniego zdarzenia DCM (wyświetlenia lub kliknięcia w okresie ważności DCM) powiązanego z sesją Google Analytics (tylko w wersji premium).
  • Wymiar – ga:dcmLastEventCreativeTypeId – identyfikator typu kreacji DCM ostatniego zdarzenia DCM (wyświetlenia lub kliknięcia w okresie ważności DCM) powiązanego z sesją Google Analytics (tylko w wersji premium).
  • Wymiar – ga:dcmLastEventCreativeVersion – wersja kreacji DCM 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:dcmLastEventRenderingId – identyfikator renderowania DCM ostatniego zdarzenia DCM (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 została wyświetlona i kliknięta kreacja DCM w ostatnim zdarzeniu DCM (wyświetleniu lub kliknięciu w okresie ważności DCM) powiązanym z sesją Google Analytics (tylko w wersji premium).
  • Wymiar – ga:dcmLastEventSiteId – identyfikator witryny DCM, w której została wyświetlona i kliknięta kreacja DCM w ostatnim zdarzeniu DCM (wyświetleniu lub kliknięciu w okresie ważności DCM) powiązanym z sesją Google Analytics (tylko w wersji premium).
  • Wymiar – ga:dcmLastEventSitePlacement – nazwa miejsca docelowego w witrynie DCM ostatniego zdarzenia DCM (wyświetlenia lub kliknięcia w okresie ważności DCM) powiązanego z sesją Google Analytics (tylko premium).
  • Wymiar – ga:dcmLastEventSitePlacementId – identyfikator miejsca docelowego w witrynie DCM ostatniego zdarzenia DCM (wyświetlenia lub kliknięcia w okresie ważności DCM) powiązanego z sesją Google Analytics (tylko w wersji premium).
  • Wymiar – ga:dcmLastEventSpotId – identyfikator konfiguracji Floodlight w DCM ostatniego zdarzenia DCM (wyświetlenie lub kliknięcie w okresie ważności DCM) powiązanego z sesją Google Analytics (tylko w wersji premium).
  • Dane – ga:dcmFloodlightQuantity – liczba konwersji Floodlight w DCM (tylko w wersji premium).
  • Dane – dcmFloodlightRevenue – przychody z DCM Floodlight (tylko w wersji premium).

W tej wersji dodaliśmy nowe wymiary i dane grupowania treści.

Wymiary i dane

Pełną listę definicji znajdziesz w dokumentacji wymiarów 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 została odwiedzona po innej grupie treści.
  • Wymiar – ga:contentGroupXX – grupa treści w danej usłudze. Grupa treści to zbiór treści zapewniających logiczną strukturę, która może być określona przez kod śledzenia, dopasowanie tytułu/adresu URL do wyrażenia regularnego lub wstępnie zdefiniowane reguły.
  • Wymiar – ga:previousContentGroupXX – odnosi się do grupy treści, która została odwiedzona przed inną grupą treści.
  • Dane – ga:contentGroupUniqueViewsXX – liczba różnych (unikalnych) stron w sesji dla określonej grupy treści. Podczas określania unikatowości uwzględniane są zarówno parametry pagePath, jak i pageTitle.

W tej wersji dodaliś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 określonym zakresie dat. Więcej informacji znajdziesz w przewodniku dla programistów dotyczącym segmentów.

Wymiary i dane

Pełną listę definicji Ulepszonego e-commerce znajdziesz w dokumentacji wymiarów i danych.

Ulepszone e-commerce

  • Wymiar ga:internalPromotionCreative – treść kreacji stworzona na potrzeby promocji.
  • Wymiar – ga:internalPromotionId – identyfikator używany w promocji.
  • Wymiar – ga:internalPromotionName – nazwa promocji.
  • Wymiar – ga:internalPromotionPosition – pozycja promocji na stronie internetowej lub ekranie aplikacji.
  • Wymiar – ga:orderCouponCode – kod kuponu na poziomie zamówienia.
  • Wymiar – ga:productBrand – nazwa marki, pod którą sprzedawany jest produkt.
  • Wymiar ga:productCategoryHierarchy – kategoria hierarchiczna, do której należy produkt (Ulepszony e-commerce).
  • Wymiar – ga:productCategoryLevelXX – poziom (1–5) w hierarchii kategorii produktów, zaczynając 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 odmiana produktu, np. XS, S, M i L w przypadku rozmiaru oraz czerwony, niebieski, zielony i czarny.
  • Wymiar – ga:checkoutOptions – opcje użytkownika określone w procesie płatności, np. Dostępne opcje dostawy: FedEx, DHL, UPS, karty Visa, Mastercard, AmEx w przypadku opcji płatności. Ten wymiar powinien być zawsze używany wraz z Etapem zakupów.
  • Wymiar ga:shoppingStage – różne etapy zakupu, które użytkownicy ukończyli w danej sesji, np. PRODUCT_VIEW, ADD_TO_CART, CHECKOUT itd.
  • Dane – ga:internalPromotionCTR – współczynnik, z jakim użytkownicy kliknęli, aby wyświetlić 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 środków za transakcję w walucie lokalnej.
  • Dane – ga:productAddsToCart – liczba dodania produktu do koszyka.
  • Dane – ga:productCheckouts – liczba przypadków uwzględnienia produktu w procesie płatności.
  • Dane – ga:productDetailViews – liczba wyświetleń strony ze szczegółami produktu.
  • Dane – ga:productListClicks – liczba kliknięć produktu po jego pojawieniu się na liście produktów.
  • Dane – ga:productListViews – liczba wyświetleń produktu na liście produktów.
  • Dane – ga:productListCTR – częstotliwość, z jaką użytkownicy klikali produkt na liście produktów.
  • Dane – ga:productRefunds – liczba przypadków zwrotu środków za produkt.
  • Dane – ga:productRefundAmount – łączna kwota zwrotu środków powiązana z produktem.
  • Dane – ga:productRemovesFromCart – liczba przypadków usunięcia produktu z koszyka.
  • Dane: ga:productRevenuePerPurchase – średni przychód z produktu na zakup (zwykle używany z kodem kuponu produktu).
  • Dane – ga:buyToDetailRate – liczba unikalnych zakupów podzielona przez liczbę wyświetleń stron ze szczegółami produktów.
  • Dane – ga:cartToDetailRate – dodania produktów podzielone przez wyświetlenia szczegółów produktu.
  • Dane – ga:quantityAddedToCart – liczba jednostek produktu dodanych do koszyka.
  • Dane – ga:quantityCheckedOut – liczba jednostek produktu uwzględnionych w płatności.
  • Dane – ga:quantityRefunded – liczba jednostek produktu, za które zwrócono środki.
  • Dane – ga:quantityRemovedFromCart – liczba jednostek produktu usuniętych z koszyka.
  • Dane – ga:refundAmount – kwota w walucie zwrócona za transakcję.
  • Dane – ga:totalRefunds – liczba dokonanych zwrotów środków.

W tej wersji naprawiliśmy błąd związany z nazwami nagłówków kolumn oraz dodaliśmy nowe wymiary i dane.

Wymiary i dane

Pełną listę definicji znajdziesz w dokumentacji wymiarów i danych.

System

  • Wymiar – ga:sourcePropertyDisplayName – wyświetlana nazwa usługi źródłowej dla 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 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 udostępniane w ramach widoku danych (profilu).
  • 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 – wersja powiązanego produktu.
  • Dane – ga:correlationScore – wynik korelacji dla produktów powiązanych.
  • Dane – ga:queryProductQuantity – liczba produktów, których dotyczy zapytanie.
  • Dane – ga:relatedProductQuantity – ilość powiązanego produktu.

Korekta nazwy kolumny nagłówka

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

Ta wersja obejmuje dodawanie i zmienianie nazw wymiarów i danych. Pełną listę definicji znajdziesz w dokumentacji wymiarów i danych.

Nowe wymiary i dane

Do interfejsu API podstawowego raportowania dodaliśmy te wymiary:

AdWords

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

Godzina

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

Zmienione nazwy wymiarów i danych

Nazwy wszystkich wymiarów i danych związanych z użytkownikiem i wizytą zostały zmienione i używają zamiast nich odpowiednio użytkownika i sesji.

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

Odbiorcy

  • Wymiar – ga:visitorAgeBracket – zamiast niego użyj wymiaru ga:userAgeBracket.
  • Wymiar – ga:visitorGender – zamiast niego użyj wymiaru ga:userGender.

E-commerce

  • Dane – ga:transactionRevenuePerVisit – zamiast tego użyj wymiaru ga:transactionRevenuePerSession.
  • Dane – ga:transactionsPerVisit – zamiast tego użyj wymiaru ga:transactionsPerSession.

Śledzenie zdarzeń

  • Dane – ga:eventsPerVisitWithEvent – zamiast tego użyj wymiaru ga:eventsPerSessionWithEvent.
  • Dane – ga:visitsWithEvent – zamiast tego użyj wymiaru ga:sessionsWithEvent.

Konwersje celu

  • Dane – ga:goalValuePerVisit – zamiast tego użyj wymiaru ga:goalValuePerSession.
  • Dane – ga:percentVisitsWithSearch – zamiast tego użyj wymiaru ga:percentSessionsWithSearch.
  • Dane – ga:searchVisits – zamiast tego użyj wymiaru ga:searchSessions.

Śledzenie strony

  • Dane – ga:pageviewsPerVisit – zamiast tego użyj wymiaru ga:pageviewsPerSession.

Sesja

  • Wymiar – ga:visitLength – zamiast niego użyj wymiaru ga:sessionDurationBucket.
  • Dane – ga:avgTimeOnSite – zamiast tego użyj wymiaru ga:avgSessionDuration.
  • Dane – ga:timeOnSite – zamiast tego użyj wymiaru ga:sessionDuration.
  • Dane – ga:visitBounceRate – zamiast tego użyj wymiaru ga:bounceRate.
  • Dane – ga:visits – zamiast tego użyj wymiaru ga:sessions.

Interakcje społecznościowe

  • Wymiar – ga:socialInteractionNetworkActionVisit – zamiast niego użyj wymiaru ga:socialInteractionNetworkActionSession.
  • Dane – ga:socialInteractionsPerVisit – zamiast tego użyj wymiaru ga:socialInteractionsPerSession.

Użytkownik

  • Wymiar – ga:daysSinceLastVisit – zamiast niego użyj wymiaru ga:daysSinceLastSession.
  • Wymiar – ga:visitCount – zamiast niego użyj wymiaru ga:sessionCount.
  • Wymiar – ga:visitorType – zamiast niego użyj wymiaru ga:userType.
  • Wymiar – ga:visitsToTransaction – zamiast niego użyj wymiaru ga:sessionsToTransaction.
  • Dane – ga:newVisits – zamiast tego użyj wymiaru ga:newUsers.
  • Dane – ga:percentNewVisits – zamiast tego użyj wymiaru ga:percentNewSessions.
  • Dane – ga:visitors – zamiast tego użyj wymiaru ga:users.

Segmenty: interfejs API podstawowego raportowania w wersji 2.4 i 3.0

Obsługa nowych segmentów w interfejsie API podstawowego raportowania.

  • Parametr segment obsługuje teraz segmenty użytkownika i sekwencje. Segmenty na poziomie użytkownika i na poziomie sesji utworzone w interfejsie internetowym można wysyłać za pomocą parametru segment.
  • W parametrze segment dostępna jest nowa składnia segmentów dynamicznych. Więcej informacji znajdziesz w przewodniku dla programistów dotyczącym segmentów.
  • Prefiks dynamic:: został wycofany. Zalecamy jak najszybsze migrate.

Ta wersja zawiera nowy format odpowiedzi Tabela danych oraz możliwość dodawania i wycofywania wymiarów oraz danych (pełną listę definicji znajdziesz w artykule o wymiarach i danych).

Dane wyjściowe tabeli danych

Aby ułatwić renderowanie danych Google Analytics za pomocą wizualizacji z Wykresów Google, interfejs API może opcjonalnie zwrócić w odpowiedzi obiekt tabeli danych.

  • Do interfejsu API dodano opcjonalny parametr zapytania output. Pozwala wybrać w odpowiedzi format wyjściowy danych Analytics. Domyślnie ma on format JSON. Jeśli jest ustawiona na datatable, odpowiedź zawiera właściwość dataTable, która zawiera obiekt tabeli danych. Tego obiektu można używać bezpośrednio z Wykresami Google. Więcej informacji znajdziesz w dokumentacji interfejsu API podstawowego raportowania.

Nowe wymiary i dane

Do interfejsu API podstawowego raportowania dodaliśmy te wymiary i dane:

Godzina

  • Wymiar – ga:minute – zwraca minutę w godzinie. Możliwe wartości mieszczą się w zakresie od 00 do 59.
  • Wymiar – ga:nthMinute – indeks każdej minuty w wybranym zakresie dat. Indeks pierwszej minuty pierwszego dnia (tj. daty rozpoczęcia) w zakresie dat to 0, 1 dla następnej minuty itd.

Odbiorcy

  • Wymiar – ga:visitorAgeBracket – przedział wiekowy użytkownika.
  • Wymiar – ga:visitorGender – płeć użytkownika.
  • Wymiar ga:interestAffinityCategory – wskazuje, że jest bardziej prawdopodobne, że użytkownicy będą zainteresowani uzyskaniem informacji o danej kategorii.
  • Wymiar ga:interestInMarketCategory – wskazuje, że użytkownicy z większym prawdopodobieństwem będą gotowi do zakupu produktów lub usług z danej kategorii.
  • Wymiar ga:interestOtherCategory: wskazuje, że jest bardziej prawdopodobne, że użytkownicy będą zainteresowani uzyskaniem informacji o danej kategorii, co z większym prawdopodobieństwem będą gotowi 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 – zamiast niego użyj wymiaru ga:deviceCategory (np. ga:deviceCategory==mobile).
  • Wymiar ga:isTablet – zamiast niego użyj wymiaru ga:deviceCategory (np. ga:deviceCategory==tablet).
  • Dane – ga:entranceBounceRate – zamiast tego użyj wymiaru ga:visitBounceRate.

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

AdSense

  • Dostęp do danych AdSense został dodany:

    • Met – ga:adsenseRevenue – łączne przychody z reklam AdSense.
    • Met – ga:adsenseAdUnitsViewed – liczba wyświetlonych jednostek reklamowych AdSense. Jednostka reklamowa to zestaw reklam wyświetlanych na podstawie jednego kodu reklamy AdSense. Szczegóły: https://support.google.com/adsense/answer/32715.
    • Met – ga:adsenseAdsViewed – liczba wyświetlonych reklam AdSense. W jednostce reklamowej można wyświetlać wiele reklam.
    • Met – ga:adsenseAdsClicks – liczba kliknięć reklam AdSense w Twojej witrynie.
    • Met – ga:adsensePageImpressions – liczba odsłon, w których wyświetliła się reklama AdSense. Wyświetlenie strony może obejmować wiele jednostek reklamowych.
    • Met – ga:adsenseCTR – odsetek wyświetleń strony, które zakończyły się kliknięciem reklamy AdSense. (ga:adsenseAdsClicks/ga:adsensePageImpressions)
    • Met – ga:adsenseECPM – szacowany koszt tysiąca wyświetleń strony. Jest to wartość przychodów z AdSense na 1000 wyświetleń. (ga:adsenseRevenue/(ga:adsensePageWyświetlenia/1000).
    • Gotowe – ga:adsenseExits – liczba sesji, które zakończyły się po kliknięciu reklamy AdSense przez użytkownika.

Godzina

  • Przyciemnienie – ga:isoYear – rok wizyty zgodnie z ISO. Szczegóły: http://en.wikipedia.org/wiki/ISO_week_date Funkcji ga:isoYear należy używać tylko z atrybutem ga:isoWeek, ponieważ ga:week reprezentuje kalendarz gregoriański.
  • Przyciemniony – ga:isoYearIsoWeek – połączone wartości ga:isoYear i ga:isoWeek.

AdWords

  • Te dane znajdują się w raportach AdWords:

Nowe funkcje kontroli rozmiaru próbki i dat względnych

Daty względne
  • Do interfejsu API podstawowego raportowania dodaliśmy obsługę dat względnych. today, yesterday i NdaysAgo są teraz prawidłowymi wartościami parametrów zapytania start-date i end-date.
  • Użycie tych wartości spowoduje automatyczne określenie zakresu dat na podstawie bieżącej daty w momencie wysłania zapytania oraz strefy czasowej widoku (profilu) określonej 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 obliczania wyniku) dla zapytania raportowania. Dozwolone wartości to DEFAULT, FASTER i HIGHER_PRECISION.
  • Do odpowiedzi interfejsu API dodano 2 nowe pola: sampleSize i sampleSpace. Na podstawie tych wartości możesz obliczyć odsetek wizyt, które zostały wykorzystane na podstawie próbkowanej odpowiedzi.
  • Więcej informacji znajdziesz w dokumentacji API i na stronie próbkowanie.

Poprawki błędów

  • ga:adwordsCustomerID prawidłowo zwraca teraz 10-cyfrowy identyfikator klienta AdWords odpowiadający identyfikatorowi AccountInfo.customerId interfejsu API AdWords. Ta poprawka pozwala na łączenie danych Analytics z wieloma kontami AdWords.

W ramach wprowadzania nowych segmentów wprowadzimy w interfejsie API podstawowego raportowania podane niżej zmiany.

  • Parametr segment obsługuje teraz nowy identyfikator alfanumeryczny dla niestandardowych segmentów zaawansowanych, który jest zwracany w kolekcji Segmenty interfejsu API zarządzania.
  • Obecne identyfikatory numeryczne segmentów niestandardowych są obecnie wycofywane. Starsze identyfikatory będą obsługiwane przez 6 miesięcy. W przypadku aplikacji zapisujących identyfikatory segmentów użytkowników zalecamy przejście na nowe identyfikatory alfanumeryczne. Po zakończeniu okresu wycofywania wszystkie zapytania ze starymi identyfikatorami numerycznymi będą zwracać błąd.
  • Obecnie zapytania za pomocą parametru segment można wysyłać tylko do segmentów poziomu wizyty utworzonych w interfejsie internetowym.
  • Nie będzie to miało wpływu na istniejące segmenty domyślne z ujemnymi identyfikatorami numerycznymi. Nowe segmenty domyślne nie są jednak obecnie obsługiwane.

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

Śledzenie aplikacji

  • W raportach profilu aplikacji znajdują się te dane:
    • Przyciemnij – ga:appId – identyfikator aplikacji.
    • Przyciemnij – ga:appInstallerId – identyfikator instalatora (np. Sklep Google Play), z której aplikacja została pobrana. Domyślnie identyfikator instalatora jest ustawiany za pomocą metody PackageManager#getInstallerPackageName.
    • Przyciemniony – ga:appName – nazwa aplikacji.
    • Przyciemniony – ga:appVersion – wersja aplikacji.
    • Przyciemnienie – ga:exitScreenName – nazwa ekranu, na którym użytkownik zamknął aplikację.
    • Przyciemnienie – ga:landingScreenName – nazwa pierwszego wyświetlonego ekranu.
    • Przyciemnienie – ga:screenDepth – liczba wyświetleń ekranu na sesję zgłoszona w postaci ciągu znaków. Może być przydatna do tworzenia histogramów.
    • Przyciemnienie – ga:screenName – nazwa ekranu.
    • Gotowe – ga:avgScreenviewDuration – średni czas (w sekundach) spędzony przez użytkowników na ekranie.
    • Gotowe – ga:timeOnScreen – czas wyświetlania bieżącego ekranu.
    • Zakończono – ga:screenviews – łączna liczba wyświetleń ekranu. Używaj go zamiast ga:appviews.
    • Przesłane – ga:uniqueScreenviews – liczba różnych (unikalnych) elementów ga:screenviews w ciągu sesji. Używaj go zamiast ga:uniqueAppviews.
    • Zakończono – ga:screenviewsPerSession – średnia liczba zdarzeń ga:screenviews na sesję. Używaj go zamiast ga:appviewsPerVisit.

Wycofano

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

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

Zmienne niestandardowe lub kolumny

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

    • Przyciemnij – ga:dimensionXX – nazwa żądanego wymiaru niestandardowego, gdzie XX oznacza liczbę lub indeks wymiaru niestandardowego.
    • Met – ga:metricXX – nazwa żądanych danych niestandardowych, gdzie XX oznacza liczbę/indeks tych danych.

Zmiany w dokumentacji

Zmieniliśmy nazwę poniższych wymiarów i danych zmiennej niestandardowej. Jest to tylko zmiana w dokumentacji – nie musisz aktualizować zapytań.

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

E-commerce

  • Dim – ga:currencyCode – kod waluty lokalnej transakcji zgodny ze standardem ISO 4217.
  • Met – ga:localItemRevenue – przychody z produktu w walucie lokalnej.
  • Met – ga:localTransactionRevenue – przychody z transakcji w walucie lokalnej.
  • Met – ga:localTransactionShipping – koszt dostawy w ramach transakcji w walucie lokalnej.
  • Met – ga:localTransactionTax – podatek od transakcji w walucie lokalnej.

Wyjątki

  • Te dane pochodzą ze śledzenia wyjątków.
    • Przyciemniony – ga:exceptionDescription – opis wyjątku.
    • Meta – ga:exceptionsPerScreenview – liczba zgłoszonych wyjątków podzielona przez liczbę wyświetleń ekranu.
    • Meta – ga:fatalExceptionsPerScreenview – liczba zgłoszonych krytycznych wyjątków podzielona przez liczbę wyświetleń ekranu.

Konwersje celu

  • Przyciemnienie – ga:goalCompletionLocation – ścieżka do strony lub nazwa ekranu, które pasują do realizacji celu dowolnego typu miejsca docelowego.
  • Przyciemnienie – ga:goalPreviousStep1 – ścieżka strony lub nazwa ekranu pasujące do dowolnego celu typu miejsca docelowego, o krok przed lokalizacją realizacji celu.
  • Przyciemnienie – ga:goalPreviousStep2 – ścieżka strony lub nazwa ekranu pasujące do dowolnego celu typu miejsce docelowe, 2 kroki przed lokalizacją realizacji celu.
  • Przyciemnienie – ga:goalPreviousStep3 – ścieżka strony lub nazwa ekranu pasujące do dowolnego celu typu miejsce docelowe, 3 kroki przed lokalizacją realizacji celu.

Zmiany w dokumentacji

Zmieniliśmy nazwę poniższego wymiaru i danych konwersji celu. Jest to tylko zmiana w dokumentacji – nie musisz aktualizować 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
  • Meta – ga:percentSearchRefinements – odsetek przypadków zawężenia wyszukiwania (tj. przejścia) między słowami kluczowymi w sieci wyszukiwania w ciągu jednej sesji.

Śledzenie strony

  • Met – ga:pageValue – średnia wartość tej strony lub zestawu stron. Wartość strony to ((przychody z transakcji + łączna wartość celu) podzielona przez unikalne odsłony strony lub zestawu stron).

Platforma lub urządzenie

  • Te dane pochodzą z ciągu znaków klienta użytkownika HTTP.

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

Interakcje społecznościowe

  • Te dane pochodzą ze śledzenia interakcji społecznościowych w witrynie.

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

Godzina

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

Źródła wizyt

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

Ta wersja dodaje do interfejsu API nowe wymiary i dane. Definicje znajdziesz w dokumentacji wymiarów i danych.

Śledzenie aplikacji

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

Źródła wizyt

  • Przyciemnij – 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 siecią społecznościową w przypadku działań w centrum danych społecznościowych. Np. Google+, Blogger, Reddit itp.
  • Przyciemnienie – ga:hasSocialSourceReferral – wskazuje wizyty, które trafiły do witryny ze źródła społecznościowego (np. z sieci społecznościowej Google+, Facebooka, Twittera itp.). Możliwe wartości to Yes (Tak) lub No (Nie), przy czym pierwsza litera musi być wielką literą.

Działania społecznościowe

  • Te dane pochodzą z aktywności poza witryną zaimportowanych od partnerów centrum danych społecznościowych.
    • Przyciemnij – ga:socialActivityDisplayName – w przypadku działania w centrum danych społecznościowych ten ciąg stanowi tytuł działania społecznościowego opublikowanego przez użytkownika sieci społecznościowej.
    • Przyciemnij – ga:socialActivityEndorsingUrl – w przypadku działania w centrum danych społecznościowych ten ciąg reprezentuje adres URL tego działania (np.URL posta w Google+, URL komentarza na blogu itp.).
    • Przyciemnij – ga:socialActivityPost – w przypadku działania w centrum danych społecznościowych ten ciąg znaków reprezentuje treść działania społecznościowego opublikowaną przez użytkownika sieci społecznościowej (np. treść wiadomości posta w Google+)
    • Przyciemnij – ga:socialActivityTimestamp – w przypadku działania w centrum danych społecznościowych ten ciąg oznacza, kiedy działanie społecznościowe miało miejsce w sieci społecznościowej.
    • Przyciemnij – ga:socialActivityUserPhotoUrl – w przypadku działania w centrum danych społecznościowych ten ciąg reprezentuje adres URL zdjęcia powiązanego z profilem użytkownika w sieci społecznościowej.
    • Przyciemnij – ga:socialActivityUserProfileUrl – w przypadku działania w centrum danych społecznościowych ten ciąg to adres URL powiązanego profilu użytkownika w sieci społecznościowej.
    • Przyciemnij – ga:socialActivityContentUrl – w przypadku działania w centrum danych społecznościowych ten ciąg znaków reprezentuje URL udostępniony przez powiązanego użytkownika sieci społecznościowej.
    • Przyciemnij – ga:socialActivityTagsSummary – w przypadku działania w centrum danych społecznościowych jest to rozdzielany przecinkami zestaw tagów powiązanych z działaniem społecznościowym.
    • Przyciemnij – ga:socialActivityUserHandle – w przypadku działania w centrum danych społecznościowych ten ciąg znaków reprezentuje nick (tj. nazwę) sieci społecznościowej, który zainicjował działanie społecznościowe.
    • Przyciemnij – ga:socialActivityAction – w przypadku działania w centrum danych społecznościowych ten ciąg znaków reprezentuje typ interakcji społecznościowej związanej z danym działaniem (np. głos, komentarz, +1-kę).
    • Przyciemnij – ga:socialActivityNetworkAction – w przypadku działania w centrum danych społecznościowych ten ciąg reprezentuje typ interakcji społecznościowej i sieci społecznościowej, z której ono pochodzi.
    • Meta – ga:socialActivities – liczba działań, w przypadku których udostępniono lub wspomniano o adresie URL treści w sieci partnerskiej centrum danych społecznościowych.

Interakcje społecznościowe

  • Te dane pochodzą ze śledzenia interakcji społecznościowych w witrynie.
    • Przyciemnienie – ga:socialInteractionAction – w przypadku interakcji społecznościowych ciąg reprezentujący śledzoną interakcję społecznościową (np. +1, polubienie, zakładka)
    • Przyciemnij – ga:socialInteractionNetwork – w przypadku interakcji społecznościowych ciąg reprezentujący śledzoną sieć społecznościową (np. Google, Facebook, Twitter, LinkedIn)
    • Przyciemnienie – ga:socialInteractionNetworkAction – w przypadku interakcji społecznościowych ciąg znaków reprezentujący łączenie śledzonych elementów ga:socialInteractionNetwork i ga:socialInteractionAction (np.Google: +1, Facebook: polubienie).
    • Przyciemnij – ga:socialInteractionTarget – w przypadku interakcji społecznościowych ciąg znaków reprezentujący adres URL (lub zasób), który odbiera działanie sieci społecznościowej.
    • Gotowe – ga:socialInteractions – łączna liczba interakcji społecznościowych w Twojej witrynie.
    • Gotowe – 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 na wizytę w Twojej witrynie.

Dane geograficzne / sieć

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

Śledzenie strony

  • Przyciemnij – ga:pagePathLevel1 – ten wymiar zbiera wszystkie ścieżki pagePath na pierwszym poziomie hierarchii w interfejsie pagePath.
  • Przyciemniony – ga:pagePathLevel2 – ten wymiar zbiera wszystkie ścieżki pagePath na drugim poziomie hierarchii w metodzie pagePath.
  • Przyciemnij – ga:pagePathLevel3 – ten wymiar zbiera wszystkie ścieżki pagePath na trzecim poziomie hierarchii w interfejsie pagePath.
  • Przyciemniony – ga:pagePathLevel4 – ten wymiar zbiera wszystkie ścieżki pagePath na czwartym poziomie hierarchii w interfejsie pagePath. Wszystkie dodatkowe poziomy hierarchii pagePath zostaną również zebrane w tym wymiarze.

Śledzenie wyjątków

  • Te dane pochodzą z danych śledzenia wyjątków.

    • Ukończono – ga:exceptions – liczba wyjątków wysłanych do Google Analytics.
    • Meta – ga:fatalExceptions – liczba wyjątków, dla których wymiar isFatal ma wartość Prawda.

Czas działań użytkownika

  • Te dane pochodzą z danych o czasie działań użytkowników.

    • Przyciemnij – ga:userTimingCategory – ciąg znaków do kategoryzowania wszystkich zmiennych czasu działań użytkowników w grupy logiczne, co ułatwia raportowanie.
    • Przyciemnij – ga:userTimingLabel – ciąg tekstowy wskazujący nazwę działania śledzonego zasobu.
    • Przyciemnij – ga:userTimingVariable – ciąg znaków, którego można używać, aby zwiększyć elastyczność w wizualizowaniu czasu działań użytkownika w raportach.
    • Przyciemnienie – ga:userTimingValue liczba milisekund w upływie czasu wysłanym do Google Analytics.
    • Met – ga:userTimingSample – liczba wysłanych próbek.
    • Met – ga:avgUserTimingValue – wartość średniego czasu działań użytkownika. ga:userTimiingValue / ga:userTimiingSample.

Urządzenie / platforma

  • Te dane pochodzą od klienta użytkownika zebranych danych.
    • Wymaż – ga:mobileDeviceBranding – nazwa producenta urządzenia mobilnego lub nazwa marki (np. Samsung, HTC, Verizon, T-Mobile).
    • Przyciemniony – ga:mobileDeviceModel – model urządzenia mobilnego (np. Nexus S)
    • Przyciemnienie – ga:mobileInputSelector – selektor używany na urządzeniu mobilnym (np. ekran dotykowy, joystick, kółko, rysik)
    • Dim - ga:mobileDeviceInfo – marka, model i nazwa marketingowa, które służą do identyfikacji urządzenia mobilnego.

Poprawki błędów

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

Ta wersja umożliwia kontom Google Analytics Premium dostęp do maksymalnie 50 zmiennych niestandardowych.

W tej wersji naprawiliśmy dwa błędy:

Poprawki błędów

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

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

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

Nowe dane

  • Dodaliśmy te dane o 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 w dokumentacji wymiarów i danych.

Przypomnienie o wycofaniu interfejsu API w wersji 2.3

  • Wersja 2.3 interfejsu Data Export API została wycofana od 2 miesięcy. Za około 4 miesiące wyłączymy tę usługę i będziemy obsługiwać tylko nowy interfejs Core Reporting API w wersjach 3.0 i 2.4.

  • Zdecydowanie zalecamy migrację aplikacji do wersji 3.0.

  • Za 4 miesiące żądania przesłania pliku danych w formacie XML starszego typu 2.3 zostaną przekierowane do wersji 2.4 i zwrócą odpowiedź XML w wersji 2.4. Od tego momentu do żądań w wersji 2.3 będą miały zastosowanie wszystkie zasady dotyczące limitów przydziału w wersji 2.4.

  • Wszystkie żądania dotyczące formatu JSON w wersji 2.3 lub biblioteki klienta JavaScript danych Google, która używa danych wyjściowych JSON w wersji 2.3, zwracają 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żyć klucza interfejsu API (lub tokena OAuth 2.0) w każdym żądaniu.

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

Ta wersja dotyczy wszystkich programistów korzystających z interfejsu Google Analytics API. Ogłasza 2 nowe wersje interfejsu API, wymaga od aplikacji rejestracji, wprowadza nowe zasady dotyczące limitów i zmienia nazwę interfejsu API na interfejs API podstawowego raportowania. Na koniec wycofuje obecny interfejs Data Export API w wersji 2.3.

Versja 3.0

  • Interfejs Core Reporting API w wersji 3.0 to najnowsza główna wersja naszego interfejsu API i nie jest zgodna wstecznie. Wszystkie przyszłe udoskonalenia interfejsu API będą odbywać się na tej wersji.

  • Nowe funkcje

  • Aktualizacje

    • Nowy adres URL do wysyłania żądań: https://www.googleapis.com/analytics/v3/data/ga….
    • Wymagane są tokeny rejestracji i programistów.
    • Wszystkie żądania danych konfiguracji należy realizować za pomocą interfejsu API zarządzania Google Analytics.

Wersja 2.4

  • Interfejs Core Reporting API w wersji 2.4 to drobne uaktualnienie, które jest w większości zgodne wstecznie z dotychczasowym interfejsem Data Export API w wersji 2.3.

  • Aktualizacje

    • Nowy adres URL, do którego można wysyłać prośby: https://www.googleapis.com/analytics/v2.4/data…
    • Wymagane są tokeny rejestracji i programistów.
    • Dane wyjściowe XML zgodne z wersją 2.3, więc pozostałe biblioteki klienta danych Google będą nadal działać.
    • Kod błędu dotyczący 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 konta. Wszystkie żądania danych konfiguracji należy realizować za pomocą interfejsu API zarządzania Google Analytics.

Rejestracja

  • Wszystkie aplikacje utworzone przy użyciu interfejsu Google Analytics API należy zarejestrować jako projekt w Konsoli interfejsów API Google.

  • Każde żądanie wysyłane do interfejsu API musi zawierać klucz interfejsu API lub w przypadku protokołu OAuth 2.0 identyfikator klienta i tajny klucz klienta.

Zasady dotyczące limitów

  • Poniższy limit dotyczy zarówno interfejsów Anlaytics API (interfejsów API zarządzania, jak i Data Export API)

    • 50 000 żądań na projekt dziennie.
    • 10 zapytań na sekundę na adres IP,
  • W przypadku interfejsu Data Export API obowiązuje limit

    • 10 000 żądań na profil dziennie.
    • 10 równoczesnych żądań na profil.
  • W przypadku niezarejestrowanych aplikacji oferujemy bardzo niski limit prolongaty ze względu na niewielką ilość testów.

Elementy wycofane

  • W tej wersji zapowiadamy również wycofanie wersji 2.3 i zbliżające się wyłączenie pliku danych konta z interfejsu Data Export API. W ciągu 6 miesięcy:

    • Żądania wysyłane do plików danych w formacie XML w wersji 2.3 zostaną przekazane do wersji 2.4 i zwrócą odpowiedź w wersji 2.4. Od tego momentu do żądań w wersji 2.3 będą miały zastosowanie wszystkie zasady dotyczące limitów przydziału w wersji 2.4.

    • Żądania wysyłane do danych wyjściowych JSON w wersji 2.3 nie będą obsługiwane przez odpowiedź w wersji 2.4 i będą zwracać kody stanu 404 Not Found. Jeśli potrzebujesz odpowiedzi JSON, uaktualnij ją do wersji 3.0.

    • Żądania wysyłane do pliku danych konta w interfejsie API eksportu danych będą zwracać kody stanu 404 Not Found. Wszystkie żądania danych konfiguracji należy realizować za pomocą interfejsu API zarządzania Google Analytics.

W tej wersji dostępne są nowsze dane Google Ads oraz więcej kombinacji wymiarów i danych AdWords.

  • Dane AdWords są teraz aktualizowane w ciągu godziny. Przed codzienną aktualizacją danych

  • Złagodziliśmy ograniczenia dotyczące prawidłowych kombinacji w danych AdWords.

Kilka tygodni temu wprowadziliśmy zmianę, która uniemożliwia wysyłanie zapytań do interfejsu API, które wysyłały żądanie ga:adGroup lub ga:adContent z wartością ga:impressions, ponieważ ta kombinacja zwraca wartość 0. Po wprowadzeniu tej zmiany ta kombinacja jest cofnięta i została naprawiona, aby zwracać prawidłowe dane.

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

Usunięto nieprawidłowe kombinacje danych i wymiarów

  • W zeszłym miesiącu zapowiedzieliśmy wprowadzenie zmian w interfejsie API, których celem jest zakazanie wyświetlania w pliku danych nieprawidłowych zapytań, które nie zwracają żadnych danych. Te zmiany zostały wprowadzone w interfejsie API i te kombinacje są nieprawidłowe:

    • Wymiarów produktów nie można łączyć z danymi o transakcjach.
    • Wartości ga:adContent i ga:adGroup nie można łączyć z ga:impressions.

    Zamiast zwracać odpowiedź z zerową liczbą wyników, API zwraca teraz kod błędu 400 w przypadku wszystkich zapytań, które dotyczą tych kombinacji.

W tej wersji wycofujemy wartość przedziału ufności danych.

Wycofanie przedziału ufności

  • W razie potrzeby przestań używać w przypadku danych wartości przedziału ufności. W tej wersji plik danych interfejsu API eksportu danych zwraca wartość 0, 0 dla wszystkich wartości przedziału ufności. Za około miesiąc usuniemy ten atrybut ze wszystkich elementów danych.

    Aby określić, czy odpowiedź została spróbkowana, użyj w odpowiedzi pola containsSampledData.

W tej wersji dodaliśmy 3 nowe wskaźniki i zmieniono wartość zwrotu równą 2.

Nowe aktualizacje danych

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

Aktualizacje wskaźników

  • Aby określić wartości waluty w filtrach, musisz podać rzeczywistą wartość przekazaną z kodu śledzenia (np. 1 jednostka zostanie określona jako 1).

  • Funkcja ga:CTR zwraca teraz rzeczywistą wartość procentową (np. wartość 2% jest zwracana jako 2).

Ta wersja zwiększa wydajność pliku danych i dodaje nowe dane:

Poprawa wydajności

  • Ta wersja skraca opóźnienie przesyłania pliku danych o 30–35%.

Nowe aktualizacje danych

  • Zaktualizowaliśmy listę wymiarów i danych, które są dozwolone w zaawansowanych segmentach. Zapoznaj się ze zaktualizowaną listą, aby upewnić się, że Twoje prośby są prawidłowe.

Nadchodzące zmiany

  • Obecnie wartość filtra waluty musisz podać w mikrojednostkach (np.1 jednostka waluty jest określona jako 1 000 000). W najbliższej przyszłości trzeba będzie określić rzeczywistą wartość przekazaną z kodu śledzenia (np. 1 jednostka zostanie teraz określona jako 1).

  • Obecnie ga:CTR ma typ percent i zwraca wartość 0, 02. W najbliższej przyszłości zmieni się ona, tak aby zwracała rzeczywistą wartość procentową (np. 2).

Ta wersja dodaje więcej danych do pliku danych:

Nowe aktualizacje danych

  • Dodano ten wymiar Czas: ga:dayOfWeek

  • Dodaliśmy te dane wyszukiwania w wewnętrznej wyszukiwarce: ga:percentVisitsWithSearch

  • Dodaliśmy te dane śledzenia zdarzeń:

    • ga:visitsWithEvent
    • ga:eventsPerVisitWithEvent

Nadchodzące zmiany

Obecnie interfejs API zwraca kody stanu 401 w przypadku różnych problemów z autoryzacją. W ciągu najbliższych kilku tygodni stan 401 będzie używany wyłącznie w przypadku nieprawidłowych tokenów, co pozwoli deweloperom na naprawienie błędu.

Ta wersja dodaje znacznie więcej danych do pliku danych:

Nowe aktualizacje danych

  • Zmieniliśmy metodę obliczania danych ga:visitors, by zwracała liczbę unikalnych użytkowników w wybranym zakresie dat. Teraz obsługuje 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.

  • Wskaźnik ga:organicSearches został dodany do grupy kampanii.

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

  • Dodano 3 nowe wymiary czasowe: ga:nthDay, ga:nthWeek i ga:nthMonth.

  • Grupowanie wymiarów i danych zostało zmienione, by lepiej odzwierciedlały funkcje, które reprezentują.

Nowe obliczone dane

Poniższe obliczone dane pochodzą z obliczeń opartych na danych podstawowych. Uwaga: każda nazwa zawierająca ciąg (n) obsługuje wartości od 1 do 20.

  • Zrealizowano cel: 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.

  • Wewnętrzna wyszukiwarka w witrynie: ga:avgSearchDepth, ga:avgSearchDuration, ga:avgSearchResultViews, ga:searchGoalConversionRateAll, ga:searchGoal(n)ConversionRate, ga:searchExitRate.

  • Oparte na e-commerce: 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ę pliku danych:

Nowe funkcje

  • Został dodany nowy element XML, który informuje użytkowników o tym, czy dane były próbkowane. true. Ten element będzie zawsze zwracać niezależnie od tego, czy dane zostały próbkowane czy nie za pomocą true czy false. Zaktualizowaliśmy również biblioteki Java i JavaScript, dodając metody pomocnicze umożliwiające dostęp do tego elementu.

W tej wersji naprawiliśmy dwa błędy:

Poprawki błędów

  • Wcześniej dodanie operatora LUB do wyrażenia filtra z wymiarem (np. ga:keyword==store,ga:keyword==bar) może zwrócić inne wartości niż gdyby każdy filtr był stosowany oddzielnie do wielu zapytań. Problem został rozwiązany i użycie operatora LUB zwraca teraz spójne wartości.

  • Niektóre komunikaty o błędach interfejsu API związane z nieprawidłowymi filtrami zostały zaktualizowane i nie uwzględniają, czy błąd był spowodowany filtrem wymiaru lub danych (chociaż nadal będzie zwracane nieprawidłowe wyrażenie filtra).

W tej wersji naprawiliśmy 3 błędy:

Poprawki błędów

  • Rozwiązaliśmy problem z kodowaniem w bibliotece klienta JavaScript. Analytics Issue Tracker

  • Naprawiono błąd, który uniemożliwiał wyświetlanie pliku danych konta po nieprawidłowym ustawieniu nazwy celu, ścieżki celu, wartości porównania celów lub typu porównania celów.

  • Nie można zastosować operatora LUB do wymiaru i danych w parametrze filtra zapytania w pliku danych. Przykład: ga:source==google,ga:visits>5. Komunikat o błędzie dotyczący tego nieprawidłowego zapytania został zmieniony na: Cannot OR dimension filter(s) with metric filter.

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

Nowe funkcje

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

    • ga:adwordsAdGroupId: odpowiada wartości AdGroup.id interfejsu AdWords API
    • ga:adwordsCampaignId: odpowiada wartości Campaign.id interfejsu AdWords API.
    • ga:adwordsCreativeId: odpowiada parametrowi Ad.id interfejsu AdWords API
    • ga:adwordsCriteriaId: odpowiada parametrowi Criterion.id interfejsu AdWords API
    • ga:adwordsCustomerId: odpowiada parametrowi AccountInfo.customerId interfejsu API AdWords

Poprawki błędów

  • Rozwiązaliśmy problem, który powodował, że plik danych konta nie zwracał danych, jeśli jeden z profili miał nieprawidłowo skonfigurowany cel lub krok.

Ta wersja zawiera szereg nowych funkcji i poprawki błędów:

Nowe funkcje

  • Domyślny segment iPhone'a (gaid::-11) został ulepszony i można teraz generować 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. Dzięki temu dane z próbkowanych raportów są wbudowane w interfejs internetowy i zwiększają spójność między nimi.

  • Zasada dotycząca limitów została zaktualizowana, aby zapewnić wszystkim użytkownikom równy dostęp do zasobów. Więcej informacji znajdziesz w dokumentacji dotyczącej zasad limitów. 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 tylko 4 oczekujące prośby.
  • Niektóre ograniczenia dotyczące kombinacji wymiarów i danych zostały złagodzone. ga:nextPagePath i ga:previousPagePath są teraz częścią grupy D3. Content. Grupa D8. Custom Variable to teraz grupa D6. Custom Variable. Zapoznaj się ze zaktualizowanym przewodnikiem referencyjnym dla tych nowych kombinacji.

Poprawki błędów

  • Naprawiliśmy błąd związany z raportowaniem wartości danych confidenceInterval przez interfejs API. Wcześniej przedziały ufności mogły mieć wartość INF lub liczbę z zakresu od 0 do 1. Teraz wszystkie przedziały ufności będą miały wartość INF lub liczbę większą lub równą 0.

  • Jednostki ga:itemQuantity i ga:uniquePurchases zostały wcześniej zamienione i zwróciły swoje wartości. Teraz zostały naprawione i zwracają prawidłowe dane.

Przypomnienie o wycofaniu wymiarów i danych

  • Jeśli nie korzystasz już z wycofanych wcześniej wymiarów i danych, przestań je używać

W tej wersji wprowadzono szereg nowych funkcji:

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

  • Niektóre funkcje wymagają używania najnowszych bibliotek klienta. Oficjalnie obsługujemy: Java i JavaScript. Biblioteki innych firm mogą nie zostać jeszcze zaktualizowane.

    • Wersję 2 można zażądać, dodając nagłówek GData-Version: 2 do każdego konta lub żądania pliku danych. Więcej informacji znajdziesz w dokumentacji.
    • Do konta i plików danych dodano nową przestrzeń nazw XML:
      xmlns:ga='http://schemas.google.com/ga/2009'
  • Interfejs API obsługuje teraz protokół danych Google w wersji 2.

Obsługa zaawansowanej segmentacji

  • Parametr zapytania do segmentów dynamicznych:

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

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

    • ga:visitorType==Returning Visitor
  • Plik danych zawiera również element XML wskazujący, czy dany segment został zastosowany w żądaniu do interfejsu API.

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

Dostępne są nowe dane dotyczące celu

  • Cele typu miejsca docelowe i zaangażowanie dostępne w pliku danych na koncie:

  • Dodano 48 nowych rodzajów danych celów 5–20. Wszystkie są zgodne 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
  • Cele GoalCompletionAll, GoalStartsAll i GoalValueAll zostały zaktualizowane, aby uwzględniać nowe dane celów.

Nowe dane zmiennej niestandardowej

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

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

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

Wycofane wymiary i dane zostaną usunięte.

  • Jeśli jeszcze nie używasz wycofanych wymiarów i danych, przestań je stosować. Wkrótce zostaną usunięte, a w razie potrzeby będą zwracać błędy z naszego interfejsu API.

    • ga:countOfVisits
    • ga:countOfVisitsToATransaction
    • ga:sourceMedium
    • ga:percentNewVisits
  • Zmieniliśmy nazwy tych wymiarów:

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

Ta wersja dodaje nowe funkcje i wycofuje niektóre starsze.

  • Podane niżej wymiary i dane zostały wycofane. Za miesiąc trwale usuniemy je z naszego interfejsu API. Pamiętaj o zaktualizowaniu kodu, aby aplikacje nie zepsuły się:

    • ga:countOfVisits
    • ga:countOfVisitsToATransaction
    • ga:sourceMedium
    • ga:percentNewVisits
  • Zmieniliśmy 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:uniqueEvents

  • Ogólne dane dotyczące nawigacji w witrynie są teraz wyświetlane w ramach tych wymiarów:

    D6. Nawigacja * ga:previousPagePath * ga:nextPagePath

  • Nawigacja po stronie docelowej jest teraz wyświetlana w tych wymiarach:

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

  • Maksymalna długość wyrażeń regularnych w parametrze zapytania filtra pliku danych została podniesiona z 32 do 128 znaków.

  • Raport Długość odwiedzin (dostępny z poziomu interfejsu użytkownika w sekcji Użytkownicy -> Lojalność użytkowników) jest obecnie wyświetlany za pomocą nowego wymiaru:

    • ga:visitLength

W tej wersji interfejs API eksportowania danych usługi Google Analytics zostanie zaktualizowany w następujący sposób:

  • Niektóre ograniczenia dotyczące kombinacji wymiarów i danych zostały złagodzone. Możesz teraz wysyłać zapytania dotyczące większości wymiarów na poziomie treści i użytkownika, na przykład 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.

  • Łączna liczba wierszy, o które można poprosić w ramach jednego żądania, została zwiększona do 10 000. Domyślna liczba zwracanych wierszy to nadal 1000,ale można ją teraz zwiększyć, ustawiając parametr zapytania max-results.

  • Plik danych konta zwraca teraz 2 nowe elementy danych dla każdego identyfikatora tabeli (waluty i strefy czasowej).

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

  • Wszystkie poprzednie wycofywane zmiany zostały wprowadzone.

Ta wersja usuwa wycofane funkcje z prywatnej wersji beta:

  • Żądania pliku danych dotyczące konta nie będą już obsługiwać nazwy użytkownika. Akceptuje tylko żądania w tym formacie:
    https://www.google.com/analytics/feeds/accounts/default

  • Te dane zostaną usunięte i przestaną działać. Zamiast tego udostępniliśmy instrukcje obliczania tych wartości na stronie http://code.google.com/apis/analytics/docs/gdata/gdataReferenceCommonCalculations.html.

    • ga:avgPageDuration
    • ga:avgPageviews
    • ga:avgSessionTime
    • ga:bounceRate
    • ga:exitRate
    • ga:costPerConversion
    • ga:costPerGoalConversion
    • ga:costPerTransaction
    • ga:revenuePerClick
    • ga:revenuePerTransaction
    • ga:revenuePerVisit
    • ga:porzucone ścieżki1
    • ga:porzucone ścieżki2
    • ga:porzucone ścieżki3
    • ga:porzucone ścieżki4
    • ga:goalConversionRate
    • ga:celConversionRate1
    • ga:celConversionRate2
    • ga:celConversionRate3
    • ga:celConversionRate4
    • ga:goalValuePerVisit
  • Zmieniliśmy nazwy tych wymiarów i danych. Stare nazwy nie będą już działać. Sprawdź, czy używasz oficjalnych nazw podanych w naszej dokumentacji: http://code.google.com/apis/analytics/docs/gdata/gdataReferenceDimensionsMetrics.html

    Wymiary * ga:subContinentRegion:internalSearch0

    Wskaźniki * ga:newGuests:gogagosGoalGogagoalGogagoalGogajogółoknogi-koni