Google api explorer что такое

Обновлено: 15.01.2025

Conversions API (раньше называемое Server-Side API) – это функционал Facebook, который позволяет передавать данные напрямую со своего сервера на сервер Facebook.

Conversions API представляет собой в некотором роде альтернативу более привычному client-side подходу, при котором для отправки данных о событиях, совершенных пользователями на сайте, используется размещение на страницах сайта js-кода пикселя Facebook.

С помощью Conversions API можно настроить отслеживание события, которое происходит за пределами сайта, например, звонок. Также, используя Conversions API, можно отправлять в Facebook данные о переводе заявки из лида в клиента на основании этапов воронки в CRM-системе или факт реальной оплаты покупки, а не отправки транзакции на сайте.

На основании событий Conversions API, так же как и событий пикселя, можно проводить дальнейшую оптимизацию рекламных кампаний.

Особенно актуальным становится освоение Conversions API сейчас, когда ужесточается политика отслеживания данных пользователей (наверняка, уже все, кто работает в рекламном кабинете Facebook, столкнулись с оповещением об изменениях подхода Apple в отношении сбора данных пользователей устройств с iOS 14).

Подготовка к настройке Conversions API

Перед тем, как приступить к настройке, убедитесь, что у вас есть бизнес-менеджер (Business Manager) и пиксель Facebook.

Business Manager – это инструмент Facebook, позволяющий централизованно управлять различными рекламными объектами: кабинетами, страницами, каталогами и др. Если бизнес-менеджера нет, создайте его (инструкция).

Пиксель Facebook (Facebook Pixel) – это код отслеживания (фрагмент кода JavaScript), с помощью которого можно собирать информацию о посетителях сайта и использовать ее для создания аудиторий ремаркетинга и оптимизации рекламы в Facebook/Instagram. Если пикселя нет, необходимо его создать и установить на сайт (инструкция).

Настройка Conversions API

В разделе Events Manager

нужно добавить новое событие, выбрав в выпадающем списке «Использование API Conversions».

Далее появится окно с выбором способа настройки Conversions API – вручную или с использованием партнерской интеграции:

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

При выборе самостоятельной настройки откроется руководство по реализации:

Генерация маркера доступа

Для реализации API запросов нам понадобится сгенерировать маркер доступа. Маркер доступа предоставляет доступ к Conversions API. Его нужно использовать при каждом вызове API.

Сгенерируйте маркер доступа, а затем скопируйте его и сохраните, так как маркер доступа в Facebook не сохраняется.

Если вдруг вы закрыли руководство или не сохранили маркер, ничего страшного, в меню генерации маркера можно перейти также в разделе «Events Manager» – «Настройки» – блок «API Conversions».

Отправка событий через API

Graph API Explorer – это инструмент Facebook, с помощью которого можно выполнять API запросы и проверять ответы на них. Руководство по работе с Graph API Explorer

Для отправки события нужно создать новый POST запрос.

Далее следует указать актуальную версию API (обычно она уже выбрана по умолчанию).

После версии API добавляем идентификатор пикселя и после него сегмент /events:

Идентификатор пикселя можно посмотреть в разделе настроек.

В поле «Маркер доступа» вставляем сгенерированный на прошлом шаге маркер:

Чтобы сформировать тело запроса, нужно переключиться на JSON

и в поле для ввода текста вставить свои данные. Чтобы не ошибиться при составлении тела запроса, удобно использовать Payload Helper. В меню слева можно указывать необходимые для вашего события параметры, а в меню справа автоматически будет формироваться нужный код в формате JSON.

Кроме того, в Payload Helper очень удобно, что при клике на «Получить код» открываются сгенерированные варианты кода на разных языках.

Сформированный JSON нужно скопировать в поле Graph API Explorer.

Если запрос составлен корректно, то в окошке посредине появится информация о том, что событие получено.

Также тестовое событие появится на вкладке «Тестирование событий» в Events Manager

После того, как вы создали и протестировали отправку нужного события, вы можете реализовать отправку данных на реальном проекте сами либо составить ТЗ для разработчика, который поддерживает ваш проект.

Важно: для событий на сайте, передаваемых через API Conversions, обязательно указывать параметры client_user_agent, action_source и event_source_url. Для остальных типов событий достаточно указания параметра action_source.

С примерами отправки события покупки, реализованными на разных серверных языках, можно ознакомиться в этом разделе developers.

Полезные ссылки со справочной информацией по событиям и параметрам:

Дедупликация событий

Если с помощью пикселя Facebook и с помощью Conversions API отправляются одинаковые события, системой выполняется дедупликация, то есть удаление дубликатов. То, что события являются совпадающими, определяется на основании параметров «название события» и «ID события», поэтому во избежание дублирования данных, следует передавать эти параметры.

При отправке события, идентичного тому, что уже было отправлено, дубль будет удален, в режиме тестирования вы можете увидеть такое оповещение:

