В BI Конструкторе расходы по рекламе собираются на уровне отдельных объявлений. Сбор данных происходит в четыре шага через API VK. BI Конструктор получает:

1. Ежедневную статистику расходов по каждому рекламному баннеру.
2. Данные о рекламной группе, к которой относится баннер.
3. Информацию о рекламной кампании, связанной с рекламной группой.
4. Данные о рекламном пакете, в который входит группа.

Метки utm_medium, utm_source, utm_campaign и utm_content собираются по иерархии: сначала у баннера, затем у группы, кампании и пакета. Приоритет — у ближайшего элемента. Например, если у баннера указано utm_medium=a, а у группы — utm_medium=b, будет использовано значение баннера.

Метки извлекаются из источников:

• Баннер (объявление) — из URL, если есть параметры utm.
• Группа — из поля utm.
• Пакет рекламы — из полей utm и banner_url_get_params.

Если в значении метки используется шаблон вида {{имя_переменной}}, BI Конструктор проверяет его. Поддерживаются следующие подстановки: {{campaign_id}}, {{campaign_name}}, {{banner_id}}. Эти переменные заменяются на реальные значения. Остальные шаблоны передаются в итоговый набор данных без изменений.

В BI Конструкторе данные по Яндекс.Директ собираются на уровне отдельных объявлений. Это позволяет точно отслеживать рекламные расходы.

Как работает сбор данных. Для получения информации используется API Яндекс.Директ, отчет типа AD_PERFORMANCE_REPORT.
Документация по полям отчета
Формат отчетов

• Date — дата показа.
• AdId — идентификатор объявления.
• AdGroupId, AdGroupName — группа объявлений.
• CampaignId, CampaignName — кампания.
• Impressions, Clicks, Cost, Conversions, AvgCpc — статистика по показам, кликам и расходам.

Как извлекаются UTM-метки. BI Конструктор извлекает UTM-метки из ссылки объявления и подставляет значения для поддерживаемых динамических параметров. Поддерживаются и заменяются:

• {ad_id}, {banner_id}.
• {campaign_id}, {campaignid}.
• {campaign_name}, {campaign_name_lat}.
• {gbid}, {adgroupid}.

Если в ссылке есть другие шаблоны, например, {keyword}, они остаются без изменений.
Список поддерживаемых параметров

UTM-метки обрабатываются только для объявлений типов: TEXT_AD и TEXT_IMAGE_AD. BI Конструктор исключает обработку других типов. Например, IMAGE_AD, VIDEO_AD, CPC_VIDEO_AD — такие объявления требуют дополнительных API-запросов и могут содержать нестандартные ссылки.

В BI Конструкторе данные по Google Ads собираются на уровне отдельных объявлений. Это позволяет точно отслеживать рекламные расходы.

Как работает сбор данных. Данные из Google Ads приходят через API по запросу к элементу ad_group_ad.
Конструктор запросов Google Ads API (ad_group_ad)

BI Конструктор извлекает следующие поля:

• segments.date — дата показа.
• campaign.id, campaign.name — идентификаторы и названия кампаний.
• ad_group.id, ad_group.name — группа объявлений.
• ad_group_ad.ad.id, ad_group_ad.ad.type — идентификатор и тип объявления.
• customer.currency_code — валюта аккаунта.
• metrics.impressions, metrics.clicks, metrics.cost_micros, metrics.average_cpc, metrics.average_cpm — статистика по показам, кликам и расходам.
• ad_group_ad.ad.text_ad.headline и responsive_search_ad.headlines — заголовки объявлений.

Как извлекаются UTM-метки. Ссылки с UTM-метками берутся из поля ad_group_ad.ad.final_urls. Это поле содержит целевые адреса объявлений, в том числе с параметрами ValueTrack. BI Конструктор анализирует ссылки и подставляет значения для поддерживаемых динамических параметров. Поддерживаются и заменяются:

• {campaignid} — заменяется на фактический campaign.id.
• {creative} — заменяется на ad_group_ad.ad.id.
• {adgroupid} — заменяется на ad_group.id.

Остальные параметры в ссылке остаются без изменений.
Документация по ValueTrack-переменным

BI Конструктор поддерживает обработку всех типов объявлений, в которых задано поле final_urls, в том числе TEXT_AD и RESPONSIVE_SEARCH_AD. Если объявление не содержит final_urls или ссылка отсутствует — метки не извлекаются.

UTM-метки извлекаются только из основной ссылки в final_urls — это первый URL в массиве. Поддерживаемые переменные подставляются автоматически. Остальные параметры, включая ValueTrack-теги, не входящие в список, остаются в ссылке без изменений.

Мы написали SQL-запрос, чтобы извлечь данные из двух наборов: рекламные источники (tracking_source) и статистика рекламных расходов (tracking_source_expenses). Запрос соединяет данные из наборов по идентификатору источника и выбирает информацию только для рекламных кампаний с идентификаторами 1-1562 и 2-5382. Вы можете скопировать запрос и посмотреть, как работает выборка. Замените идентификаторы кампаний перед выполнением запроса.

SELECT 
 tracking_source.ID AS "Идентификатор источника",
 tracking_source.NAME AS "Название источника",
 tracking_source_expenses.CAMPAIGN_ID AS "Идентификатор кампании",
 tracking_source_expenses.CAMPAIGN_NAME AS "Название кампании",
 tracking_source_expenses.DATE AS "Дата",
 tracking_source_expenses.EXPENSES AS "Расходы",
 tracking_source_expenses.CLICKS AS "Количество кликов",
 tracking_source_expenses.CPC AS "Цена за клик"
FROM 
 tracking_source
INNER JOIN 
 tracking_source_expenses ON tracking_source.ID = tracking_source_expenses.SOURCE_ID
WHERE 
 tracking_source_expenses.CAMPAIGN_ID IN ('1-1562', '2-5382');

SELECT — определяет, какие данные извлечь из наборов. Например, запрос tracking_source.ID AS "Идентификатор источника":

• выбирает идентификатор источника ID из набора tracking_source,
• присваивает ему название Идентификатор источника,
• выводит результат в отдельную колонку в таблице.

FROM — указывает основной набор, из которого извлекаются данные. Мы извлекаем из tracking_source — это таблица со списком рекламных источников.

INNER JOIN — связывает наборы и объединяет информацию в них. Запрос tracking_source_expenses ON tracking_source.ID = tracking_source_expenses.SOURCE_ID объединяет информацию о рекламных источниках с их расходами.

WHERE — фильтрует результаты, чтобы отобрать данные только из определенных рекламных кампаний.