Listy odbiorców w Google Analytics 4 umożliwiają podział użytkowników na segmenty odpowiadające wymaganiom Twojej firmy. Dzięki listom odbiorców możesz grupować użytkowników witryny lub aplikacji według wspólnych atrybutów.
Korzystając z interfejsu Google Analytics Data API w wersji 1, możesz generować eksporty list odbiorców, które zawierają migawkę użytkowników z tej listy.
Tworzenie eksportu listy odbiorców
Interfejs Google Analytics Data API w wersji 1 do tworzenia eksportów list odbiorców korzysta z metody asynchronicznej. Najpierw żądanie wysłane do metody audienceExports.create
jest niezbędne do utworzenia eksportu list odbiorców obejmującego użytkowników. Następnie za pomocą metody audienceExports.query
pobiera się użytkowników z tej listy.
Możesz też użyć metody audienceExports.get
, aby pobrać metadane konfiguracji określonego eksportu odbiorców, lub audienceExports.list
, aby wyświetlić listę wszystkich eksportów listy odbiorców z danej usługi.
Wybierz podmiot zgłaszający
Wszystkie metody interfejsu Data API w wersji 1 wymagają określenia identyfikatora usługi Google Analytics 4 w ścieżce żądania adresu URL w postaci properties/GA4_PROPERTY_ID
, np.:
POST https://analyticsdata.googleapis.com/v1beta/properties/GA4_PROPERTY_ID/audienceExports
Raport jest generowany na podstawie danych o zdarzeniach w Google Analytics zebranych w określonej usłudze w Google Analytics 4.
Jeśli używasz jednej z bibliotek klienta interfejsu Data API, nie musisz ręcznie modyfikować ścieżki adresu URL żądania.
Większość klientów korzystających z interfejsu API udostępnia parametr property
, który oczekuje ciągu znaków w postaci properties/GA4_PROPERTY_ID
.
Przykłady korzystania z bibliotek klienta znajdziesz w krótkim przewodniku.
Poproś o utworzenie eksportu listy odbiorców
Aby utworzyć eksport odbiorców, wywołaj metodę audienceExports.create
za pomocą obiektu AudienceExport
w żądaniu. Wymagane są te parametry:
- Prawidłowa nazwa listy odbiorców w polu
audience
w formacieproperties/{propertyId}/audiences/{audienceId}
. Aby uzyskać tę wartość, możesz użyć metodyaudiences.list
w interfejsie Google Analytics Admin API w wersji 1. PoleAudience.name
odpowiedziaudiences.list
zawiera nazwę listy odbiorców. - Prawidłowa lista wymiarów w polu
dimensions
. Listę wymiarów obsługiwanych przez tę metodę znajdziesz w dokumentacji schematu eksportu odbiorców. W eksporcie listy odbiorców uwzględniane są tylko dane dotyczące wymiarów wymienionych w tym polu.
Przykład prośby o utworzenie eksportu listy odbiorców:
Żądanie HTTP
POST https://analyticsdata.googleapis.com/v1beta/properties/1234567/audienceExports
{
"audience": "properties/1234567/audiences/12345",
"dimensions": [
{
"dimensionName": "deviceId"
}
]
}
Odpowiedź metody audienceExports.create
zawiera w polu name
nazwę eksportu listy odbiorców (np. properties/1234567/audienceExports/123
), której można używać w kolejnych zapytaniach do pobrania kont użytkowników z eksportu listy odbiorców.
Odpowiedź HTTP
{
"response": {
"@type": "type.googleapis.com/google.analytics.data.v1alpha.AudienceExport",
"name": "properties/1234567/audienceExports/123",
"audience": "properties/1234567/audiences/12345",
"audienceDisplayName": "Purchasers",
"dimensions": [
{
"dimensionName": "deviceId"
}
],
"state": "CREATING",
"beginCreatingTime": "2023-06-22T23:35:28.787910949Z"
}
}
Zapytanie o stan gotowości do eksportu list odbiorców
Wygenerowanie eksportu listy odbiorców po wywołaniu metody audienceExports.create
może potrwać kilka minut. Stan gotowości do eksportowania list odbiorców możesz uzyskać, wywołując metodę audienceExports.get
.
Aby określić eksport odbiorców, użyj nazwy eksportu odbiorców (np. properties/1234567/audienceExports/123
) uzyskanej z odpowiedzi audienceExports.create
.
Przykład:
Żądanie HTTP
GET https://analyticsdata.googleapis.com/v1beta/properties/1234567/audienceExports/123
Stan gotowości do wyeksportowania listy odbiorców jest podawany w polu state
odpowiedzi. Po zakończeniu generowania eksportu listy odbiorców jego stan zmieni się z CREATING
na ACTIVE
.
Odpowiedź HTTP
{
"name": "properties/1234567/audienceExports/123",
"audience": "properties/1234567/audiences/12345",
"audienceDisplayName": "Purchasers",
"dimensions": [
{
"dimensionName": "deviceId"
}
],
"state": "CREATING",
"beginCreatingTime": "2023-06-22T23:35:28.787910949Z"
}
Stan wszystkich eksportów listy odbiorców możesz uzyskać, wywołując metodę audienceExports.list
.
Pobieranie użytkowników w ramach eksportu list odbiorców
Po wygenerowaniu eksportu listy odbiorców utworzonego za pomocą metody audienceExports.create
wywołaj metodę audienceExports.query
i podaj nazwę eksportu odbiorców (np. properties/1234567/audienceExports/123
).
Żądanie HTTP
POST https://analyticsdata.googleapis.com/v1beta/properties/1234567/audienceExports/123:query
Gdy eksport listy odbiorców jest gotowy, zwracana jest odpowiedź zawierająca listę użytkowników z danej listy:
Odpowiedź HTTP
{
"audienceExport": {
"name": "properties/1234567/audienceExports/123",
"audience": "properties/1234567/audiences/12345",
"audienceDisplayName": "Purchasers",
"dimensions": [
{
"dimensionName": "deviceId"
}
],
"state": "ACTIVE",
"beginCreatingTime": "2023-06-22T23:35:28.787910949Z"
},
"audienceRows": [
{
"dimensionValues": [
{
"value": "1000276123.1681742376"
}
]
},
{
"dimensionValues": [
{
"value": "1000374452.1668627377"
}
]
},
{
"dimensionValues": [
{
"value": "1000391956.1652750758"
}
]
},
{
"dimensionValues": [
{
"value": "1000410539.1682018694"
}
]
},
{
"dimensionValues": [
{
"value": "1000703969.1666725875"
}
]
}
],
"rowCount": 5
}
Oczekiwania dotyczące eksportu danych o odbiorcach
W tej sekcji znajdziesz oczekiwania dotyczące danych dotyczących członkostwa użytkowników w eksportach list odbiorców.
Częstotliwość aktualizacji danych
Częstotliwość aktualizacji danych eksportowanych list odbiorców wskazuje, ile czasu Google Analytics potrzebuje na zebranie zdarzeń, przetworzenie zdarzeń i aktualizowanie członkostwa użytkowników w listach odbiorców. Jeśli cały ten proces trwa 24 godziny, częstotliwość aktualizacji danych eksportu odbiorców wynosi 24 godziny. Więcej informacji znajdziesz w sekcji Częstotliwość aktualizacji danych.
Jeśli np. użytkownik dokona pierwszego zakupu, a następnie 7 godzin później utworzysz eksport listy odbiorców dla listy odbiorców „Kupujący”, prawie na pewno nie będzie go jeszcze w eksporcie listy odbiorców „Kupujący”. W ciągu 14–38 godzin od pierwszego zakupu ten użytkownik prawdopodobnie znajdzie się w nowych eksportach list odbiorców.
Eksporty list odbiorców to migawki
Eksporty list odbiorców to listy użytkowników na liście odbiorców w ujęciu czasowym. W przypadku remarketingu w Google Ads Google Analytics automatycznie i na bieżąco eksportuje użytkowników z listy odbiorców do Google Ads. Jeśli natomiast eksporty listy odbiorców zostały utworzone za pomocą interfejsu Data API w wersji 1, musisz utworzyć nowy eksport, aby zobaczyć najnowszych użytkowników z tej listy.
Eksporty odbiorców są tworzone na podstawie najnowszych dostępnych informacji o członkostwie użytkowników. Dane w eksportach list odbiorców mogą być odświeżane np. z 20 godzin, co oznacza, że eksport listy odbiorców będzie oparty na wszystkich zdarzeniach, które nastąpiły 20 godzin przed bieżącą chwilą.
Najnowsze dane o członkostwie są aktualizowane raz dziennie, zazwyczaj w godzinach dziennych w strefie czasowej usługi. Oznacza to, że eksport listy odbiorców dla tych samych odbiorców o 9:00 i 11:00 prawdopodobnie zwróci te same dane, ale eksport listy odbiorców o 15:00 może się różnić ze względu na uwzględnienie danych z dodatkowego dnia.
Wygaśnięcie eksportów odbiorców
Dane wyeksportowane po 72 godzinach są usuwane. Nowi użytkownicy mogą codziennie trafiać na listę odbiorców i z niej wyjść. Aby uzyskać najnowsze podsumowanie danych o użytkownikach, musisz codziennie tworzyć nowe eksporty list odbiorców.
Limity użytkowników dotyczące eksportowania list odbiorców
Gdy rozmiar listy odbiorców lub usługi przekracza limit liczby użytkowników, eksporty list odbiorców zwracają reprezentatywne próbki listy odbiorców. Zależą one od typu usługi (np. usługi standardowej lub usługi w Analytics 360) i są egzekwowane w przypadku każdego eksportu list odbiorców oddzielnie. Powracający użytkownicy to użytkownicy na żądanej liście odbiorców, a uznani użytkownicy to użytkownicy, którzy mogą, ale nie muszą, być na niej.
Typ limitu | Limity usług standardowych | Limity usług w Analytics 360 |
---|---|---|
Maksymalna liczba powracających użytkowników | 2 miliony | 200 mln |
Maksymalna liczba uwzględnionych użytkowników | 10 milionów | 1 miliard |
Spójność tożsamości na potrzeby raportowania
Tożsamość na potrzeby raportowania określa sposób usuwania duplikatów użytkowników w raportach. Eksporty list odbiorców NIE zmieniają się zależnie od ustawienia tożsamości na potrzeby raportowania. Eksportowanie list odbiorców zawsze identyfikuje użytkowników według identyfikatora User-ID, a następnie identyfikatora urządzenia.
Oznacza to, że raporty o danej liście odbiorców mogą pokazywać więcej użytkowników niż zwracane dane z eksportu odbiorców. Jeśli na przykład tożsamość raportowania jest oznaczona jako „oparta na urządzeniu” i zbierana jest identyfikator użytkownika, raporty nie będą usuwać duplikatów użytkowników na podstawie identyfikatora użytkownika, ale w eksportach list odbiorców duplikaty na podstawie identyfikatora użytkownika nie będą usuwane.
Spójność uzupełnień
Gdy utworzysz w Google Analytics listę odbiorców i włączysz w Google Ads remarketing, Google Analytics będzie uzupełniać tę listę w Google Ads nowo dodanymi użytkownikami. Raporty Google Analytics i eksporty danych o odbiorcach NIE zawierają jednak tych użytkowników dodanych do list w Google Ads. Po utworzeniu listy odbiorców użytkownik musi wywołać jakieś zdarzenie, aby pojawić się w raportach i w eksportach list odbiorców.
Jeśli np. użytkownik wywoła 20 czerwca zdarzenie purchase, a 21 czerwca utworzysz listę odbiorców „Kupujący”, musisz pewnie poczekać do 22 czerwca na ewentualne pojawienie się tego użytkownika w nowych eksportach listy odbiorców. Pojawi się on jednak w eksporcie listy odbiorców tylko wtedy, gdy 21 czerwca zarejestrował jakieś zdarzenie.