Google Analytics – wszystkie dzienniki zmian interfejsu API

Na tej stronie znajdują się informacje o zmianach wprowadzonych we wszystkich interfejsach API i pakietach SDK Google Analytics. Obejmuje logi zmian wszystkich czynności dotyczących zbierania danych, raportowania i konfiguracji. Zalecamy okresowe sprawdzanie tej listy 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.

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.

Ustawienia przechowywania danych użytkowników w interfejsie Management API

Można teraz programowo konfigurować ustawienia przechowywania danych użytkownika za pomocą nowych pól „dataPrzechowywanieTtl” i „dataRestoreResetOnNewActivity” dodanych do zasobu WebProperty.

Oto pierwsza wersja interfejsu User Deletion API:

  • Interfejs User Deletion API pozwala klientom Google Analytics usuwać z projektu lub usługi internetowej dane określonego użytkownika. Prośby o usunięcie użytkownika można przesyłać za pomocą projektów Firebase lub usług Google Analytics. Więcej informacji znajdziesz w artykule z opisem interfejsu User Deletion API.

Operacje zapisu w interfejsie API zarządzania

Operacje zapisu w interfejsie API zarządzania (np. tworzenie, aktualizowanie, usuwanie, poprawka) dla zasobów usługi internetowej, widoku (profil) i celów nie wymagają już umieszczania na białej liście. Domyślny limit dzienny dla wszystkich operacji zapisu w interfejsie Management API to 50 zapisów dziennie. Więcej informacji znajdziesz na stronie Limity i limity.

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 wprowadziliśmy zmiany w limitach interfejsu Analytics Real Time API.

Wywołania interfejsu Analytics Real Time Reporting API użyte do uzyskania 10 000 wywołań na wyświetlenie (profil) dziennie (tak jak w przypadku innych wywołań interfejsu Analytics API). Obecnie wywołania interfejsu API do raportowania w czasie rzeczywistym są rozliczane oddzielnie, co oznacza, że można wykonać 10 000 wywołań dziennie na widok (profil) przy użyciu interfejsu Analytics Real Time Reporting API ORAZ wykonywać kolejne 10 000 wywołań dziennie na widok (profil) przy użyciu innych interfejsów API Analytics. Więcej informacji znajdziesz na stronie Limity i limity.

Ta zmiana umożliwia bardziej szczegółowe i bezpieczne zarządzanie limitami, dzięki czemu częste wywołania interfejsu Analytics Real Time Reporting API nie będą przypadkowo blokować wszystkich innych wywołań tego interfejsu Analytics API do końca dnia dla danego profilu.

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).

Dodano adresy URL „android-app://” jako prawidłowe źródło odesłania.

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.

Wskaźniki niestandardowe

Jest to poprawka błędów. Rozwiązano problem polegający na tym, że nie można było utworzyć danych niestandardowych typu TIME, gdy nie ustawiono parametru min_value. Żądania bez wartości min_value tworzą teraz dane niestandardowe z domyślną wartością min_value w polu 0.

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 zawiera:

Google Analytics

  • Zgodność z iOS 10 i poprawki błędów.

Ta wersja zawiera:

Google Analytics

  • Poprawki awarii.

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. Pełną listę definicji znajdziesz w dokumentacji wymiarów i danych.

Identyfikator transakcji

  • wymiar mcf:transactionId – identyfikator transakcji podany przez metodę śledzenia e-commerce i dotyczący zakupu w koszyku.

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 dodano nowy atrybut: addedInApiVersion.

Dodano w wersji interfejsu API

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.

Niespróbkowane raporty

W interfejsie API niespróbkowanych raportów nie obowiązuje już limit 100 raportów dziennie. Interfejs API korzysta z tego samego systemu tokenów według usługi i danego dnia co przy tworzeniu niespróbkowanego raportu w interfejsie internetowym.

Niespróbkowane raporty

Niespróbkowane raporty, które są niedostępne dla bieżącego użytkownika, nie będą już zawierać linku do pobierania w odpowiedzi interfejsu API zarządzania. Działa to teraz tak samo jak w panelu interfejsu, gdzie tylko właściciele raportów mogą zobaczyć link do pobierania wygenerowanego dokumentu.

Ta wersja zawiera:

Google Analytics

  • Nic się nie zmieni.

Menedżer tagów Google

  • Rozwiązaliśmy problem, który powodował awarię podczas testów jednostkowych.

Segmenty

Jest to wersja z poprawką błędów. W tej wersji rozwiązaliśmy problem, który powodował, że segmenty z wartościami waluty w definicji wyświetlały się nieprawidłowo podczas wywoływania metody listy segmentów.

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 zawiera:

Google Analytics

  • Dodano obsługę kodu bitowego.

Menedżer tagów Google

  • Dodano obsługę kodu bitowego.

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.

Segmenty

Jest to wersja z poprawką błędów. Rozwiązano w niej problem, który powodował, że użytkownicy z segmentami prywatnymi przypiętymi do wielu widoków danych (profili) otrzymywali odpowiedź o błędzie 500 podczas wywoływania metody listy segmentów.

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ć.

W tej wersji do adresu URL Warunków korzystania z interfejsu API do obsługi administracyjnej dodano dodatkowy parametr:

  • Dodanie parametru URL (provisioningSignup=false) rozwiązuje problem, który pojawia się podczas udostępniania konta Google Analytics użytkownikowi, który nie ma żadnych kont Google Analytics. Deweloperzy powinni zaktualizować swój kod, aby dodać ten parametr do adresu URL Warunków korzystania z usługi.

Grupowanie

W tej wersji oprócz ogólnej pomocy zbiorczej dodaliśmy specjalną obsługę interfejsu User Permissions API. Zbiorcze prośby o uprawnienia użytkowników spowodują znaczny wzrost wydajności i zmniejszenie wykorzystania limitu.

Wyświetlenia (profile)

W tej wersji właściwość Widok (profil) currency będzie domyślnie ustawiona na USD, jeśli nie zostanie ustawiona podczas operacji insert. Również operacje get i list zwracają USD w przypadku widoków danych (profili), które zostały utworzone wcześniej bez właściwości currency.

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 zawiera:

Google Analytics

  • Naprawiono błąd, który powodował awarię podczas korzystania z funkcji setCampaignParametersFromUrl. Numer 636.

Menedżer tagów Google

  • Nic się nie zmieni.

Filtry

W tej wersji po raz ostatni usunęliśmy wycofane pola filtrów IS_MOBILE i IS_TABLET. Należy je zastąpić polami DEVICE_CATEGORY=mobile i DEVICE_CATEGORY=tablet. Żądania wstawiania, aktualizacji i poprawek, które ustawiono w polach filtrów na podstawie IS_MOBILE i IS_TABLET, zwracają błąd.

Ta wersja zawiera:

Google Analytics

  • Nic się nie zmieni.

Menedżer tagów Google

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.

Filtry

W tej wersji dodaliśmy możliwość korzystania z wymiaru niestandardowego w polu filtra przez dodanie właściwości fieldIndex do wszystkich sekcji szczegółów filtra. Można na przykład ustawić wyrażenie filtra z zastosowaniem "field": "CUSTOM_DIMENSION" i "fieldIndex": "1", aby filtr działał na pierwszym wymiarze niestandardowym.

Cele

W tej wersji rozwiązano też problem, który powodował, że tworzenie celu za pomocą funkcji "comparisonValue": "0" kończyło się niepowodzeniem.

Ta wersja zawiera:

Google Analytics

  • Dodaliśmy obsługę wysyłania w tle na urządzeniach spoza Google Play.
  • Wycofano usługę Analytics Logger/LogLevel. Analytics korzysta teraz z logowania w Androidzie. Aby włączyć logowanie debugowania, uruchom adb shell setprop log.tag.GAv4 DEBUG.
  • Refaktoryzacja w celu poprawy dostarczania danych i ustalania atrybucji kampanii.
  • Usunięto błąd analizy kampanii. Wydanie 596.
  • Nieobsługiwane wyjątki aplikacji w pierwszych sekundach inicjowania Analytics są prawidłowo raportowane. Numer 443.

Menedżer tagów Google

  • Bez zmian.

Ta wersja zawiera:

Google Analytics

  • Zgłaszaj rozdzielczość ekranu za pomocą natywnejBounds w systemie iOS 8.0 lub nowszym. Dotyczy to problemu 504.
  • Dodaliśmy obsługę parametrów kampanii związanych z kliknięciami.
  • Oprócz wersji systemu operacyjnego urządzenia raportuj model sprzętu iOS. Dotyczy to problemu 408.
  • Raportowanie atrybucji instalacji reklam iAd w systemie iOS 7.1 lub nowszym. Wymaga to korzystania z platformy iAd.
  • Dodaliśmy ostrzeżenie o wycofaniu typu działania appview.
  • Biblioteka sqlite3 jest teraz wymagana.

Menedżer tagów Google

  • Usunięto awarię ciągu znaków zerowego w narzędziu TAGDispatcher.

Ta wersja zawiera nowe pole. Pełną listę pól znajdziesz w Opisach pól.

