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 inquery, nach dem Namen eines Werbetreibenden inadvertiserName, nach dem Zahler inpayeroder nach einer Kombination auf. Jede Anzeige enthält ihren Werbetreibenden, ihr Format, ihren Titel, ihren Text und ihre Medien, und die Antwort endet mit einersummaryder 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.
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
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:searchmit dem Namen des Wettbewerbers inadvertiserNamelistet seine Anzeigen auf.advertiserNamepasst auf einen Teil eines Namens, prüfen Sie daheradvertiserNamebei jeder Anzeige. Ergänzen Siequery, um die Anzeigen auf ein Thema einzugrenzen, undsortByoldest, um bei den ältesten Anzeigen zu beginnen.admit derlibraryIdeiner Anzeige liefert, wer bezahlt hat, die Zielseite und, bei in der EU ausgespielten Anzeigen, die Laufzeitdaten, die Impressionen und das Targeting.searchmitpayerlistet die Anzeigen auf, die eine Agentur oder ein Unternehmen bezahlt hat, unabhängig davon, welche Seite sie schaltet.
Parameter
action:search(Standard) oderad.query: Ein Stichwort im Text der Anzeige.searchbrauchtquery,advertiserNameoderpayer.advertiserName: Ein Name, der auf einen Teil des Namens des Werbetreibenden passt, etwasamsung.payer: Der Name dessen, der die Anzeige bezahlt hat, passend auf einen Teil des Namens, etwaStarcom.libraryId: Die numerische ID einer Anzeige, etwa1638962914.adverlangt sie.country: Wo die Anzeigen ausgespielt wurden, als zweistelliger Ländercode, oderALLfü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) oderoldest.limit: 1 bis 120 Anzeigen. Standard 30.cursor: DernextCursoreiner 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ältnextCursor. 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,sortByund die erhaltenen Daten zurück.returnedCountzählt die Anzeigen inads,hasMoreisttrue, wenn die Bibliothek mehr hat, dienextCursorliest, undlibraryUrlöffnet dieselbe Suche in der Werbebibliothek.totalCountistnull, weil die Bibliothek keine Anzahl liefert. - Jede Anzeige ist eine Karte:
position,libraryId,libraryUrl,advertiserName,advertiserLogoUrl,creativeType(etwaSPONSORED_STATUS_UPDATEoderSPONSORED_VIDEO),format,title,body,imagesundvideos(das Posterbild des Videos inpreviewUrl) sowieplatforms(LINKEDIN).formatistIMAGE,VIDEO,CAROUSEL,DOCUMENT,ARTICLE,MESSAGE,JOB,SPOTLIGHToderFOLLOW_COMPANY. - Nachrichtenanzeigen und Thought-Leader-Anzeigen enthalten
member, den Absender der Nachricht oder das Mitglied, dessen Beitrag die Anzeige bewirbt, mitnameundurl;adliefert es in derselben Form. Bei anderen Anzeigen istmembernull. - Eine Karte enthält die ersten 120 Zeichen des Textes, und
bodyTruncatedisttrue, wenn der Text länger ist.adliefert den vollständigen Text. advertiserId,payer,startDate,endDate,activeDays,linkUrl,landingDomain,impressions,targeting,ctaTextundutmsind auf einer Kartenull.adfüllt sie, wo die Bibliothek sie hat.isActiveistnull, weil die Bibliothek nicht angibt, ob eine Anzeige noch läuft.summaryzählt die Anzeigen dieser Antwort:ads,advertisers(die 10 mit den meisten Anzeigen:advertiserName,ads),formatsundplatforms. Die Datumsfelder (oldestStartDate,newestStartDate,medianActiveDays,launchesByWeekundlongestRunning) bleiben leer odernull, weil Karten keine Daten enthalten.- Eine Suche ohne passende Anzeigen endet mit leerem
adsund einersummarymit0Anzeigen.
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>.
adenthält die Felder einer Suchkarte mit dem vollständigen Text sowieadvertiserId,advertiserUrl,advertiserType(companyoderperson),payer(wer die Anzeige bezahlt hat),linkUrl,landingDomain,ctaText,startDate,endDate,activeDays,impressions,targetingundreachedCountries.impressionsist die Spanne, die die Bibliothek veröffentlicht (min,max).targetinglistet die Sprachen und Orte, die der Werbetreibende ein- oder ausgeschlossen hat (language,location), und die Targeting-Parameter (parameters:parameter,targeted,excluded). Die Daten,impressions,targetingundreachedCountriessindnullbei einer Anzeige, die nicht in der EU ausgespielt wurde, wie der Adobe-Anzeige1698237666. Zahler und Werbetreibender sind bei jeder Anzeige vorhanden.videoslistet jedes Video miturl(die Datei mit der höchsten Bitrate),files(jedes mp4:url,type,bitrate) undpreviewUrl. Eine Karussell-Anzeige ergänztcards(title,imageUrl), und eine Dokument-Anzeige ergänztdocument(ihren Titel, die Seitenzahl und die Seitencover).advertiserist die Seite hinter der Anzeige:advertiserId,advertiserName,url,typeundlogoUrl.transparencyistnullbei einer nicht in der EU ausgespielten Anzeige. Bei einer in der EU ausgespielten Anzeige enthält esimpressions,impressionsText(den Text der Bibliothek, etwa50k-100k) undreachByCountry, den Anteil der Impressionen in jedem Land (country,countryCode,share,shareText), auch außerhalb der EU.variantslistet die anderen Versionen der Anzeige, wo die Bibliothek mehr als eine zeigt, und ist sonstnull.- 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 mitPAGE_UNAVAILABLEfehl.
Preis
Eine Suche reserviert 0.5 Credits je 30 Anzeigen, die ihrlimit 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.