Metryki NowMetrix w Microsoft Excel

Excel pobiera wybrane dane bezpośrednio z REST API NowMetrix:

NowMetrix REST API → Power Query → Excel table → charts, formulas, or PivotTables

Przykład z tego przewodnika importuje 30 ostatnich dostępnych dziennych wierszy z punktu końcowego /v1/overview. Każdy wiersz zawiera datę, tracker, strefę czasową trackera, odsłony i wizyty. Odświeżenie zapytania zastępuje zaimportowaną tabelę najnowszą odpowiedzią API.

Potrzebne są:

• konto NowMetrix z dostępem do REST API,
• dostęp do trackera, który ma zostać wyeksportowany,
• Microsoft Excel z Power Query,
• uprawnienie do tworzenia i odświeżania zewnętrznych połączeń danych.

W systemie Windows Power Query jest dostępne w menu Dane → Pobierz dane. W aktualnych wersjach Microsoft 365 dla systemu macOS należy użyć opcji Dane → Pobierz dane (Power Query). Nazwy menu mogą się nieznacznie różnić zależnie od wersji i języka programu Excel.

Jeśli na komputerze Mac nie można znaleźć Edytora Power Query, należy najpierw zaktualizować Microsoft 365. Firma Microsoft opisuje bieżący sposób pracy na komputerach Mac w przewodniku po Power Query dla programu Excel na komputerach Mac.

1. Zalogować się do NowMetrix.
2. Otworzyć Ustawienia → API.
3. Utworzyć nowy klucz z czytelną etykietą, na przykład Microsoft Excel.
4. Natychmiast skopiować cały klucz. Jest wyświetlany tylko raz.
5. Zapisać identyfikator trackera dla witryny, która ma zostać wyeksportowana.

Excel dla systemu Windows

1. Utworzyć nowy skoroszyt lub otworzyć skoroszyt, w którym ma znaleźć się eksport.
2. Wybrać Dane → Pobierz dane → Z innych źródeł → Puste zapytanie.
3. W Edytorze Power Query wybrać Narzędzia główne → Edytor zaawansowany.

Excel dla systemu macOS

1. Utworzyć nowy skoroszyt lub otworzyć docelowy skoroszyt.
2. Wybrać Dane → Pobierz dane (Power Query) → Uruchom Edytor Power Query.
3. Utworzyć Puste zapytanie, a następnie otworzyć Narzędzia główne → Edytor zaawansowany.

1. Usunąć istniejącą zawartość Edytora zaawansowanego.
2. Wkleić całe zapytanie poniżej.
3. Zastąpić nm_YOUR_KEY i TRACKER_ID w dwóch pierwszych wierszach.
4. Pozostawić cudzysłowy wokół obu wartości.
5. Wybrać Gotowe.

let
    ApiKey = "nm_YOUR_KEY",
    TrackerId = "TRACKER_ID",

    Response = Json.Document(
        Web.Contents(
            "https://api.nowmetrix.com",
            [
                RelativePath = "v1/overview",
                Query = [
                    site = TrackerId,
                    days = "30"
                ],
                Headers = [
                    Authorization = "Bearer " & ApiKey,
                    Accept = "application/json"
                ],
                Timeout = #duration(0, 0, 0, 30)
            ]
        )
    ),

    DailyRows = if List.IsEmpty(Response[daily]) then
        #table(type table [date = text, pageviews = Int64.Type, visits = Int64.Type], {})
    else
        Table.FromRecords(Response[daily]),

    AddTracker = Table.AddColumn(
        DailyRows,
        "tracker",
        each Response[site],
        type text
    ),
    AddTimezone = Table.AddColumn(
        AddTracker,
        "timezone",
        each Response[timezone],
        type text
    ),
    ReorderedColumns = Table.ReorderColumns(
        AddTimezone,
        {"date", "tracker", "timezone", "pageviews", "visits"}
    ),
    TypedColumns = Table.TransformColumnTypes(
        ReorderedColumns,
        {
            {"date", type date},
            {"tracker", type text},
            {"timezone", type text},
            {"pageviews", Int64.Type},
            {"visits", Int64.Type}
        }
    )
in
    TypedColumns

Stały podstawowy adres URL oraz elementy RelativePath i Query sprawiają, że adres jest czytelny, a klucz API nie pojawia się w adresie URL. Klucz jest przesyłany wyłącznie w nagłówku HTTPS Authorization.

Excel może zapytać, jak połączyć się z adresem https://api.nowmetrix.com.

1. Wybrać Anonimowe.
2. Zastosować ustawienie do adresu https://api.nowmetrix.com.
3. Wybrać Połącz.
4. Jeśli pojawi się pytanie o poziom prywatności, wybrać poziom wymagany przez organizację. Prywatne zapewnia najsurowszą separację od innych źródeł danych.

1. Poczekać, aż podgląd Power Query wyświetli pięć kolumn.
2. Opcjonalnie zmienić nazwę zapytania na NowMetrix Daily.
3. Wybrać Narzędzia główne → Zamknij i załaduj.
4. Excel utworzy tabelę w arkuszu z zaimportowanymi wierszami.

Można teraz tworzyć formuły, wykresy, tabele przestawne lub dodatkowe arkusze odwołujące się do tej tabeli. Notatki i obliczenia wprowadzane ręcznie należy umieszczać poza zaimportowaną tabelą, ponieważ odświeżenie może zmienić rozmiar tabeli lub zastąpić jej wiersze.

Odświeżanie ręczne

Wybrać Dane → Odśwież wszystko. Excel ponownie uruchomi zapytanie i zastąpi zaimportowane wiersze.

Odświeżanie przy otwieraniu skoroszytu

1. Otworzyć Dane → Zapytania i połączenia.
2. Kliknąć prawym przyciskiem myszy NowMetrix Daily i wybrać Właściwości.
3. Włączyć opcję Odśwież dane przy otwieraniu pliku.

Odświeżanie w określonych odstępach

1. Otworzyć właściwości tego samego zapytania.
2. Włączyć opcję Odświeżaj co i wprowadzić odstęp, na przykład 60 minut.
3. Zapisać skoroszyt.

Unikać niepotrzebnie częstego odświeżania. Limit API NowMetrix jest wspólny dla danego trackera dla wszystkich kluczy API i użytkowników. Firma Microsoft opisuje ustawienia połączeń programu Excel w swoim przewodniku po odświeżaniu danych zewnętrznych.

REST API udostępnia kilka zestawów danych na potrzeby różnych raportów:

• Używać osobnego klucza NowMetrix oznaczonego nazwą tego skoroszytu.
• Przyznać użytkownikowi NowMetrix wyłącznie dostęp do trackera wymaganego na potrzeby eksportu.
• Nie przechowywać klucza API w komórce arkusza, formule, adresie URL, zrzucie ekranu ani komentarzu.
• Nie przesyłać skoroszytu do publicznie dostępnego miejsca pobierania.
• Udostępniać skoroszyt wyłącznie osobom uprawnionym do korzystania z klucza API.
• Zakładać, że każda osoba edytująca skoroszyt może sprawdzić zapytanie Power Query i odczytać jego klucz.
• Ograniczyć dostęp do OneDrive lub SharePoint, jeśli skoroszyt jest tam przechowywany.
• Natychmiast unieważnić osobny klucz, jeśli istnieje ryzyko naruszenia bezpieczeństwa skoroszytu lub konta.
• Po zmianie klucza zaktualizować pierwszy wiersz zapytania i odświeżyć skoroszyt.