Saltar al contenido principal
Lee la Biblioteca de anuncios de LinkedIn como JSON a través de la API asíncrona de tareas para ver qué anuncia tu competencia a los profesionales. ADS es un motor propio: envía taskType ADS con platform linkedin_ad_library, y action elige qué leer. Para elegir entre las bibliotecas de anuncios, consulta Bibliotecas de anuncios comparadas.
  • search (por defecto) lista anuncios por una palabra clave en query, por el nombre de un anunciante en advertiserName, por quién pagó en payer, o por una combinación. Cada anuncio incluye su anunciante, formato, título, texto y contenido multimedia, y la respuesta termina con un summary de los anuncios devueltos.
  • ad abre un anuncio: el anunciante, quién pagó, la página de destino y, donde la biblioteca lo publica, las fechas de emisión, las impresiones, los países que alcanzó y su segmentación.
La biblioteca no tiene búsqueda de anunciantes, así que action advertisers se rechaza con 400 VALIDATION_ERROR. Encuentra a un competidor con advertiserName en una búsqueda. Una búsqueda cuesta 0.5 créditos por cada 30 anuncios que devuelve. ad cuesta 0.5 créditos.

Solicitud

Envía la tarea y consulta GET /v1/async/task/{id} o recibe su webhook. Consulta Tareas asíncronas. La biblioteca limita la velocidad de lectura, así que una búsqueda de 120 anuncios tarda unos treinta segundos.

Analiza los anuncios de un competidor

Tres solicitudes cubren un análisis de la competencia:
  1. search con el nombre del competidor en advertiserName lista sus anuncios. advertiserName coincide con parte de un nombre, así que revisa advertiserName en cada anuncio. Añade query para acotar los anuncios a un tema, y sortBy oldest para empezar por los anuncios más antiguos.
  2. ad con el libraryId de un anuncio devuelve quién pagó, la página de destino y, en los anuncios mostrados en la UE, las fechas de emisión, las impresiones y la segmentación.
  3. search con payer lista los anuncios que pagó una agencia o empresa, sea cual sea la página que los publica.

Parámetros

  • action: search (por defecto) o ad.
  • query: Una palabra clave en el texto del anuncio. search necesita query, advertiserName o payer.
  • advertiserName: Un nombre, que coincide con parte del nombre del anunciante, como samsung.
  • payer: El nombre de quien pagó el anuncio, que coincide con parte del nombre, como Starcom.
  • libraryId: El ID numérico de un anuncio, como 1638962914. ad lo requiere.
  • country: Dónde se mostraron los anuncios, como código de país de dos letras, o ALL para todos los países (por defecto).
  • startDate, endDate: YYYY-MM-DD, enviados juntos, dentro del último año. Conserva los anuncios mostrados entre los dos días.
  • sortBy: newest (por defecto) o oldest.
  • limit: De 1 a 120 anuncios. Por defecto 30.
  • cursor: El nextCursor de una respuesta anterior, para leer los anuncios siguientes.
search lee todos los campos anteriores excepto libraryId, y ad lee solo libraryId. Un filtro de la Biblioteca de anuncios de Meta (pageId, pageIds, activeStatus, searchType, adType, mediaType, publisherPlatforms o contentLanguages), un valor que la biblioteca no puede buscar o un campo que la acción no lee se rechaza con 400 VALIDATION_ERROR, y details indica el campo.

Leer más anuncios

Una respuesta con más anuncios por leer incluye nextCursor. Envíalo como cursor con la misma búsqueda para recibir los anuncios siguientes, de nuevo hasta limit. nextCursor es null cuando la biblioteca no tiene más. Un cursor solo funciona con la búsqueda que lo devolvió: un query, advertiserName, payer, country, rango de fechas o sortBy distinto se rechaza con 400 VALIDATION_ERROR, mientras que limit puede cambiar.

