LinkedInAdAccountFinderTool
ChatGPTFinds a LinkedIn Ad Account by name or ID (data only, no UI). Use this tool only when the user already specified which account they want (by name or ID). If the user did NOT specify an account, call RenderAdAccountsForAuthUserWidget instead to let them browse and select visually.
LinkedInCampaignFinderTool
ChatGPTRetrieves campaigns for a LinkedIn Ad Account with performance metrics (data only, no UI). Use this tool only when the user already specified which campaign they want (by name or ID) and you need to match it before chaining to another tool. If the user did NOT specify a campaign, call RenderCampaignMultiSelectWidget (to compare campaign performance) or RenderCampaignSingleSelectWidget (to pick one campaign for viewing creatives) instead. Requires an account ID. If missing, call RenderAdAccountsForAuthUserWidget to let the user select one. Do not auto-select an account. When the user specifies a fixed period (e.g., 'December 2025', 'Q4 2025'), pass startDate and endDate. For 'last N days' queries, use the days parameter. If the days parameter was used in a previous tool call in this conversation, reuse the same days value here unless the user specifies a different time range.
LinkedInCampaignPerformanceTool
ChatGPTShows a detailed time-series performance chart for LinkedIn Ad Campaigns. Displays trends of impressions, clicks, CPM, CPC, CTR, and spend over time. Only use this tool when the user explicitly asks for a performance chart, trend analysis, or time-series breakdown for specific campaigns. Do NOT use this tool when the user asks to list, browse, or view summary metrics for campaigns — use RenderCampaignMultiSelectWidget instead. Supports two modes: (1) Single campaign when one campaignId is provided, (2) Multi-campaign comparison when multiple campaignIds are provided (max 5). Requires an account ID and at least one campaign ID. If campaign IDs are missing, call RenderCampaignMultiSelectWidget to let the user browse and select campaigns. If account ID is missing, call RenderAdAccountsForAuthUserWidget to let the user select one. Do not auto-select an account. When the user specifies a fixed period (e.g., 'December 2025', 'Q4 2025'), pass startDate and endDate. For 'last N days' queries, use the days parameter. If the days parameter was used in a previous tool call in this conversation, reuse the same days value here unless the user specifies a different time range.
LinkedInCreativeFinderTool
ChatGPTRetrieves creatives for a LinkedIn campaign with performance metrics (data only, no UI). Use this tool only when the user already specified which creative they want (by name or ID) and you need to match it before chaining to another tool. If the user did NOT specify a creative, call RenderCreativesListWidget instead to let them browse and select visually. Requires an account ID and a campaign ID. If campaign ID is missing, call RenderCampaignSingleSelectWidget to let the user browse and select a campaign. If account ID is missing, call RenderAdAccountsForAuthUserWidget to let the user select one. Do not auto-select an account. When the user specifies a fixed period (e.g., 'December 2025', 'Q4 2025'), pass startDate and endDate. For 'last N days' queries, use the days parameter. If the days parameter was used in a previous tool call in this conversation, reuse the same days value here unless the user specifies a different time range.
LinkedInCreativePerformanceTool
ChatGPTShows a detailed time-series performance chart for specific LinkedIn Ad Creatives. Displays trends of impressions, clicks, CPM, CPC, CTR, and spend over time. Only use this tool when the user explicitly asks for a performance chart, trend analysis, or time-series breakdown for specific creatives. Do NOT use this tool when the user asks to list, browse, or view summary metrics for creatives — use RenderCreativesListWidget instead. Supports two modes: (1) Single creative when one creativeId is provided, (2) Multi-creative comparison when multiple creativeIds are provided (max 5). Requires an account ID, a campaign ID, and at least one creative ID. If creative IDs are missing, call RenderCreativesListWidget to let the user browse and select creatives. If campaign ID is missing, call RenderCampaignSingleSelectWidget to let the user browse and select a campaign. If account ID is missing, call RenderAdAccountsForAuthUserWidget to let the user select one. Do not auto-select an account. When the user specifies a fixed period (e.g., 'December 2025', 'Q4 2025'), pass startDate and endDate. For 'last N days' queries, use the days parameter. If the days parameter was used in a previous tool call in this conversation, reuse the same days value here unless the user specifies a different time range.
RenderAdAccountsForAuthUserWidget
ChatGPTRetrieves and displays the user's LinkedIn Ad Accounts for selection. Use this tool whenever the user asks about their ad accounts, wants to see their accounts, or needs to choose an account. This tool fetches its own data directly — no input parameters required. Only use LinkedInAdAccountFinderTool when you already know which account the user wants (by name or ID) and need to match it before chaining to another tool.
RenderCampaignMultiSelectWidget
ChatGPTRetrieves and displays campaigns for a LinkedIn Ad Account as a multi-select widget with summary metrics (spend, clicks, impressions, budget) per campaign. Use this tool when the user wants to see, list, or browse campaigns, view campaign metrics or stats, change the time range for campaign analytics data, or select campaigns to compare — the widget lets the user select up to 5 campaigns for comparison. Do NOT use this tool when the user wants to view creatives — use RenderCampaignSingleSelectWidget instead. Only use LinkedInCampaignPerformanceTool when the user explicitly asks for a detailed time-series performance chart for specific campaigns. This tool fetches its own data directly — pass accountId and optional days. Only use LinkedInCampaignFinderTool when you already know which campaign the user wants (by name or ID) and need to match it before chaining to another tool. Requires an account ID. If missing, call RenderAdAccountsForAuthUserWidget to let the user select one. Do not auto-select an account. When the user specifies a fixed period (e.g., 'December 2025', 'Q4 2025'), pass startDate and endDate. For 'last N days' queries, use the days parameter. If the days parameter was used in a previous tool call in this conversation, reuse the same days value here unless the user specifies a different time range.
RenderCampaignSingleSelectWidget
ChatGPTRetrieves and displays campaigns for a LinkedIn Ad Account as a single-select widget with summary metrics (spend, clicks, impressions, budget) per campaign. Use this tool when the user wants to pick one campaign to view or analyze its creatives, view campaign metrics or stats, or change the time range for campaign analytics data — the widget lets the user select a single campaign with radio buttons. Do NOT use this tool when the user wants to compare multiple campaigns — use RenderCampaignMultiSelectWidget instead. This tool fetches its own data directly — pass accountId and optional days. Only use LinkedInCampaignFinderTool when you already know which campaign the user wants (by name or ID) and need to match it before chaining to another tool. Requires an account ID. If missing, call RenderAdAccountsForAuthUserWidget to let the user select one. Do not auto-select an account. When the user specifies a fixed period (e.g., 'December 2025', 'Q4 2025'), pass startDate and endDate. For 'last N days' queries, use the days parameter. If the days parameter was used in a previous tool call in this conversation, reuse the same days value here unless the user specifies a different time range.
RenderCreativesListWidget
ChatGPTRetrieves and displays creatives for a LinkedIn campaign as a visual widget with summary metrics (spend, clicks, impressions) per creative. Use this tool whenever the user asks to see, list, or browse creatives for a campaign, view creative metrics or stats, or change the time range for creative analytics data. This tool fetches its own data directly — pass accountId, campaignId, and optional days. Only use LinkedInCreativeFinderTool when you already know which creative the user wants (by name or ID) and need to match it before chaining to another tool. Only use LinkedInCreativePerformanceTool when the user explicitly asks for a detailed time-series performance chart for specific creatives. Requires an account ID and a campaign ID. If campaign ID is missing, call RenderCampaignSingleSelectWidget to let the user browse and select a campaign. If account ID is missing, call RenderAdAccountsForAuthUserWidget to let the user select one. Do not auto-select an account. When the user specifies a fixed period (e.g., 'December 2025', 'Q4 2025'), pass startDate and endDate. For 'last N days' queries, use the days parameter. If the days parameter was used in a previous tool call in this conversation, reuse the same days value here unless the user specifies a different time range.
