Historia zmian interfejsu API podstawowego raportowania Google Analytics

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

Na tej stronie opisujemy wszystkie zmiany wprowadzone w interfejsie Google Analytics Core Reporting API, które mogą mieć wpływ na Twoją aplikację. Zalecamy deweloperom korzystającym z interfejsów API sprawdzanie co jakiś czas tej listy, czy nie pojawiły się nowe ogłoszenia. Możesz też zasubskrybować zmiany za pomocą kanałów wymienionych w sekcji Subskrybuj poniżej.

Subskrybuj powiązane dzienniki zmian

Obejmuje wszystkie interfejsy API zbierania, konfiguracji i raportowania.

Obejmuje interfejs API podstawowego raportowania, interfejs API do raportowania ścieżek wielokanałowych i interfejs Real Time Reporting API.

To jest pierwsza wersja interfejsu User Activity API

  • Interfejs User Activity API umożliwia pobieranie wszystkich danych powiązanych z pojedynczym identyfikatorem klienta lub użytkownika w danym zakresie dat. Jest ona przeznaczona przede wszystkim dla właścicieli usług, którzy chcą zapewnić bezpośredni dostęp do danych użytkownika w sposób automatyczny. Więcej informacji znajdziesz w przewodniku po interfejsie User Activity API.

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

W tej wersji zwiększamy maksymalną liczbę 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 zwiększa się z 10 000 do 100 000.

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

W tej wersji wycofujemy funkcję Produkty powiązane oraz powiązane z nią wymiary i dane. Pełną listę definicji znajdziesz w dokumentacji wymiarów i danych. Aby dowiedzieć się więcej o usuwaniu danych, zapoznaj się z zasadami wycofywania danych:

W tej wersji wycofujemy 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 do interfejsu API nowy wymiar. Pełną listę definicji znajdziesz w dokumentacji wymiarów i danych. W tej wersji usunęliśmy też 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 elementy 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

Obliczanie danych Użytkownicy i Aktywni użytkownicy zostało zaktualizowane, 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 wybranym okresie.
  • ga:1dayusers – łączna liczba użytkowników aktywnych w ciągu 1 dnia w każdym dniu w wybranym okresie.
  • ga:7dayusers – łączna liczba użytkowników aktywnych w ciągu 7 dni w każdym dniu w wybranym okresie.
  • ga:14dayusers – łączna liczba użytkowników aktywnych w ciągu 14 dni na każdy dzień w wybranym okresie.
  • ga:30dayusers – łączna liczba użytkowników aktywnych w ciągu 30 dni na każdy dzień w wybranym okresie.

Unikalne zdarzenia

Zbliża się koniec okresu wycofywania usługi ga:uniqueEvents. Po 26 marca 2017 r. zaktualizujemy definicję typu ga:uniqueEvents i zostaną usunięte z interfejsu API prywatne dane ga:uniqueEventsTemporary. Więcej informacji znajdziesz w dokumentacji pomocy dotyczącej unikalnych zdarzeń.

W tej wersji dodaliśmy nowy wymiar 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 każdego użytkownika wymiar Grupa użytkowników (wartości od 1 do 100) wskazuje zasobnik, do którego został on przypisany. Więcej informacji znajdziesz w artykule Testowanie 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

Widoki danych spoza AdSense nie będą mogły wysyłać zapytań o wymiary i dane AdSense. Zapytanie o te wymiary i dane w widoku niepołączonym z AdSense spowoduje błąd.

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

Wymiary i dane AdSense

W tej wersji rozwiązaliśmy problem występujący od 7 stycznia 2017 roku, który powodował, że w przypadku widoków danych niepołączonych z AdSense wysyłanie zapytań o wymiary i dane AdSense powodowało wyświetlanie błędu „Nieznane dane”.

Nadchodzące zmiany

Od 31 stycznia 2017 r. lub po tej dacie możliwość wysyłania zapytań o wymiary i dane AdSense dla widoków niepołączonych z AdSense Zapytanie o te wymiary i dane w widoku niepołączonym z AdSense spowoduje błąd.

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

Obliczone dane

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

  • Dane – ga:calcMetric_ – wartość żądanych obliczonych danych, gdzie odnosi się do zdefiniowanej przez użytkownika nazwy obliczonych danych. Pamiętaj, że typem danych ga:calcMetric_ może być FLOAT, INTEGER, CURRENCY, TIME lub PERCENT. Więcej informacji znajdziesz w sekcji Obliczone dane – informacje.

W tej wersji dodaliśmy do interfejsu API nowy rodzaj danych. Spowoduje to też wycofanie dotychczasowych danych. Pełną listę definicji znajdziesz w dokumentacji wymiarów i danych.

Śledzenie zdarzeń

Definicja obiektu ga:uniqueEvents zmieni się, aby dokładniej odzwierciedlać liczbę unikalnych zdarzeń. Aby mieć wpływ na tę zmianę, technicznie wycofamy obecne dane ga:uniqueEvents zgodnie z naszymi zasadami wycofywania danych. 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 też nowy wskaźnik ga:uniqueDimensionCombinations, który zachowa obecną definicję typu ga:uniqueEvents. Po odpowiednim okresie wycofania (około 6 miesięcy) wskaźnik prywatny ga:uniqueEventsTemporary zostanie usunięty, a pierwotna wartość ga:uniqueEvents będzie prawidłowo odzwierciedlać liczbę niepowtarzalnych zdarzeń. Więcej informacji znajdziesz w dokumentach pomocy dotyczących unikalnych zdarzeń.

Unikalne zdarzenia

  • Dane – ga:uniqueEvents – definicja zdarzenia ga:uniqueEvents wkrótce się zmieni, aby dokładniej odzwierciedlać liczbę unikalnych zdarzeń. Jeśli chcesz zachować obecną definicję, użyj parametru ga:uniqueDimensionCombinations. Więcej informacji znajdziesz w dokumentacji pomocy dotyczącej unikalnych zdarzeń.
  • Dane – ga:uniqueDimensionCombinations – Unikalne kombinacje wymiarów zliczają liczbę niepowtarzalnych 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ń.

Testy przejścia – prywatne

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

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

