Zum Hauptinhalt springen
Lesen Sie die LinkedIn-Werbebibliothek über die asynchrone Task-API als JSON, um zu sehen, wofür Ihre Wettbewerber bei Fachleuten werben. ADS ist eine eigene Engine: Senden Sie taskType ADS mit platform linkedin_ad_library, und action wählt, was gelesen wird. Zur Auswahl zwischen den Werbebibliotheken siehe Werbebibliotheken im Vergleich.
  • search (Standard) listet Anzeigen nach einem Stichwort in query, nach dem Namen eines Werbetreibenden in advertiserName, nach dem Zahler in payer oder nach einer Kombination auf. Jede Anzeige enthält ihren Werbetreibenden, ihr Format, ihren Titel, ihren Text und ihre Medien, und die Antwort endet mit einer summary der gelieferten Anzeigen.
  • ad öffnet eine Anzeige: den Werbetreibenden, den Zahler, die Zielseite und, soweit die Bibliothek sie veröffentlicht, die Laufzeitdaten, die Impressionen, die erreichten Länder und das Targeting.
Die Bibliothek bietet keine Suche nach Werbetreibenden, daher wird action advertisers mit 400 VALIDATION_ERROR abgelehnt. Finden Sie einen Wettbewerber mit advertiserName in einer Suche. Eine Suche kostet 0.5 Credits je 30 Anzeigen, die sie liefert. ad kostet 0.5 Credits.

Anfrage

Senden Sie den Task ab und fragen Sie dann GET /v1/async/task/{id} ab oder empfangen Sie den Webhook. Siehe Asynchrone Tasks. Die Bibliothek begrenzt die Lesegeschwindigkeit, daher dauert eine Suche nach 120 Anzeigen etwa eine halbe Minute.

Anzeigen eines Wettbewerbers analysieren

Drei Anfragen decken eine Wettbewerbsanalyse ab:
  1. search mit dem Namen des Wettbewerbers in advertiserName listet seine Anzeigen auf. advertiserName passt auf einen Teil eines Namens, prüfen Sie daher advertiserName bei jeder Anzeige. Ergänzen Sie query, um die Anzeigen auf ein Thema einzugrenzen, und sortBy oldest, um bei den ältesten Anzeigen zu beginnen.
  2. ad mit der libraryId einer Anzeige liefert, wer bezahlt hat, die Zielseite und, bei in der EU ausgespielten Anzeigen, die Laufzeitdaten, die Impressionen und das Targeting.
  3. search mit payer listet die Anzeigen auf, die eine Agentur oder ein Unternehmen bezahlt hat, unabhängig davon, welche Seite sie schaltet.

Parameter

  • action: search (Standard) oder ad.
  • query: Ein Stichwort im Text der Anzeige. search braucht query, advertiserName oder payer.
  • advertiserName: Ein Name, der auf einen Teil des Namens des Werbetreibenden passt, etwa samsung.
  • payer: Der Name dessen, der die Anzeige bezahlt hat, passend auf einen Teil des Namens, etwa Starcom.
  • libraryId: Die numerische ID einer Anzeige, etwa 1638962914. ad verlangt sie.
  • country: Wo die Anzeigen ausgespielt wurden, als zweistelliger Ländercode, oder ALL für alle Länder (Standard).
  • startDate, endDate: YYYY-MM-DD, gemeinsam zu senden, innerhalb des letzten Jahres. Behält die Anzeigen, die zwischen den beiden Tagen ausgespielt wurden.
  • sortBy: newest (Standard) oder oldest.
  • limit: 1 bis 120 Anzeigen. Standard 30.
  • cursor: Der nextCursor einer früheren Antwort, um die darauffolgenden Anzeigen zu lesen.
search liest alle Felder oben außer libraryId, und ad liest nur libraryId. Ein Filter der Meta-Werbebibliothek (pageId, pageIds, activeStatus, searchType, adType, mediaType, publisherPlatforms oder contentLanguages), ein Wert, den die Bibliothek nicht durchsuchen kann, oder ein Feld, das die Aktion nicht liest, wird mit 400 VALIDATION_ERROR abgelehnt, und details nennt das Feld.

Weitere Anzeigen lesen

Eine Antwort mit weiteren zu lesenden Anzeigen enthält nextCursor. Senden Sie ihn mit derselben Suche als cursor, um die nächsten Anzeigen zu erhalten, wieder bis zu limit. nextCursor ist null, sobald die Bibliothek keine weiteren hat. Ein Cursor funktioniert nur mit der Suche, die ihn geliefert hat: Eine andere query, advertiserName, payer, country, ein anderer Datumsbereich oder sortBy wird mit 400 VALIDATION_ERROR abgelehnt, während sich limit ändern darf.

