Comenzar

Este documento está dirigido a desarrolladores que deseen usar la API de AdSense Management para obtener información sobre su cuenta de AdSense. En este documento, se supone que estás familiarizado con los conceptos de programación web y los formatos de datos web.

Antes de comenzar

Obtén una cuenta de AdSense

Accede a tu cuenta de AdSense o accede a ella para comenzar.

Familiarízate con AdSense

Si no conoces los conceptos de AdSense, lee la información introductoria sobre AdSense y experimenta con la IU de AdSense antes de comenzar a programar.

Elige tu biblioteca cliente

En la página Muestras y bibliotecas cliente, encontrarás información sobre las bibliotecas y muestras disponibles. Haz clic en la pestaña del idioma que elegiste y sigue los vínculos para descargar la fuente. Las bibliotecas cliente controlan lo siguiente por ti:

  • authentication
  • descubrimiento de servicios
  • compilar las solicitudes a la API
  • análisis de respuestas

Lee las instrucciones para instalar y configurar la biblioteca cliente elegida, que por lo general se encuentra en el archivo README del directorio raíz del repositorio.

Si tu implementación tiene necesidades especiales, como usar un lenguaje no compatible, puedes realizar solicitudes directas a la API en lugar de usar una biblioteca cliente.

Registra tu aplicación

Para utilizar la API de AdSense Management, debes registrar la aplicación que estés desarrollando. Para ello, debes crear un proyecto y generar un ID de cliente.

Registra tu app

Edita los archivos de configuración de tu proyecto de biblioteca cliente con las credenciales nuevas que acabas de crear. Consulta la documentación de la biblioteca cliente para obtener más detalles.

Nota: La Cuenta de Google que se use para el registro debe ser tu cuenta de desarrollador, es decir, la cuenta que deseas que los usuarios de tu aplicación vean como su desarrollador. Esta cuenta no necesita estar vinculada a un acceso de AdSense, ya que los usuarios otorgarán acceso a sus propias cuentas mientras usan la aplicación.

Instructivo de inicio rápido

Sigue los pasos a continuación para realizar tus primeras solicitudes. Ten en cuenta que estos pasos pueden variar un poco según la biblioteca o el idioma que uses:

  1. Usa la muestra adecuada para obtener una lista de clientes publicitarios de una cuenta de AdSense. Esta solicitud inicia un proceso único en el que el usuario de AdSense autentica y autoriza tu proyecto.

    Los clientes de anuncios representan una asociación entre una cuenta de AdSense y un producto de AdSense, como los anuncios de contenido o los anuncios de búsqueda. Una cuenta de AdSense puede tener uno o varios clientes de anuncios.

    1. En el caso de las aplicaciones web, se redireccionará a los usuarios a un sitio en el que pueden optar por otorgar acceso. Una vez autorizado, se lo redireccionará a la URL de devolución de llamada definida en la consola de APIs.
    2. Las aplicaciones instaladas funcionan de manera similar. La biblioteca cliente intentará abrir una ventana del navegador y usar un código de autorización. En el caso de las aplicaciones para Android, iOS y Chrome, este método es específico de la plataforma.
  2. Usa el explorador de API para reports.generate a fin de solicitar el siguiente informe:
    • date_range: YESTERDAY
    • dimensions: DATE
    • metrics: ESTIMATED_EARNINGS

    Los informes te brindan información sobre lo que estás ganando y lo que afecta a esos ingresos. Se pueden publicar en una cuenta completa o en un subconjunto de unidades de anuncios mediante el uso de canales.

  3. Intenta solicitar el mismo informe desde tu aplicación.
  4. Puedes filtrar los informes por unidades de anuncios. Obtén la lista de unidades de anuncios con adunits.list. Ten en cuenta que se necesita un ID de cliente de anuncios (obtenlo desde el paso 1). Después de elegir una unidad de anuncios, usa su ID en el parámetro filter para reports.generate:

    Las unidades de anuncios son marcadores de posición para anuncios configurados por el usuario que definen algunas propiedades de los anuncios que se muestran (como el tamaño y la forma).

    • date_range: YESTERDAY
    • dimensions: DATE
    • metrics: ESTIMATED_EARNINGS
    • filter: AD_UNIT_ID==ca-pub-123456789:987654321
  5. Intenta filtrar por canales personalizados o de URL, o bien mezcla varios filtros.

    Los canales son herramientas que te permiten hacer un seguimiento del rendimiento de un subconjunto de tus unidades de anuncios. Existen dos tipos de canales: de URL y personalizados. El primero te permite hacer un seguimiento del rendimiento en una página o un dominio específicos, mientras que el segundo te ayuda a hacer un seguimiento del rendimiento en grupos de unidades de anuncios específicos seleccionados por el usuario.

Si deseas comenzar la implementación, explora el resto de las llamadas y los recursos disponibles en la documentación de referencia.