Основы экспорта аудитории,Основы экспорта аудитории

Аудитории в Google Analytics 4 позволяют сегментировать пользователей по критериям, важным для вашего бизнеса. С помощью аудиторий вы можете группировать пользователей вашего сайта или приложения на основе общих атрибутов.

Используя API данных Google Analytics v1, вы можете создавать экспорты аудиторий, которые включают снимки пользователей в аудитории.

Создать экспорт аудитории

API данных Google Analytics версии 1 использует асинхронный подход для создания экспорта аудитории. Во-первых, запрос к методу audienceExports.create необходим для создания экспорта пользователей по аудитории. Затем метод audienceExports.query используется для получения пользователей в аудитории.

Кроме того, вы можете использовать audienceExports.get для получения метаданных конфигурации о конкретном экспорте аудитории и audienceExports.list для получения списка всех экспортированных аудиторий для ресурса.

Выберите отчитывающуюся организацию

Для всех методов API данных версии 1 требуется, чтобы идентификатор свойства Google Analytics 4 был указан внутри пути запроса URL-адреса в форме properties/GA4_PROPERTY_ID , например:

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

Отчет создается на основе данных о событиях Google Analytics, собранных в указанном ресурсе Google Analytics 4.

Если вы используете одну из клиентских библиотек Data API , нет необходимости вручную манипулировать URL-путем запроса. Большинство клиентов API предоставляют параметр property , который ожидает строку в виде properties/GA4_PROPERTY_ID . См. Краткое руководство для примеров использования клиентских библиотек.

Запросить создание экспорта аудитории

Чтобы создать экспорт аудитории, вызовите метод audienceExports.create , используя объект AudienceExport в запросе. Требуются следующие параметры:

  • Допустимое имя аудитории в поле audience в формате properties/{propertyId}/audiences/{audienceId} . Чтобы получить это значение, вы можете использовать метод audiences.list Google Analytics Admin API v1. Поле Audience.name ответа audiences.list содержит название аудитории.
  • Действительный список размеров в поле dimensions . Список параметров, поддерживаемых этим методом, можно найти в документации схемы экспорта аудитории . В экспорт аудитории включаются только данные по параметрам, упомянутым в этом поле.

Пример запроса на создание экспорта аудитории:

HTTP-запрос

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

Ответ метода audienceExports.create содержит имя экспорта аудитории в поле name (например properties/1234567/audienceExports/123 ), которое можно использовать в последующих запросах для извлечения пользователей из экспорта аудитории.

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"
  }
}

Запрос состояния готовности экспорта аудитории

Создание экспорта аудитории после вызова audienceExports.create может занять несколько минут. Вы можете получить состояние готовности к экспорту аудитории, вызвав метод audienceExports.get .

Используйте имя экспорта аудитории (например, properties/1234567/audienceExports/123 ), полученное из ответа audienceExports.create , чтобы указать экспорт аудитории.

Пример:

HTTP-запрос

GET https://analyticsdata.googleapis.com/v1beta/properties/1234567/audienceExports/123

Статус готовности к экспорту аудитории возвращается в поле state ответа. После завершения создания экспорта аудитории его состояние изменится с CREATING на ACTIVE .

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"
}

Вы можете получить состояние всех экспортированных аудиторий, вызвав метод audienceExports.list .

Получение пользователей при экспорте аудитории

После создания экспорта аудитории, созданного с помощью метода audienceExports.create , вызовите метод audienceExports.query и укажите имя экспорта аудитории (например properties/1234567/audienceExports/123 ).

HTTP-запрос

POST https://analyticsdata.googleapis.com/v1beta/properties/1234567/audienceExports/123:query

Если экспорт аудитории готов, возвращается ответ, содержащий список пользователей в аудитории:

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
}

Ожидания по экспорту данных аудитории

В следующем разделе задаются ожидаемые данные для членства пользователей в экспорте аудиторий.

Свежесть данных

Актуальность данных экспорта аудитории — это то, сколько времени требуется Google Analytics для сбора событий, их обработки и последующего обновления членства пользователей в аудиториях. Если весь этот процесс занимает 24 часа, то актуальность данных экспорта аудитории составляет 24 часа. Дополнительную информацию см. в разделе «Новизна данных» .

