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