meta-ads-mcp 1.0.18__py3-none-any.whl → 1.0.21__py3-none-any.whl

meta_ads_mcp/__init__.py

@@ -6,7 +6,7 @@ This package provides a Meta Ads MCP integration
 
 from meta_ads_mcp.core.server import main
 
-__version__ = "1.0.18"
+__version__ = "1.0.21"
 
 __all__ = [
     'get_ad_accounts',

meta_ads_mcp/core/ads.py

@@ -759,6 +759,7 @@ async def create_ad_creative(
     descriptions: Optional[List[str]] = None,
     dynamic_creative_spec: Optional[Dict[str, Any]] = None,
     call_to_action_type: Optional[str] = None,
+    lead_gen_form_id: Optional[str] = None,
     instagram_actor_id: Optional[str] = None
 ) -> str:
     """
@@ -778,6 +779,8 @@ async def create_ad_creative(
         descriptions: List of descriptions for dynamic creative testing (cannot be used with description)
         dynamic_creative_spec: Dynamic creative optimization settings
         call_to_action_type: Call to action button type (e.g., 'LEARN_MORE', 'SIGN_UP', 'SHOP_NOW')
+        lead_gen_form_id: Lead generation form ID for lead generation campaigns. Required when using
+                         lead generation CTAs like 'SIGN_UP', 'GET_OFFER', 'SUBSCRIBE', etc.
         instagram_actor_id: Optional Instagram account ID for Instagram placements
     
     Returns:
@@ -910,9 +913,13 @@ async def create_ad_creative(
         
         # Add call_to_action to link_data for simple creatives
         if call_to_action_type:
-            creative_data["object_story_spec"]["link_data"]["call_to_action"] = {
-                "type": call_to_action_type
-            }
+            cta_data = {"type": call_to_action_type}
+            
+            # Add lead form ID to value object if provided (required for lead generation campaigns)
+            if lead_gen_form_id:
+                cta_data["value"] = {"lead_gen_form_id": lead_gen_form_id}
+            
+            creative_data["object_story_spec"]["link_data"]["call_to_action"] = cta_data
     
     # Add dynamic creative spec if provided
     if dynamic_creative_spec:
@@ -965,7 +972,8 @@ async def update_ad_creative(
     description: Optional[str] = None,
     descriptions: Optional[List[str]] = None,
     dynamic_creative_spec: Optional[Dict[str, Any]] = None,
-    call_to_action_type: Optional[str] = None
+    call_to_action_type: Optional[str] = None,
+    lead_gen_form_id: Optional[str] = None
 ) -> str:
     """
     Update an existing ad creative with new content or settings.
@@ -981,6 +989,8 @@ async def update_ad_creative(
         descriptions: New list of descriptions for dynamic creative testing (cannot be used with description)
         dynamic_creative_spec: New dynamic creative optimization settings
         call_to_action_type: New call to action button type
+        lead_gen_form_id: Lead generation form ID for lead generation campaigns. Required when using
+                         lead generation CTAs like 'SIGN_UP', 'GET_OFFER', 'SUBSCRIBE', etc.
     
     Returns:
         JSON response with updated creative details
@@ -1045,7 +1055,7 @@ async def update_ad_creative(
         update_data["asset_feed_spec"] = asset_feed_spec
     else:
         # Use traditional object_story_spec with link_data for simple creatives
-        if message or headline or description or call_to_action_type:
+        if message or headline or description or call_to_action_type or lead_gen_form_id:
             update_data["object_story_spec"] = {"link_data": {}}
             
             if message:
@@ -1060,10 +1070,17 @@ async def update_ad_creative(
                 update_data["object_story_spec"]["link_data"]["description"] = description
             
             # Add call_to_action to link_data for simple creatives
-            if call_to_action_type:
-                update_data["object_story_spec"]["link_data"]["call_to_action"] = {
-                    "type": call_to_action_type
-                }
+            if call_to_action_type or lead_gen_form_id:
+                cta_data = {}
+                if call_to_action_type:
+                    cta_data["type"] = call_to_action_type
+                
+                # Add lead form ID to value object if provided (required for lead generation campaigns)
+                if lead_gen_form_id:
+                    cta_data["value"] = {"lead_gen_form_id": lead_gen_form_id}
+                
+                if cta_data:
+                    update_data["object_story_spec"]["link_data"]["call_to_action"] = cta_data
     
     # Add dynamic creative spec if provided
     if dynamic_creative_spec:

meta_ads_mcp/core/insights.py

@@ -1,7 +1,7 @@
 """Insights and Reporting functionality for Meta Ads API."""
 
 import json
-from typing import Optional, Union, Dict
+from typing import Optional, Union, Dict, List
 from .api import meta_api_tool, make_api_request
 from .utils import download_image, try_multiple_download_methods, ad_creative_images, create_resource_from_image
 from .server import mcp_server
@@ -11,9 +11,10 @@ import datetime
 
 @mcp_server.tool()
 @meta_api_tool
-async def get_insights(object_id: str, access_token: Optional[str] = None, 
-                      time_range: Union[str, Dict[str, str]] = "maximum", breakdown: str = "", 
-                      level: str = "ad", limit: int = 25, after: str = "") -> str:
+async def get_insights(object_id: str, access_token: Optional[str] = None,
+                      time_range: Union[str, Dict[str, str]] = "maximum", breakdown: str = "",
+                      level: str = "ad", limit: int = 25, after: str = "",
+                      action_attribution_windows: Optional[List[str]] = None) -> str:
     """
     Get performance insights for a campaign, ad set, ad or account.
     
@@ -51,6 +52,8 @@ async def get_insights(object_id: str, access_token: Optional[str] = None,
         level: Level of aggregation (ad, adset, campaign, account)
         limit: Maximum number of results to return per page (default: 25, Meta API allows much higher values)
         after: Pagination cursor to get the next set of results. Use the 'after' cursor from previous response's paging.next field.
+        action_attribution_windows: Optional list of attribution windows (e.g., ["1d_click", "7d_click", "1d_view"]).
+                   When specified, actions include additional fields for each window. The 'value' field always shows 7d_click.
     """
     if not object_id:
         return json.dumps({"error": "No object ID provided"}, indent=2)
@@ -78,7 +81,11 @@ async def get_insights(object_id: str, access_token: Optional[str] = None,
     
     if after:
         params["after"] = after
-    
+
+    if action_attribution_windows:
+        # Meta API expects single-quote format: ['1d_click','7d_click']
+        params["action_attribution_windows"] = "[" + ",".join(f"'{w}'" for w in action_attribution_windows) + "]"
+
     data = await make_api_request(endpoint, access_token, params)
     
     return json.dumps(data, indent=2)

{meta_ads_mcp-1.0.18.dist-info → meta_ads_mcp-1.0.21.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: meta-ads-mcp
-Version: 1.0.18
+Version: 1.0.21
 Summary: Model Context Protocol (MCP) server for Meta Ads - Use Remote MCP at pipeboard.co for easiest setup
 Project-URL: Homepage, https://github.com/pipeboard-co/meta-ads-mcp
 Project-URL: Bug Tracker, https://github.com/pipeboard-co/meta-ads-mcp/issues
@@ -389,6 +389,7 @@ For advanced users who need to self-host, the package can be installed from sour
       - `time_range`: Time range for insights (default: maximum)
       - `breakdown`: Optional breakdown dimension (e.g., age, gender, country)
       - `level`: Level of aggregation (ad, adset, campaign, account)
+      - `action_attribution_windows` (optional): List of attribution windows for conversion data (e.g., ["1d_click", "1d_view", "7d_click", "7d_view"]). When specified, actions and cost_per_action_type include additional fields for each window. The 'value' field always shows 7d_click attribution.
     - Returns: Performance metrics for the specified object
 
 21. `mcp_meta_ads_get_login_link`

{meta_ads_mcp-1.0.18.dist-info → meta_ads_mcp-1.0.21.dist-info}/RECORD

@@ -1,8 +1,8 @@
-meta_ads_mcp/__init__.py,sha256=qVIccqA3rZtJUEMjPcFLKFUhyRlnAJyTyP4l29VklAU,1477
+meta_ads_mcp/__init__.py,sha256=sauxtzAb9-OLhcjlqj63XQN_rQkL_tkK8edYVgqua3M,1477
 meta_ads_mcp/__main__.py,sha256=XaQt3iXftG_7f0Zu7Wop9SeFgrD2WBn0EQOaPMc27d8,207
 meta_ads_mcp/core/__init__.py,sha256=IEJtqpyUo0CZSUWeQPljQ-D2vKorTFwXnpBQWSi1hIM,1819
 meta_ads_mcp/core/accounts.py,sha256=7Zoqq0zMIJi_Xsxe9-_b3EYx-UTeieJJvO7HxVRuUS0,4327
-meta_ads_mcp/core/ads.py,sha256=ED67n5kCcmqk5BDDTOA4zVYUPUsAJw8ZvlM2kVwNQlI,62007
+meta_ads_mcp/core/ads.py,sha256=Hv6CYgYz85yUJ_OtxLMFH2Q4gZdQKiWEvxQs39oslfU,63116
 meta_ads_mcp/core/ads_library.py,sha256=smGz9FhM6RIUjlQT4Jv1BaZmXahGdK21eRCB7QMhK-4,3228
 meta_ads_mcp/core/adsets.py,sha256=3Ok3EwPTReKshtsVs4gRMlws6LMTUJTb4ZeGPPM8JR8,16570
 meta_ads_mcp/core/api.py,sha256=RvEbXpVO_SxKJeuqsiQhpGYLZuhQlYKCd9hNv7AIZac,16856
@@ -13,7 +13,7 @@ meta_ads_mcp/core/callback_server.py,sha256=LIAJv9DW--83kdZ7VWWZal8xEprYjRZ8iug4
 meta_ads_mcp/core/campaigns.py,sha256=LKo5B8hNUUmfVQ1iu88o8HoU9ixOlGS9lwmPu6x9keA,15604
 meta_ads_mcp/core/duplication.py,sha256=pJ41pI9bIxNf21TSy6KkpcUsc3aSr4KIiO__sunNoq0,18909
 meta_ads_mcp/core/http_auth_integration.py,sha256=lGpKhfzJcyWugBcYEvypY-qnlt-3UDBLqh7xAUH0DGw,12473
-meta_ads_mcp/core/insights.py,sha256=ogSGlC0ddh8RFzWydilfDc7GYnjtInFiEQS7cSoyTmw,5061
+meta_ads_mcp/core/insights.py,sha256=eN9jVMyoA0CaJ76x8GZZfwJOdMvs25U4RjJUrzznFPU,5606
 meta_ads_mcp/core/openai_deep_research.py,sha256=68ayGopnBSPEYhN9R1sFvTXtyWtM0lji9aWS3uSXnLY,18649
 meta_ads_mcp/core/pipeboard_auth.py,sha256=vv0yc4RBcGOm7VOovud-QNV1JmvBF-njOKICzAOlyf0,24602
 meta_ads_mcp/core/reports.py,sha256=2pXYCCjYc3MZ8GlrbSHND436W62WlbfbtMll1dfJdqE,5750
@@ -21,8 +21,8 @@ meta_ads_mcp/core/resources.py,sha256=-zIIfZulpo76vcKv6jhAlQq91cR2SZ3cjYZt3ek3x0
 meta_ads_mcp/core/server.py,sha256=9SlgM_qvdlxo24ctnZzLgW1e1nfAspCSx3YyJQkKP64,17856
 meta_ads_mcp/core/targeting.py,sha256=d2uLWbIEtucRuTgwZEdtVKLDZJgaxQ1lDtZ0ZgkBJC4,25150
 meta_ads_mcp/core/utils.py,sha256=ytj41yC5SqduLrAiZYBSd6OUwlJRaIClTwnnYKpNFds,9387
-meta_ads_mcp-1.0.18.dist-info/METADATA,sha256=9Dyns9X9nMyMP-ZCMWpFuk6lckX7ApqIAJIfIiYY_vs,24903
-meta_ads_mcp-1.0.18.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-meta_ads_mcp-1.0.18.dist-info/entry_points.txt,sha256=Dv2RkoBjRJBqj6CyhwqGIiwPCD-SCL1-7B9-zmVRuv0,57
-meta_ads_mcp-1.0.18.dist-info/licenses/LICENSE,sha256=E2d762fbhwKRYn8o7J6Szr6vyBPrHVDlK3jbHPx-d84,3851
-meta_ads_mcp-1.0.18.dist-info/RECORD,,
+meta_ads_mcp-1.0.21.dist-info/METADATA,sha256=TaQcg4cOHgRz7qSIbogEt1A4NEQSTCwJ_l0yalfudUs,25201
+meta_ads_mcp-1.0.21.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+meta_ads_mcp-1.0.21.dist-info/entry_points.txt,sha256=Dv2RkoBjRJBqj6CyhwqGIiwPCD-SCL1-7B9-zmVRuv0,57
+meta_ads_mcp-1.0.21.dist-info/licenses/LICENSE,sha256=E2d762fbhwKRYn8o7J6Szr6vyBPrHVDlK3jbHPx-d84,3851
+meta_ads_mcp-1.0.21.dist-info/RECORD,,