Equip GPTs with the ability to retrieve real-time reporting data from Google Ads, Facebook Ads, Instagram Insights, Google Analytics, and more.

The list of workspaces created by the user on adzviser.com/main. A workspace can include multiple data sources

The list of data sources that the workspace is connected. The name can be an account name and type can be Google Ads/Facebook Ads/Bing Ads

data_connections_accounts

name

getWorkspaceResponse

Contains details about queried data source, metrics, breakdowns, time ranges and time granularity, etc.

This object contains API-specific requests for retrieving data from various data sources. Only include requests relevant to the user's query. For instance, if the user requests 'cost on Google ads last month,' include only the `google_ads_request` with the appropriate metrics and breakdowns. Do not include irrelevant or unused requests in this object. Depends on from which data source the user asks for data, call the corresponding APIs defined above to get metrics and breakdowns, if exist. For example, if the user asks for "cost on Google ads last month", then call getGoogleAdsMetricsList and getGoogleAdsBreakdownsList to retrieve the latest up-to-date info about how to compose a google_ads_request. A metric is a quantitative measurement. It represents data that can be measured and expressed in numbers. Metrics are used to track performance or behavior. Examples include clicks, impressions, conversions, revenue, etc. A breakdown is a qualitative attribute or descriptor. It provides context for metrics by categorizing or segmenting them. Breakdowns are text. Examples include country, channel, campaign name, etc. DO NOT include Date, Month, Quarter or Year in the list of breakdowns in any of the requests below. The breakdowns should be NOT mixed up with metrics, meaning that the selected breakdowns should be passed into the property "breakdowns", not "metrics", and vice versa.

A request that contains details of demand for Bing Ads data.

A request that contains details of demand for Facebook Ads data.

A request that contains details of demand for Facebook Page insights data.

A request that contains details of demand for Facebook Post insights data.

A request that contains details of demand for Google Analytics 4 data.

DO NOT come up with metrics and breakdowns on your own. You MUST call API getGoogleAdsMetricsAndBreakdownsList to be better informed prior of composing a google_ads_request.

A request that contains details of demand for Google My Business (aka Business Profile) data.

A request that contains details of demand for Google Search Console data.

A request that contains details of demand for Instagram Post insights data.

A request that contains details of demand for Instagram profile insight data.

A request that contains details of demand for Klaviyo data.

A request that contains details of demand for LinkedIn Ads data.

A request that contains details of demand for LinkedIn Company Page data.

A request that contains details of demand for Mailchimp data.

A request that contains details of demand for Merchant Center data.

A request that contains details of demand for Pinterest Ads data.

A request that contains details of demand for Shopify data.

A request that contains details of demand for Snapchat Ads data.

A request that contains details of demand for TikTok Ads data.

A request that contains details of demand for WooCommerce data.

assorted_requests

A list of date ranges requested from the user. They needs to be calculated seperately with Code Interpreter and Python every single time for accuracy. For example, if the user requests "Google Ads search impression share in May and August", then this array should be [["2024-05-01", "2024-05-31"], ["2024-08-01", "2024-08-31"]].

A 2-element array. The first represents the start date and the second the end date. Both are in YYYY-MM-DD format.

Describes how granularity you wish the date_ranges to be. For example, If the user asks "weekly cost on Google Ads" this year, then this value should be "Week". If the user does not specify, then leave it as empty.

time_granularity

Call API getWorkspace first to get a list of available workspaces. Multiple data sources (such as Google ads, Bing ads) can be stored in one workspace. If the user does not specify a workspace name, then use the available workspace name from the retrieved list based on the data source. If the user has not yet created one, then ask them to go to adzviser.com/main to create a new workspace.

workspace_name

searchQueryRequest

Adzviser Actions for GPT

Get the list of selectable Bing Ads metrics like Impressions, Cost, Clicks, etc. and breakdowns like Campaign name, Keyword, and Device type etc.

Get the list of selectable Facebook Ads metrics, such as Spend, CPC, Clicks, and breakdowns such as Gender, Country, and Device etc.

Get the list of selectable Facebook Page Insights metrics, such as Total likes, Total reach, Total page views etc.

Get the list of selectable Facebook Post/Video metrics like Post likes, Post total reactions, etc. and breakdowns like Post message, Post image URL, etc.

Get the list of selectable Google Analytics metrics such as Active users, New users, Sessions, and breakdowns like Account name, Session medium, and Country etc.

Get the list of selectable Google Ads metrics, such as Cost, Roas, Impressions, and breakdowns like Device, Keyword Text, and Campaign Name etc.

Get the list of selectable Google My Business metrics, such as Total views, Phone calls, Bookings, and breakdowns like Location name, Website URL, and Address lines etc.

Get the list of selectable Instagram Post metrics such as Post Comments, Post Follows, Post Likes, and breakdowns like Media URL, Media Caption, and Media Product Type etc.

Get the list of selectable Instagram Profile metrics like Profile Follower, Profile Impressions, etc., and breakdowns like Profile ID, Profile Name, and Profile Website etc.

Get the list of selectable Klaviyo metrics, such as Emails recipients, Received SMS, and breakdowns like Campaign name, Flow name, and Person first name etc.

Get the list of selectable LinkedIn Ads metrics, such as Impressions, Reach, Total spent, and breakdowns like Device, Placement, and Campaign name etc.

Get the list of selectable LinkedIn Page metrics, such as Content comments, Lifetime followers, Page views, and breakdowns like Content text, and Content URL etc.

Get the list of selectable Mailchimp metrics, such as Emails sent, Open rate (%), Total clicks, and breakdowns like Campaign name, List name, and Member email etc.

Get the list of selectable Merchant Center metrics, such as Impressions, Clicks, Conversions, and breakdowns like Title, Brand, and Availability etc.

Get the list of selectable Pinterest Ads metrics, such as Impressions paid, Cost, Video views, and breakdowns like Ad group name, and Targeting location etc.

Retrieve real-time reporting data such as impressions, cpc, etc. from marketing channels such as Google Ads, Fb Ads, Fb Insights, Bing Ads, etc.

Get the list of selectable Google Search Console metrics like Clicks, Positions, etc. and breakdowns like Landing page, and Search query etc.

Get the list of selectable Shopify metrics, such as Gross sales, Returns, Shipping, and breakdowns like Customer first name, Product SKU, and Order ID etc.

Get the list of selectable Snapchat Ads metrics such as Impressions, Cost, Leads, and breakdowns like DMA, Ad type, and Campaign name etc.

Get the list of selectable TikTok Ads metrics, such as Clicks, CPM, Cost, and breakdowns like Campaign name, Gender, and Age etc.

Get the list of selectable WooCommerce metrics, such as Gross sales, Returns, Items sold, and breakdowns like Order number, Billing first name, and Shipping phone etc.

Retrieve a list of workspaces that have been created by the user and their data sources, such as Google Ads, Facebook Ads accounts connected with each.