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

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

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

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

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

Включает Core Reporting API, Multi-Channel Funnels Reporting API и Real Time Reporting 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 (показ или клик), соответствующая конверсии 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 – соответствует AdWords API AdGroup.id .
  • Параметр – 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 отчетов о многоканальных последовательностях .