Listy odbiorców w Google Analytics 4 umożliwiają dzielenie użytkowników na segmenty według znaczenia dla Twojej firmy. Dzięki listom odbiorców możesz grupować użytkowników witryny lub aplikacji według wspólnych atrybutów.
Listy odbiorców, w tym podsumowanie ich użytkowników, możesz eksportować za pomocą interfejsu Data API.
Ważne informacje o danych, które widzisz w eksportach list odbiorców, znajdziesz w przewodniku Oczekiwania dotyczące eksportu danych o odbiorcach.
Przegląd
Aby utworzyć eksport list odbiorców i wysłać do niego zapytanie, wykonaj te żądania do interfejsu Data API:
- Wywołaj metodę
audienceExports.create
, aby utworzyć eksport list odbiorców. - Wywołaj metodę
audienceExports.query
, która służy do pobierania użytkowników z listy odbiorców.
Aby uzyskać więcej informacji, możesz wywołać metodę audienceExports.get
, aby pobrać metadane konfiguracji określonego eksportu odbiorców, i wywołać audienceExports.list
, aby wyświetlić wszystkie eksporty list odbiorców z konkretnej usługi.
Wybierz podmiot zgłaszający
Wszystkie metody interfejsu Data API wymagają określenia identyfikatora usługi w Google Analytics 4 w ścieżce żądania adresu URL w postaci properties/GA4_PROPERTY_ID
. Oto przykład:
POST https://analyticsdata.googleapis.com/v1beta/properties/GA4_PROPERTY_ID/audienceExports
Raport jest generowany na podstawie danych o zdarzeniach Google Analytics zebranych przez określoną usługę w Google Analytics 4.
Jeśli korzystasz z jednej z bibliotek klienta interfejsu Data API, nie musisz zmieniać ścieżki adresu URL żądania.
Większość klientów 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.
Tworzenie eksportu list odbiorców
Aby utworzyć eksport list odbiorców, wywołaj metodę audienceExports.create
za pomocą obiektu AudienceExport
w żądaniu. Wymagane są te parametry:
- W polu
audience
podana jest prawidłowa nazwa listy odbiorców w formacieproperties/{propertyId}/audiences/{audienceId}
. Aby uzyskać tę wartość, możesz użyć metodyaudiences.list
z interfejsu 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. Eksport listy odbiorców obejmuje tylko dane z wymiarów wymienionych w tym polu.
Oto przykładowe żądanie utworzenia eksportu list 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 odbiorców, np. properties/1234567/audienceExports/123
.
Oto przykładowa odpowiedź:
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"
}
}
Za pomocą name
możesz wysyłać zapytania do użytkowników z eksportu list odbiorców.
Wysyłanie zapytania o stan gotowości eksportu list odbiorców
Po wywołaniu audienceExports.create
wygenerowanie eksportu list odbiorców może potrwać kilka minut.
Stan gotowości eksportu list odbiorców możesz sprawdzić, wywołując metodę audienceExports.get
.
Aby określić w żądaniu eksport list odbiorców, użyj nazwy z odpowiedzi audienceExports.create
.
Oto przykładowe żądanie:
Żądanie HTTP
GET https://analyticsdata.googleapis.com/v1beta/properties/1234567/audienceExports/123
Stan gotowości do eksportu odbiorców jest zwracany w polu state
odpowiedzi. Po zakończeniu generowania eksportu list odbiorców jego stan zmienia się z CREATING
na ACTIVE
.
Oto przykładowa odpowiedź:
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 list odbiorców możesz uzyskać, wywołując metodę audienceExports.list
.
Pobieranie użytkowników z eksportu list odbiorców
Po wygenerowaniu eksportu list odbiorców wywołaj metodę audienceExports.query
i określ name
eksportu list odbiorców w żądaniu.
Oto przykładowe żądanie:
Żądanie HTTP
POST https://analyticsdata.googleapis.com/v1beta/properties/1234567/audienceExports/123:query
Jeśli eksport list odbiorców jest gotowy, wywołanie zwróci listę użytkowników na tej liście.
Oto przykładowa odpowiedź:
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
}