Tworzenie eksportu list odbiorców

Listy odbiorców w Google Analytics pozwalają podzielić użytkowników w sposób odpowiadający wymaganiom Twojej firmy. Na odbiorców, można grupować użytkowników witryny lub aplikacji na podstawie .

Możesz eksportować listy odbiorców, w tym podsumowanie ich użytkowników, za pomocą Interfejs Data API.

Zapoznaj się z artykułem Oczekiwania dotyczące danych związanych z eksportem odbiorców. zawiera ważne informacje o danych, które widzisz w eksportach list odbiorców.

Omówienie

Aby utworzyć eksport list odbiorców i wysłać do niego zapytanie, wykonaj te żądania do interfejsu Data API:

  1. Zadzwoń pod numer audienceExports.create , aby utworzyć eksport list odbiorców.
  2. Zadzwoń pod numer audienceExports.query jest używana do pobierania użytkowników z listy odbiorców.

Więcej informacji można uzyskać, dzwoniąc pod numer audienceExports.get do Pobieranie metadanych konfiguracji dotyczących określonego eksportu odbiorców oraz audienceExports.list do wyświetlić listę wszystkich eksportów list odbiorców z danej usługi.

Wybierz podmiot zgłaszający

Wszystkie metody interfejsu API danych wymagają usługi w Google Analytics identyfikatora w ścieżce żądania adresu URL w parametrze format properties/GA_PROPERTY_ID. Oto przykład:

  POST  https://analyticsdata.googleapis.com/v1beta/properties/GA_PROPERTY_ID/audienceExports

Raport jest generowany na podstawie danych o zdarzeniach Google Analytics zebranych w w danej usłudze w Google Analytics.

Jeśli używasz jednej z bibliotek klienta interfejsu Data API, nie muszą zmieniać ścieżki adresu URL żądania. Większość klientów API udostępnia property który oczekuje ciągu znaków w postaci properties/GA_PROPERTY_ID. Zobacz Krótki przewodnik, w którym znajdziesz przykłady korzystania z bibliotek klienckich.

Tworzenie eksportu list odbiorców

Aby utworzyć eksport list odbiorców, wywołaj metodę audienceExports.create za pomocą funkcji AudienceExport do wybranego obiektu. Wymagane są te parametry:

  • Prawidłowa nazwa listy odbiorców w polu audience. w formacie properties/{propertyId}/audiences/{audienceId}. Dostępne opcje użyj audiences.list interfejsu Google Analytics Admin API w wersji 1. Audience.name pole odpowiedzi audiences.list zawiera nazwę listy odbiorców.
  • Prawidłowa lista wymiarów w atrybucie dimensions . Listę wymiarów obsługiwanych przez tę metodę znajdziesz w Dokumentacja schematu eksportu odbiorców. Tylko dane z wymiarów wymienionych w tym polu są uwzględniane na liście odbiorców eksportu.

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 komponent eksportu list odbiorców w polu name, 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

Wygenerowanie eksportu listy odbiorców po audienceExports.create .

Stan gotowości eksportu list odbiorców możesz sprawdzić, wywołując metodę audienceExports.get.

Użyj nazwy eksportu odbiorców z odpowiedzi audienceExports.create do określ eksport listy odbiorców w swoim żądaniu.

Oto przykładowe żądanie:

Żądanie HTTP
GET https://analyticsdata.googleapis.com/v1beta/properties/1234567/audienceExports/123

Stan gotowości do eksportu list 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 sprawdzić, 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 metodę eksport listy odbiorców (name) 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 z z całego świata.

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
}