Respuesta de búsqueda

  • La respuesta devuelve platform, action, country, query, advertiserName, payer, sortBy y las fechas recibidas. returnedCount cuenta los anuncios de ads, hasMore es true cuando la biblioteca tiene más, que nextCursor lee, y libraryUrl abre la misma búsqueda en la Biblioteca de anuncios. totalCount es null, porque la biblioteca no da un recuento.
  • Cada anuncio es una tarjeta: position, libraryId, libraryUrl, advertiserName, advertiserLogoUrl, creativeType (como SPONSORED_STATUS_UPDATE o SPONSORED_VIDEO), format, title, body, images y videos (el póster del vídeo en previewUrl), y platforms (LINKEDIN). format es IMAGE, VIDEO, CAROUSEL, DOCUMENT, ARTICLE, MESSAGE, JOB, SPOTLIGHT o FOLLOW_COMPANY.
  • Los anuncios de mensaje y los anuncios Thought Leader incluyen member, el remitente del mensaje o el miembro cuya publicación promueve el anuncio, con name y url; ad lo devuelve con la misma forma. En los demás anuncios, member es null.
  • Una tarjeta incluye los primeros 120 caracteres del texto, y bodyTruncated es true cuando el texto es más largo. ad devuelve el texto completo.
  • advertiserId, payer, startDate, endDate, activeDays, linkUrl, landingDomain, impressions, targeting, ctaText y utm son null en una tarjeta. ad los rellena cuando la biblioteca los tiene. isActive es null, porque la biblioteca no indica si un anuncio sigue en emisión.
  • summary cuenta los anuncios de esta respuesta: ads, advertisers (los 10 con más anuncios: advertiserName, ads), formats y platforms. Sus campos de fecha (oldestStartDate, newestStartDate, medianActiveDays, launchesByWeek y longestRunning) quedan vacíos o en null, porque las tarjetas no incluyen fechas.
  • Una búsqueda sin anuncios coincidentes se completa con ads vacío y un summary de 0 anuncios.

Qué conserva la biblioteca

  • El creativo, el anunciante y el pagador de cada anuncio están disponibles para todos los países.
  • Las fechas de emisión, el rango de impresiones, el porcentaje de impresiones por país y la segmentación solo están disponibles para los anuncios mostrados en la UE.
  • La biblioteca conserva los anuncios durante unos 12 meses, y su filtro de fechas solo acepta el último año.

Abrir un anuncio

action ad abre el anuncio con el libraryId que envíes, obtenido de una búsqueda o de la dirección de la Biblioteca de anuncios /ad-library/detail/<libraryId>.
  • ad tiene los campos de una tarjeta de búsqueda con el texto completo, más advertiserId, advertiserUrl, advertiserType (company o person), payer (quién pagó el anuncio), linkUrl, landingDomain, ctaText, startDate, endDate, activeDays, impressions, targeting y reachedCountries.
  • impressions es el rango que publica la biblioteca (min, max). targeting lista los idiomas y ubicaciones que el anunciante incluyó o excluyó (language, location) y los parámetros de segmentación (parameters: parameter, targeted, excluded). Las fechas, impressions, targeting y reachedCountries son null en un anuncio que no se mostró en la UE, como el anuncio de Adobe 1698237666. El pagador y el anunciante aparecen en todos los anuncios.
  • videos lista cada vídeo con url (el archivo con la tasa de bits más alta), files (cada mp4: url, type, bitrate) y previewUrl. Un anuncio de carrusel añade cards (title, imageUrl) y un anuncio de documento añade document (su título, número de páginas y portadas de las páginas).
  • advertiser es la página que hay detrás del anuncio: advertiserId, advertiserName, url, type y logoUrl.
  • transparency es null en un anuncio no mostrado en la UE. En un anuncio mostrado en la UE contiene impressions, impressionsText (el texto de la biblioteca, como 50k-100k) y reachByCountry, el porcentaje de las impresiones en cada país (country, countryCode, share, shareText), también fuera de la UE.
  • variants lista las otras versiones del anuncio cuando la biblioteca muestra más de una, y es null en caso contrario.
  • Las URL del contenido multimedia de los creativos siguen abiertas durante años. Las URL de las tarjetas de un carrusel caducan tras una semana aproximadamente, y los logotipos de los anunciantes tras unas dos semanas y media. Guarda los archivos que necesites.
  • Un libraryId para el que la biblioteca no tiene ningún anuncio falla con PAGE_UNAVAILABLE.

Precio

Una búsqueda reserva 0.5 créditos por cada 30 anuncios que pide su limit, y cobra 0.5 créditos por cada 30 anuncios que devuelve, con un mínimo de 0.5 créditos. La búsqueda predeterminada de 30 anuncios cuesta 0.5 créditos, y una búsqueda con limit 120 reserva 2 créditos. ad cuesta 0.5 créditos. Solo se cobran las solicitudes completadas.

Relacionado