Ta strona została przetłumaczona przez Cloud Translation API.

Podstawowe informacje na temat list odbiorców

Listy odbiorców w Google Analytics 4 umożliwiają dzielenie użytkowników na segmenty w sposób odpowiadający potrzebom Twojej firmy. Dzięki listom odbiorców możesz grupować użytkowników witryny lub aplikacji na podstawie wspólnych atrybutów.

Za pomocą interfejsu Google Analytics Data API w wersji 1 możesz generować listy odbiorców zawierające podsumowanie informacji o użytkownikach na danej liście.

Tworzenie listy odbiorców

Interfejs Google Analytics Data API w wersji 1 umożliwia asynchroniczne tworzenie list odbiorców. Po pierwsze, do utworzenia listy odbiorców użytkowników konieczne jest przesłanie żądania do metody audienceLists.create. Następnie metoda audienceLists.query jest używana do pobierania użytkowników z tej listy.

Możesz też użyć metody audienceLists.get, aby pobrać metadane konfiguracji określonej listy odbiorców, lub audienceLists.list, aby wyświetlić wszystkie listy odbiorców 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/v1alpha/properties/GA4_PROPERTY_ID/audienceLists

Raport jest generowany na podstawie danych o zdarzeniach 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 interfejsu API udostępnia parametr property, który wymaga ciągu znaków w postaci properties/GA4_PROPERTY_ID. Przykłady użycia bibliotek klienta znajdziesz w krótkim przewodniku.

Poproś o utworzenie listy odbiorców

Aby utworzyć listę odbiorców, wywołaj metodę audienceLists.create w żądaniu za pomocą obiektu AudienceList. Wymagane są te parametry:

Prawidłowa nazwa listy odbiorców w polu audience w formacie properties/{propertyId}/audiences/{audienceId}. Aby uzyskać tę wartość, możesz użyć metody audiences.list w interfejsie Google Analytics Admin API w wersji 1. Pole Audience.name odpowiedzi audiences.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 listy odbiorców. Na liście odbiorców znajdują się tylko dane dotyczące wymiarów wymienionych w tym polu.

Przykładowe żądanie utworzenia listy odbiorców:

Żądanie HTTP

POST https://analyticsdata.googleapis.com/v1alpha/properties/1234567/audienceLists
{
  "audience": "properties/1234567/audiences/12345",
  "dimensions": [
    {
      "dimensionName": "deviceId"
    }
  ]
}

Odpowiedź metody audienceLists.create zawiera w polu name nazwę listy odbiorców (np. properties/1234567/audienceLists/123), której można używać w kolejnych zapytaniach do pobierania użytkowników z tej listy.

Odpowiedź HTTP