Such-Antwort

  • Die Antwort gibt platform, action, country, query, advertiserName, payer, sortBy und die erhaltenen Daten zurück. returnedCount zählt die Anzeigen in ads, hasMore ist true, wenn die Bibliothek mehr hat, die nextCursor liest, und libraryUrl öffnet dieselbe Suche in der Werbebibliothek. totalCount ist null, weil die Bibliothek keine Anzahl liefert.
  • Jede Anzeige ist eine Karte: position, libraryId, libraryUrl, advertiserName, advertiserLogoUrl, creativeType (etwa SPONSORED_STATUS_UPDATE oder SPONSORED_VIDEO), format, title, body, images und videos (das Posterbild des Videos in previewUrl) sowie platforms (LINKEDIN). format ist IMAGE, VIDEO, CAROUSEL, DOCUMENT, ARTICLE, MESSAGE, JOB, SPOTLIGHT oder FOLLOW_COMPANY.
  • Nachrichtenanzeigen und Thought-Leader-Anzeigen enthalten member, den Absender der Nachricht oder das Mitglied, dessen Beitrag die Anzeige bewirbt, mit name und url; ad liefert es in derselben Form. Bei anderen Anzeigen ist member null.
  • Eine Karte enthält die ersten 120 Zeichen des Textes, und bodyTruncated ist true, wenn der Text länger ist. ad liefert den vollständigen Text.
  • advertiserId, payer, startDate, endDate, activeDays, linkUrl, landingDomain, impressions, targeting, ctaText und utm sind auf einer Karte null. ad füllt sie, wo die Bibliothek sie hat. isActive ist null, weil die Bibliothek nicht angibt, ob eine Anzeige noch läuft.
  • summary zählt die Anzeigen dieser Antwort: ads, advertisers (die 10 mit den meisten Anzeigen: advertiserName, ads), formats und platforms. Die Datumsfelder (oldestStartDate, newestStartDate, medianActiveDays, launchesByWeek und longestRunning) bleiben leer oder null, weil Karten keine Daten enthalten.
  • Eine Suche ohne passende Anzeigen endet mit leerem ads und einer summary mit 0 Anzeigen.

Was die Bibliothek aufbewahrt

  • Creative, Werbetreibender und Zahler jeder Anzeige sind für jedes Land verfügbar.
  • Die Laufzeitdaten, die Impressionen-Spanne, der Anteil der Impressionen nach Land und das Targeting sind nur für in der EU ausgespielte Anzeigen verfügbar.
  • Die Bibliothek bewahrt Anzeigen etwa 12 Monate auf, und ihr Datumsfilter nimmt nur das letzte Jahr an.

Eine Anzeige öffnen

action ad öffnet die Anzeige mit der libraryId, die Sie senden, aus einer Suche oder aus der Adresse der Werbebibliothek /ad-library/detail/<libraryId>.
  • ad enthält die Felder einer Suchkarte mit dem vollständigen Text sowie advertiserId, advertiserUrl, advertiserType (company oder person), payer (wer die Anzeige bezahlt hat), linkUrl, landingDomain, ctaText, startDate, endDate, activeDays, impressions, targeting und reachedCountries.
  • impressions ist die Spanne, die die Bibliothek veröffentlicht (min, max). targeting listet die Sprachen und Orte, die der Werbetreibende ein- oder ausgeschlossen hat (language, location), und die Targeting-Parameter (parameters: parameter, targeted, excluded). Die Daten, impressions, targeting und reachedCountries sind null bei einer Anzeige, die nicht in der EU ausgespielt wurde, wie der Adobe-Anzeige 1698237666. Zahler und Werbetreibender sind bei jeder Anzeige vorhanden.
  • videos listet jedes Video mit url (die Datei mit der höchsten Bitrate), files (jedes mp4: url, type, bitrate) und previewUrl. Eine Karussell-Anzeige ergänzt cards (title, imageUrl), und eine Dokument-Anzeige ergänzt document (ihren Titel, die Seitenzahl und die Seitencover).
  • advertiser ist die Seite hinter der Anzeige: advertiserId, advertiserName, url, type und logoUrl.
  • transparency ist null bei einer nicht in der EU ausgespielten Anzeige. Bei einer in der EU ausgespielten Anzeige enthält es impressions, impressionsText (den Text der Bibliothek, etwa 50k-100k) und reachByCountry, den Anteil der Impressionen in jedem Land (country, countryCode, share, shareText), auch außerhalb der EU.
  • variants listet die anderen Versionen der Anzeige, wo die Bibliothek mehr als eine zeigt, und ist sonst null.
  • Medien-URLs der Creatives bleiben jahrelang offen. Die URLs der Karussell-Karten laufen nach etwa einer Woche ab, Logos von Werbetreibenden nach etwa zweieinhalb Wochen. Speichern Sie die Dateien, die Sie brauchen.
  • Eine libraryId, zu der die Bibliothek keine Anzeige hat, schlägt mit PAGE_UNAVAILABLE fehl.

Preis

Eine Suche reserviert 0.5 Credits je 30 Anzeigen, die ihr limit verlangt, und berechnet 0.5 Credits je 30 gelieferte Anzeigen, mindestens 0.5 Credits. Die Standardsuche mit 30 Anzeigen kostet 0.5 Credits, und eine Suche mit limit 120 reserviert 2 Credits. ad kostet 0.5 Credits. Nur abgeschlossene Anfragen werden berechnet.

Siehe auch