Сторонние компании не являются прямыми пользователями Ad Manager, поскольку у них может не быть собственной сети Ad Manager. Вместо этого они создают сервисы или интеграции с Ad Manager для своих клиентов, которые являются клиентами Ad Manager. Это руководство охватывает основы интеграции со сторонними сервисами, предоставляя рекомендации, советы и советы.
В этом руководстве предполагается, что вы уже знакомы с API Ad Manager. Если вы не знакомы с API Ad Manager, ознакомьтесь с нашей документацией по началу работы .
Начало работы в качестве третьей стороны
Чтобы использовать API Ad Manager для доступа к сети клиента Ad Manager, просто следуйте приведенным ниже инструкциям. Дополнительное одобрение от Google не требуется, однако обратите внимание, что, получая доступ к API Ad Manager и/или используя его, вы соглашаетесь с условиями использования API Ad Manager.
Как протестировать интеграцию Ad Manager с сторонним сервисом
Как сторонний разработчик, вы, возможно, задаетесь вопросом, как протестировать интеграцию Ad Manager перед запуском в рабочих сетях ваших клиентов. Рекомендуемый подход — создать тестовую сеть . Для этого вам не обязательно быть клиентом Ad Manager. Любой пользователь с учетной записью Google может создать тестовую сеть.
Однако следует отметить различия между тестовыми и рабочими сетями . Тестовые сети не могут показывать рекламу. Кроме того, тестовые сети не обязательно будут содержать все функции, которые могут быть доступны вашим клиентам в их рабочих сетях. Если вам необходимо протестировать функции Ad Manager, недоступные в вашей тестовой сети, одним из вариантов является приобретение доступа к нетестовой сети через реселлера Ad Manager.
Кроме того, вы должны четко объяснить своим клиентам, какие функции им необходимы в их производственной сети для корректной работы вашего приложения. Ваше приложение должно обрабатывать случаи, когда функции могут отсутствовать, либо перехватывая исключения и корректно завершая работу, либо ведя список ваших клиентов и указывая, какие функции у каждого из них есть или нет. Ответственность за управление функциями в сети клиента должна лежать на его контактном лице в Google.
Аутентификация: Как правильно получить доступ к рекламной сети клиента.
Для того чтобы ваше приложение могло получить доступ к рекламной сети вашего клиента, необходимо настроить безопасный процесс аутентификации.
Это включает в себя два этапа:
- Создайте адрес электронной почты в учетной записи Google, который вы будете использовать для доступа к сети вашего клиента.
- Попросите клиента добавить этот аккаунт в качестве пользователя в свою рекламную сеть Ad Manager.
На первом этапе вы можете создать либо отдельную учетную запись Google для каждого клиента, либо основную, которую будете использовать для всех клиентов. Первый вариант более безопасен в случае взлома одной из ваших учетных записей. Во втором случае вам нужно будет выполнить первый шаг только один раз.
Независимо от того, что вы сделаете на шаге 1, на шаге 2 вам нужно будет попросить каждого нового клиента добавить в свою рекламную сеть Ad Manager соответствующую учетную запись Google, которую вы для него создали.
1. Создание учетной записи Google
Существует несколько способов создания учетной записи Google, которую можно добавить в рекламную сеть Ad Manager.
Вариант 1: Создайте сервисный аккаунт OAuth2 , который сгенерирует для вас адрес электронной почты сервисного аккаунта, выступающий в качестве учетной записи Google. Инструкции по созданию нового сервисного аккаунта .
Вариант 2: Вы можете создать обычную учетную запись Google (например, учетную запись Gmail), зарегистрировавшись как новый пользователь . Если у вас уже есть учетная запись Google, завершите регистрацию в режиме инкогнито или в новой сессии браузера. Или, если ваша компания использует Google Workspace , вы можете создать учетную запись Google в домене вашей компании и использовать ее. В целях данного руководства мы будем называть оба варианта «обычной» учетной записью Google.
2. Попросите клиента добавить вашу учетную запись Google в свою сеть.
После того, как вы получите учетную запись Google для доступа к сети вашего клиента, попросите его добавить эту учетную запись в качестве нового пользователя в свою сеть Ad Manager.
Если вы предоставляете им адрес электронной почты сервисной учетной записи OAuth2, попросите их добавить его в свою сеть .
Если вы предоставляете им обычную учетную запись Google, попросите их добавить вашу учетную запись в качестве пользователя в свою сеть.
Независимо от выбранного вами пути, обязательно обсудите с клиентом, какие роли и права доступа должна иметь ваша учетная запись, чтобы ваше приложение могло получить доступ к необходимым данным в сети клиента.
Теперь вы можете начать выполнять вызовы API к рекламной сети вашего клиента. Убедитесь, что заголовок SOAP networkCode установлен на код сети клиента, к которой вы обращаетесь с вызовом API. Все наши клиентские библиотеки позволяют устанавливать это программно. Например, в Java-клиентской библиотеке ads вы можете программно установить код сети при создании экземпляра DfpSession.
Будьте в курсе последних обновлений API.
Важно быть в курсе того, какие версии API устарели или прекращены, а также когда выходят новые версии. Вы же не хотите оказаться застигнутыми врасплох прекращением поддержки какой-либо версии и рисковать нарушением работы ваших клиентов. Мы не всегда можем связаться с третьими сторонами по поводу предстоящего устаревания или прекращения поддержки, как это делаем для наших клиентов. Поэтому вы обязаны подписаться на один из трех основных каналов получения обновлений API и настроить параметры уведомлений:
- Наша группа объявлений о прекращении поддержки API Ad Manager .
- Наш блог для разработчиков рекламы .
На нашем сайте для разработчиков также размещен график устаревания программного обеспечения , который вам следует регулярно проверять.