DoubleClick Bid Manager

  • Wymiar – ga:dbmClickAdvertiser – nazwa reklamodawcy DBM kliknięcia DBM odpowiadającego sesji Google Analytics (tylko Analytics 360, wymaga integracji z DBM).
  • Wymiar – ga:dbmClickAdvertiserId – identyfikator reklamodawcy DBM, którego dotyczyło kliknięcie DBM odpowiadające sesji Google Analytics (tylko Analytics 360, wymaga integracji z DBM).
  • Wymiar – ga:dbmClickCreativeId – identyfikator kreacji DBM odpowiadający kliknięciu DBM odpowiadającemu 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 odpowiadającego kliknięciu DBM odpowiadającemu 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 kliknięcia DBM odpowiadającego sesji Google Analytics (tylko Analytics 360, wymaga integracji z DBM).
  • Wymiar – ga:dbmClickSite – nazwa witryny DBM, w której wyświetliła się kreacja DBM i została kliknięta w związku z kliknięciem DBM odpowiadającym sesji Google Analytics (tylko Analytics 360, wymaga integracji z DBM).
  • Wymiar – ga:dbmClickSiteId – identyfikator witryny DBM, w której wyświetliła się kreacja DBM i została kliknięta w związku z kliknięciem DBM odpowiadającym 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 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:dbmLastEventCreativeId – identyfikator kreacji 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: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ś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: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ęcia 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 w ostatnim zdarzeniu DBM (wyświetleniu lub kliknięciu w okresie ważności DBM) powiązanym z sesją Google Analytics (tylko Analytics 360, wymaga integracji z DBM).
  • Wymiar – ga:dbmLastEventLineItemId – identyfikator elementu zamówienia 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:dbmLastEventSite – nazwa witryny DBM, w której wyświetliła się kreacja DBM i została kliknięta w związku z ostatnim zdarzeniem DBM (wyświetleniem lub kliknięciem w okresie ważności DBM) powiązanym z sesją Google Analytics (tylko Analytics 360, wymaga integracji z DBM).
  • Wymiar – ga:dbmLastEventSiteId – identyfikator witryny DBM, w której wyświetliła się kreacja DBM i została kliknięta w związku z ostatnim zdarzeniem DBM (wyświetleniem lub kliknięciem w okresie ważności DBM) powiązanym z sesją Google Analytics (tylko Analytics 360, wymaga integracji z DBM).
  • Dane – ga:dbmCPA – eCPA z przychodów w DBM (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 w DS (tylko Analytics 360, wymaga integracji z DS).
  • Wymiar – ga:dsAdvertiserId – identyfikator reklamodawcy w 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 w DS po stronie reklamodawcy (tylko Analytics 360, wymaga integracji z DS).
  • ga:dsCTR – współczynnik klikalności w DS (tylko Analytics 360, wymaga integracji z DS).
  • ga:dsClicks – kliknięcia w DS (tylko Analytics 360, wymaga integracji z DS).
  • ga:dsCost – koszt DS (tylko Analytics 360, wymaga integracji z DS).
  • ga:dsImpressions – wyświetlenia w 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, wymaga integracji z DS).

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

Geo Network

  • Wymiar ga:continentId – identyfikator kontynentu użytkownika pobrany z adresów IP lub identyfikatorów geograficznych.

Ograniczenia

Tych wymiarów w poniższych grupach nie można wysyłać zapytań z wymiarami z innych grup:

  • Otwórz grupę informacyjną Zakupów Google.
    • ga:checkoutOptions
    • ga:shoppingStage
  • Grupa eksperymentalna GWO
    • ga:experimentVariant
    • ga:experimentId
  • Grupa zainteresowań
    • ga:interestOtherCategory
  • Grupa zainteresowań na rynku
    • ga:interestInMarketCategory
  • Grupa reklam wewnętrznych:
    • ga:internalPromotionCreative
    • ga:internalPromotionId
    • ga:internalPromotionName
    • ga:internalPromotionPosition
  • Budowanie marki – grupa zainteresowań:
    • 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 w przypadku nieudanych (5XX) żądań raportowania.

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

Limity dotyczące przestawień

W tej wersji zaczynamy egzekwować limity dotyczące żądań przestawnych:

  • Żądanie raportu może teraz mieć maksymalnie 2 przestawienia.
  • Tabela przestawna może zawierać maksymalnie 4 wymiary.
  • Wymiary przestawne wchodzą w skład ograniczenia łącznej liczby wymiarów dozwolonych w żądaniu.
  • metrics przestawne wchodzą w skład 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, pozyskany na podstawie adresów IP lub identyfikatorów geograficznych użytkowników.

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 zawierająca dwie jednostki reklamowe zostanie wyświetlona raz, zarejestrujemy dwa wyświetlenia (łączenie z Ad Manager i ukrywanie przychodów z Ad Managera wyłączone).
  • 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 Ad Managerem jest włączone, a ukryte przychody z Google Ad Managera wyłączone)”
  • Dane – ga:dfpMonetizedPageviews – łączna liczba odsłon w usłudze, które zawierały reklamę z połączonego konta DFP. Pamiętaj, że pojedyncza strona może zawierać wiele jednostek reklamowych (łączenie z Ad Managerem jest włączone i wyłączono opcję Ukryj przychody z Google Ad Managera).
  • Dane – ga:dfpImpressionsPerSession – stosunek wyświetleń reklam z Ad Managera do sesji Analytics (wyświetlenia reklam / sesje Analytics) (łączenie z Ad Managerem i ukrywanie przychodów z Ad Managera wyłączone).
  • Dane – ga:dfpViewableImpressionsPercent – odsetek widocznych wyświetleń reklamy. Wyświetlenie uznaje się za widoczne, gdy pojawi się w przeglądarce użytkownika i istnieje możliwość, aby je zobaczyć (łączenie z Google Ad Manager i ukrywanie przychodów z Ad Managera wyłączone).
  • Dane – ga:dfpClicks – liczba kliknięć reklam DFP w witrynie (łączenie z kontem DFP włączone i wyłączenie opcji Ukryj przychody z Google Ad Managera).
  • Dane – ga:dfpCTR – odsetek odsłon strony, które zakończyły się kliknięciem reklamy z Google Ad Managera (łączenie z Ad Managerem i ukrywanie przychodów z Ad Managera wyłączone).
  • Dane – ga:dfpRevenue – przychody z Google Ad Managera to oszacowanie łącznych przychodów z reklam na podstawie zrealizowanych wyświetleń (łączenie z kontem DFP jest włączone, a ukryta opcja Ukryj przychody z Ad Managera nie jest włączona).
  • Dane – ga:dfpRevenuePer1000Sessions – łączne szacunkowe przychody z reklam DFP na 1000 sesji Analytics. Zwróć uwagę, że dane te są oparte na sesjach w witrynie, a nie na wyświetleniach reklam (łączenie z Ad Managerem jest włączone i wyłączono opcję Ukryj przychody z Ad Managera).
  • Dane – ga:dfpECPM – efektywny koszt tysiąca odsłon. Są to przychody z Google Ad Managera na 1000 odsłon (połączenie z Ad Managerem jest włączone i wyłączono opcję Ukryj przychody z Google Ad Managera).
  • Dane – ga:backfillImpressions – wyświetlenia zapasowe to suma wszystkich wyświetleń reklam AdSense lub Ad Exchance zrealizowanych jako wyświetlenia zapasowe przez DFP. Wyświetlenie reklamy jest odnotowywane za każdym razem, gdy pojedyncza reklama wyświetli się w witrynie. Jeśli na przykład strona zawierająca dwie jednostki reklamowe zostanie wyświetlona raz, zarejestrujemy dwa wyświetlenia (łączenie z Ad Manager i ukrywanie przychodów z Ad Managera wyłączone).
  • Dane – ga:backfillCoverage – Pokrycie reklam zapasowych to odsetek żądań reklam zapasowych, które zwróciły co najmniej 1 reklamę. Pokrycie ułatwia identyfikację witryn, 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ą dwóch kont zapasowych (łączenie z Ad Managerem jest włączone i wyłączono opcję Ukryj przychody z Ad Exchange).
  • Dane – ga:backfillMonetizedPageviews – łączna liczba odsłon w usłudze, które zawierały co najmniej 1 reklamę z połączonych kont reklam zapasowych. Pamiętaj, że jedna odsłona strony generującej przychód może obejmować wiele wyświetleń reklam (łączenie z Ad Managerem i ukrywanie przychodów z Ad Managera nie jest włączone).
  • Dane – ga:backfillImpressionsPerSession – stosunek wyświetleń reklam zapasowych do liczby sesji Analytics (Wyświetlenia reklam / sesje Analytics). Jeśli zarówno AdSense, jak i Ad Exchange udostępniają reklamy zapasowe, te dane są sumą danych z dwóch kont zapasowych (łączenie z Ad Managerem i wyłączone opcję Ukryj przychody z Ad Exchange).
  • Dane – ga:backfillViewableImpressionsPercent – odsetek zapasowych wyświetleń reklam, które były widoczne. Wyświetlenie staje się widocznym wyświetleniem, gdy pojawiło się w przeglądarce użytkownika, który miał okazję je zobaczyć. Jeśli zarówno AdSense, jak i Ad Exchange udostępniają reklamy zapasowe, te dane są średnią ważoną dwóch kont zapasowych (łączenie z Ad Managerem jest włączone i wyłączono opcję Ukryj przychody z Ad Exchange).
  • Dane – ga:backfillClicks – liczba kliknięć reklam zapasowych w witrynie. Jeśli zarówno AdSense, jak i Ad Exchange udostępniają reklamy zapasowe, te dane są sumą danych z tych dwóch kont (łączenie z Ad Managerem jest włączone i wyłączono opcję Ukryj przychody z Ad Exchange).
  • Dane – ga:backfillCTR – odsetek zapasowych wyświetleń, które zakończyły się kliknięciem reklamy. Jeśli zarówno AdSense, jak i Ad Exchange udostępniają reklamy zapasowe, te dane są średnią ważoną dwóch kont zapasowych (łączenie z Ad Managerem jest włączone i wyłączono opcję Ukryj przychody z Ad Exchange).
  • Dane – ga:backfillRevenue – łączne szacunkowe przychody z reklam zapasowych. Jeśli zarówno AdSense, jak i Ad Exchange udostępniają reklamy zapasowe, te dane są sumą danych z tych dwóch kont (łączenie z Ad Managerem jest włączone i wyłączono opcję Ukryj przychody z Ad Exchange).
  • 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 są sumą danych z dwóch kont zapasowych (łączenie z Ad Managerem i wyłączone opcję Ukryj przychody z Ad Exchange).
  • Dane – ga:backfillECPM – efektywny koszt tysiąca odsłon. Przychody z reklam zapasowych DFP na 1000 odsłon. Jeśli zarówno AdSense, jak i Ad Exchange udostępniają reklamy zapasowe, te dane są sumą danych z dwóch kont zapasowych (łączenie z Ad Managerem i wyłączone opcję Ukryj przychody z Ad Exchange).