Transport

  • W polu transport możesz ustawić mechanizm, za pomocą którego będą wysyłane działania.

Inne zmiany

  • Opcja useBeacon została wycofana.
  • Poprawki błędów

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.

To jest wersja z poprawką błędów:

  • W tej wersji rozwiązano problem z egzekwowaniem ograniczeń związanych z filtrowaniem w zapytaniach do interfejsu Real Time Reporting API. Żądania z atrybutem rt:activeUsers i filtrem w wymiarze na poziomie zdarzenia skutkowałyby błędem o przyczynie badRequest i komunikatem o wartości OR operator not supported for a hit level filter. Więcej informacji o ograniczeniach zapytań znajdziesz w Przewodniku dla programistów interfejsu Real Time Reporting API.

W tej wersji dodaliśmy nowy parametr działania. Pełną listę parametrów znajdziesz w dokumentacji parametrów.

Źródło danych

  • Parametr Źródło danych ds umożliwia ustawienie źródła danych działania.

Ta wersja zawiera nowe pole. Pełną listę pól znajdziesz w Opisach pól.

Źródło danych

W tej wersji dodaliśmy nowy parametr działania. Pełną listę parametrów znajdziesz w dokumentacji parametrów.

Zastąpienie geograficzne

W tej wersji do interfejsu API zarządzania dodaliśmy 2 nowe kolekcje dotyczące wymiarów niestandardowych i danych niestandardowych.

Wymiary i dane niestandardowe

Teraz możesz tworzyć, wyświetlać, pobierać, wprowadzać poprawki i aktualizować wymiary i dane niestandardowe za pomocą interfejsu Management API.

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.

Odpowiedź metody list dotycząca wszystkich kolekcji zawiera teraz pustą listę dla właściwości items, jeśli zbiór nie zawiera żadnych zasobów. Wcześniej właściwość items była pomijana w odpowiedzi. Szczegółowe informacje o zapytaniach i odpowiedziach dotyczących danych konfiguracyjnych Google Analytics znajdziesz w dokumentacji interfejsu API.

Dodano nowe pole filtrów DEVICE_CATEGORY oraz wycofaliśmy IS_MOBILE i IS_TABLET. Należy użyć właściwości DEVICE_CATEGORY=mobile i DEVICE_CATEGORY=tablet.

Ta wersja zawiera:

Google Analytics

  • Naprawiono błąd, który uniemożliwiał wysyłanie wszystkich beaconów podczas wysyłania takich sygnałów.
  • Zaktualizowaliśmy przykładową aplikację CuteAnimals, aby pokazać, jak wysyłać aplikacje, gdy działa w tle.
  • Dodaliśmy obsługę dodatkowych pól Ulepszonego e-commerce.
  • Usunięto komunikaty ostrzegawcze dotyczące klas GAIHit i GAIProperty, których brakuje podczas kompilowania do iOS SDK 8.0. Te klasy zostały usunięte.
  • Wysyłanie beaconów jest teraz bardziej wydajne – wiele takich beaconów jest wysyłanych w jednym żądaniu HTTPS.
  • W określonych okolicznościach żądania będą kompresowane, aby zmniejszyć wykorzystanie transmisji danych.

Menedżer tagów Google

  • Wycofujemy funkcję openContainerWithId opartą na obiekcie TAGContainerFuture. Używanie tego interfejsu API w iOS8 powoduje błędy, jeśli metoda get zostanie wywołana w niektórych fazach cyklu życia UIAppDelegate.
  • Dodaliśmy obsługę niestandardowych danych i wymiarów niestandardowych w Ulepszonym e-commerce w przypadku tagu Google Universal Analytics.
  • Naprawiliśmy błąd związany z produktami w działaniach Ulepszonego e-commerce, które zawierają produkty opcjonalne.
  • Obsługa funkcji identyfikatora wyświetlania reklam na potrzeby tagu Google Universal Analytics.
  • Zaktualizowano przykładową aplikację CuteAnimals, aby pokazać, jak wysyłać dane, gdy aplikacja działa w tle.

Zasób Widok (profil) zawiera teraz właściwość enhancedECommerceTracking, która wskazuje, czy Ulepszone e-commerce jest włączone (true), czy wyłączone (false).

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 zawiera nowy wymiar. Pełną listę definicji znajdziesz w dokumentacji wymiarów i danych.

Godzina

  • Wymiar – rt:minutesAgo – liczba minut temu, zanim wystąpiło działanie.

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.
  • Działania można teraz wysyłać za pomocą interfejsu navigator.sendBeacon (w obsługiwanych przeglądarkach) poprzez przekazanie parametru useBeacon.
  • Nazwa pliku cookie tworzonego przez wtyczkę display features została zmieniona z _dc na _gat.

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

Ścieżki konwersji

  • wymiar – mcf:dcmAd – nazwa reklamy DCM odpowiadającej konwersji Google Analytics (wyświetlenie lub kliknięcie),
  • wymiar – mcf:dcmAdPath – ścieżka do konwersji, w przypadku której interakcje na ścieżce są reprezentowane przez reklamy DCM.
  • wymiar – mcf:dcmAdType – nazwa typu reklamy DCM powiązanego ze zdarzeniem DCM (wyświetlenie lub kliknięcie) pasującego do konwersji Google Analytics.
  • wymiar – mcf:dcmAdvertiser – nazwa reklamodawcy DCM w związku ze zdarzeniem DCM (wyświetlenie lub kliknięcie) odpowiadającą konwersji Google Analytics.
  • wymiar – mcf:dcmAdvertiserPath – ścieżka do konwersji, w przypadku której interakcje na ścieżce są reprezentowane przez reklamodawców DCM.
  • wymiar – mcf:dcmCampaign – nazwa kampanii DCM, której dotyczy zdarzenie DCM (wyświetlenie lub kliknięcie) odpowiadające konwersji Google Analytics.
  • wymiar – mcf:dcmCampaignPath – ścieżka do konwersji, w przypadku której interakcje na ścieżce są reprezentowane przez kampanie DCM.
  • wymiar – mcf:dcmCreative – nazwa kreacji DCM odpowiadającej konwersji Google Analytics (wyświetlenie lub kliknięcie).
  • wymiar – mcf:dcmCreativePath – ścieżka do konwersji, w przypadku której interakcje na ścieżce są reprezentowane przez kreacje DCM.
  • wymiar – mcf:dcmCreativeVersion – wersja kreacji DCM zdarzenia DCM (wyświetlenie lub kliknięcie) pasująca do konwersji Google Analytics.
  • wymiar – mcf:dcmCreativeVersionPath – ścieżka do konwersji, w przypadku której interakcje na ścieżce są reprezentowane przez wersje kreacji DCM.
  • wymiar – mcf:dcmNetwork – używana sieć.
  • wymiar – mcf:dcmPlacement – nazwa miejsca docelowego w witrynie w DCM (wyświetlenie lub kliknięcie) odpowiadającego konwersji Google Analytics.
  • wymiar – mcf:dcmPlacementPath – ścieżka do konwersji, w przypadku której interakcje na ścieżce są reprezentowane przez miejsca docelowe DCM.
  • wymiar – mcf:dcmSite – nazwa witryny w DCM, w której została wyświetlona kreacja DCM (wyświetlenie lub kliknięcie) odpowiadające konwersji Google Analytics.
  • wymiar – mcf:dcmSitePath – ścieżka do konwersji, w przypadku której interakcje na ścieżce są reprezentowane przez witryny DCM.
  • dane – mcf:firstImpressionConversions – liczba konwersji, w przypadku których wyświetlenie z kampanii DCM było pierwszą interakcją z konwersją w 30-dniowym okresie ważności. Ten wymiar obejmuje zarówno realizacje celów, jak i transakcje.
  • dane – mcf:firstImpressionValue – wartość konwersji, w przypadku których wyświetlenie z kampanii DCM było pierwszą interakcją z konwersją w 30-dniowym okresie ważności. Ten wymiar obejmuje zarówno realizacje celów, jak i transakcje.
  • dane – mcf:impressionAssistedConversions – liczba konwersji, w przypadku których wystąpiło wyświetlenie z kampanii DCM na ścieżce konwersji, ale nie było ono ostateczną interakcją prowadzącą do konwersji. Ten wymiar obejmuje zarówno realizacje celów, jak i transakcje.
  • dane – mcf:impressionAssistedValue – wartość konwersji, w przypadku których wyświetlenie z kampanii DCM pojawiło się na ścieżce konwersji, ale nie było ostateczną interakcją prowadzącą do konwersji. Ten wymiar obejmuje zarówno realizacje celów, jak i transakcje.

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).

Ta wersja zawiera:

Google Analytics

  • Bez zmian.

Menedżer tagów Google

  • Do tagu Google Universal Analytics dodaliśmy obsługę Ulepszonego e-commerce.
  • Do klasy TAGManager dodano nowe metody dispatch i dispatchWithCompletionHandler.

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.

Ta wersja zawiera:

Google Analytics

  • Dodaliśmy obsługę Ulepszonego e-commerce. Więcej informacji znajdziesz w przewodniku dla programistów Ulepszonego e-commerce.
  • Od tej chwili po każdej zmianie identyfikatora wyświetlania reklam jest on resetowany.
  • Zbieranie identyfikatorów wyświetlania reklam jest domyślnie wyłączone.
  • Dodano zautomatyzowane interfejsy API do raportowania wyjątków.
  • Poprawki błędów w dokumentacji.
  • Naprawiono drobne błędy.

Menedżer tagów Google

  • Brak zmian w Menedżerze tagów Google.

Ta wersja zawiera:

Google Analytics

  • Jeśli aplikacja zawiera bibliotekę libAdIdAccess.a (dostarczoną w ramach pakietu SDK), a właściwość allowIDFACollection ma w trackerze wartość Prawda, pakiet SDK będzie teraz zbierać identyfikatory IDFA oraz flagę umożliwiającą śledzenie reklamodawcy.
  • Dodaliśmy obsługę Ulepszonego e-commerce.
  • Dodano typ działania „Wyświetlenie ekranu”, aby zastąpić typ działania „appview”.
  • Teraz do każdego działania dodawany jest parametr identyfikatora działania. Zmienia się ona za każdym razem, gdy następuje odsłona aplikacji, odsłona ekranu lub działanie polegające na odsłonie strony.
  • Identyfikator ClientId będzie teraz resetowany po każdej zmianie wartości IDFA. Dzieje się tak tylko wtedy, gdy identyfikator IDFA jest zbierany w lokalizatorze.
  • Do klasy GAI została dodana nowa metoda dispatchWithCompletionHandler.
  • Rozwiązaliśmy problem, który powodował, że pakiet SDK mógł wysyłać beacon bez identyfikatora clientId lub z pustym clientId.

Menedżer tagów Google

  • Bez zmian
  • Działania, które nie zawierają prawidłowego identyfikatora śledzenia, są teraz odrzucane.

Ta wersja obejmuje nowe typy importu danych i wycofuje zasób dailyUpload.

Import danych

Szczegółowe informacje o tym, jak importować dane na konto Google Analytics za pomocą interfejsu API zarządzania Google Analytics, znajdziesz w Przewodniku dla programistów ds. importowania danych.

Przesłane filmy

  • Zasób upload obsługuje teraz te typy przesyłania:
    • Dane kampanii
    • Dane o treści
    • Dane o kosztach
    • Dane produktu
    • Dane o zwrocie środków
    • Dane użytkownika
  • Zasób upload ma nową metodę migrateDataImport, która pozwala przenieść istniejące Dane o kosztach customDataSources.

Wycofanie codziennej liczby przesłanych plików

  • Zasób dailyUpload został wycofany. W przewodniku po migracji znajdziesz informacje o tym, jak przeprowadzić migrację z użyciem funkcji Importu danych.
  • Zasób dailyUpload będzie działać jeszcze przez 6 miesięcy. Po tym czasie wszystkie pozostałe zasoby customDataSources z właściwością uploadType ustawioną na analytics#dailyUploads zostaną automatycznie przeniesione i będą działać tylko z zasobem upload.
  • Obecni użytkownicy zasobu dailyUpload powinni jak najszybciej zaktualizować swój kod i przeprowadzić migrację, aby zacząć korzystać z zasobu Prześlij.

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.

W tej wersji wprowadziliśmy zmianę konwencji nazewnictwa atrybutu uiName.

Zmiana nazwy UI

  • Atrybut uiName dla kolumn szablonów używa teraz do reprezentowania indeksu liczbowego za pomocą XX, a nie 1. Na przykład Goal 1 Value to teraz Goal XX Value.

Oto pierwsza wersja interfejsu Embed API:

  • Interfejs Google Analytics Embed API to biblioteka JavaScript, która umożliwia łatwe utworzenie i umieszczenie panelu w witrynie zewnętrznej w ciągu kilku minut. Więcej informacji znajdziesz w omówieniu interfejsu Embed API.
  • Obejmuje komponenty: uwierzytelnianie, selektor widoku, dane i wykres danych.

To jest pierwsza wersja interfejsu API do obsługi administracyjnej:

  • Interfejs API do obsługi administracyjnej umożliwia automatyczne tworzenie nowych kont Google Analytics. Ten interfejs API jest dostępny tylko na zaproszenie i przeznaczony dla kwalifikujących się dostawców usług oraz dużych partnerów. Więcej informacji znajdziesz na stronie z omówieniem obsługi administracyjnej interfejsu API.

W tej wersji dodaliśmy 2 nowe interfejsy API konfiguracji.

Filtry

Niespróbkowane raporty: interfejs API zarządzania

Do interfejsu API zarządzania zostaje dodany nowy zasób o nazwie Niespróbkowane raporty. Niespróbkowane raporty to raporty Google Analytics (GA), które zostały wygenerowane na podstawie niespróbkowanych danych.Niespróbkowane raporty są obecnie dostępne tylko dla użytkowników Google Analytics Premium. 

  • Zaktualizowaliśmy listę obsługiwanych źródeł bezpłatnych.

    • Usunięto: Netscape, About, Mamma, Voila, Live, Wirtulana Polska, Yam, Ozu.
    • Dodane/zaktualizowane: Baidu, DOCOMO, Onet, Centrum, Sogou, Tut.By, Globo, Ukr.net, So.com, au one.
  • Zaktualizowaliśmy listę obsługiwanych źródeł bezpłatnych.

    • Usunięto: Netscape, About, Mamma, Voila, Live, Wirtulana Polska, Yam, Ozu.
    • Dodane/zaktualizowane: Baidu, DOCOMO, Onet, Centrum, Sogou, Tut.By, Globo, Ukr.net, So.com, au one.

Ta wersja zawiera:

Google Analytics

  • Dodano pole identyfikatora użytkownika.

Menedżer tagów Google

  • Naprawiliśmy błąd w identyfikatorze makra reklamowego, który umożliwia prawidłowe zwracanie identyfikatora reklamodawcy (IDFA), jeśli jest dostępny.
  • Rozwiązaliśmy problem, który uniemożliwiał użytkownikom korzystanie z danych e-commerce za pomocą NSNumber.

W tej wersji wycofaliśmy atrybut appUiName. Szczegółowe informacje o usuwaniu atrybutów znajdziesz w zasadach wycofywania danych:

Wycofanie appUiName

  • Interfejs appUiName został wycofany. Nie jest już wymagany w interfejsie Metadata API, ponieważ nazwy UI widoków (profili) internetowych i aplikacji zostały ujednolicone. Usuń cały kod, który korzysta z atrybutu appUiName, i korzystaj tylko z atrybutu uiName.

W tej wersji wprowadziliśmy zmiany nazw wymiarów i danych. Pełną listę definicji znajdziesz w dokumentacji wymiarów i danych.

Zmienione nazwy wymiarów i danych

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

Użytkownik

  • Wymiar – rt:visitorType – zamiast niego użyj wymiaru rt:userType.
  • Dane – rt:activeVisitors – zamiast tego użyj wymiaru rt:activeUsers.

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.

Ta wersja zawiera zastąpienie typu działania appview oraz dodanie i zmianę nazw parametrów. Pełną listę parametrów znajdziesz w dokumentacji parametrów.

Zamiennik appview

  • Typ działania appview został zastąpiony przez screenview. Jak najszybciej zaktualizuj kod śledzenia aplikacji, aby używać screenview zamiast appview.

Nowe parametry

Zmiana nazwy parametru

  • Opis treści to teraz Nazwa ekranu. Nazwa parametru zapytania (cd) pozostanie bez zmian.

Ta wersja zawiera zastąpienie typu działania appview i dodanie nowych pól. Pełną listę pól znajdziesz w Opisach pól.

Zamiennik appview

  • Typ działania appview został zastąpiony przez screenview. Jak najszybciej zaktualizuj kod śledzenia aplikacji, aby używać screenview zamiast appview.

Nowe pola

Inne zmiany

  • Ulepszono dane wyjściowe debugowania.
  • Naprawiono różne błędy związane z wstępnym renderowaniem.
  • Dodano obsługę interfejsów API renderowania z wyprzedzeniem bez prefiksu. Renderowanie wstępne działa teraz nie tylko w Chrome, ale też w IE11.
  • Inne drobne poprawki błędów w obsłudze tagu łączącego.
  • Bezpieczne wyszukiwanie Yahoo jest teraz prawidłowo klasyfikowane jako źródło bezpłatne.
  • Dodano obsługę interfejsów API renderowania z wyprzedzeniem bez prefiksu. Renderowanie wstępne działa teraz nie tylko w Chrome, ale też w IE11.

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.

Segmenty: interfejs API zarządzania w wersjach 2.4 i 3.0

W kolekcji segmentów wprowadzono te zmiany:

  • Segmenty użytkownika i sekwencji są teraz obsługiwane przez interfejs API.
  • Kolekcja Segmenty zwraca teraz wszystkie wbudowane i niestandardowe segmenty na poziomie sesji i na poziomie użytkownika.
  • Właściwość definition segmentów będzie teraz używać nowej składni segmentów. Obejmuje to definicje dotychczasowych segmentów na poziomie sesji, które zmienią się z definition: "" na definition: "sessions::condition::".
  • Do zasobu Segment dodaliśmy nową usługę type, która wskazuje, czy segment to CUSTOM (tzn. utworzony przez użytkownika w interfejsie internetowym) czy BUILT_IN (dostarczany przez Google Analytics).

Eksperymenty

Jako celów optymalizacji można teraz używać tych danych AdSense:

  • ga:adsenseAdsClicks – liczba kliknięć reklam AdSense w Twojej witrynie.
  • ga:adsenseAdsViewed – liczba wyświetlonych reklam AdSense. W jednostce reklamowej można wyświetlać wiele reklam.
  • ga:adsenseRevenue – łączne przychody z reklam AdSense.

Nowa kolekcja podsumowań konta

  • Kolekcja AccountSummaries została dodana do interfejsu Management API. Zawiera ono podsumowanie informacji o każdym koncie, usłudze i widoku (profilu), do którego autoryzowany użytkownik ma dostęp, w ramach jednej, szybkiej prośby. Więcej informacji znajdziesz w Przewodniku dla programistów podsumowań konta.

Google Analytics i Menedżer tagów Google

Wycofano prefiks ga:

Prefiks ga: został wycofany ze wszystkich wymiarów i danych w czasie rzeczywistym, a został zastąpiony nowym prefiksem rt:. Żądania do interfejsu API z prefiksem ga: będą działać przez 6 miesięcy. Po tym czasie będzie zwracany błąd.

Nowe wymiary i dane

Ta aktualizacja dodaje nowe wymiary i dane do interfejsu Real Time Reporting API. Pełną listę znajdziesz w dokumentacji wymiarów i danych.

Śledzenie zdarzeń

  • Wymiar – rt:eventAction – działanie zdarzenia.
  • Wymiar – rt:eventCategory – kategoria zdarzenia.
  • Wymiar – rt:eventLabel – etykieta zdarzenia.
  • Wymiar – rt:totalEvents – łączna liczba zdarzeń w profilu we wszystkich kategoriach.

Śledzenie celów

  • Wymiar – rt:goalId: ciąg znaków odpowiadający identyfikatorowi celu.
  • Dane – rt:goalXXValue – łączna wartość liczbowa żądanego numeru celu, gdzie XX to liczba z zakresu od 1 do 20.
  • Dane – rt:goalValueAll – łączna wartość liczbowa wszystkich celów zdefiniowanych w Twoim profilu.
  • Dane – rt:goalXXCompletions – łączna liczba realizacji dla żądanego numeru celu, gdzie XX to liczba z zakresu od 1 do 20.
  • Dane – rt:goalCompletionsAll – łączna liczba realizacji wszystkich celów zdefiniowanych w Twoim profilu.

Śledzenie strony

  • Dane – rt:pageViews – łączna liczba wyświetleń strony.

Śledzenie aplikacji

  • Dane – rt:screenViews – łączna liczba wyświetleń ekranu.

Ta wersja zawiera:

Google Analytics

  • Pakiet SDK będzie teraz domyślnie wypełniać parametr identyfikatora aplikacji (&aid).

Menedżer tagów Google

  • Dodaliśmy obsługę makra Eksperymentowanie z treścią stron w Google Analytics.

Ta wersja zawiera:

Google Analytics

  • Bez zmian w Google Analytics.

Menedżer tagów Google

  • Dodaliśmy obsługę makra Eksperymentowanie z treścią stron w Google Analytics.

Ta wersja zawiera:

Google Analytics

  • Bez zmian bezpośrednio w Google Analytics. Użytkownicy Google Analytics powinni pamiętać, że Menedżer tagów Google nie korzysta już domyślnie z tabeli AdSupport.framework. Może to pomóc w rozwiązaniu problemu 387.

Menedżer tagów Google

  • Funkcje, które wywołują interfejs AdSupport.framework API, są umieszczane w osobnej bibliotece: libAdIdAccess.a. Aplikacje muszą połączyć się z tą biblioteką, aby mieć dostęp do ciągu tekstowego identyfikatora wyświetlania reklam (IDFA) i flagi włączonego śledzenia reklamodawcy.

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

Ścieżki konwersji

  • Wymiar – mcf:adwordsCustomerIDPath – sekwencja identyfikatora klienta Google Ads na ścieżkach konwersji.

Interactions

  • Wymiar – mcf:adwordsCustomerID – odpowiada Customer.id interfejsu API AdWords.
  • Parametry tagu łączącego nie są już ignorowane podczas nawigowania po różnych domenach w Firefoksie przy różnych poziomach powiększenia.
  • Naprawiono problem z wczytywaniem Analytics w treści strony w przypadku niektórych adresów URL.
  • Ulepszenia danych wyjściowych trybu debugowania.
  • Wersja konserwacyjna.

W tej wersji: * Usunięto potrzebę korzystania z AdSupport.framework. * Usunięto nieużywany kod.

Ta wersja zawiera: * Dodano obsługę 64-bitowego pakietu SDK iOS 7.0. * Usunięto pozycję libGoogleAnalytics_debug.a – należy ona do biblioteki libGoogleAnalyticsServices.a. * Wyczyszczono plik kompilacji CuteAnimals na potrzeby Google Analytics.

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

Ścieżki konwersji

  • Wymiar – mcf:adwordsAdGroupIDPath – sekwencja identyfikatora grupy reklam AdWords na ścieżkach konwersji.
  • Wymiar – mcf:adwordsCampaignIDPath – sekwencja identyfikatora kampanii AdWords na ścieżkach konwersji.
  • Wymiar – mcf:adwordsCreativeIDPath – sekwencja identyfikatora kreacji AdWords na ścieżkach konwersji.
  • Wymiar – mcf:adwordsCriteriaIDPath – kolejność identyfikatorów kryteriów Google Ads na ścieżkach konwersji.

Interactions

  • Wymiar – mcf:adwordsAdGroupID – odpowiada AdGroup.id interfejsu API AdWords.
  • Wymiar – mcf:adwordsCampaignID – odpowiada Campaign.id interfejsu API AdWords.
  • Wymiar – mcf:adwordsCreativeID – odpowiada Ad.id interfejsu API AdWords.
  • Wymiar – mcf:adwordsCriteriaID – odpowiada Criterion.id interfejsu API AdWords.

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.

W segmentach domyślnych wprowadziliśmy te zmiany ze względu na wycofanie wymiarów ga:isMobile i ga:isTablet:

  • Nazwa segmentu gaid::-11 została zmieniona z Ruch z komórek na Ruch z komórek i tabletów. Definicja tego segmentu została zmieniona z ga:isMobile==Yes na ga:deviceCategory==mobile,ga:deviceCategory==tablet. Pamiętaj, że raport ga:isMobile uwzględniał ruch z tabletów, co znajduje odzwierciedlenie w nowej definicji. Jeśli chcesz generować tylko ruch z urządzeń mobilnych (z wyłączeniem tabletów), przełącz się na nowy segment Ruch z komórek (gaid::-14).
  • Definicja segmentu gaid::-13 została zmieniona z ga:isTablet==Yes na ga:deviceCategory==tablet. Nadal będzie ona uwzględniać Ruch z tabletów.
  • Dodano segment gaid::-14. Nazwa segmentu to Ruch z komórek, a definicja to ga:deviceCategory==mobile.
  • Wersja konserwacyjna.

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:

Poprawki błędów:

  • Poprawiliśmy informacje o strefie czasowej w widokach (profilach). Szczegóły: przed wprowadzeniem poprawki w niektórych przypadkach widok listy (profili) w interfejsie Management API zwracał nieprawidłowe informacje o strefie czasowej dla widoku (profilu). Teraz informacje o strefie czasowej w widokach (profilach) są spójne z ustawieniami w interfejsie administratora Google Analytics.

Ta wersja zawiera: * Naprawiony konflikt z pakietem SDK bufora protokołu. * Naprawiono błąd tagu łączącego, który występował, gdy włączone było usuwanie kodu.

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

Daty względne
  • Do interfejsu MCF Reporting API 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.

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.

Ta wersja zawiera: * szóstą wersję beta, * Wprowadziliśmy zmianę, która pozwoli uniknąć wyjątku działania, gdy aplikacja kierowana na platformę KitKat (poziom interfejsu API 19) korzysta z pakietu SDK.

Ta wersja zawiera: * Drugie wydanie wersji 3.0. * Wprowadziliśmy zmianę, która pozwoli uniknąć wyjątku działania, gdy aplikacja kierowana na platformę KitKat (poziom interfejsu API 19) korzysta z pakietu SDK.

W tej wersji wprowadziliśmy operacje zapisu w zasobach usług internetowych, widoków (profil) i celów, a także zestaw 3 nowych zasobów, które umożliwiają zarządzanie uprawnieniami użytkowników.

Interfejsy API konfiguracji i konfiguracji konta

Uprawnienia użytkowników w interfejsie Management API

Ta wersja zawiera:

  • Usunięto błąd linku w kierowaniu na iOS 7.0.

Oto pierwsza wersja interfejsu Metadata API:

  • Interfejs Metadata API zwraca informacje o wymiarach i danych dostępnych w interfejsach API do raportowania Google Analytics. Zwrócone metadane zawierają takie atrybuty jak nazwa interfejsu użytkownika, opis czy obsługa segmentów zaawansowanych. Dzięki interfejsowi Metadata API Twoje aplikacje mogą automatycznie otrzymywać najnowsze informacje o wymiarach i danych dostępnych w przypadku zapytań dotyczących raportowania. Więcej informacji znajdziesz na stronie z opisem interfejsu metadanych API.

W tej wersji: * Pierwsza wersja 3.0; * zmiana interfejsu API pakietu SDK w celu zapewnienia zgodności z analytics.js. Metody track i send zostały usunięte. Zamiast tego użyj metod tworzenia send i GAIDictionaryBuilder. * Większość usług protokołu GAITracker została usunięta. Zamiast tego użyj pola set w różnych polach. * Wszystkie parametry ustawione za pomocą metody set zostaną zachowane. Wcześniej kilka parametrów było ustawianych tylko dla następnego wywołania wysyłania/śledzenia. * Protokół GAILogger jest dostępny dla osób, które chcą wdrożyć własne logowanie niestandardowe w pakiecie SDK. * Zmieniły się minimalne wymagania systemowe. Szczegółowe informacje znajdziesz w pliku Readme.txt. * Cała aktywność związana z pakietem SDK (dostęp do bazy danych i sieci) jest teraz wykonywana w osobnym wątku. * Można teraz odczytywać tekst clientId. Zadzwoń pod numer [tracker get:kGAIClientId]. Pamiętaj, że to wywołanie zostanie zablokowane, dopóki nie będzie można odczytać elementu clientId z bazy danych. * Pakiet SDK nie korzysta już z POST, chyba że działanie ma więcej niż 2000 bajtów. Zamiast niego będzie używany język GET. * Pakiet SDK nie będzie już ponawiać próby wysyłania działań na podstawie kodu odpowiedzi HTTP.

W tej wersji: * Pierwsza wersja 3.0; * interfejs API pakietu SDK napisany na nowo w celu jego lepszego dostosowania do biblioteki analytics.js. Szczegółowe informacje znajdziesz w dokumentach javadoc i /analytics/devguides/collection/android/v3/. * Usunięto wszystkie metody track i send. Zamiast tego do wysyłania działań możesz używać metody send i odpowiadających im metod tworzenia z klasy MapBuilder. W klasie Fields znajdziesz listę stałych, których możesz użyć do generowania działań za pomocą elementów set i send. * Wiele różnych właściwości, np. useHttps, anonymizeIp itp., również zostało usuniętych. Możesz skonfigurować/zresetować te właściwości, używając polecenia set. * EasyTracker obejmuje teraz rozszerzenie Tracker. Aby śledzić połączenia bezpośrednio, nie musisz dzwonić pod numer EasyTracker.getTracker. * Pakiet SDK nie ustawia już flagi kontroli sesji w momencie uruchomienia. To deweloperzy odpowiadają teraz za określenie, czy potrzebna jest nowa sesja. Pamiętaj, że EasyTracker nadal obsługuje zarządzanie sesjami tak jak wcześniej. * Pakiet SDK obsługuje teraz niestandardową klasę logowania. Więcej informacji znajdziesz w sekcji Logger w dokumencie javadoc. * Dodano tryb dryRun. * Można teraz odczytywać tekst clientId. Zadzwoń do firmy tracker.get(Fields.CLIENT_ID). To wywołanie będzie zablokowane do czasu wczytania elementu clientId z magazynu trwałego. * Pakiet SDK nie będzie już ponawiać działań na podstawie kodu odpowiedzi HTTP.

Oto pierwsza wersja interfejsu Real Time Reporting API w ograniczonej wersji beta:

  • Interfejs Real Time Reporting API umożliwia tworzenie raportów o aktywności mającej miejsce w tej chwili w Twojej usłudze. Za pomocą interfejsu API do raportowania w czasie rzeczywistym możesz wysyłać zapytania o wymiary i dane, aby tworzyć widżety i panele internetowe dla klientów. Więcej informacji znajdziesz na stronie z omówieniem interfejsu API do raportowania w czasie rzeczywistym.

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.

W ramach wprowadzania nowych segmentów wprowadzimy w kolekcji segmentów te zmiany:

  • Wszystkie identyfikatory segmentów zostaną zmienione z dodatnich liczb całkowitych na ciągi alfanumeryczne. Jeśli masz zapisane identyfikatory segmentów użytkowników, zalecamy zaktualizowanie ich tak, aby korzystały z nowych identyfikatorów.
  • Kolekcja Segmenty zwróci tylko istniejące segmenty poziomu wizyty. Segmenty nowych użytkowników, kohort i sekwencji nie są obecnie obsługiwane przez interfejs API.
  • Kolekcja Segmenty będzie nadal zwracać istniejące segmenty domyślne o takich samych ujemnych identyfikatorach liczbowych, ale nowe segmenty domyślne nie są 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 do zasobu usługi internetowej dodane są 2 nowe usługi:

  • profileCount – zwraca liczbę profili dla usługi. Umożliwia to filtrowanie usług, które nie mają żadnych profili (np. profileCount = 0).
  • industryVertical – zwraca branżę/kategorię branży wybraną dla usługi.

Poprawki błędów:

  • Usługa eCommerceTracking zasobu profilu jest teraz spójna z ustawieniami e-commerce w sekcji administracyjnej interfejsu internetowego. Zwraca wartość true, gdy śledzenie e-commerce jest włączone, i false, jeśli nie jest włączone.

Ta wersja zawiera: * Piątą wersję beta. * Naprawiono błąd analizy wyjątków EasyTracker. Gdy ustawiona jest flaga ga_reportUncaughtExceptions, nie inicjowaliśmy parsera wyjątków, dlatego lokalizacja nieobsłużonego wyjątku nie jest analizowana. Po wprowadzeniu tej poprawki raporty o awariach i wyjątkach będą podawać lokalizację niewykrytych wyjątków, gdy zasada ga_reportUncaughtExceptions ma wartość Prawda.

  • Do interfejsu Management API w wersji 3 dodano nowy punkt końcowy, który umożliwia dostęp do zasobów eksperymentów i ich modyfikowanie.

Następujące zmiany zostały przekazane do najnowszej wersji kodu śledzenia:

  • Dodaliśmy obsługę określania walut lokalnych w przypadku _set, np.gaq.push(['_set', 'currencyCode', 'EUR']).
  • 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.
  • Zasób profilu zawiera teraz właściwość type, która pozwala określić, czy profil jest skonfigurowany na potrzeby witryny czy aplikacji. Dwie możliwe wartości to: WEB lub APP.

Ta wersja zawiera:

  • Zmień domyślną parametr appVersion na wartość z kolumny CFBundleShortVersionString zamiast CFBundleVersionKey.
  • Używaj protokołu HTTPS jako protokołu domyślnego zamiast HTTP.
  • Metody śledzenia zmieniono na Wysyłanie (np. trackView teraz nazywa się sendView).
  • Naprawiono drobne błędy.

Ta wersja zawiera: * Czwartą wersję beta. * Pakiet SDK będzie teraz uwzględniać ustawienie częstotliwości próbkowania. Jeśli wcześniej była ustawiona częstotliwość próbkowania inna niż 100%, zobaczysz teraz odpowiadający jej spadek niektórych danych Analytics w porównaniu z wersją beta 3. * Zmienione metody śledzenia wysyłania (np. trackView teraz nosi nazwę sendView). * Dodano obsługę waluty lokalnej przez Transaction.setCurrencyCode * Domyślnie używaj protokołu HTTPS zamiast HTTP. * Pakiet SDK nie będzie próbować wysyłać trafień, jeśli nie będzie połączenia sieciowego. * Unikaj błędów ANR podczas próby obsługi danych kampanii promujących instalacje. * Z pakietu SDK usunięto klasy TrackedActivity. * Przenieś inicjowanie pakietu SDK z głównego wątku UI. * Zwiększ możliwość przywracania przez pakiet SDK uszkodzonej bazy danych SQLite. * Naprawiono kilka innych awarii i błędów.

Ta wersja zawiera:

  • Dodano architekturę Armv7s do libGoogleAnalytics.a.
  • Usunięto architekturę Armv6 z libGoogleAnalytics.a.

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.

Ta wersja zawiera:

  • Poprawki błędów:

    • Usuń wersję biblioteki NoThumb.
    • Opuść obsługę kampanii Armv6.
  • Nowe funkcje:

    • Dodano obsługę Armv7s (dla iPhone'a5).

Ta wersja zawiera:

  • Poprawki błędów:
    • Poprawiono migrację z kodu CV pakietu SDK w wersji starszej niż 1.5 do niestandardowych zmiennych niestandardowych w pakiecie SDK 1.5.
    • Przestrzegaj ustawienia ograniczeń dotyczących danych w tle użytkownika.

Ta wersja zawiera:

  • Poprawki błędów:
    • Metody protokołu GANTrackerDelegate są teraz opcjonalne.
    • Zdarzenia obejmują teraz ostatnie śledzone wyświetlenie strony (utmp).
  • Nowe funkcje:
    • Obsługa maks. 50 zmiennych niestandardowych (uwaga: ta funkcja jest dostępna tylko dla użytkowników Google Analytics Premium).
    • Zaktualizowano przykładową aplikację BasicExample.

Ta wersja zawiera:

  • Poprawki błędów:

    • Rozwiąż problem z wyciekiem pamięci.
    • Zdarzenia obejmują teraz ostatnie śledzone wyświetlenie strony (utmp).
  • Nowe funkcje:

    • Obsługa 50 zmiennych niestandardowych (uwaga: ta funkcja jest dostępna tylko dla użytkowników Google Analytics Premium).

Ta wersja zawiera:

  • Do kampanii GAITracker dodano metodę śledzenia społecznościowego:
    • trackSocial:withAction:withTarget:
  • Zmieniono podpis metody czasu na:
    • trackTiming:withValue:withName:withLabel:
  • Ręczne konstruowanie i wysyłanie metod dodanych do GAITracker:
    • set:value:
    • get:
    • send:params:
  • Dodano metody ustawiania niestandardowych wymiarów do GAITracker:
    • setCustom:dimension:
    • setCustom:metric:
  • Architektura magazynu danych została refaktoryzowana, aby zapobiec zgłoszonym problemom CoreData.

Ta wersja zawiera:

  • Dodaliśmy obsługę wymiarów i danych niestandardowych.
  • Dodaliśmy obsługę śledzenia interakcji społecznościowych.
  • Zmieniono zajęcia StandardExceptionParser na publiczne
  • Naprawiono sporadyczne awarie występujące podczas inicjowania pakietu SDK.
  • Rozwiązaliśmy problem z ignorowaniem transmisji INSTALL_REFERRER na niektórych urządzeniach.
  • Naprawiono ConcurrentModificationExceptions w GoogleTracker zajęciach.
  • Inne poprawki błędów i ulepszenia

Oto pierwsza wersja interfejsu API do raportowania ścieżek wielokanałowych:

  • Ten nowy interfejs API umożliwia wysyłanie żądań danych ścieżek wielokanałowych do uwierzytelnionego użytkownika. Dane pochodzą z danych o ścieżce konwersji, które wskazują interakcje użytkowników z różnymi źródłami wizyt w trakcie wielu wizyt przed konwersją. Dzięki temu możesz analizować, jak różne kanały marketingowe wpływają na konwersje na przestrzeni czasu. Więcej informacji o dostępnych danych i korzystaniu z interfejsu API znajdziesz w artykule Interfejs API do raportowania ścieżek wielokanałowych.

Ta wersja zawiera:

  • Zaktualizowano do najnowszego formatu przewodu.
  • Zmieniono wartość sampleRate na liczbę zmiennoprzecinkową o podwójnej precyzji.
  • Nadmierne śledzenie jest ograniczane.
  • Niewysłane informacje o śledzeniu są usuwane po włączeniu rezygnacji.
  • Niewysłane informacje o śledzeniu starsze niż 30 dni zostaną usunięte.
  • Ulepszenia dotyczące trafienia w dyspozytora.
  • Zamiast co jakiś czas ponawiać próby połączenia, po utracie połączenia dyspozytor może użyć interfejsu Reachability API i otrzymać powiadomienie, gdy połączenie zostanie przywrócone.
  • Zaktualizowano przykładową aplikację.
  • Inne poprawki błędów i ulepszenia.

Ta wersja zawiera:

  • Uproszczony interfejs EasyTracker.
  • Kontrola wysyłania została przeniesiona do nowej klasy: GAServiceManager.
  • Zaktualizowano do najnowszego formatu przewodu.
  • sampleRate: wartość zmiennoprzecinkowa.
  • Nadmierne śledzenie jest ograniczane.
  • Niewysłane informacje o śledzeniu są usuwane po włączeniu rezygnacji.
  • Niewysłane informacje o śledzeniu starsze niż 30 dni zostaną usunięte.
  • Inne poprawki błędów i ulepszenia.

Poprawki błędów

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

Ta wersja zawiera:

  • Dodano usługę obsługi niewykrytych wyjątków.
  • Usunięto właściwość dispatchEnabled z grupy GAI.
  • Dodano właściwość defaultTracker do listy GAI.
  • Dodano metodę close do: GAITracker.
  • Dodano metodę śledzenia czasu do projektu GAITracker.
  • Do metody GAITracker dodano metodę trackView, która nie przyjmuje żadnych argumentów.
  • Nazwy pól elementu transakcji zostały zaktualizowane.
  • Zaktualizowano do najnowszego formatu przewodu.
  • Wartość zdarzenia jest interpretowana jako 64-bitowa liczba całkowita.
  • Generowanie kodu ARMV6 zostało przełączone z THUMB na ARM.

Ta wersja zawiera:

  • Metoda startSession została usunięta. Użyj w zamian zasady setStartSession.
  • Dodano parametr ga_sessionTimeout do EasyTracker.
  • Wdrożenie trybu oszczędzania energii.
  • Do metody GAITracker dodano metodę trackView, która nie przyjmuje żadnych argumentów.
  • Naprawiliśmy błąd, który uniemożliwiał wysyłanie parametrów wyjątków w przypadku działań.
  • Działania, których nie można odczytać z bazy danych, są odrzucane, zamiast trwale blokować wysyłanie wszystkich działań.
  • Zaktualizowano do najnowszego formatu przewodu.
  • Wdrożono typ działania czasowego.
  • Wdrożenie typów działań e-commerce (transakcja i produkt).

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

Następujące zmiany zostały przekazane do najnowszej wersji kodu śledzenia:

  • Maksymalny dozwolony współczynnik próbkowania szybkości witryny (_setSiteSpeedSampleRate) został zwiększony z 10% do 100%.
  • Metoda _setAccount usuwa teraz spacje na początku i na końcu.

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.

Następujące zmiany zostały przekazane do najnowszej wersji kodu śledzenia:

  • Zaktualizowano listę wykrytych domyślnie bezpłatnych wyszukiwarek. Dodano adresy „startsiden.no”, „rakuten.co.jp”, „biglobe.ne.jp” i „goo.ne.jp”. Usunięto słowa „search”, a „conduit.com”, „babylon.com”, „search-results.com”, „avg.com”, „comcast.net” i „incredimail.com” były wcześniej przypisywane razem jako „incredimail.com”.

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

Ta wersja dodaje do interfejsu Management API przydatne odpowiedzi na błędy.

  • Do treści odpowiedzi na błędy interfejsu API dodano nowe kody błędów, przyczyny i opisy. Wszystkie kody zostały udokumentowane dla obu wersji – wersji 2.4 i wersji 3.0 – interfejsu API zarządzania.

Następujące zmiany zostały przekazane do najnowszej wersji kodu śledzenia:

  • Zwiększyliśmy limit długości zmiennej niestandardowej z 64 do 128 znaków. Dodatkowo przed zakodowaniem adresu URL jest teraz sprawdzana długość.
  • Złagodzono limit częstotliwości działań związanych ze zdarzeniem. Teraz możesz wysłać 10 działań z 1 dodatkowym działaniem na sekundę (wcześniej było to 1 działanie co 5 sekund). Pamiętaj, że nadal obowiązuje limit 500 działań na sesję.
  • Pliki cookie __utmv są teraz zapisywane za pomocą innego separatora zmiennych (kreska zamiast przecinka), aby zapewnić zgodność ze standardem RFC. To powinno rozwiązać niektóre problemy z kodowaniem plików cookie, które napotykają klienci.

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.

Ta wersja dodaje dane, zmienia dotychczasowe funkcje i poprawia błędy.

Nowe dane

  • Kolekcja Zaawansowane segmenty zawiera teraz pole segmentId, którego można użyć w parametrze segment interfejsu API eksportu danych.

Zmiany

  • Typ danych max-results został zmieniony na integer.

  • Wartość domyślna i maksymalna dla max-results została zmieniona na 1000.

Poprawki błędów

  • Konta, usługi internetowe i profile eksperymentów Optymalizatora witryny Google nie są już uwzględniane w odpowiednich zbiorach.

Ta wersja zawiera:

  • Dokumentacja:

    • Plik ReadMe.txt został zaktualizowany, aby wskazywał stronę internetową z dokumentacją.

Ta wersja zawiera:

  • Poprawki błędów:
    • Naprawiono obsługę automatycznego śledzenia docelowego adresu URL z Google Play.
    • Zezwalaj na kodowanie parametru strony odsyłającej do setReferrer w adresie URL.

Zmiany w zbieraniu danych o szybkości witryny:

  • Dane o szybkości witryny są teraz zbierane automatycznie dla wszystkich usług internetowych z częstotliwością próbkowania 1%. Funkcja _trackPageLoadTime, która wcześniej była wymagana do zbierania danych o szybkości witryny, została wycofana.
  • Domyślną częstotliwość próbkowania można dostosować za pomocą nowej funkcji _setSiteSpeedSampleRate.
  • Jeśli w wywołaniu _trackPageview użyto ścieżki wirtualnej, będzie ona również powiązana ze wszystkimi danymi o szybkości witryny zebranymi przez tę stronę.

Ta wersja zawiera:

  • Poprawki błędów:
    • Zmieniono lokalizację bazy danych z katalogu Dokumenty na katalog Library.
    • Pakiet SDK nie zwraca już NSAsserts z powodu błędów bazy danych SQLite.
    • Naprawiono awarię, która występowała podczas wywoływania funkcji trackPageview z pustym ciągiem znaków.
    • Naprawiono awarie występujące podczas wywoływania różnych metod GANTracker po wywołaniu funkcji stopTracker.
    • Naprawiono kilka wycieków pamięci, w tym jedno wywoływanie funkcji FEATURE z adresem URL strony zaczynającym się od „/”.
  • Nowe funkcje:
    • Dodano metodę dispatchSynchronously.
    • Prezentowano kilka użytecznych stałych (patrz GANTracker.h).

Ta wersja zawiera:

  • Poprawki błędów:
    • Uwięziony i obsługiwany kilka elementów SQLiteExceptions.
    • Naprawiliśmy błąd NullPointerException w usłudze stopSession, jeśli został wywołany przed wywołaniem startNewSession.
    • Usunięto błędy braku pamięci na urządzeniach HTC Thunderbolt i Motorola Droid Bionic.
    • Wyeliminowano niepotrzebny dostęp do bazy danych w metodzie wysyłania.

Ta wersja zawiera tę nową funkcję:

  • Zdarzenia można oznaczyć jako niewymagające interakcji, ustawiając nowy parametr opt_noninteraction metody _trackEvent() na true. Jeśli zdarzenie nie wymaga interakcji, oznacza to, że odwiedziny pochodzące z otagowanego zdarzenia nie będą wpływały na współczynnik odrzuceń. Więcej informacji znajdziesz w dokumentacji ga.js.

Ta wersja zawiera następujące poprawki:

  • Rozwiązaliśmy problem, który powodował, że propagacja parametru adresu URL gclid AdWords w wewnętrznych linkach witryny mogła skutkować zawyżoną liczbą płatnych wizyt.

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.

Ta wersja zawiera:

  • Poprawki błędów:
    • Naprawiliśmy błąd autobusu, który występował podczas próby ustawienia flagi dryRun przed uruchomieniem trackera.
    • Naprawiono błąd autobusu, który próbował przejeżdżać przez: NULL z powodu błędu.
    • Użyj poprawnego języka w nagłówku HTTP.
  • Nowe funkcje:
    • Dodano flagę anonymizeIp.
    • Dodano parametr sampleRate.
    • Dodano obsługę odesłań z kampanii.

Ta wersja zawiera:

  • Poprawki błędów:
    • Usunięto błąd ogólnego śledzenia odesłań z kampanii.
    • Usunięto flagę anonymizeIp zakłócającą śledzenie kampanii.

W tej wersji dodaliśmy 2 nowe wersje interfejsu API z wieloma nowymi funkcjami i wycofujemy starą. Zmiany te wpływają na sposób wysyłania żądań i przetwarzania danych z interfejsu API.

Versja 3.0

  • To jest najnowsza główna wersja naszego interfejsu API. Nie jest zgodna wstecznie. Wszystkie przyszłe udoskonalenia interfejsu API będą odbywać się na tej wersji.

  • Nowe dane

    • Pełna reprezentacja celów zdarzeń
    • Wewnętrzny identyfikator usługi internetowej, który może służyć do tworzenia precyzyjnych linków do interfejsu Google Analytics
    • Konfiguracje profilu dla domyślnych parametrów zapytania w wyszukiwarce na stronie i w witrynie
  • Zmiany

Wersja 2.4

  • To jest uaktualnienie wersji podrzędnej, które jest w większości zgodne wstecznie z obecną wersją 2.3.

  • Zmiany

    • nowe zasady dotyczące limitów.
    • Integracja z konsolą interfejsów API Google w celu zarządzania dostępem do interfejsów API i zgłaszania próśb o zwiększenie limitu.
    • ciągła obsługa istniejących mechanizmów autoryzacji i protokołu OAuth 2.0,
    • Nowy adres URL, do którego można wysyłać prośby: https://www.googleapis.com/analytics/v2.4/management/…
    • Odpowiedzi tylko w formacie XML
    • Brak obsługi biblioteki klienta JavaScript Data Google
    • Dane wyjściowe XML zgodne z wersją 2.3, więc pozostałe biblioteki klienta danych Google będą nadal działać.

Wycofanie

  • Ogłaszamy wycofanie starszej wersji 2.3 interfejsu Management API. Będzie ona działać przez 2 miesiące. Po tym czasie wszystkie żądania w wersji 2.3 będą zwracać odpowiedź w wersji 2.4.

Naprawiliśmy błąd, który w niektórych witrynach spowodował zawyżoną liczbę wizyt lub spadek liczby nowych użytkowników. Pierwszy z nich dotyczył przede wszystkim witryn z ruchem bezpłatnym, w połączeniu z określonymi zachowaniami użytkowników. Drugi efekt dotyczył witryn z nieobsługiwaną konfiguracją śledzenia z wieloma modułami śledzącymi.

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.

Zmiany w obliczeniach sesji:

  • Jedna kampania na sesję: jeśli nowa kampania zostanie uruchomiona w trakcie istniejącej sesji, skrypt śledzenia automatycznie rozpocznie nową sesję. Nowa kampania zostanie wywołana przez zmianę dowolnego z następujących pól: identyfikator kampanii, nazwa, źródło, medium, wyszukiwane hasło, treść lub gclid.
  • Skrypt śledzenia nie uruchamia już nowej sesji, gdy użytkownik zamknie przeglądarkę.

Zmiany w śledzeniu w wielu domenach:

  • Wywołanie metody _setAllowHash(false) nie jest już wymagane przy konfigurowaniu śledzenia w wielu domenach. Strony, które zawierają już wywołanie _setAllowHash(false), będą nadal działać, ale nie jest już wymagane podczas konfigurowania nowej witryny.
  • Skrypt śledzenia będzie teraz próbować naprawić parametry tagu łączącego, które zostały zniekształcone przez przekierowania HTTP i przeglądarki. Około 85% wartości powiązań, które są obecnie odrzucane z powodu zmian w kodowaniu wprowadzonych przez narzędzia do przekierowania i przeglądarki, powinno już być pomyślnie przywróconych i ponownie akceptowanych przez kod śledzenia.

Ta wersja zawiera:

  • Poprawki błędów:
    • Naprawiono kilka problemów z obsługą bazy danych.
    • Naprawiono wyjątki podczas korzystania ze zmiennych niestandardowych.
    • Przechowuj kontekst aplikacji zamiast przekazywanego do niego kontekstu.
    • Usunięto możliwość przypadkowego tworzenia fantastycznych sesji.
  • Nowe funkcje:
    • Dodano możliwość ustawiania w każdej chwili odesłań do kampanii
    • Dodano flagę (sampleRate)
    • Dodano flagę (anonymizeIp)

Ta wersja zawiera jedną nową funkcję:

  • Kod śledzenia opóźnia teraz trafienie w przypadku wstępnie wyrenderowanych stron do momentu wyświetlenia ich przez użytkownika. Jeśli wstępnie renderowana strona nie zostanie nigdy wyświetlona, działania nie zostaną wysłane. Ta funkcja jest dostępna tylko dla witryn korzystających z asynchronicznego skryptu śledzenia. Więcej informacji o renderowaniu wstępnym znajdziesz na blogu Centrum Google dla webmasterów.

Ta wersja zawiera różne poprawki błędów i refaktoryzację oraz jedną nową funkcję:

  • Dodano obsługę śledzenia społecznościowego ( _tracksocial).

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.

Ta wersja zawiera:

  • Poprawki błędów:
    • Naprawiono awarię, która występowała podczas korzystania ze zmiennych niestandardowych.
    • Usunięto wycieki pamięci podczas korzystania ze zmiennych niestandardowych.
  • Nowe funkcje:
    • Dodana obsługa działań e-commerce.
    • Dodano flagę Debug.
    • Dodano flagę DryRun.
    • Bardziej opisowe informacje o błędach SQLite3

Ta wersja zawiera:

  • Poprawki błędów:

    • Naprawiono źle sformatowany ciąg znaków userAgent.
  • Nowe funkcje:

    • Dodana obsługa śledzenia e-commerce
    • Dodano flagę (debug)
    • Dodano flagę (dryRun)

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 zawiera następujące poprawki błędów.

  • Naprawiono błąd śledzenia w wielu domenach, który w niektórych przypadkach powodował nieprawidłowe kodowanie danych kampanii.
  • Naprawiono błąd w śledzeniu w wielu domenach, który powodował, że pliki cookie były ładowane z adresu URL więcej niż raz, a w niektórych przypadkach były nieprawidłowe.
  • Naprawiliśmy błąd w zmiennych niestandardowych, który powodował kodowanie niektórych wartości w raportach.

Ta wersja zawiera:

  • Poprawki błędów:

    • Naprawiono nieprawidłowe kodowanie spacji.
    • SQLiteExceptions nie powoduje już awarii aplikacji.
  • Nowe funkcje:

    • Dodano obsługę zmiennych niestandardowych

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 obejmuje regularne prace konserwacyjne, w tym poprawki błędów i refaktoryzację. Publiczne interfejsy API i funkcje nie uległy zmianie.

Ta wersja zawiera aktualizacje i 1 nową funkcję.

  • Pomoc na poziomie POST:

    • Kod śledzenia może teraz wysyłać znacznie większe beacony. Tradycyjnie obrazy typu beacon były wysyłane za pomocą żądań HTTP GET, które niektóre przeglądarki i serwery proxy nie mogą przekraczać 2048 znaków. Żądania przekraczające ten limit zostały pominięte, a dane nigdy nie dotarły do Google Analytics. Od tej wersji żądania dłuższe niż 2048 znaków będą wysyłane przez protokół HTTP POST, który nie ma takiego limitu. Kod śledzenia będzie teraz obsługiwać obrazy typu beacon o długości do 8192 znaków.

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 zawiera następujące poprawki błędów.

  • Naprawiliśmy błąd, który uniemożliwiał prawidłowe działanie _addIgnoredOrganic i _addIgnoredRef przy pierwszej wizycie w witrynie.
  • Naprawiono problem związany z działaniem kodu śledzenia w wielu elementach iframe.

Ta wersja zawiera:

  • Nowe funkcje:
    • Dodano obsługę zmiennych niestandardowych.
    • Dodano wersję biblioteki NoThumb.

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.

Ta wersja obejmuje regularne prace konserwacyjne, w tym poprawki błędów i refaktoryzację. Publiczne interfejsy API i funkcje nie uległy zmianie.

Ta wersja zawiera:

  • Nowe funkcje:

    • Dodano obsługę iOS4

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).

