Adyntel integration

Adyntel is an ad intelligence tool for finding and analyzing the ads that companies run on major advertising platforms. With this integration, you can build a table of ads matching a keyword, or take companies you already have and pull back the ad copy, creative, landing pages, and campaign dates behind their live campaigns.

Creating a table with Adyntel

1. In a workbook, click + Add at the bottom.
2. Search for Adyntel and select from the results.
3. In the modal, you will be asked to Select Adyntel account.
   • If you have your own account, click + Add account and go through authentication. Otherwise, use the Clay provided key.

Source Find Meta ads by keyword with Adyntel

Search the Meta ad library for ads matching a keyword and import them along with the companies running them.

Inputs

• Keywords: One or more keywords to search the ad library for, for example webinar or ai sdr. Each keyword runs its own search, and matching ads are combined and deduplicated. You can include up to 20 keywords per import.
• Country (optional): Limit results to ads shown in one country. If this is not added, the search covers all countries.
• Limit (optional): The maximum number of ads to import. Defaults to 100, and the maximum is 1,000.

Source Find professional social media ads by keyword

Search for ads matching a keyword and import them along with the companies running them, optionally filtered by country or date range.

Inputs

• Keywords: One or more keywords to search the ad library for, for example webinar or ai sdr. Each keyword runs its own search, and matching ads are combined and deduplicated. You can include up to 20 keywords per import.
• Country (optional): Limit results to ads shown in one country. If this is not added, the search covers all countries.
• Date range (optional): Filter returned ads by the date they ran — Last 30 days, Current month, Current year, Last year, or Custom date range. If this is not added, the search covers ads from any date.
• Start date (optional): The start of the custom date range. Only used when Date range is set to Custom date range.
• End date (optional): The end of the custom date range, which has to be before today. A custom range can span up to 364 days. Only used when Date range is set to Custom date range.
• Limit (optional): The maximum number of ads to import. Defaults to 100, and the maximum is 1,000.

Enriching data with Adyntel

1. While in a Clay table, click Add enrichment and search for Adyntel.
2. Under Integrations, select one of the Adyntel options.
   • If you have your own account, click + Add account and go through authentication. Otherwise, use the Clay provided key.

Action Check for Meta ads

View Facebook and Instagram ads that a company is currently running, including ad copy, creative, advertiser details, and landing pages.

Inputs

Required:

• Facebook page URL: The Facebook page URL of the company to match, for example https://www.facebook.com/clay.com. (Required if company domain is not provided.)
• Company domain: The company domain associated with the company to match, for example clay.com. (Required if Facebook page URL is not provided.)

Optional:

• Country: Filter for ads shown in a specific country. If this is not added, ads from all countries are returned.
• Media type: Filter results for a specific type of media — Image, Meme, Image and Meme, Video, or All. Defaults to All.
• Active status: Filter the ad library by Active, Inactive, or Active and Inactive. Defaults to active ads only.
• Ad languages: Filter for ads written in one or more languages. An ad matching any selected language is returned. If this is not added, ads in all languages are returned.
• Detect UGC for video ads: Check each video ad for whether it reads as user-generated content, and add an Is UGC video flag to the video creative. This only applies when Media type is set to Video.

Outputs

• Number of ads: The total number of ads found for the company.
• Count landing pages: How many distinct landing pages the ads point to.
• Unique landing pages: The list of those landing page URLs.
• Page ID: The Facebook page the ads belong to.
• Platform: The platforms the ads ran on.
• Media types, Active status, Languages, and Country code: The filters this search ran with.
• Is result complete: Whether the full set of matching ads was returned.
• Continuation token: Token for paging through further results.
• Results: One entry per ad, containing:
  • Ad archive ID, Collation ID, Page ID, Page name, and Entity type
  • Is active, Start date, End date, and Total active time
  • Publisher platform, Categories, and Ad library URL
  • Snapshot: the creative itself — Ad text, Title, Caption, CTA text, CTA type, Display format, Link URL, Link description, Page profile URL, Page profile picture URL, and Page like count
  • Cards, Images, and Videos within the snapshot, each carrying the image and video URLs for that creative. Entries in Cards also include Is UGC video when Detect UGC for video ads is turned on.

Action Check for professional social media ads

Uncover and analyze professional social media ad campaigns run by companies based on their website domains or company page IDs.

Inputs

Required:

• Company page ID: The numeric ID of the company's page on professional social media (e.g., 15564). Using the page ID is more accurate than using the domain. (Required if company domain is not provided.)
• Company domain: The company domain to find ads for (e.g., clay.com). (Required if company page ID is not provided.)

Optional:

• Date range: Filter returned ads by the date they ran — Last 30 days, Current month, Current year, Last year, or Custom date range. If this is not added, the search covers ads from any date.
• Start date: The start of the custom date range. Only used when Date range is set to Custom date range.
• End date: The end of the custom date range. Only used when Date range is set to Custom date range.

Outputs

• Total ads: The total number of ads found for the company.
• Page ID: The company page the ads belong to.
• Is last page: Whether this response is the final page of results.
• Continuation token: Token for paging through further results.
• Ads: One entry per ad, containing:
  • Creative type, Ad ID, and Type
  • Advertiser: the advertiser's Name, Logo URL, and Promoted flag
  • Commentary: the ad copy
  • Image: the creative's URL and Alt text
  • Headline: the ad's Title and Description
  • View details link: a URL to view the ad in the ad library

Action Check for Google ads

Retrieve and analyze detailed data on a company's Google Ads campaigns to understand their advertising strategies and campaign effectiveness.

Inputs

Required:

• Company domain: The company domain associated with the company to match, for example clay.com.

Optional:

• Media type: Filter results for a specific type of media — Text, Image, Video, or All. Defaults to All.
• Country: Filter results to the ads shown in one country. If this is not added, ads shown anywhere in the world are returned.
• Extract ad copy: Pull the full text out of each ad creative. This changes which output field the ads land in — see the outputs below.

Outputs

• Total ad count: The number of ads found.
• Country code: The country the search covered.
• Continuation token: Token for paging through further results.
• Ads: One entry per ad, containing Advertiser ID, Advertiser name, Creative ID, Format, Original URL, Start, Last seen, and Variants. Each entry in Variants carries the creative's Content, Height, and Width.
• Processed ads: Returned in place of Ads when Extract ad copy is turned on. Each entry carries Advertiser ID, Advertiser name, Creative ID, Original URL, Display URL, Format, Start, Last seen, and Extracted ad copy.
• Processing summary: Also returned when Extract ad copy is turned on, with Total ads received, Text ads found, Successfully processed, and Failed processing.

Run settings

• Auto-update
• Only run if: The enrichment will only run if conditions are met. (Learn more about conditional formulas here!)