Контрольный список для начинающих разработчиков Google Рекламы

Этот контрольный список проведет вас через процесс начала работы с API Google Рекламы. Шаги разделены на несколько категорий, некоторые из которых вы можете пропустить, если они не соответствуют вашим потребностям. Чтобы получить максимальную пользу от этого документа, прочитайте и выполните шаги по порядку.

Список содержит три типа элементов:

Todo: шаги, необходимые для выполнения определенной задачи или настройки определенной части вашего инструмента.

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

Доступ и настройка

Получите токен разработчика в Центре API своей учетной записи менеджера верхнего уровня. Все поля формы доступа к API должны быть заполнены и приняты Условия использования. Убедитесь, что предоставленный вами контактный адрес электронной почты API ведет в регулярно отслеживаемый почтовый ящик. Вам будет выдан токен разработчика с уровнем доступа к тестовому аккаунту .

Чтобы получить одобрение вашего токена для производственного доступа, вам необходимо заполнить нашу последующую форму заявки и объяснить, как вы собираетесь использовать API.

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

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

Настройка клиентской библиотеки

Мы используем OAuth 2.0 для аутентификации ваших запросов к API. Следуйте инструкциям в нашем руководстве по OAuth 2.0, чтобы настроить учетные данные для OAuth 2.0. Для устранения неполадок можно использовать площадку OAuth 2.0 .
Мы предоставляем клиентские библиотеки для некоторых распространенных языков программирования. Загрузите библиотеку для языка, который вы хотите использовать, и настройте ее файл конфигурации, используя ранее полученные учетные данные.

Токен разработчика – уровни доступа

Прочтите об уровнях доступа и решите, потребует ли ваш инструмент более 15 000 операций в день в какой-то момент в будущем. В этом случае вам нужно будет подать заявку на стандартный доступ для неограниченного количества операций mutate и запросов GoogleAdsService.Search и GoogleAdsService.SearchStream в день. Однако на это по-прежнему распространяется ежедневный лимит в 1000 операций get .
Ознакомьтесь с прейскурантом, чтобы понять, как рассчитываются операции для вашего уровня доступа. Обратите внимание, что запросы GoogleAdsService.Search с установленным полем page_token не учитываются при расчете лимита операций.

Требуемая минимальная функциональность (RMF)

Прочтите о требуемой минимальной функциональности (RMF) , которая представляет собой набор функций, которые ваш инструмент должен реализовать в зависимости от его характера.
Прочтите о штрафах за несоблюдение требований, чтобы понять, что происходит, когда RMF не применяются должным образом.
Убедитесь, что ваш инструмент реализует применимые RMF.
Подайте заявку на стандартный доступ .

Начните работать с API

Ознакомьтесь с разделом «Первый вызов API» , в котором объясняется, как получать кампании с использованием API. Все объекты доступны одинаковым образом, поэтому стоит запомнить структуру.
Понять базовую структуру API ресурсов и сервисов .
Ознакомьтесь с разделами «Изменение и проверка объектов» и «Извлечение объектов» .
Прочтите о метаданных ресурсов , чтобы понять, как запрашивать их динамически.
Прочтите «Обзор кампаний» , чтобы узнать, как создавать различные кампании и типы объявлений и управлять ими.

Примеры кода

Основные операции > Получить кампании
Основные операции > Получение развернутых текстовых объявлений
Основные операции > Добавление кампаний
Основные операции > Добавить ключевые слова
Основные операции > Обновить ключевое слово
Управление кампанией > Получить все отклоненные объявления
Управление кампанией > Добавить модификатор ставки кампании
Управление учетной записью > Получить информацию об учетной записи
Управление учетной записью > Создать клиента
Управление учетной записью > Получить изменения учетной записи

Составление отчетов

Сделайте краткий обзор отчетов и пример обобщения эффективности аккаунта за последние 30 дней, используя GoogleAdsService в качестве единственного источника достоверной информации для отчетов в отчетах Google Рекламы.
Прочтите язык запросов Google Рекламы (GAQL), ​​чтобы понять грамматику и структуру запросов, а также концепции ресурса, сегмента и показателей.
Прочтите о показателях критериев, чтобы понять, как получить данные о производительности для различных критериев с помощью ресурсов *_view , например KeywordView , TopicView и GenderView .

Интерактивный конструктор запросов Google Рекламы

Используйте редактор этого инструмента, чтобы создать оператор языка запросов Google Рекламы для определенного ресурса; например группа объявлений. Скопируйте и вставьте созданный оператор GAQL в свое приложение.

Исследование ключевых слов

Если вы не знакомы с нашим инструментом «Планировщик ключевых слов» , попробуйте его, чтобы узнать, как планирование ключевых слов работает в пользовательском интерфейсе Google Рекламы.

Примеры кода

Примеры планирования -> Создание показателей прогноза
Примеры планирования -> Генерация вариантов ключевых слов