В этой статье я хотел бы дать обзор api, которые предоставляет google. Я не буду рассматривать все api и давать детальную инструкцию по их использованию, а расскажу только про те, которые считаю наиболее полезными, и дам примеры кодов с комментариями (примеры взяты из документации к api).

AJAX Libraries API

С помощью этого api мы можем подключать к своим web-приложениям популярные на данный момент JavaScript библиотеки (jQuery, Prototype, MooTools, Dojo, Ext Core и другие). Так же AJAX Libraries API будeт загружать библиотеки, необходимые для api, которые будут представлены ниже.
Пример использования AJAX Libraries API:

// Скрипт самого api
<script src= "http://www.google.com/jsapi" ></script>
<script>
// Загрузка библиотеки. В данном случае jquery версии 1.3.2
google.load( "jquery" , "1.3.2" );
// Указываем Callback-функцию которая вызывается после загрузки библиотеки
google.setOnLoadCallback( function () alert($.browser.version);
>);
</script>

* This source code was highlighted with Source Code Highlighter .

Документация к api здесь

AJAX API языков

AJAX API языков дает нам возможность перевести текст, а так же определить язык, на котором написан текст, используя при этом только javaScript.

<html>
<head>
<script type= "text/javascript" src= "http://www.google.com/jsapi" >
</script>
<script type= "text/javascript" >
// Подключаем библеотеку language
google.load( "language" , "1" );

google.setOnLoadCallback( function () var text = document .getElementById( "text" ).innerHTML;
//Определяем язык и вызываем колбек функцию
google.language.detect(text, function (result) if (!result.error && result.language) // Если нет ошибок и язык определен, переводим текст на русский
google.language.translate(text, result.language, "ru" ,
function (result) var translated = document .getElementById( "translation" );
if (result.translation) translated.innerHTML = result.translation;
>
>);
>
>);
>);

* This source code was highlighted with Source Code Highlighter .

Документация к api здесь

Code Playground

Приложение, с помощью которого мы можем выполнять наш JavaScript. Но прелесть Code Playground не в этом (лично для меня). Здесь представлено много полезных примеров. Например, именно отсюда я узнал, как использовать YouTube API (и ответил на вопрос, как сделать собственную шкуру для плеера с YouTube).

Query Explorer — это способ получить необработанные данные веб-аналитики для сайта. Вы можете экспортировать в виде TSV (и переделать в CSV) или по прямой ссылке. Экспорт данных Google Analytics через API полезен, потому что можно перезапустить запрос в любое время, когда нужно обновить данные.

Что такое Query Explorer

Это пользовательский интерфейс, который позволяет создавать запросы к API для получения информации из учетной записи GA. Изначально Google создал его для тестирования в своих проектах. Сейчас это отличный способ экспорта и обработки данных для всех желающих. Нет никаких платных тарифов и ограничений по использованию.

Инструмент запросов позволяет указывать данные на основе предварительно определенных показателей и измерений. Более опытные пользователи могут применять фильтры, сортировки и сегменты.

Query Explorer vs стандартный GA

Часто нужно экспортировать данные из интерфейса Google Analytics и обрабатывать их различными способами. GA имеет свои недостатки: ограничение в 500 строк, фильтрация по одному или двум параметрам вместо нескольких. Стандартный инструмент не справляется, если хотя бы один пункт нарушается. На помощь приходит API.Query Explorer позволяет без знаний языка программирования создавать конечный URL. Через меню он автоматически создаст адрес с правильным синтаксисом, нужными параметрами и кодировкой.
1. QE можно использовать для создания многофункциональных панелей аналитики. Информация обновляется автоматически, сохраняются нужные настройки.
Пошаговый туториал: как использовать QE

Рассмотрим, как создать запрос к API, который будет извлекать данные из аккаунта Google Analytics.

Авторизация

Первое, что потребуется для работы с QE — вход через аккаунт Гугл. Иначе все поля будут неактивны.

1. View
1. Нажмите Account и откройте список аккаунтов.
2. Выберите учетную запись.
3. Кликните на Property. Появится список свойств вашего аккаунта. Выберите нужное.
4. Проделайте тоже самое с меню View.
Если вы выбрали одно из представлений, поле «ids» будет автоматически заполняться его идентификатором.

2. Start-date и end-date

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

В QE выделяется 3 базовых типа времени:
1. Календарная дата: 06.06.2019.
2. Относительная дата: вчера, сегодня.
3. NdaysAgo: 30daysAgo (за 30 дней), 7daysAgo (за 7 дней).
Используйте удобные комбинации для уточнения.
1. Заполните поле start-date. Например, 7daysAgo.
2. Укажите значение в end-date, например, сегодня.
Обратите внимание на предупреждение «This result is based on sampled data» — этот результат основан на выборочных данных.

В некоторых случаях может потребоваться помощь при работе с большим набором данных (например, получать просмотры страницы по минутам). Обычно сокращение диапазона тоже помогает.

3. Metrics

Каждый API запрос, отправляемый из Query Explorer, должен содержать по крайней мере одну метрику.

Что такое метрики в Google Analytics

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

План действий

4. Dimensions

