Api Yandex Direct todas las empresas. Tipos dependientes utilizando el ejemplo de interacción con la API Yandex.Direct. Cambiar opciones para todas las frases de la campaña

En este curso veremos servicio de gestión de apuestas en Direct corredor R- http://r-broker.ru/.

Hay muchos servicios similares. R-broker es uno de los líderes del mercado.

Puede utilizar el servicio de forma gratuita si crea una campaña en su cuenta.. Simplemente comuníquese con ellos y ellos crearán una nueva cuenta limpia para usted (esta será una subcuenta de su cuenta de agente principal).

Si desea conectar el servicio a su cuenta, existe un cuadro de tarifas. Los precios por utilizar las capacidades del servicio dependen de la cantidad de frases y ajustes.

¿Cómo funciona R-broker?

R-broker trabaja a través de API directa: http://direct.yandex.ru/help/?id=1113180

Se conecta a la campaña y tiene acceso a los campos de oferta.

El servicio realiza hasta 96 correcciones automáticas por día (cada 15 minutos).

Según Ayuda Directa, se activan nuevas tarifas de 5 a 60 minutos. ¡Pero el tiempo medio de procesamiento de esta acción es de 10 minutos!

El significado de R-broker

1. Protección antideslizante

El corredor P protege contra soporte/soporte (se puede llamar de otra manera).

Veámoslo con un ejemplo.

1 especial = $5
2 especiales = $2
entrada a especial = 0.5$

Apareces en 1er lugar.

El monto debitado por clic es de $2,01.

El competidor en la segunda posición te toma y te apoya, hace una oferta de $4,99.

Todo. Ahora un clic le cuesta $5, no $2,01.

Cuando tienes cientos de frases en tu campaña, nunca podrás controlar por ti mismo la aparición de tales situaciones..

Ahora algunos robots ya tienen una función similar.

Ejemplo: www.magazion.ru.

Basándose en la estrategia elegida, "Magazion" ataca las ofertas de los competidores, fijando sus propias ofertas más altas. El importe de la prima de ataque depende de la configuración de agresividad (se puede establecer tanto para toda la campaña publicitaria como para frases individuales).

Bueno, todos los robots modernos adecuados tienen una función de protección.

Situaciones similares surgen todo el tiempo en campos altamente competitivos.

Por ejemplo - ventanas de plastico, creación de sitios web, etc.

Sin automatizar las ofertas a través de la API, Kazajstán no puede tener verdadero éxito en estas áreas.

2. Gestión de ofertas

P-broker es un robot. Supervisa la correcta implementación de la estrategia elegida..

A veces, un bróker P es sencillamente irremplazable.

La característica principal es mantener posiciones sin descensos..

Los precios suben y bajan a lo largo del día.

Si desea ser especial en la entrada, podemos configurar manualmente las tarifas en la interfaz Directa para ingresar al bloque.

Cualquier fluctuación de 1 centavo y saldremos de allí.

Inicialmente suministraremos más (dentro de nuestros límites); las subvenciones son posibles.

Podemos sentarnos todo el día y ajustar las tarifas nosotros mismos, pero pronto terminaremos en un hospital psiquiátrico.

El propio corredor P puede ajustar las tarifas varias veces por hora.

Mientras que las tarifas de la competencia cambian automáticamente a través de API muchas veces al día, estas personas las cambian manualmente una vez al día por la mañana. No hay competencia igualitaria en absoluto.

Matices

No puede conectar el corredor P a las estrategias automáticas de Direct, porque Los campos de oferta no están disponibles.

Es ideal utilizar un corredor P para la posición más alta disponible (simplemente establece la tasa para la posición deseada) e ingresa bloques de mínimo. precio.

Autobroker Direct siempre bajará la tarifa al mínimo posible ahora y aquí.

El autobroker y la estrategia en Direct son de importancia decisiva para determinar la posición en la búsqueda.

Esto es lo malo: el P-broker a veces tarda mucho en cargarse.

Configurar un corredor R

Un corredor P puede parecer complicado a primera vista. Pero te aseguro que no tiene nada de complicado.

Si aún no comprende muy bien cómo funciona Direct, hasta que lo comprenda, es mejor no seguir leyendo, de lo contrario será muy difícil de entender.

Es mejor volver a estudiar temas pasados.!

Es necesario leer las instrucciones del R-broker

Hay muchas cosas innecesarias en el P-broker. Escribiré a qué vale la pena prestarle atención.

Registros de eventos/estadísticas y análisis

Nunca miro las estadísticas a través de un corredor P. La revista a veces es útil y otras no.

Estas son secciones mediocres. Puedes simplemente ignorarlos ahora.

Opciones de control

Utilice el control deslizante (a la izquierda) para habilitar el control y establecer un cronograma para ajustar las tarifas. Marcamos las casillas de la hora a la que se publica su anuncio.

Control de calidad de la campaña.

Es mejor no tocar nada.

Recrear una frase con un CTR bajo es generalmente un camino a la tumba.

Necesitamos tratar el problema, no recrearlo. Yandex recuerda todo.

Conexión automática de nuevas frases para controlar.

Si las tácticas son las mismas para toda la República de Kazajstán, entonces es posible. Y si no, entonces debes incluir cada frase tú mismo.

R-max es el precio máximo que estamos dispuestos a pagar por clic. No el que estará en la interfaz Directa. Esta información es específicamente para el corredor P.

Configuraciones generales

Marque la segunda casilla: "Establezca siempre una oferta no inferior a la oferta mínima para mostrar en la búsqueda".

Normalmente desactivo la primera opción.

Al incluir el punto 3, no tendremos una limitación de r-max y la tarifa se puede fijar incluso en $50; lo principal es que el presupuesto lo permita. Para estar seguro, es mejor no encenderlo.

Por cierto, $50 es la apuesta máxima permitida en Direct. Horror. No sé quién está dispuesto a pagar tanto por 1 clic. ¿Estás listo?

Cambiar opciones para todas las frases de la campaña

Aquí puedes establecer tácticas generales.

Lea más sobre estrategias en las instrucciones..

Tácticas básicas:

1>2>3 (ocupamos lugar especifico, caemos sobre el más cercano desde abajo)

1>G>D(tomamos un lugar dentro del bloque, caemos en el bloque adyacente)

El resto realmente no es necesario. Repiten estas tácticas hasta cierto punto.

Ejemplo

Imaginemos que tenemos una táctica en la interfaz Direct: ingresar un bloque de minutos. precio (especial + garantía).

Configuramos el P-broker para 1>G>D CP (ubicación especial) con algo de R-max.

Como resultado, todo lo que se pueda mostrar se mostrará al especialista (en la entrada), si falla, se garantizará en la entrada.

Todo lo que está garantizado, lo antes posible, se convierte en especial.

Económicamente, enojado.

Recuerde: una campaña publicitaria bien adaptada es muy fácil de arruinar durante una búsqueda, por eso la táctica y el lanzamiento adecuado son muy importantes.

Hola.

La popularización de los tipos dependientes para la programación se ve facilitada en gran medida por la biblioteca Servant, que se utiliza tanto para proporcionar una API escrita (servidor-servidor) como para escribir consultas en una existente (servidor-cliente). Usaremos esta biblioteca (una explicación de cómo funciona está fuera del alcance de esta publicación; los interesados ​​pueden leer el informe). Sin embargo, el asunto no se limitará a los tipos dependientes integrados en Servant, y agregaremos más propios.

Plan

Describiremos varias entidades básicas de la API Yandex.Direct: método (agregar, obtener), operación, resultado de la operación, objeto (nombres de diccionarios, anuncios, campañas) y definiremos una función escrita de forma dependiente que le permita llamar a cualquier método. parametrizado por algún objeto y aceptar una respuesta cuyo tipo depende del método llamado y el tipo de objeto.

Operaciones

Objetos

La API Yandex.Direct es muy extensa: se puede utilizar para procesar anuncios, grupos de anuncios, campañas, extensiones, palabras clave y mucho más. Escribiremos una función genérica que nos permitirá pasar cualquiera de estos objetos al método llamado.

Primero un par de ejemplos. Anuncios:

Campañas:

La dirección para procesar solicitudes relacionadas con anuncios es “https://api.direct.yandex.com/json/v5/ads” y la dirección para procesar solicitudes relacionadas con campañas es “https://api direct.yandex. com/json/v5/campaigns”. Todos los demás objetos también tienen sus propias direcciones para procesar solicitudes. Así que creemos una clase de tipo.

Es decir, cada objeto debe ser serializable a JSON para que pueda enviarse a través de la red y tener un nombre que forme parte de la dirección de solicitudes.

API

Describamos la API directa utilizando las herramientas proporcionadas por Servant:

a es el tipo de parámetro del método llamado, r es el tipo del resultado devuelto. La operación se serializa automáticamente a JSON, el resultado se deserializa automáticamente desde JSON.

También necesitamos una configuración específica de Direct:

Y finalmente podemos juntar todo y definir la función principal para comunicarnos con Direct API:

(En versiones más recientes, Servant Manager es parte de ClientM, pero al momento de escribir este artículo, la última instantánea de LTS en Stackage usa versión antigua). perform acepta una configuración específica de Direct, un administrador de conexiones, un método que se llamará en forma singleton y un objeto que se pasará al método. De la firma de perform podemos ver que el tipo de valor de retorno (ResultOf m a) realmente depende del método llamado (m en SMthod m) y del tipo de parámetro (a) que se le pasa. De lo contrario, simplemente utilizamos la funcionalidad básica proporcionada por Servant.

Conclusión

Al utilizar un Servant escrito de forma dependiente, puede describir la API de forma declarativa y eliminar la necesidad de serializar y deserializar datos manualmente. Sin embargo, los tipos de datos que llegan en respuesta a una solicitud pueden depender del contenido de la solicitud, pero los tipos dependientes aquí también le permiten expresar todas las invariantes necesarias.

Este Acuerdo rige la relación entre usted (en adelante, usted o el Usuario) y YANDEX LLC (en adelante, Yandex) con respecto al uso de la API (en adelante, la API) del Servicio Yandex.Direct (en adelante, denominada como el Servicio).

Yandex le brinda la oportunidad de utilizar la API del Servicio para administrar campañas publicitarias utilizando Aplicaciones que interactúan con el Servicio, así como utilizar la API de otras formas que no contradigan este Acuerdo. El uso de la API dentro del Servicio se rige por este Acuerdo, la Oferta de Servicio ubicada en y el Acuerdo de Usuario de Yandex, que está disponible en: .

Al utilizar la API, usted acepta todos los términos de este Acuerdo y los documentos especificados anteriormente y se compromete a cumplirlos o dejar de usar la API.

A los efectos de este Acuerdo, se utilizan los siguientes términos:

Servicio API "Yandex.Direct", API- interfaz de software para la interacción de las Aplicaciones (como se define este término a continuación) con el Servicio Yandex.Direct.

Clave API (token OAuth)- un identificador único emitido al Usuario, que permite el acceso a las funciones del Servicio.

Términos de uso de API:

1. Tu seguridad.

Usted es responsable de la seguridad de su clave API, así como de todo lo que se realiza en el Servicio utilizando la Aplicación y la clave API que utiliza. Todas las acciones en el Servicio realizadas utilizando su clave API se consideran realizadas por usted. Usted acepta que debe notificar inmediatamente a Yandex sobre cualquier acceso no autorizado (no autorizado por usted) a su clave API y/o cualquier violación de seguridad. Yandex no es responsable de la posible pérdida o cambio de datos que pueda ocurrir debido a su violación de las disposiciones de esta parte de las PS. Yandex te anima a utilizar todas las medidas de seguridad. Trabajo de API, incluidas medidas para mantener la confidencialidad de la clave API.

2. Acceso automatizado.

Usted acepta que, con excepción de las Aplicaciones para interactuar con la API, tiene prohibido utilizar otros medios de acceso automatizado (robots, etc.) al Servicio.

3. Monitoreo.

Usted comprende y acepta que Yandex monitorea toda la actividad que utiliza la API y puede recopilar y analizar estadísticas sobre las acciones de los usuarios realizadas mediante la API.

4. Garantía de acceso.

Usted acepta que Yandex puede cambiar los términos de servicio (incluida la API) en cualquier momento sin previo aviso a los usuarios. Por lo tanto, Yandex no garantiza la disponibilidad constante del Servicio (incluida la API) ni de ninguno de sus componentes. Los Servicios (incluida la API) se proporcionan "tal cual". Yandex no garantiza que el Servicio o sus componentes (incluida la API) cumplan con los objetivos y expectativas del Usuario, ni que su funcionamiento sea ininterrumpido o esté libre de errores. Yandex no es responsable de sus acciones ni de las de otros usuarios realizadas en el Servicio utilizando la API. Yandex no compensa ningún daño, directo o indirecto, causado al Usuario o a terceros como resultado del uso o la imposibilidad de utilizar el Servicio o sus componentes individuales (incluida la API).

Usted acepta que Yandex puede suspender o cerrar completamente el acceso a la API, cambiar protocolos y métodos de acceso sin dar motivos y sin responsabilidad de su parte. Usted es responsable de la seguridad de todos sus datos y debe estar preparado para gestionar campañas a través de la interfaz del cliente web.

5. Limitaciones.

Usted acepta que Yandex puede, a su discreción, establecer restricciones (cuotas) sobre el uso de la API o sus componentes individuales, dependiendo de muchos indicadores, incluido, entre otras cosas, el volumen de servicios proporcionados al Usuario de la Aplicación, indicadores técnicos de la campaña publicitaria (CTR medio, disponibilidad de anuncios rechazados por moderación, etc.).

Las reglas para aplicar dichas restricciones se describen en las "Preguntas y respuestas" ubicadas en el enlace "API" de su cuenta.

Si utiliza una Aplicación que no cumple con los requisitos establecidos en el Acuerdo de usuario para desarrolladores, Yandex se reserva el derecho de limitar y/o denegar su acceso a la API.

También asume toda la responsabilidad y el riesgo de sufrir consecuencias adversas asociadas con la restricción y\\o prohibición del acceso de las Aplicaciones a la API por los motivos establecidos en el Acuerdo de usuario para desarrolladores.

6. Terceros.

En el caso de que utilice la API para gestionar campañas publicitarias de terceros en función de un contrato u otro acuerdo entre usted, debe comprender que todos los datos relacionados con las cuentas de dichos clientes y otra información relacionada con las campañas publicitarias de dichos clientes, realizadas utilizando su clave API se consideran confidenciales; No tiene derecho a utilizarlos usted mismo ni a transferirlos a terceros sin el consentimiento por escrito de sus propietarios.

Si proporciona acceso a la API a terceros (incluso creando para ellos una cuenta asociada con su cuenta) Usted es el único responsable de todas las acciones de dichos terceros como si fueran suyas.

7. Vigencia de este acuerdo.

Yandex se reserva el derecho de suspender este acuerdo con usted si no cumple con sus términos. Desde el momento de dicha suspensión, deberá dejar de utilizar la API.

8. Disposiciones finales.

Este Acuerdo y todas las relaciones relacionadas con el uso del Servicio y la API se rigen por las leyes de la Federación Rusa.

Todos los reclamos relacionados con el uso o la imposibilidad de usar la API dentro del Servicio deben enviarse a: [correo electrónico protegido].

Yandex puede cambiar el texto de este Acuerdo y/o cualquier otro término de uso del Servicio en cualquier momento sin notificar al Usuario. El texto actual de este Acuerdo está publicado en: .

_____________________________

Fecha de publicación 05/04/2019

Versión anterior del documento: .

Versión anterior del documento: .