To jest wersja beta interfejsu API do zarządzania Google Analytics.

Nowe pliki danych

Zaktualizowane biblioteki klienta

  • Interfejs API zarządzania zostanie udostępniony w tej samej bibliotece co interfejs Google Analytics Data Export API. Zaktualizowaliśmy biblioteki Java i JavaScript danych Google. Dostęp do każdego kanału można uzyskać, podając odpowiedni identyfikator URI pliku w metodzie getManagementFeed() biblioteki.

Nowa dokumentacja

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 poprawki błędów i czyszczenie interfejsu API.

  • Poprawki błędów:

    • Usunięto błąd śledzenia zdarzeń. Aby zadzwonić pod numer _trackEvent, nie musisz już najpierw zadzwonić pod numer _initData lub _trackPageview.
    • Zaktualizowany fragment asynchroniczny, dzięki czemu można go umieścić w nagłówku na dowolnej stronie, nie powodując problemów w IE 6 i 7. Nowy fragment kodu znajdziesz w przewodniku po śledzeniu asynchronicznego. Ta aktualizacja miała miejsce 22.03.2010.
    • Rozwinięto składnię asynchroniczną, aby umożliwić obsługę metod wywoływania w obiekcie _gat.
  • Zaktualizowane interfejsy API inicjowania trackera w celu zachowania spójności ze składnią asynchroniczną. Wycofano też stare funkcje.

    • Dodano funkcję _gat._createTracker(opt_account, opt_name). Pozwala na nadawanie nazw trackerom i późniejsze pobieranie ich według nazwy.Używaj tej opcji zamiast: _gat._getTracker(account).
    • Dodano: _gat._getTrackerByName(name). Pobiera urządzenie śledzące o podanej nazwie.
    • Dodano: tracker._getName(). Zwraca nazwę nadana trackerowi, gdy został utworzony.
    • Wycofano: _gaq._createAsyncTracker(account, opt_name). Użyj w zamian zasady _gat._createTracker.
    • Wycofano: _gaq._getAsyncTracker(name). Użyj w zamian zasady _gat._getTrackerByName.
  • Szczegółowe informacje o zmianach w interfejsie API znajdziesz w dokumentacji modułu śledzenia.

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:

    • <dxp:segment id="gaid::-3" name="Returning Visitors"></dxp:segment>
    • <dxp:definition>ga:visitorType==Returning Visitor</dxp:definition>
  • 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:

    • <ga:goal active="true" name="Completing Order" number="1" value="10.0"></ga:goal>
    • <ga:destination expression="/purchaseComplete.html" matchtype="regex" step1required="false" casesensitive="false"></ga:destination>
    • <ga:step number="1" name="Login" path="/login.html"></ga:step>
    • <ga:engagement comparison=">" thresholdvalue="300" type="timeOnSite"></ga:engagement>
  • 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:

    • <ga:customvariable index="1" name="category" scope="visitor"></ga:customvariable>
  • 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 zawiera aktualizacje listy domyślnych wyszukiwarek i nowe funkcje kontroli limitów czasu oczekiwania na pliki cookie. Oprócz tego uruchamiany jest asynchroniczny fragment kodu GA, który zmniejsza czas oczekiwania na kod ga.js na stronie.

  • Zaktualizowano listę domyślnych wyszukiwarek

    • Dodano wyszukiwarki Naver, Eniro i Daum.
    • Z listy usunięto Looksmart, Gigablast, Club-internet, Netsprint, Intera, Nostrum i Ilse.
  • Dodano funkcje kontrolowania czasu ważności plików cookie dla wszystkich przechowywanych plików cookie. Wycofano istniejące funkcje limitu czasu obsługi plików cookie. Więcej informacji znajdziesz w dokumentacji interfejsu JS API.

    • _setVisitorCookieTimeout(cookieTimeoutMillis) zastępuje funkcję _setCookiePersistence.
    • _setSessionCookieTimeout(cookieTimeoutMillis) zastępuje funkcję _setSessionTimeout.
    • _setCampaignCookieTimeout(cookieTimeoutMillis) zastępuje funkcję _setCookieTimeout.
  • Udostępniono asynchroniczny fragment kodu GA. Aby dowiedzieć się, jak je wypróbować, zapoznaj się z dokumentacją.

  • Funkcja _setVar została wycofana. Funkcja Zmienne niestandardowe zastępuje funkcję _setVar. Więcej informacji znajdziesz w dokumentacji.