Измерения необязательны при создании запроса к API, но рекомендуется их указывать.

Что такое измерения в Google Analytics

Измерения — это качественные значения, которые описывают извлекаемые данные или метрику. Это могут быть дата, источник, типы пользователей.

Например, вы создали запрос для пользователей за последние 7 дней и прописали в dimensions даты. Результат будет состоять из двух колонок Date и Users. Вы увидите число посетителей в конкретный день.

План действий

5. Start-index и max-result

Query Explorer вернет количество строк, ограниченное полем max-result. Максимальное число — 10.000. Но вы можете использовать поле start-index, чтобы получить более 10.000 строк.

Например, вам нужно получить 30 тысяч. Если в max-result было установлено значение 10.000, Query Explorer вернет ровно 10.000 строк, от 1 до 10.000.

Как получить с 10.001 по 20.000? Впишите в поле start-index значение 2. QE вернет с 10,001 до 20000.

Затем установите 3. Вы получите строки 20,001–30.000.

Поэтому, если ваш запрос возвращает более 10.000 результатов, используйте start-index для их итерации.

6. Экспорт

Кроме того, можно поделиться результатом со своими коллегами или клиентами: нажав «Share Report», вы получите ссылку на Query с запросом.

Важно отметить: при совместном использовании URL выделяется общий доступ к указанным значениям измерений, метрик, сегментов, фильтров и т.д. Но никакие данные Google Analytics предоставляться не будут.

Пользователь, получивший ссылку, должен иметь доступ к нужному аккаунту Google Analytics, свойству и представлению, чтобы выполнить запрос.

Продвинутые кейсы в QE

Преимущество экспорта данных с помощью QE — гибкость, которую вы получаете при создании запроса API.
1. Анализ трафика из одного источника, например, из Facebook.
2. Почасовой мониторинг для определения наилучшего времени для обновления сайта.
3. Обработка информации о посетителях и их группировка на основе среднего времени, проведенного на странице, и количества посещений.
4. Создание библиотеки запросов на все случаи жизни.
Для таких действий понадобятся фильтры и сегменты.

Фильтры

Применение фильтра полезно для уточнения данных, которые вы получаете при вызове. Можно применить их к метрикам или измерениям.

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

Сегменты

Как и в обычном интерфейсе Google Analytics, вы можете запрашивать данные для определенного сегмента, например, «Мобильный трафик». Если развернуть раскрывающийся список, вы увидите «Default Segments» и «Custom Segments», которые вы определили. В Query Explorer можно создать свой сегмент, но обычно так не делают.

Подводим итоги

Query Explorer — это пользовательский интерфейс для создания запроса к API. Технически, вы можете вручную создать ссылку и успешно ее использовать для извлечения данных. QE уменьшает количество ошибок, добавляя правильные параметры. Следуйте несложным инструкциям, и у вас все получится.

Яндекс.Директ. Яндекс Маркет. Google Adwords. Google Merchant. Ремаркетинг
– Широкая семантика.
– Высокий CTR.
– Тщательная минусовка.
– Только целевые заходы.

APIs-Google – это агент пользователя, который API Google применяет для отправки push-уведомлений. Разработчики приложений могут включить такие уведомления, чтобы узнавать об изменении интересующих их ресурсов, не перегружая серверы Google постоянными запросами. Чтобы предотвратить злоупотребления этой функцией, Google требует от разработчиков подтвердить, что они являются владельцами домена. Только потом разрешается зарегистрировать URL в домене как адрес для получения уведомлений.

Как APIs-Google получает доступ к сайту

Частота обращений к сайту зависит от того, сколько запросов push-уведомлений было создано для ваших серверов, а также от скорости обновления отслеживаемых ресурсов и от количества повторных попыток. Поэтому трафик APIs-Google в некоторых случаях может быть равномерным, а в других – сильно колебаться.

Подготовка сайта для APIs-Google
- Сертификаты с собственной подписью.
- Сертификаты с подписью из ненадежного источника.
- Отозванные сертификаты.
Чтобы на сервер не поступали лишние повторные запросы, приложение должно быть хорошо продуманным, а ответ на уведомление должен отправляться за считанные секунды.

Как запретить APIs-Google обращаться к вашему сайту

Вы можете выполнить одно из следующих действий:
- Отменить регистрацию. Если у вашего домена есть субдомены или подпространства адресов с отдельными владельцами или администраторами, возможно, кто-то из них настроил приложение, в котором используются push-уведомления. Чтобы заблокировать доступ для APIs-Google, попросите других владельцев или администраторов отключить эту функцию.
- Использовать файл robots.txt. В файле robots.txt необходимо указать агент пользователя APIs-Google , так как APIs-Google не следует директивам для робота Googlebot. APIs-Google может не сразу обнаружить изменения в файле robots.txt. Если после блокировки доступа в файле robots.txt прошло несколько дней, а APIs-Google продолжает отправлять уведомления на ваш сайт, убедитесь, что файл robots.txt размещен там, где нужно.
Проверка источника запросов

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Читайте также: