Podstawy eksportu odbiorców

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 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 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.