Журнал изменений API отчетности по многоканальным последовательностям Google Analytics

Мы периодически обновляем API отчетов по многоканальным последовательностям Google Analytics, чтобы предоставлять новые функции и устранять дефекты, обнаруженные в предыдущих версиях. В большинстве случаев эти изменения будут прозрачны для разработчиков API. Однако иногда нам необходимо внести изменения, которые требуют от разработчиков модификации существующих приложений.

На этой странице описаны все изменения, внесенные в API отчетов по многоканальным последовательностям Google Analytics, которые могут повлиять на ваше приложение. Мы рекомендуем разработчикам API периодически проверять этот список на наличие новых объявлений. Вы также можете подписаться на изменения через каналы, перечисленные в разделе «Подписка» ниже.

Подпишитесь на соответствующие журналы изменений

Включает все API сбора, настройки и отчетности.

Включает базовый API отчетов, API отчетов по многоканальным последовательностям и API отчетов в реальном времени.

В этом выпуске API добавлено новое измерение. Полный список определений см. в Справочнике по измерениям и метрикам .

ID транзакции

  • измерение — mcf:transactionId — идентификатор транзакции, предоставленный методом отслеживания электронной торговли для покупки в корзине.

В этом выпуске в API добавлены новые параметры и показатели. Полный список определений можно найти в Справочнике по измерениям и метрикам .

Пути конверсии

  • Параметр – mcf:dcmAd – название объявления DCM для события DCM (показа или клика), соответствующего конверсии Google Analytics.
  • измерение – mcf:dcmAdPath – путь к конверсии, где взаимодействия на пути представлены объявлениями DCM.
  • измерение – mcf:dcmAdType – название типа объявления DCM для события DCM (показа или клика), соответствующего конверсии Google Analytics.
  • параметр – mcf:dcmAdvertiser – название рекламодателя DCM для события DCM (показа или клика), соответствующего конверсии Google Analytics.
  • измерение – mcf:dcmAdvertiserPath – путь к конверсии, где взаимодействия на пути представлены рекламодателями DCM.
  • параметр – mcf:dcmCampaign – название кампании DCM для события DCM (показа или клика), соответствующего конверсии Google Analytics.
  • измерение – mcf:dcmCampaignPath – путь к конверсии, где взаимодействия на пути представлены кампаниями DCM.
  • измерение – mcf:dcmCreative – название объявления DCM для события DCM (показа или клика), соответствующего конверсии Google Analytics.
  • измерение – mcf:dcmCreativePath – путь к конверсии, где взаимодействия на пути представлены объявлениями DCM.
  • измерение – mcf:dcmCreativeVersion – версия объявления DCM для события DCM (показ или клик), соответствующая конверсии Google Analytics.
  • измерение – mcf:dcmCreativeVersionPath – путь к конверсии, где взаимодействия на пути представлены версиями объявлений DCM.
  • измерение — mcf:dcmNetwork — используемая сеть.
  • измерение – mcf:dcmPlacement – название места размещения на сайте DCM для события DCM (показа или клика), соответствующего конверсии Google Analytics.
  • измерение – mcf:dcmPlacementPath – путь к конверсии, где взаимодействия на пути представлены местами размещения DCM.
  • измерение – mcf:dcmSite – название сайта DCM, на котором было показано объявление DCM для события DCM (показа или клика), соответствующего конверсии Google Analytics.
  • измерение – mcf:dcmSitePath – путь к конверсии, где взаимодействия на пути представлены сайтами DCM.
  • метрика – mcf:firstImpressionConversions – количество конверсий, для которых показ кампании DCM был первым взаимодействием-конверсией за 30-дневный период ретроспективного анализа. Это измерение включает в себя как достижение целей, так и транзакции.
  • метрика – mcf:firstImpressionValue – ценность конверсий, для которых показ кампании DCM был первым взаимодействием-конверсией за 30-дневный период ретроспективного анализа. Это измерение включает в себя как достижение целей, так и транзакции.
  • метрика – mcf:impressionAssistedConversions – количество конверсий, в которых показ кампании DCM появлялся на пути конверсии, но не был конечным взаимодействием конверсии. Это измерение включает в себя как достижение целей, так и транзакции.
  • метрика – mcf:impressionAssistedValue – ценность конверсий, для которых показ кампании кампании DCM появлялся на пути конверсии, но не был конечным взаимодействием конверсии. Это измерение включает в себя как достижение целей, так и транзакции.

В этом выпуске в API добавлены новые параметры и показатели. Полный список определений можно найти в Справочнике по измерениям и метрикам .

Пути конверсии

  • Параметр – mcf:adwordsCustomerIDPath – последовательность идентификаторов клиентов AdWords вдоль путей конверсии.

Взаимодействия

  • Измерение — mcf:adwordsCustomerID — соответствует AdWords API Customer.id .

В этом выпуске в API добавлены новые параметры и показатели. Полный список определений можно найти в Справочнике по измерениям и метрикам .

Пути конверсии

  • Параметр – mcf:adwordsAdGroupIDPath – последовательность идентификаторов группы объявлений AdWords вдоль путей конверсии.
  • Параметр – mcf:adwordsCampaignIDPath – последовательность идентификаторов кампании AdWords вдоль путей конверсии.
  • Параметр – mcf:adwordsCreativeIDPath – последовательность идентификаторов объявлений AdWords вдоль путей конверсии.
  • Параметр – mcf:adwordsCriteriaIDPath – последовательность идентификаторов критериев AdWords вдоль путей конверсии.

Взаимодействия

  • Измерение – mcf:adwordsAdGroupID – соответствует AdGroup.id AdWords API.
  • Измерение – mcf:adwordsCampaignID – соответствует AdWords API Campaign.id .
  • Размер – mcf:adwordsCreativeID – соответствует Ad.id AdWords API.
  • Измерение – mcf:adwordsCriteriaID – соответствует AdWords API Criterion.id .

Новые функции контроля размера выборки и относительных дат

Относительные даты
  • В API отчетов MCF добавлена ​​поддержка относительных дат. today , yesterday и NdaysAgo теперь являются допустимыми значениями для параметров запроса start-date и end-date .
  • Использование этих значений автоматически определит диапазон дат на основе текущей даты на момент выполнения запроса и часового пояса представления (профиля), указанного в запросе. Дополнительные сведения см. в справочнике по API .
Уровень выборки
  • Был введен новый параметр samplingLevel , который позволяет вам установить уровень выборки (т. е. количество посещений, используемых для расчета результата) для запроса отчета. Допустимые значения: DEFAULT , FASTER и HIGHER_PRECISION .
  • В ответ API добавлено 2 новых поля: sampleSize и sampleSpace . Эти значения можно использовать для расчета процента посещений, использованных для выборочного ответа.
  • Дополнительную информацию см. в разделе «Справочник по API и выборке» .

Это первая версия API отчетности по многоканальным последовательностям:

  • Этот новый API позволяет запрашивать данные многоканальных последовательностей для аутентифицированного пользователя. Данные извлекаются из данных о пути конверсии, которые показывают взаимодействие пользователя с различными источниками трафика за несколько посещений до конверсии. Это позволяет вам проанализировать, как несколько маркетинговых каналов влияют на конверсии с течением времени. Более подробную информацию о том, какие данные доступны и как использовать API, см. в разделе API отчетности по многоканальным последовательностям .