Comenzar

Este documento está dirigido a desarrolladores que desean 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

Regístrate o accede a tu cuenta de AdSense para comenzar.

Familiarízate con AdSense

Si no estás familiarizado con los conceptos de AdSense, lee la información introductoria de AdSense y experimenta con la IU de AdSense antes de comenzar a programar.

Elige tu biblioteca cliente

En la página de muestras y bibliotecas cliente, encontrarás información sobre las bibliotecas y las 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
  • compila las solicitudes a la API
  • análisis de respuestas

Lee las instrucciones para instalar y configurar la biblioteca cliente que elegiste, que por lo general se encuentra en el archivo README en el 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 creando un proyecto y generando un ID de cliente.

Registra tu app

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

Nota: La Cuenta de Google que uses para el registro debe ser tu cuenta de desarrollador, es decir, la cuenta que quieres que los usuarios de tu aplicación vean como el desarrollador de la aplicación. No es necesario que esta cuenta esté vinculada a un acceso de AdSense, ya que los usuarios otorgarán acceso a sus propias cuentas cuando usen la aplicación.

Instructivo de inicio rápido

Sigue los pasos que se indican a continuación para realizar tus primeras solicitudes. Ten en cuenta que estos pasos pueden variar un poco según la biblioteca o el lenguaje 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 publicitarios 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 podrán elegir otorgar acceso. Una vez que se haya autorizado, se los redireccionará a la URL de devolución de llamada definida en la Consola de APIs de Google.
    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 las aplicaciones para Android, iOS y Chrome, este método es específico de la plataforma.
  2. Usa el Explorador de APIs de Google para reports.generate para solicitar el siguiente informe:
    • date_range: YESTERDAY
    • dimensions: DATE
    • metrics: ESTIMATED_EARNINGS

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

  3. Intenta solicitar el mismo informe de 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 (puedes obtenerlo en el paso 1). Después de elegir una unidad de anuncios, usa su ID en el parámetro filter de reports.generate:

    Las unidades de anuncios son marcadores de posición configurados por el usuario para los anuncios, 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. Filtra por canales personalizados o de URL, o 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: personalizados y de URL. La primera opción te permite hacer un seguimiento del rendimiento en una página o un dominio específicos, mientras que la segunda te ayuda a hacer un seguimiento del rendimiento en grupos de unidades de anuncios seleccionados por el usuario.

Ya puedes comenzar la implementación; para ello, explora el resto de las llamadas y los recursos disponibles en la documentación de referencia.