To jest wersja z poprawką błędów, która rozwiązała 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ł on podzielony na 2 segmenty w interfejsie Analytics Reporting API w wersji 4.

Próbkowanie

W tej wersji rozwiązaliśmy problem polegający na tym, że podzbiór żądań z tabel niestandardowych zwracał próbkowane dane.

To jest wersja z poprawką błędów, która eliminuje problem występujący podczas tworzenia żądań do interfejsu Analytics Reporting API V4 w przypadku kohorty.

Prośby dotyczące kohorty

Żądania kohorty mogą teraz prosić o żądanie wszystkich wymiarów kohorty. Wcześniej interfejs API zwracał błąd, gdy zażądano wymiarów ga:acquisition....

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

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

W tej wersji przedstawiamy nową wersję interfejsu API – Analytics Reporting API V4. Ten nowy interfejs API jest najbardziej zaawansowaną metodą automatyzacji uzyskiwania 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 możliwości platformy Google Analytics. Najważniejsze funkcje interfejsu Analytics Reporting API w wersji 4 to między innymi:

  • Wyrażenia wskaźników – interfejs API umożliwia zgłaszanie żądań nie tylko wbudowanych danych, ale też 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 – można zażądać dwóch zakresów dat, co pozwala porównać dane z dwóch okresów w jednym żądaniu.
  • Kohorty i wartość od początku śledzenia – interfejs API ma bogaty asortyment umożliwiający zapotrzebowanie na raporty dotyczące kohorty i wartości od początku śledzenia.
  • Wiele segmentów – możesz teraz zażądać wielu segmentów w jednym żądaniu.

Pierwsze kroki

Szczegółowe informacje o tym, jak zacząć korzystać z interfejsu API, znajdziesz w dokumentacji dla programistów.

Zasady dotyczące limitów

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

Migracja

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

Wymiary i dane

W tej wersji dodaliśmy też zestaw wymiarów i danych przeznaczonych specjalnie na potrzeby 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 definiowania kohort użytkownik może należeć do wielu kohort, podobnie jak użytkownik może należeć do wielu segmentów.

  • Wymiar – ga:cohortNthDay – przesunięcie o wartość od 0 dnia w stosunku do daty definicji kohorty. Jeśli np. kohorta została zdefiniowana z datą pierwszej wizyty jako 1 września 2015 r., dla dnia 4 września 2015 r. atrybut ga:cohortNthDay będzie mieć wartość 3.

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

  • Wymiar – ga:cohortNthWeek – przesunięcie tygodniowe względem daty definicji kohorty opartej na 0.

  • Wymiar – ga:acquisitionTrafficChannel – kanał ruchu, dzięki któremu udało się pozyskać użytkownika. Jest wyodrębniany z pierwszej sesji użytkownika. Kanał ruchu jest obliczany na podstawie domyślnych reguł grupowania kanałów (na poziomie widoku danych, jeśli są dostępne) w momencie pozyskiwania 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 – połączona 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 są istotne w kontekście wymiarów przesunięcia, które są liczone od 0 (ga:cohortNthDay, ga:cohortNthWeek lub ga:cohortNthMonth). Wskazuje liczbę użytkowników w kohorcie, którzy są aktywni w okresie odpowiadającym n-tym dniu/tygodniowi/miesiącu kohorty. 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 przypadku kohorty.

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

  • Dane – ga:cohortTotalUsersWithLifetimeCriteria – występują 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 dzięki bieżącemu kanałowi, źródłu, medium lub kampanii. Na przykład w przypadku ga:acquisitionTrafficChannel=Direct przedstawia liczbę użytkowników w kohorcie, którzy zostali bezpośrednio pozyskani. 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 przypadku wymiaru pozyskiwania w przypadku kohorty.

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

  • Dane – ga:cohortRevenuePerUserWithLifetimeCriteria – przychody na użytkownika według wymiaru pozyskiwania 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 i po 30 kwietnia 2016 r. będą uwzględniać w raportach 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. Aby dowiedzieć się więcej o usuwaniu danych, zapoznaj się z zasadami wycofywania danych:

  • Wymiar ga:socialActivityEndorsingUrl – w przypadku działania w centrum danych społecznościowych jest to adres URL działania społecznościowego (np. adres URL posta w Google+, komentarz na blogu itp.).
  • Wymiar ga:socialActivityDisplayName – w przypadku działania w centrum danych społecznościowych jest to tytuł działania społecznościowego opublikowanego przez użytkowników sieci społecznościowej.
  • Wymiar ga:socialActivityPost – w przypadku działania w centrum danych społecznościowych jest to treść 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 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 nick (np. nazwa lub identyfikator) sieci społecznościowej 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 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 działaniem.
  • Wymiar – ga:socialActivityNetworkAction – w przypadku działania centrum danych społecznościowych określa rodzaj 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 aktywności, w przypadku których adres URL treści został udostępniony lub wspomniany w sieci partnerskiej centrum danych społecznościowych.

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

Platforma lub urządzenie

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

W tej wersji dodaliśmy nowy parametr do interfejsu API.

