Interfejs API do raportowania ścieżek wielokanałowych Google Analytics

Okresowo aktualizujemy interfejs API do śledzenia ścieżek wielokanałowych w Google Analytics, aby udostępniać nowe funkcje i naprawiać błędy wykryte w poprzednich wersjach. W większości przypadków zmiany te będą przejrzyste dla programistów interfejsu API. Czasami musimy jednak wprowadzić zmiany, które wymagają od programistów zmodyfikowania dotychczasowych aplikacji.

Ta strona dokumentuje wszelkie zmiany wprowadzone w Google Analytics API do monitorowania ścieżek wielokanałowych, które mogą mieć wpływ na Twoją aplikację. Zalecamy, aby deweloperzy interfejsu API okresowo sprawdzali tę listę pod kątem nowych powiadomień. Możesz też zasubskrybować zmiany za pomocą kanałów wymienionych w sekcji Subskrybuj poniżej.

Subskrybuj powiązane historię zmian

Wszystkie historie zmian interfejsu API Google Analytics
–
Subskrybuj rs

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

Wszystkie historię zmian interfejsu API raportowania
–
Subskrybuj rs

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

Historia zmian interfejsu MCF Reporting API
–
Subskrybuj rs

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

Identyfikator transakcji

  • wymiar – mcf:transactionId – identyfikator transakcji dostarczony przez metodę śledzenia e-commerce przy zakupie w koszyku na zakupy.

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

Ścieżki konwersji

  • wymiar – mcf:dcmAd – nazwa reklamy DCM zdarzenia (wyświetlenia lub kliknięcia) pasującego do konwersji Google Analytics.
  • wymiar – mcf:dcmAdPath – ścieżka konwersji, na której reklamy są wyświetlane przez reklamy DCM;
  • wymiar – mcf:dcmAdType – nazwa typu reklamy DCM zdarzenia (wyświetlenie lub kliknięcie) pasujące do konwersji Google Analytics.
  • wymiar – mcf:dcmAdvertiser – nazwa reklamodawcy w DCM zdarzenia (wyświetlenia lub kliknięcia) pasującego do konwersji Google Analytics.
  • wymiar – mcf:dcmAdvertiserPath – ścieżka konwersji, na której reklamodawcy reprezentują interakcje na ścieżce.
  • wymiar – mcf:dcmCampaign – nazwa kampanii DCM zdarzenia (wyświetlenia lub kliknięcia) pasującej do konwersji Google Analytics.
  • wymiar – mcf:dcmCampaignPath – ścieżka konwersji, na której kampanie odzwierciedlają interakcje na ścieżce
  • wymiar – mcf:dcmCreative – nazwa kreacji DCM zdarzenia (wyświetlenia lub kliknięcia) pasującego do konwersji Google Analytics.
  • wymiar – mcf:dcmCreativePath – ścieżka konwersji, na której kreacje na ścieżce są reprezentowane przez kreacje
  • wymiar – mcf:dcmCreativeVersion – wersja kreacji DCM zdarzenia (wyświetlenia lub kliknięcia), która pasuje do konwersji Google Analytics.
  • wymiar – mcf:dcmCreativeVersionPath – ścieżka do konwersji, w której interakcje na ścieżce są reprezentowane przez wersje kreacji DCM.
  • wymiar – mcf:dcmNetwork – używana sieć.
  • wymiar – mcf:dcmPlacement – nazwa miejsca docelowego w witrynie DCM zdarzenia (wyświetlenia lub kliknięcia) pasującego do konwersji Google Analytics.
  • wymiar – mcf:dcmPlacementPath – ścieżka konwersji, na której interakcje są reprezentowane przez miejsca docelowe DCM
  • wymiar – mcf:dcmSite – nazwa witryny z Campaign Managera, w której wyświetliła się kreacja z zdarzenia DCM (wyświetlenie lub kliknięcie) odpowiadająca konwersji Google Analytics.
  • wymiar – mcf:dcmSitePath – ścieżka konwersji, na której konwersje na ścieżce są reprezentowane przez witryny DCM
  • dane – mcf:firstImpressionConversions – liczba konwersji, w przypadku których wyświetlenie w kampanii DCM było pierwszą interakcją powodującą konwersję w okresie 30 dni. Ten wymiar obejmuje zarówno realizacje celów, jak i transakcje.
  • dane – mcf:firstImpressionValue – wartość konwersji, w przypadku których wyświetlenie w ramach kampanii DCM było pierwszą interakcją powodującą konwersję w okresie 30 dni. Ten wymiar obejmuje zarówno realizacje celów, jak i transakcje.
  • dane – mcf:impressionAssistedConversions – liczba konwersji, w przypadku których wyświetlenie kampanii DCM wystąpiło na ścieżce konwersji, ale nie wskazuje ostatecznej interakcji prowadzącej do konwersji. Ten wymiar obejmuje zarówno realizacje celów, jak i transakcje.
  • dane – mcf:impressionAssistedValue – wartość konwersji, w przypadku których wyświetlenie kampanii w kampanii DCM wystąpiło na ścieżce konwersji, ale nie wskazuje ostatecznej interakcji prowadzącej do konwersji. Ten wymiar obejmuje zarówno realizacje celów, jak i transakcje.

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

Ścieżki konwersji

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

Interakcje

  • Wymiar – mcf:adwordsCustomerID – odpowiada interfejsowi API AdWords Customer.id.

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

Ścieżki konwersji

  • Wymiar – mcf:adwordsAdGroupIDPath – sekwencja identyfikatora grupy reklam AdWords wzdłuż ścieżek konwersji.
  • Wymiar – mcf:adwordsCampaignIDPath – sekwencja identyfikatora kampanii AdWords wzdłuż ścieżek konwersji.
  • Wymiar – mcf:adwordsCreativeIDPath – sekwencja identyfikatora kreacji AdWords wzdłuż ścieżek konwersji.
  • Wymiar – mcf:adwordsCriteriaIDPath – sekwencja identyfikatorów kryteriów AdWords wzdłuż ścieżek konwersji.

Interakcje

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

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

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

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

  • Nowy interfejs API umożliwia żądanie danych ścieżek wielokanałowych uwierzytelnionych użytkowników. Dane pochodzą z danych ścieżki konwersji, które wskazują interakcje użytkowników z różnymi źródłami wizyt w ciągu wielu wizyt przed konwersją. Dzięki temu możesz analizować wpływ wielu kanałów marketingowych na konwersje na przestrzeni czasu. Więcej informacji o dostępnych danych i sposobie korzystania z interfejsu API znajdziesz w artykule Interfejs API do raportowania ścieżek wielokanałowych.