Например, если пользователь совершает свою первую покупку, а затем через 7 часов вы создаете экспорт аудитории для аудитории «Покупатели», пользователь почти наверняка еще не будет в экспорте аудитории «Покупатели». Через 14–38 часов после первой покупки этот пользователь, скорее всего, окажется в новом экспорте аудиторий.

Экспорт аудитории – это снимки.

Экспорт аудитории — это списки пользователей аудитории в моментальном снимке времени. Для ремаркетинга Google Рекламы Google Analytics автоматически и постоянно экспортирует пользователей из аудиторий в Google Рекламу. Напротив, при экспорте аудитории, созданном с использованием Data API v1, вам необходимо создать новый экспорт аудитории, чтобы увидеть последних пользователей в этой аудитории.

Экспорт аудитории создается на основе последних доступных членств пользователей. Однако актуальность данных экспорта аудитории может составлять, скажем, 20 часов, а это означает, что экспорт аудитории будет основан на всех событиях, произошедших за 20 часов до текущего момента.

Последние данные о членстве обновляются один раз в день, обычно в светлое время суток в часовом поясе объекта. Это означает, что экспорт аудитории для одной и той же аудитории в 9:00 и 11:00, скорее всего, вернет одни и те же данные, но экспорт аудитории, скажем, в 15:00 может отличаться в зависимости от включения данных за дополнительный день.

Срок действия экспорта аудитории

Срок действия экспорта аудитории истекает через 72 часа. Новые пользователи могут входить в аудиторию и выходить из нее каждый день. Чтобы получить последние снимки пользователей, вам необходимо создавать новые экспортированные данные для каждого дня.

Пользовательские ограничения экспорта аудитории

Когда размер аудитории или ресурса превышает ограничение пользователя, функция экспорта аудитории возвращает репрезентативные выборки аудитории. Эти ограничения зависят от типа вашего ресурса (например, стандартного ресурса или ресурса 360) и применяются при каждом экспорте аудитории индивидуально. Возвращенные пользователи — это пользователи запрошенной аудитории, а рассматриваемые пользователи — это пользователи, которые могут быть или не быть членами аудитории.

Тип лимита Стандартные ограничения свойств Ограничения ресурсов Аналитики 360
Максимальное количество вернувшихся пользователей 2 миллиона 200 миллионов
Макс считал пользователей 10 миллионов 1000000000

Отчетность о согласованности идентификационных данных

Идентификация отчетов определяет, как пользователи будут дедуплицироваться в отчетах. Экспорт аудитории НЕ меняется в зависимости от настроек удостоверения отчетности. При экспорте аудитории пользователи всегда идентифицируются по идентификатору пользователя, а затем по идентификатору устройства.

Это означает, что в отчетах по аудитории может быть показано больше пользователей, чем возвращается в отчетах экспорта аудитории. Например, если в качестве идентификатора создания отчетов выбрано «На основе устройства» и собирается идентификатор пользователя , то в отчетах не будет выполняться дедупликация пользователей на основе идентификатора пользователя, а при экспорте аудитории будет выполняться дедупликация на основе идентификатора пользователя.

Консистенция засыпки

Когда вы создаете аудиторию в Google Analytics и включаете ремаркетинг Google Ads, Google Analytics заполняет эту аудиторию в Google Ads недавно добавленными участниками. Однако отчеты Google Analytics и экспорт аудиторий НЕ содержат заполненные данные о членстве в аудиториях. Пользователю необходимо будет зарегистрировать событие после создания аудитории для отчетов и экспорта аудитории, чтобы отобразить пользователя в этой аудитории.

Например, если пользователь регистрирует событие покупки 20 июня, а вы создаете аудиторию «Покупатели» 21 июня, то вам, вероятно, придется подождать до 22 июня, чтобы потенциально увидеть этого пользователя в новом экспорте аудиторий. Однако этот пользователь будет отображаться в экспорте аудитории только в том случае, если он зарегистрировал какое-либо событие 21 июня.