Uwzględnij puste wiersze

  • W tej wersji dodaliśmy nowy opcjonalny parametr include-empty-rows, który w przypadku ustawienia wartości false wierszy bez danych zostanie pominięty w odpowiedzi. Wartość domyślna to true, a nie jest to zmiana powodująca problemy i dlatego nie powinna wymagać aktualizacji kodu. Więcej informacji znajdziesz w dokumentacji interfejsu API Core Reporting.

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 przesłać zapytanie o te dane, należy określić co najmniej jeden z elementów ga:nthDay, ga:date lub ga:day. Zwracaną wartością dla danej daty będzie łączna liczba 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 przesłać zapytanie o te dane, należy określić co najmniej jeden z elementów ga:nthDay, ga:date lub ga:day. Zwracaną wartością dla danej daty będzie łączna liczba unikalnych użytkowników z 7-dniowego okresu kończącego 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 przesłać zapytanie o te dane, należy określić co najmniej jeden z elementów ga:nthDay, ga:date lub ga:day. Zwracaną wartością dla danej daty będzie łączna liczba unikalnych użytkowników z 14-dniowego okresu kończącego 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 przesłać zapytanie o te dane, należy określić co najmniej jeden z elementów ga:nthDay, ga:date lub ga:day. Zwracaną wartością dla danej daty będzie łączna liczba unikalnych użytkowników z 30-dniowego okresu kończącego się w danym dniu.

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

DoubleClick Ad Exchange (AdX)

  • Dane – ga:adxCTR – odsetek odsłon, które zakończyły się kliknięciem reklamy AdX.
  • Dane – ga:adxClicks, liczba kliknięć reklam AdX w Twojej witrynie.
  • Dane – ga:adxCoverage – pokrycie to odsetek żądań reklamy, które zwróciły co najmniej 1 reklamę. Pokrycie z reguły pozwala zidentyfikować witryny, w których konto Ad Exchange 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 Ad Exchange na 1000 odsłon.
  • Dane – ga:adxImpressions – wyświetlenie reklamy AdX jest odnotowywane po każdorazowym wyświetleniu pojedynczej reklamy w Twojej witrynie. 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 przychody podają łączną liczbę odsłon w Twojej usłudze, które zawierały reklamę z połączonego konta AdX. Uwaga: pojedyncza strona może zawierać wiele jednostek reklamowych.
  • Dane – ga:adxRevenue – łączne szacunkowe przychody z reklam AdX.
  • Dane – ga:adxRevenuePer1000Sessions – łączne szacunkowe przychody z reklam AdX na 1000 sesji Analytics. Pamiętaj, że podstawą dla tego wyliczenia jest liczba sesji w witrynie, a nie liczba wyświetleń reklam.
  • Dane – ga:adxViewableImpressionsPercent – odsetek wyświetleń reklam, które były widoczne. Wyświetlenie staje się widocznym wyświetleniem, gdy pojawiło się w wyszukiwarce użytkownika, który miał okazję je zobaczyć.

Ta wersja wycofuje istniejące wymiary lub dane. Pełną listę definicji znajdziesz w dokumentacji wymiarów i danych.

Wycofane wymiary

Te wymiary zostały wycofane. Aby dowiedzieć się więcej o usuwaniu danych, zapoznaj się z zasadami wycofywania danych:

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

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

AdWords

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

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

Platforma lub urządzenie

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

Ta wersja dodaje do interfejsu API nowe wymiary i dane oraz wycofuje 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 pochodzące z 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 postaci kodu 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 postaci kodu 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ą podawane jako kod UN M.49 (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. Więcej informacji o usuwaniu danych znajdziesz w zasadach wycofywania danych: + Wskaźnik – ga:dcmROI – Zamiast nich użyj ga:dcmROAS. + Dane – ga:dcmMargen – zamiast tego użyj wymiaru ga:dcmROAS.

W tej wersji dodaliśmy do interfejsu API nowe dane i wycofano 2 dotychczasowe dane. 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. Więcej informacji o usuwaniu danych znajdziesz w zasadach wycofywania danych: + Wskaźnik – ga:ROI – Zamiast nich użyj ga:ROAS. + Dane – ga:margin – zamiast tego użyj wymiaru ga:ROAS.

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

AdSense

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

W tej wersji dodaliśmy nowe dane o 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 strony, zdarzenia, czas itd.)

Źródła wizyt

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

DoubleClick Campaign Manager

  • Wymiar – ga:dcmClickAd – nazwa reklamy DCM, której dotyczyło kliknięcie DCM odpowiadające sesji Google Analytics (tylko w wersji premium).
  • Wymiar – ga:dcmClickAdId – identyfikator reklamy DCM odpowiadający kliknięciu w DCM odpowiadającemu sesji Google Analytics (tylko w wersji premium).
  • Wymiar – ga:dcmClickAdType – nazwa typu reklamy DCM, której dotyczyło kliknięcie DCM odpowiadające sesji Google Analytics (tylko w wersji 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 kliknięcie odpowiada kliknięciu sesji Google Analytics (tylko w wersji premium).
  • Wymiar – ga:dcmClickAdvertiserId – identyfikator reklamodawcy DCM, którego kliknięcie odpowiada kliknięciu 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 w DCM odpowiadającego sesji Google Analytics (tylko w wersji premium).
  • Wymiar – ga:dcmClickCreativeId – identyfikator kreacji DCM odpowiadający kliknięciu w DCM odpowiadającemu sesji Google Analytics (tylko w wersji premium).
  • Wymiar – ga:dcmClickCreativeType – nazwa typu kreacji DCM odpowiadającej kliknięciu reklamy DCM odpowiadającej sesji Google Analytics (tylko premium).
  • Wymiar – ga:dcmClickCreativeTypeId – identyfikator typu kreacji DCM, którego dotyczyło kliknięcie DCM odpowiadające sesji Google Analytics (tylko w wersji premium).
  • Wymiar – ga:dcmClickCreativeVersion – wersja kreacji DCM, której dotyczyło kliknięcie DCM pasujące do sesji Google Analytics (tylko w wersji premium).
  • Wymiar – ga:dcmClickRenderingId – identyfikator renderowania DCM kliknięcia DCM odpowiadającego 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 została kliknięta w przypadku kliknięcia DCM odpowiadającego sesji Google Analytics (tylko w wersji Premium).
  • Wymiar – ga:dcmClickSitePlacement – nazwa miejsca docelowego w witrynie w DCM, którego dotyczyło kliknięcie DCM odpowiadające sesji Google Analytics (tylko w wersji premium).
  • Wymiar – ga:dcmClickSitePlacementId – identyfikator miejsca docelowego w witrynie w 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 odpowiadający kliknięciu w DCM odpowiadającemu 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 ostatnie zdarzenie DCM (wyświetlenie lub kliknięcie w okresie ważności DCM) powiązanego z sesją Google Analytics (tylko dla subskrybentów Premium).
  • Wymiar – ga:dcmLastEventAdvertiserId – identyfikator reklamodawcy 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:dcmLastEventAttributionType: możliwe 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świetlenia lub kliknięcia 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świetlenia lub kliknięcia w okresie ważności DCM) powiązanego z sesją Google Analytics (tylko w wersji Premium).
  • Wymiar – ga:dcmLastEventCreative – nazwa 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: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świetlenia lub kliknięcia 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 wyświetliła się kreacja DCM i kliknięto ją 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 kreacja DCM została wyświetlona i kliknięta w przypadku ostatniego zdarzenia DCM (wyświetlenia lub kliknięcia w okresie ważności DCM) powiązanego z sesją Google Analytics (tylko dla subskrybentów Premium).
  • Wymiar – ga:dcmLastEventSitePlacement – nazwa miejsca docelowego w witrynie w 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:dcmLastEventSitePlacementId – identyfikator miejsca docelowego w witrynie w 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świetlenia lub kliknięcia w okresie ważności DCM) powiązanego z sesją Google Analytics (tylko w wersji Premium).
  • Dane – ga:dcmFloodlightQuantity – liczba konwersji Floodlight w DCM (tylko w wersji premium).
  • Dane – dcmFloodlightRevenue – przychody z DCM Floodlight (tylko w wersji premium).

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

Wymiary i dane

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

Grupowanie treści

  • Wymiar – ga:landingContentGroupXX – pierwsza pasująca grupa treści w sesji użytkownika.
  • Wymiar – ga:nextContentGroupXX – odnosi się do grupy treści, która została odwiedzonej po innej grupie treści.
  • Wymiar – ga:contentGroupXX – grupa treści w usłudze. Grupa treści to zbiór treści zapewniający 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ędnia ona zarówno parametr pagePath, jak i pageTitle.

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

Segmenty

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

Wymiary i dane

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

Ulepszone e-commerce

  • Wymiar – ga:internalPromotionCreative – treść kreacji stworzona na potrzeby promocji.
  • Wymiar – ga:internalPromotionId – identyfikator, którego używasz w przypadku promocji.
  • Wymiar – ga:internalPromotionName: nazwa promocji.
  • Wymiar – ga:internalPromotionPosition – pozycja promocji na stronie internetowej lub ekranie aplikacji.
  • Wymiar – ga:orderCouponCode – kod kuponu zamówienia 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, w 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, a kolor czerwony, niebieski, zielony i czarny.
  • Wymiar – ga:checkoutOptions – opcje użytkownika określone podczas procesu płatności, np. Opcje dostawy: FedEx, DHL, UPS, albo 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 procesu zakupu, realizowane przez użytkowników w danej sesji, np. PRODUCT_VIEW, ADD_TO_CART, ACCOUNTOUT itp.
  • Dane – ga:internalPromotionCTR – współczynnik kliknięć, z jaką użytkownicy kliknęli, aby zobaczyć promocję wewnętrzną (liczba kliknięć / liczba wyświetleń promocji).
  • Dane – ga:internalPromotionClicks – liczba kliknięć promocji wewnętrznej.
  • Dane – ga:internalPromotionViews – liczba wyświetleń promocji wewnętrznej.
  • Dane – ga:localProductRefundAmount – kwota zwrotu środków za dany produkt w walucie lokalnej.
  • Dane – ga:localRefundAmount – łączna kwota zwrotu środków za transakcję w walucie lokalnej.
  • Dane – ga:productAddsToCart – liczba przypadków dodania produktu do koszyka.
  • Dane – ga:productCheckouts – liczba przypadków, w których produkt był uwzględniany w procesie płatności.
  • Dane – ga:productDetailViews – liczba wyświetleń strony ze szczegółami produktu.
  • Dane – ga:productListClicks – liczba kliknięć produktu, który pojawił się na liście produktów.
  • Dane – ga:productListViews – liczba wyświetleń produktu na liście produktów.
  • Dane – ga:productListCTR – współczynnik klikalności produktu na liście produktów przez użytkowników.
  • Dane – ga:productRefunds – liczba zwrotów ś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 – średnie przychody z produktu na zakup (używane 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 przy finalizowaniu zakupu.
  • 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 poprawiliśmy błąd związany z nazwami nagłówków kolumn, a także 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 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 widoku danych (Profil).
  • Wymiar – ga:correlationModelId – identyfikator modelu korelacji dla produktów powiązanych.
  • Wymiar ga:queryProductId – identyfikator produktu, którego dotyczy zapytanie.
  • Wymiar – ga:queryProductName – nazwa produktu, którego dotyczy zapytanie.
  • Wymiar – ga:queryProductVariation – wersja 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 wyślesz zapytanie o wycofane wymiary lub dane, interfejs API zwróci nagłówki kolumn z zastąpionymi wymiarami lub danymi. a teraz prawidłowo zwraca taką samą nazwę wymiaru lub danych, która została użyta w żądaniu.

W tej wersji wprowadziliśmy możliwość dodawania i zmieniania nazw wymiarów oraz 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 dla 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.

Zmiana nazw wymiarów i danych

Nazwy wszystkich wymiarów i danych opartych na użytkownikach i wizytach zostały zmienione i używają one teraz odpowiednio użytkowników i sesji.

Zmieniliśmy nazwy tych wymiarów i danych. Aby dowiedzieć się więcej o zmienianiu nazw danych, zapoznaj się z zasadami 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 nich użyj wymiaru ga:transactionRevenuePerSession.
  • Dane – ga:transactionsPerVisit – zamiast nich użyj wymiaru ga:transactionsPerSession.

Śledzenie zdarzeń

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

Konwersje celu

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

Śledzenie strony

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

Sesja

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

Interakcje społecznościowe

  • Wymiar ga:socialInteractionNetworkActionVisit – zamiast niego użyj wymiaru ga:socialInteractionNetworkActionSession.
  • Dane – ga:socialInteractionsPerVisit – zamiast nich 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 nich użyj wymiaru ga:newUsers.
  • Dane – ga:percentNewVisits – zamiast nich użyj wymiaru ga:percentNewSessions.
  • Dane – ga:visitors – zamiast nich użyj wymiaru ga:users.

Segmenty: interfejs API podstawowego raportowania v2.4 i 3.0

Interfejs API podstawowego raportowania obsługuje nowe segmenty.

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

Ta wersja zawiera nowy format odpowiedzi dla tabeli danych oraz dodanie i wycofanie wymiarów i danych (pełną listę definicji znajdziesz w dokumentacji wymiarów i danych).

Dane wyjściowe tabeli danych

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

  • Do interfejsu API dodano opcjonalny parametr zapytania output. Pozwala on wybrać w odpowiedzi format wyjściowy danych Analytics. Domyślnie ma on format JSON. Jeśli jest ustawiona na datatable, w odpowiedzi zostanie uwzględniona 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 Core Reporting.

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 dla każdej minuty w wybranym zakresie dat. Indeks dla 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: oznacza, że użytkownicy mogą być bardziej zainteresowani uzyskaniem informacji o określonej kategorii.
  • Wymiar ga:interestInMarketCategory – oznacza, że użytkownicy są bardziej skłonni do zakupu produktów lub usług z określonej kategorii.
  • Wymiar ga:interestOtherCategory: wskazuje, że użytkownicy są bardziej zainteresowani uzyskaniem informacji o danej kategorii, co z kolei jest bardziej prawdopodobne, że 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. Aby dowiedzieć się więcej o usuwaniu danych, zapoznaj się z zasadami 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 nich użyj wymiaru ga:visitBounceRate.

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

AdSense

  • Dostęp do danych AdSense został dodany:

    • Met – ga:adsenseRevenue – łączne przychody z reklam AdSense.
    • Met – ga:adsenseAdUnitsViewed – liczba wyświetlonych jednostek reklamowych AdSense. Jednostka reklamowa to zestaw reklam wyświetlanych na podstawie jednego kodu reklamy AdSense. Szczegółowe informacje: https://support.google.com/adsense/answer/32715.
    • Met – ga:adsenseAdsViewed – liczba wyświetlonych reklam AdSense. W jednej jednostce reklamowej może być wyświetlanych wiele reklam.
    • Met – ga:adsenseAdsClicks – liczba kliknięć reklam AdSense w Twojej witrynie.
    • ME – ga:adsensePageImpressions – liczba odsłon strony, podczas których została wyświetlona reklama AdSense. Wyświetlenie strony może mieć wiele jednostek reklamowych.
    • Met – ga:adsenseCTR – odsetek wyświetleń strony, które zakończyły się kliknięciem reklamy AdSense. (ga:adsenseAdsClicks/ga:adsensePageImpressions)
    • Wskaźnik – 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).
    • Zakończono – 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 Wartości ga:isoYear należy używać tylko z parametrem ga:isoWeek, ponieważ ga:week reprezentuje kalendarz agregatorski.
  • Przyciemnij – ga:isoYearIsoWeek – połączone wartości ga:isoYear i ga:isoWeek.

AdWords

  • W raportach AdWords można znaleźć te dane:

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 daty bieżącej w momencie wysyłania zapytania i według strefy czasowej widoku (profilu) podanej w zapytaniu. Więcej informacji znajdziesz w dokumentacji API.
Poziom próbkowania
  • Wprowadziliśmy nowy parametr samplingLevel, który pozwala ustawić poziom próbkowania (tj. liczbę wizyt używanych do obliczenia wyniku) dla zapytania raportowania. Dozwolone wartości to DEFAULT, FASTER i HIGHER_PRECISION.
  • Do odpowiedzi interfejsu API dodano 2 nowe pola: sampleSize i sampleSpace. Na podstawie tych wartości możesz obliczyć odsetek wizyt użytych w próbkowanej odpowiedzi.
  • Więcej informacji znajdziesz w dokumentacji API i na stronach próbkowanie.

Poprawki błędów

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

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

  • Parametr segment obsługuje teraz nowy identyfikator alfanumeryczny niestandardowych segmentów zaawansowanych, który jest zwracany w kolekcji Segmenty interfejsu API zarządzania.
  • Obecne identyfikatory numeryczne segmentów niestandardowych są teraz wycofywane. Te identyfikatory będą nadal obsługiwane przez 6 miesięcy. W celu przejścia na nowe identyfikatory alfanumeryczne zalecamy aplikacje, które zapisują identyfikatory segmentów użytkowników. Po zakończeniu okresu wycofywania wszystkie zapytania ze starymi identyfikatorami numerycznymi będą zwracać błąd.
  • Obecnie zapytania generowane przez parametr segment można tworzyć tylko w przypadku segmentów poziomu wizyty utworzonych w interfejsie internetowym.
  • Nie będzie to miało wpływu na istniejące domyślne segmenty o ujemnych identyfikatorach liczbowych. Nowe segmenty domyślne nie są jednak obecnie obsługiwane.

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

Śledzenie aplikacji

  • Te dane można znaleźć w raportach profilu aplikacji:
    • Przyciemnij – ga:appId – identyfikator aplikacji.
    • Ściemnia – ga:appInstallerId – identyfikator instalatora (np. Sklep Google Play), z której aplikacja została pobrana. Domyślnie identyfikator instalatora aplikacji jest ustawiany na podstawie metody PackageManager#getInstallerPackageName.
    • Przyciemniony – ga:appName – nazwa aplikacji.
    • Przyciemniony – ga:appVersion – wersja aplikacji.
    • Przyciemnij – 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.
    • Przyciemniony – ga:screenName – nazwa ekranu.
    • Wskaźnik – ga:avgScreenviewDuration: średni czas (w sekundach), jaki użytkownicy spędzili na ekranie.
    • Wskaźnik – ga:timeOnScreen – czas oglądania bieżącego ekranu.
    • Przesłano – ga:screenviews – łączna liczba wyświetleń ekranu. Użyj tej metody zamiast właściwości ga:appviews.
    • Przesłane – ga:uniqueScreenviews – liczba różnych (unikalnych) elementów ga:screenviews w sesji. Użyj tej metody zamiast właściwości ga:uniqueAppviews.
    • Licznik – ga:screenviewsPerSession – średnia liczba zdarzeń typu ga:screenviews na sesję. Użyj tej metody zamiast właściwości ga:appviewsPerVisit.

Wycofano

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

  • Meta – ga:appviews – zamiast niego użyj ga:screenviews.
  • Meta – ga:uniqueAppviews – zamiast niego użyj ga:uniqueScreenviews.
  • Meta – ga:appviewsPerVisit – zamiast niego 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 odnosi się do liczby/indeksu wymiaru niestandardowego.
    • Met (ga:metricXX) – nazwa żądanych danych niestandardowych, gdzie XX odnosi się do liczby/indeksu danych niestandardowych.

Zmiany w dokumentacji

Zmieniliśmy nazwę poniższych wymiarów i danych zmiennej niestandardowej. Jest to tylko zmiana w dokumentacji i nie wymaga wprowadzania zmian w zapytaniach.

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

działania związane z wyjątkami.

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

Konwersje celu

  • Dim – ga:goalCompletionLocation – ścieżka do strony lub nazwa ekranu pasujące do realizacji celu dowolnego typu miejsca docelowego.
  • Przyciemnij – ga:goalPreviousStep1 – ścieżka do strony lub nazwa ekranu pasujące do dowolnego celu związanego z typem miejsca docelowego, krok przed lokalizacją realizacji celu.
  • Przyciemnij – ga:goalPreviousStep2 – ścieżka do strony lub nazwa ekranu pasujące do dowolnego celu związanego z typem miejsca docelowego, 2 kroki przed lokalizacją realizacji celu.
  • Przyciemnij – ga:goalPreviousStep3 – ścieżka do strony lub nazwa ekranu pasujące do dowolnego celu związanego z typem miejsca docelowego, 3 kroki przed lokalizacją realizacji celu.

Zmiany w dokumentacji

Zmieniliśmy nazwę poniższego wymiaru i danych Konwersje celu. Jest to tylko zmiana w dokumentacji i nie wymaga wprowadzania zmian w zapytaniach.

  • 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
  • Met – ga:percentSearchRefinements: odsetek przypadków zawężenia wyszukiwania (tj. przejścia) między słowami kluczowymi w sieci wyszukiwania w ramach 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 są pobierane z ciągu znaków klienta użytkownika HTTP.

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

Interakcje społecznościowe

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

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

Godzina

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

Źródła wizyt

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

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

Śledzenie aplikacji

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

Źródła wizyt

  • Przyciemniony – ga:socialNetwork: ciąg znaków reprezentujący nazwę sieci społecznościowej. Może ona być powiązana 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.
  • Przyciemnij – ga:hasSocialSourceReferral – wskazuje odwiedziny w witrynie ze źródła społecznościowego (np. z sieci społecznościowej, np. Google+, Facebooka czy Twittera). Możliwe wartości to Yes (Tak) i No (Nie), gdzie pierwsza litera musi być pisana 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 ciąg znaków stanowi adres URL działania społecznościowego (np.adres URL posta w Google+, komentarz 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+).
    • Przyciemniony – ga:socialActivityTimestamp: w przypadku działania centrum danych społecznościowych ten ciąg znaków wskazuje, 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 stanowi adres URL zdjęcia powiązanego z profilem użytkownika w sieci społecznościowej.
    • Dim – ga:socialActivityUserProfileUrl: w przypadku działania w centrum danych społecznościowych ten ciąg stanowi 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 reprezentuje adres URL udostępniany przez powiązanego użytkownika sieci społecznościowej.
    • Dim – ga:socialActivityTagsSummary – w przypadku działania centrum danych społecznościowych jest to rozdzielany przecinkami zestaw tagów powiązanych z działaniem społecznościowym.
    • Dim – 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 użytkownika, który zainicjował działanie społecznościowe.
    • Przyciemnij – ga:socialActivityAction: w przypadku działania w centrum danych społecznościowych ten ciąg oznacza typ interakcji społecznościowej związanej z danym działaniem (np. zagłosowanie, komentarz, +1-kę).
    • Dim – ga:socialActivityNetworkAction: w przypadku działania centrum danych społecznościowych ten ciąg znaków reprezentuje typ interakcji społecznościowej i sieć społecznościową, z której ono pochodzi.
    • Met – ga:socialActivities: liczba działań, w przypadku których adres URL treści został udostępniony lub wspomniany w sieci partnerskiej centrum danych społecznościowych.

Interakcje społecznościowe

  • Te dane pochodzą ze śledzenia interakcji społecznościowych w witrynie.
    • Przyciemnij – ga:socialInteractionAction – w przypadku interakcji społecznościowych ciąg znaków 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).
    • Przyciemnij – ga:socialInteractionNetworkAction – w przypadku interakcji społecznościowych ciąg znaków reprezentujący konkatenację śledzonych elementów ga:socialInteractionNetwork i ga:socialInteractionAction (np.Google: +1, Facebook: polubienie).
    • Przyciemniony – ga:socialInteractionTarget: w przypadku interakcji społecznościowych ciąg znaków reprezentujący adres URL (lub zasób), w przypadku którego odbierane jest działanie sieci społecznościowej.
    • Zakończono – ga:socialInteractions – łączna liczba interakcji społecznościowych w Twojej witrynie.
    • Przesłane – ga:uniqueSocialInteractions – łączna liczba unikalnych interakcji społecznościowych w Twojej witrynie. Na podstawie pary wartości ga:socialInteractionNetwork i ga:socialInteractionAction
    • Zakończony – ga:socialInteractionsPerVisitga:socialInteractions / ga:uniqueSocialInteractions. Średnia liczba interakcji społecznościowych na wizytę w Twojej witrynie.

Dane geograficzne / sieć

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

Śledzenie strony

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

Śledzenie wyjątków

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

    • Zakończono – ga:exceptions – liczba wyjątków przesłanych do Google Analytics.
    • Met (ga:fatalExceptions) – liczba wyjątków, w których parametr isFatal ma wartość true (prawda).

Czas działań użytkownika

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

    • Dim – ga:userTimingCategory: ciąg znaków służący do podziału wszystkich zmiennych czasu użytkownika na kategorie w grupy logiczne, co ułatwia raportowanie.
    • Dim – 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ść wizualizacji czasu działań użytkownika w raportach.
    • Przyciemnienie – ga:userTimingValue liczba milisekund w czasie przesyłania danych do Google Analytics.
    • Met (ga:userTimingSample) – liczba wysłanych próbek.
    • Met – ga:avgUserTimingValue – średnia wartość czasu użytkownika. ga:userTimiingValue / ga:userTimiingSample.

Urządzenie / platforma

  • Te dane pochodzą od klienta użytkownika zebranych danych.
    • Dim – 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, klawisz nawigacyjny, rysik)
    • Dim - ga:mobileDeviceInfo – marka, model i nazwa marketingowa, które służą do identyfikacji urządzenia mobilnego.

Poprawki błędów

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

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

Ta wersja zawiera poprawki 2 błędów:

Poprawki błędów

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

  • Łą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 dotyczące szybkości witryny:
    • ga:speedMetricsSample
    • ga:domainLookupTime
    • ga:pageDownloadTime
    • ga:redirectionTime
    • ga:serverConnectionTime
    • ga:serverResponseTime
    • ga:avgDomainLookupTime
    • ga:avgPageDownloadTime
    • ga:avgRedirectionTime
    • ga:avgServerConnectionTime
    • ga:avgServerResponseTime

Definicje znajdziesz w dokumentacji wymiarów i danych.

Przypomnienie o wycofaniu wersji 2.3 interfejsu API

  • Wersja 2.3 interfejsu Data Export API jest wycofywana 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.

  • W ciągu 4 miesięcy żądania przesłania pliku danych w formacie XML starszego typu 2.3 zostaną przekazane do wersji 2.4 i zwrócą odpowiedź XML w wersji 2.4. Od tego momentu do żądań w wersji 2.3 będą obowiązywać wszystkie zasady dotyczące limitów w wersji 2.4.

  • Wszystkie żądania dotyczące plików JSON w wersji 2.3 lub biblioteki klienta Google Data JavaScript, która korzysta z danych wyjściowych JSON w wersji 2.3, będą zwracać kody stanu 404.

  • Aby uzyskać pełny limit, obie wersje wymagają zarejestrowania aplikacji w Konsoli interfejsów API Google i użycia klucza interfejsu API (lub tokena OAuth 2.0) w każdym żądaniu.

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

Ta wersja dotyczy wszystkich programistów korzystających z interfejsu Google Analytics API. Prezentuje 2 nowe wersje interfejsu API, wymaga zarejestrowania aplikacji, wprowadza nowe zasady dotyczące limitów i zmienia nazwę interfejsu API na interfejs API podstawowego raportowania. i 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. Nie jest zgodna wstecznie. Wszystkie przyszłe interfejsy API będą się opierać na tej wersji.

  • Nowe funkcje

  • Aktualizacje

    • Nowy adres URL, z którego można przesyłać prośby: https://www.googleapis.com/analytics/v3/data/ga….
    • Wymagane są tokeny rejestracji i programistów.
    • Wszystkie żądania danych konfiguracji należy wysyłać za pomocą interfejsu API zarządzania Google Analytics.

Wersja 2.4

  • Interfejs API podstawowego raportowania w wersji 2.4 to aktualizacja wersji podrzędnej, która jest w większości zgodna wstecznie z dotychczasowym interfejsem Data Export API w wersji 2.3.

  • Aktualizacje

    • Nowy adres URL, z którego można przesył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 Google Data JavaScript nie jest obsługiwana.
    • Brak pliku danych na koncie. Wszystkie żądania danych konfiguracji należy wysyłać za pomocą interfejsu API zarządzania Google Analytics.

Rejestracja

  • Wszystkie aplikacje utworzone za pomocą interfejsu Google Analytics API muszą być zarejestrowane jako projekt w Konsoli interfejsów API Google.

  • Każde żądanie wysyłane do interfejsu API musi zawierać klucz 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 Analytics API (Management API, jak i Data Export API)

    • 50 000 żądań na projekt dziennie
    • 10 zapytań na sekundę (QPS) na adres IP
  • W przypadku interfejsu Data Export API obowiązuje poniższy limit

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

Elementy wycofane

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

    • Żądania przesłane do pliku danych w formacie XML w wersji 2.3 zostaną przekazane do wersji 2.4 i będą zwracać odpowiedź w wersji 2.4. Od tego momentu do żądań w wersji 2.3 będą obowiązywać wszystkie zasady dotyczące limitów 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 wysyłać za pomocą interfejsu API zarządzania Google Analytics.

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

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

  • Złagodziliśmy niektóre ograniczenia dotyczące kombinacji w danych AdWords.

Kilka tygodni temu wprowadziliśmy zmianę, aby nie zezwalać na zapytania do interfejsu API, które wysyłały żądania ga:adGroup lub ga:adContent z parametrem ga:impressions, ponieważ ta kombinacja zwróciła wartość 0. Po tej zmianie ta kombinacja wróciła i została poprawiona, aby zwracać prawidłowe dane.

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

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

  • W zeszłym miesiącu ogłosiliśmy zmiany w interfejsie API, które zabraniają wyświetlania w pliku danych nieprawidłowych zapytań, które nie zwracają żadnych danych. Wprowadziliśmy już te zmiany w interfejsie API i te kombinacje są nieprawidłowe:

    • Wymiarów produktów nie można łączyć z danymi o transakcjach.
    • Zasad 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 wymagają tych kombinacji.

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