Автоматизируйте бюджеты

Прочтите о способах оплаты и настройках , чтобы понять доступные варианты выставления счетов в Google Рекламе, такие как автоматические платежи, платежи вручную, ежемесячное выставление счетов (кредитная линия).
Ознакомьтесь с настройками выставления счетов , чтобы понять, как программно управлять платежными профилями и платежными счетами.
Прочтите о бюджете аккаунта , чтобы понять, как бюджеты могут автоматически назначаться аккаунтам.
Свяжитесь с представителем своей компании в Google, чтобы подать заявку на регистрацию для ежемесячного выставления счетов.
Свяжитесь с представителем своей компании в Google, чтобы подать заявку на доступ к AccountBudgetProposalService .
Создайте AccountBudgetProposal и назначьте его учетной записи. Попробуйте использовать бюджет вместе с бюджетом кампании .

Товарные объявления

Создайте учетную запись Merchant Center и получите MerchantID.
Получите ключ сервисной учетной записи , если вашему приложению нужен только доступ к вашей учетной записи Merchant Center. Но если вы пишете стороннее приложение, которому требуется доступ к учетным записям Merchant Center ваших клиентов, ознакомьтесь с руководством по авторизации запросов с помощью OAuth 2.0.
Загрузите клиентскую библиотеку для выбранного вами языка.
Просмотрите примеры кода Content API для Java , .NET , PHP , Python и т. д.
Узнайте, как вручную связать аккаунты Merchant Center и Google Рекламы.
Узнайте, как настроить список продуктов с помощью Content API.
Ознакомьтесь с руководством «Создание торговой кампании с помощью Google Ads API».

Рекомендации и изменение статуса

Если вы не знакомы с функциями «Рекомендации» и «История изменений» , попробуйте их в пользовательском интерфейсе Google Рекламы.

РекомендацияСервис

Прочтите наше руководство о том , как использовать Рекомендательную службу для получения и применения рекомендаций Google к вашей учетной записи, чтобы повысить общую эффективность рекламы.
Откройте для себя функциональные возможности рекомендаций, выполнив этот пример кода: Образцы рекомендаций -> Получение рекомендаций по текстовым объявлениям .

Чангестатуссервице

Прочтите наше руководство о том , как использовать ChangeStatusService для получения истории изменений и отслеживания изменений в вашей учетной записи, таких как кампании и реклама.
Откройте для себя функциональные возможности истории изменений, запустив этот пример кода: Образцы ChangeStatus -> Получить изменения учетной записи. .

Быть в курсе событий

Управление версиями

Когда выйдет новый API, получите последнюю версию нашей клиентской библиотеки .
Добавьте закладку к последним примечаниям к выпуску и просмотрите основные изменения в каждой версии.
Замените вызовы старой версии клиентской библиотеки вызовами новой версии.
Подпишитесь на этот блог , чтобы подписаться на нашу RSS-ленту и получать сообщения блога по электронной почте, а также посетите форум , чтобы получить самую свежую информацию о Google Ads API.
Убедитесь, что контактный адрес электронной почты API, зарегистрированный в Центре API вашего основного управляющего аккаунта, актуален, поскольку именно так мы свяжемся с вами, если обнаружим какие-либо технические проблемы, связанные с использованием вами API.
Google Мерчант Центр Google Merchant Center помогает загрузить данные о вашем магазине и продуктах в Google и сделать их доступными для товарных объявлений и других служб Google.
Бизнес-профиль Профиль вашей компании помогает вам привлекать местных клиентов и взаимодействовать с ними через Google Поиск и Карты.
Гугл Аналитика Google Analytics предоставляет подробные отчеты о том, как люди используют ваш сайт. Вы можете использовать Google Analytics, чтобы узнать, что люди делают после нажатия на ваши объявления.
Диспетчер тегов Google Google Tag Manager — это система управления тегами (TMS), которая позволяет быстро и легко обновлять коды отслеживания и связанные с ними фрагменты кода, называемые тегами, на вашем веб-сайте или в мобильном приложении.
Google Оптимизация Google Optimize предлагает малым предприятиям A/B-тестирование, тестирование веб-сайтов и инструменты персонализации, которые помогают обеспечить привлекательное качество обслуживания клиентов.
Google Студия данных Data Studio превращает ваши данные в информативные, удобные для чтения и обмена, а также полностью настраиваемые информационные панели и отчеты.

Получать помощь

Добавьте закладку в руководства по API Google Рекламы . Там подробно объяснено большинство основных понятий.
Добавьте закладку в справочник Google Ads API . Там подробно описан весь функционал API.
Добавьте закладку на страницу поддержки Google Ads API , на которой описаны основные каналы поддержки.
Посетите канал YouTube для разработчиков Google Рекламы.
Свяжитесь с представителем вашего бизнеса/менеджером по работе с партнерами в Google, чтобы назначить встречу для решения более сложных стратегических вопросов, связанных с API.