{
  "response": {
    "@type": "type.googleapis.com/google.analytics.data.v1alpha.AudienceList",
    "name": "properties/1234567/audienceLists/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 listy odbiorców

Po wywołaniu audienceLists.create wygenerowanie listy odbiorców może potrwać kilka minut. Stan gotowości listy odbiorców możesz uzyskać, wywołując metodę audienceLists.get.

Aby określić listę odbiorców, użyj nazwy listy odbiorców (np. properties/1234567/audienceLists/123) uzyskanej w odpowiedzi na żądanie audienceLists.create.

Przykład:

Żądanie HTTP

GET https://analyticsdata.googleapis.com/v1alpha/properties/1234567/audienceLists/123

Stan gotowości listy odbiorców jest zwracany w polu state odpowiedzi. Po zakończeniu generowania listy odbiorców jej stan zmieni się z CREATING na ACTIVE.

Odpowiedź HTTP

{
  "name": "properties/1234567/audienceLists/123",
  "audience": "properties/1234567/audiences/12345",
  "audienceDisplayName": "Purchasers",
  "dimensions": [
    {
      "dimensionName": "deviceId"
    }
  ],
  "state": "CREATING",
  "beginCreatingTime": "2023-06-22T23:35:28.787910949Z"
}

Stan wszystkich list odbiorców możesz uzyskać, wywołując metodę audienceLists.list.

Pobieranie użytkowników z listy odbiorców

Po wygenerowaniu listy odbiorców utworzonej za pomocą metody audienceLists.create wywołaj metodę audienceLists.query i podaj jej nazwę (np. properties/1234567/audienceLists/123).

Żądanie HTTP

POST https://analyticsdata.googleapis.com/v1alpha/properties/1234567/audienceLists/123:query

Jeśli lista odbiorców jest gotowa, zwracana jest odpowiedź zawierająca listę użytkowników znajdujących się na danej liście:

Odpowiedź HTTP

{
  "audienceList": {
    "name": "properties/1234567/audienceLists/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 danych dotyczących list odbiorców

Poniższa sekcja przedstawia oczekiwania dotyczące danych dotyczących członkostwa użytkowników na listach odbiorców.

Aktualność danych

Częstotliwość aktualizacji danych listy odbiorców określa, 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 proces trwa 24 godziny, częstotliwość aktualizacji danych listy odbiorców to 24 godziny. Więcej informacji znajdziesz w sekcji Częstotliwość aktualizacji danych.

Załóżmy, że użytkownik dokonuje pierwszego zakupu, a 7 godzin później tworzysz listę odbiorców dla odbiorców „Kupujący”. Ten użytkownik prawie na pewno nie będzie jeszcze na liście odbiorców „Kupujący”. W ciągu 14–38 godzin od pierwszego zakupu ten użytkownik prawdopodobnie znajdzie się na nowych listach odbiorców.

Listy odbiorców to migawki

Listy odbiorców to m.in. wykaz użytkowników znajdujących się na danej liście odbiorców w określonym czasie. W przypadku remarketingu w Google Ads Google Analytics automatycznie i na bieżąco eksportuje użytkowników do tej usługi. Jeśli natomiast listy odbiorców są tworzone za pomocą interfejsu Data API w wersji 1, musisz utworzyć nową listę odbiorców, aby zobaczyć najnowszych użytkowników z tej listy.

Listy odbiorców są tworzone na podstawie najnowszych dostępnych członków użytkowników. Dane Listy odbiorców mogą być jednak aktualizowane np. przez 20 godzin, co oznacza, że lista odbiorców będzie utworzona na podstawie wszystkich zdarzeń z 20 godzin poprzedzających bieżącą chwilę.

Najnowsze dane o członkostwie są aktualizowane raz dziennie, zwykle w godzinach dziennych w strefie czasowej usługi. Oznacza to, że lista odbiorców przeznaczona dla tych samych odbiorców z 9:00 i 11:00 zwróci te same dane, ale lista odbiorców o 15:00 może się różnić, jeśli uwzględnisz dane z dodatkowego dnia.

Wygaśnięcie list odbiorców

Listy odbiorców tracą ważność po 72 godzinach. Nowi użytkownicy mogą codziennie dotrzeć do odbiorców i z nich wyjść. Aby uzyskać najnowsze podsumowanie użytkowników, musisz na każdy dzień utworzyć nowe listy odbiorców.

Limity użytkowników na liście odbiorców

Gdy rozmiar listy odbiorców lub usługi przekracza limit użytkowników, Listy odbiorców zawierają reprezentatywne próbki odbiorców. Te limity zależą od typu usługi (np. usługi standardowej lub usługi w Analytics 360) i są wymuszane na każdej liście odbiorców z osobna. Powracający użytkownicy to użytkownicy z żądanej listy odbiorców, a użytkownicy to użytkownicy, którzy mogą, ale nie muszą, być członkami tej listy.

Typ limitu	Limity dotyczące usług standardowych	Limity usług w Analytics 360
Maksymalna liczba zwróconych użytkowników	2 miliony	200 milionów
Maksymalna liczba rozważanych 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. Listy odbiorców NIE zmieniają się zależnie od ustawienia tożsamości na potrzeby raportowania. Listy odbiorców zawsze identyfikują użytkowników według identyfikatora użytkownika, a następnie identyfikatora urządzenia.

Oznacza to, że raporty o danej liście odbiorców mogą zawierać więcej użytkowników niż powracających listów odbiorców. Jeśli na przykład tożsamość na potrzeby raportowania jest określana na podstawie urządzenia i rejestrowany jest identyfikator użytkownika, raporty nie usuwają duplikatów użytkowników na podstawie identyfikatora użytkownika, ale listy odbiorców na podstawie identyfikatora użytkownika usuwają duplikaty.

Może się też zdarzyć, że w raportach o danej liście odbiorców będzie podane mniej użytkowników niż zwracana lista odbiorców. Jeśli na przykład tożsamość na potrzeby raportowania ma wartość „Mieszana”, raporty będą usuwać duplikaty użytkowników na podstawie Google Signals, ale listy odbiorców nie.

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 i Listy odbiorców w Google Analytics NIE zawierają jednak tych użytkowników dodanych do list w Google Analytics. Po utworzeniu listy odbiorców użytkownik musi zarejestrować jakieś zdarzenie, aby uzyskać dostęp do raportów i list odbiorców.

Jeśli np. użytkownik wywoła zdarzenie zakupu 20 czerwca, a 21 czerwca utworzysz listę odbiorców „Kupujący”, prawdopodobnie musisz poczekać do 22 czerwca, aby móc go zobaczyć na nowych listach odbiorców. Będzie on jednak widoczny na liście odbiorców tylko wtedy, gdy wywołał jakieś zdarzenie w dniu 21 czerwca.