Ta wersja zawiera:

  • Dodaliśmy nową funkcję pobierania zmiennych niestandardowych na poziomie użytkownika. Więcej informacji znajdziesz w dokumentacji funkcji.

    • _getVisitorCustomVar(index)
  • Zamiast czekać na window.onload, treść nakładki witryny jest wczytywana od razu po wykonaniu kodu ga.js.

Ta wersja zawiera nową funkcję:

  • Do funkcji _addOrganic dodaliśmy opcjonalny parametr logiczny, który określa, czy nowe źródła bezpłatne mają być dodawane na początku czy na końcu listy takich źródeł. Więcej informacji znajdziesz w dokumentacji.

    • _addOrganic(newOrganicEngine, newOrganicKeyword, opt_prepend)

Ta wersja obejmuje regularną konserwację w celu poprawy wydajności i refaktoryzacji. Publiczne interfejsy API i funkcje nie uległy zmianie.

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

Ta wersja zawiera wiele poprawek błędów i poprawia wydajność:

  • Poprawne kodowanie wyszukiwanych haseł w przypadku bezpłatnych wyników wyszukiwania, informacji o ścieżce do strony internetowej dla (utmp) oraz wartości zdefiniowanych przez użytkownika w przypadku użycia z funkcją łączącą (np. funkcje _link i _linkByPost).
  • Wyszukiwarka Rambler została dodana do listy bezpłatnych wyników wyszukiwania.
  • Analiza składni bezpłatnych wyników wyszukiwania w wyszukiwarce http://kvasir.no została poprawiona.
  • Nowe bezpłatne wyszukiwarki zdefiniowane przez użytkownika są teraz dodawane u góry listy
  • Usunięto wycofaną funkcję _trackEvent(action, label, value) i zastąpiono ją funkcją _trackEvent(category, action, label, value)
  • Adresy URL stron odsyłających są obecnie zapisane z uwzględnieniem wielkości liter. Przykład: adres URL strony www.domain.com/PaGe.HtMl będzie raportowany z uwzględnieniem wielkości liter.
  • Dodano ograniczenie 1200 znaków do rozmiaru tokena GASO.
  • Dodaliśmy nową funkcję, która umożliwia zastąpienie domyślnych limitów czasu korzystania z plików cookie: _setCookiePersistence(timeout)

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).
    <dxp:property name="ga:currency" value="USD"></dxp:property>
    <dxp:property name="ga:timezone" value="America/Los_Angeles"></dxp:property>

  • 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