Wycofanie przedziału ufności

  • Przestań używać wartości przedziału ufności w przypadku danych, jeśli jeszcze nie zostało to zrobione. W tej wersji plik danych interfejsu API eksportu danych zwraca wartość 0, 0 w przypadku wszystkich wartości przedziału ufności. Za około miesiąc całkowicie usuniemy ten atrybut ze wszystkich elementów danych.

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

W tej wersji dodaliśmy 3 nowe dane i zmieniono wartość zwracaną 2.

Nowe aktualizacje danych

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

Aktualizacje wskaźników

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

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

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

Poprawa wydajności

  • Ta wersja skróci czas oczekiwania na plik danych o 30–35%.

Nowe aktualizacje danych

  • Zaktualizowaliśmy listę wymiarów i danych, które są dozwolone w zaawansowanych segmentach. Przejrzyj zaktualizowaną listę, aby sprawdzić, czy Twoje prośby są prawidłowe.

Nadchodzące zmiany

  • Obecnie wartość filtra waluty musisz podać jako mikrojednostki (np.jedna jednostka waluty jest określona jako 1 000 000). W najbliższej przyszłości konieczne będzie określenie rzeczywistej wartości przekazywanej z kodu śledzenia (np. 1 jednostka zostanie teraz określona jako 1).

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

Ta wersja dodaje więcej danych do pliku danych:

Nowe aktualizacje danych

  • Dodano ten wymiar Czas: ga:dayOfWeek

  • Dodaliśmy te dane dotyczące 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, dzięki czemu deweloperzy będą mogli naprawić ten wyjątek.

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

Nowe aktualizacje danych

  • Zmieniliśmy sposób obliczania wartości ga:visitors, aby podawać 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.

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

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

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

  • Grupowanie wymiarów i danych zostało zmienione, aby lepiej odzwierciedlały cechy, na które składają się te wymiary i dane.

Nowe obliczone dane

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

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

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

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

  • Na podstawie 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

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

Ta wersja zawiera poprawki 2 błędów:

Poprawki błędów

  • Wcześniej do wyrażenia filtra z wymiarem dodano operator LUB (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ł naprawiony 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 tak, aby NIE zawierały informacji o tym, czy błąd był spowodowany przez filtr wymiaru lub danych (chociaż nadal będzie zwracane nieprawidłowe wyrażenie filtra).

Ta wersja zawiera poprawki 3 błędów:

Poprawki błędów

  • Problem z kodowaniem w bibliotece klienta JavaScript został rozwiązany. Śledzenie problemów z Analytics

  • Naprawiono błąd, który uniemożliwiał wyświetlenie pliku danych konta po nieprawidłowej nazwie celu, ścieżce celu, wartości porównywania celów lub typie porównania celów.

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

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

Nowe funkcje

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

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

Poprawki błędów

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

W tej wersji wprowadziliśmy szereg nowych funkcji i naprawiliśmy błąd:

Nowe funkcje

  • Domyślny segment na iPhonie (gaid::-11) został ulepszony, aby umożliwić raportowanie na wszystkich urządzeniach mobilnych. Identyfikator jest taki sam jak wcześniej (-11), ale nazwa segmentu to: 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ą spójne z interfejsem internetowym 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 zasad dotyczących 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.
    • W danym momencie aplikacja może mieć 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 nazywa się teraz grupą D6. Custom Variable. W zaktualizowanym przewodniku znajdziesz informacje o tych nowych kombinacjach.

Poprawki błędów

  • Naprawiliśmy błąd w sposobie raportowania wartości confidenceInterval w interfejsie 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.

  • Parametry ga:itemQuantity i ga:uniquePurchases zostały wcześniej zamienione i zwrócone wzajemnie wartości. Są one już naprawione i zwracają prawidłowe dane.

Przypomnienie o wycofaniu wymiarów i danych

  • Zaprzestań używania wcześniej wycofanych wymiarów i danych

W tej wersji wprowadziliśmy szereg nowych funkcji:

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

  • Niektóre funkcje wymagają użycia najnowszych bibliotek klienta. Oficjalnie obsługujemy: Java i Javascript. Biblioteki zewnętrzne mogą nie zostać jeszcze zaktualizowane.

    • Wersję 2 można żą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 została dodana nowa przestrzeń nazw XML:
      xmlns:ga='http://schemas.google.com/ga/2009'
  • Interfejs API obsługuje teraz protokół danych Google w wersji 2.

Zaawansowana obsługa segmentacji

  • Parametr zapytania o segmenty dynamiczne:

    • ...&segment=dynamic::wyrażenie
    • umożliwia tworzenie zaawansowanych segmentów „na bieżąco”.
    • może to być dowolny wymiar lub dane. Jego składnia powinna być taka sama jak w przypadku filtrów.
  • Domyślny i niestandardowy parametr zapytania o segmenty:

    • ...&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 o segmentach za pomocą tych elementów i atrybutów XML:

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

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

Dostępne są nowe dane dotyczące celów

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

  • Dodaliśmy 48 nowych rodzajów danych do 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ły nowe dane o celach.

Nowe dane zmiennej niestandardowej

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

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

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

Wycofane wymiary i dane zostaną usunięte.

  • Przestań używać wycofanych wcześniej wymiarów i danych. Wkrótce zostaną usunięte i w razie potrzeby będą zwracać błędy z interfejsu API.

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

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

Ta wersja dodaje nowe funkcje i wycofuje niektóre stare funkcje:

  • Te wymiary i dane zostały wycofane. Za miesiąc trwale usuniemy je z interfejsu API. Pamiętaj o zaktualizowaniu kodu, aby aplikacje działały prawidłowo:

    • 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 następujących wymiarach:

    D6. Nawigacja * ga:previousPagePath * ga:nextPagePath

  • Nawigacja na stronie docelowej jest teraz dostępna 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 w interfejsie użytkownika w sekcji Użytkownicy -> Lojalność użytkowników) jest teraz wyświetlany za pomocą nowego wymiaru:

    • ga:visitLength

W tej wersji interfejs API eksportowania danych 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, np. ga:pagePath i ga:source są teraz prawidłową kombinacją. W zaktualizowanym przewodniku znajdziesz informacje na temat tych nowych kombinacji: http://code.google.com/apis/analytics/docs/gdata/gdataReferenceValidCombos.html.

  • Łączna liczba wierszy, o które można poprosić w jednym żądaniu, została zwiększona do 10 000. Domyślna liczba zwróconych 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).

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

  • Wszystkie wcześniejsze zmiany w wycofaniu zostały wprowadzone.

Ta wersja usuwa wycofane funkcje z prywatnej wersji beta:

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

  • Te dane zostaną usunięte i przestaną działać. Instrukcje obliczania tych wartości znajdziesz tutaj: 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:abandonedFunnels1
    • ga:abandonedFunnels2
    • ga:abandonedFunnels3
    • ga:abandonedFunnels4
    • ga:goalConversionRate
    • ga:goalConversionRate1
    • ga:goalConversionRate2
    • ga:goalConversionRate3
    • ga:goalConversionRate4
    • ga:goalValuePerVisit
  • Zmieniliśmy nazwy tych wymiarów i danych. Stare nazwy nie będą już działać. Sprawdź, czy używasz oficjalnej nazwy z naszej dokumentacji: http://code.google.com/apis/analytics/docs/gdata/gdataReferenceDimensionsMetrics.html

    wymiary

    Dane:goGA4ga