,

Аудитории в Google Analytics 4 позволяют сегментировать пользователей по критериям, важным для вашего бизнеса. С помощью аудиторий вы можете группировать пользователей вашего сайта или приложения на основе общих атрибутов.

Используя API данных Google Analytics v1, вы можете создавать экспорты аудиторий, которые включают снимки пользователей в аудитории.

Создать экспорт аудитории

API данных Google Analytics версии 1 использует асинхронный подход для создания экспорта аудитории. Во-первых, запрос к методу audienceExports.create необходим для создания экспорта пользователей по аудитории. Затем метод audienceExports.query используется для получения пользователей в аудитории.

Кроме того, вы можете использовать audienceExports.get для получения метаданных конфигурации об определенном экспорте аудитории и audienceExports.list для получения списка всех экспортированных аудиторий для ресурса.

Выберите отчитывающуюся организацию

Для всех методов API данных версии 1 требуется, чтобы идентификатор свойства Google Analytics 4 был указан внутри пути запроса URL-адреса в форме properties/GA4_PROPERTY_ID , например:

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

Отчет создается на основе данных о событиях Google Analytics, собранных в указанном ресурсе Google Analytics 4.

Если вы используете одну из клиентских библиотек Data API , нет необходимости вручную манипулировать URL-путем запроса. Большинство клиентов API предоставляют параметр property , который ожидает строку в виде properties/GA4_PROPERTY_ID . См. Краткое руководство для примеров использования клиентских библиотек.

Запросить создание экспорта аудитории

Чтобы создать экспорт аудитории, вызовите метод audienceExports.create , используя объект AudienceExport в запросе. Требуются следующие параметры:

  • Допустимое имя аудитории в поле audience в формате properties/{propertyId}/audiences/{audienceId} . Чтобы получить это значение, вы можете использовать метод audiences.list Google Analytics Admin API v1. Поле Audience.name ответа audiences.list содержит название аудитории.
  • Действительный список размеров в поле dimensions . Список параметров, поддерживаемых этим методом, можно найти в документации схемы экспорта аудитории . В экспорт аудитории включаются только данные по параметрам, упомянутым в этом поле.

Пример запроса на создание экспорта аудитории:

HTTP-запрос

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

Ответ метода audienceExports.create содержит имя экспорта аудитории в поле name (например properties/1234567/audienceExports/123 ), которое можно использовать в последующих запросах для извлечения пользователей из экспорта аудитории.

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"
  }
}

Запрос состояния готовности экспорта аудитории

Создание экспорта аудитории после вызова audienceExports.create может занять несколько минут. Вы можете получить состояние готовности к экспорту аудитории, вызвав метод audienceExports.get .

Используйте имя экспорта аудитории (например, properties/1234567/audienceExports/123 ), полученное из ответа audienceExports.create , чтобы указать экспорт аудитории.

Пример:

HTTP-запрос

GET https://analyticsdata.googleapis.com/v1beta/properties/1234567/audienceExports/123

Статус готовности к экспорту аудитории возвращается в поле state ответа. После завершения создания экспорта аудитории его состояние изменится с CREATING на ACTIVE .

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"
}

Вы можете получить состояние всех экспортированных аудиторий, вызвав метод audienceExports.list .

Получение пользователей при экспорте аудитории

После создания экспорта аудитории, созданного с помощью метода audienceExports.create , вызовите метод audienceExports.query и укажите имя экспорта аудитории (например properties/1234567/audienceExports/123 ).

HTTP-запрос

POST https://analyticsdata.googleapis.com/v1beta/properties/1234567/audienceExports/123:query

Если экспорт аудитории готов, возвращается ответ, содержащий список пользователей в аудитории:

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
}

Ожидания по экспорту данных аудитории

В следующем разделе задаются ожидаемые данные для членства пользователей в экспорте аудиторий.

Свежесть данных

Актуальность данных экспорта аудитории — это то, сколько времени требуется Google Analytics для сбора событий, их обработки и последующего обновления членства пользователей в аудиториях. Если весь этот процесс занимает 24 часа, то актуальность данных экспорта аудитории составляет 24 часа. Дополнительную информацию см. в разделе «Новизна данных» .

Например, если пользователь совершает свою первую покупку, а затем через 7 часов вы создаете экспорт аудитории для аудитории «Покупатели», пользователь почти наверняка еще не будет в экспорте аудитории «Покупатели». Через 14–38 часов после первой покупки этот пользователь, скорее всего, окажется в новом экспорте аудиторий.

Экспорт аудитории – это снимки.

Экспорт аудитории — это списки пользователей аудитории в моментальном снимке времени. Для ремаркетинга Google Рекламы Google Analytics автоматически и постоянно экспортирует пользователей из аудиторий в Google Рекламу. Напротив, при экспорте аудитории, созданном с использованием Data API v1, вам необходимо создать новый экспорт аудитории, чтобы увидеть последних пользователей в этой аудитории.

Экспорт аудитории создается на основе последних доступных членств пользователей. Однако актуальность данных экспорта аудитории может составлять, скажем, 20 часов, а это означает, что экспорт аудитории будет основан на всех событиях, произошедших за 20 часов до текущего момента.

Последние данные о членстве обновляются один раз в день, обычно в светлое время суток в часовом поясе объекта. Это означает, что экспорт аудитории для одной и той же аудитории в 9:00 и 11:00, скорее всего, вернет одни и те же данные, но экспорт аудитории, скажем, в 15:00 может отличаться в зависимости от включения данных за дополнительный день.

Срок действия экспорта аудитории

Срок действия экспорта аудитории истекает через 72 часа. Новые пользователи могут входить и выходить из аудитории каждый день. Чтобы получить последние снимки пользователей, вам необходимо создавать новые экспортированные данные для каждого дня.

Пользовательские ограничения экспорта аудитории

Когда размер аудитории или ресурса превышает ограничение пользователя, функция экспорта аудитории возвращает репрезентативные выборки аудитории. Эти ограничения зависят от типа вашего ресурса (т. е. стандартного ресурса или ресурса 360) и применяются при каждом экспорте аудитории индивидуально. Возвращенные пользователи — это пользователи запрошенной аудитории, а рассматриваемые пользователи — это пользователи, которые могут быть или не быть членами аудитории.

Тип лимита Стандартные ограничения свойств Ограничения ресурсов Аналитики 360
Максимальное количество вернувшихся пользователей 2 миллиона 200 миллионов
Макс считал пользователей 10 миллионов 1000000000

Отчетность о согласованности идентификационных данных

Идентификация отчетов определяет, как пользователи будут дедуплицироваться в отчетах. Экспорт аудитории НЕ меняется в зависимости от настроек удостоверения отчетности. При экспорте аудитории пользователи всегда идентифицируются по идентификатору пользователя, а затем по идентификатору устройства.

Это означает, что в отчетах по аудитории может быть показано больше пользователей, чем возвращается в отчетах экспорта аудитории. Например, если в качестве идентификатора создания отчетов выбрано «На основе устройства» и собирается идентификатор пользователя , то в отчетах не будет выполняться дедупликация пользователей на основе идентификатора пользователя, а при экспорте аудитории будет выполняться дедупликация на основе идентификатора пользователя.

Консистенция засыпки

Когда вы создаете аудиторию в Google Analytics и включаете ремаркетинг Google Ads, Google Analytics заполняет эту аудиторию в Google Ads недавно добавленными участниками. Однако отчеты Google Analytics и экспорт аудиторий НЕ содержат заполненные данные о членстве в аудиториях. Пользователю необходимо будет зарегистрировать событие после создания аудитории для отчетов и экспорта аудитории, чтобы отобразить пользователя в этой аудитории.

Например, если пользователь регистрирует событие покупки 20 июня, а вы создаете аудиторию «Покупатели» 21 июня, то вам, вероятно, придется подождать до 22 июня, чтобы потенциально увидеть этого пользователя в новом экспорте аудиторий. Однако этот пользователь будет отображаться в экспорте аудитории только в том случае, если он зарегистрировал какое-либо событие 21 июня.