create_retargeting_audience

Create a new retargeting audience on the Metadata platform from native channel audiences.

                This tool creates a retargeting audience by importing an existing audience from a native advertising
                channel (Google Ads, LinkedIn, or Facebook). The audience can be selected from the list of available
                retargeting audiences returned by the get_retargeting_audiences tool.

                **REQUIRED TWO-STEP WORKFLOW:**

                STEP 1: Get available audiences for your channel
                - Call get_retargeting_audiences with your channel (GOOGLE_ADS, LINKEDIN, or FACEBOOK)
                - Review the returned list of available audiences with their details (name, matchCount, etc.)
                - Select the audience you want to import by its ID or by matching its properties

                STEP 2: Create the retargeting audience
                - Use this tool (create_retargeting_audience) with the audience data from Step 1
                - Provide the audience details from the get_retargeting_audiences response
                - The audience will be created and imported into the Metadata platform

                SUPPORTED CHANNELS:
                - GOOGLE_ADS: Google Ads retargeting audiences
                - LINKEDIN: LinkedIn retargeting audiences
                - FACEBOOK: Facebook retargeting audiences

                WHEN TO USE:
                - "Create a retargeting audience from [audience name] in [channel]"
                - "Import [native channel] audience into Metadata"
                - "Add [audience name] from [channel] as a retargeting audience"
                - "Create a new retargeting audience based on [channel] native audience"

                WORKFLOW EXAMPLE:
                User: "Create a retargeting audience from my Google Ads campaign audience"
                1. Call get_retargeting_audiences(channel="GOOGLE_ADS") to list available audiences
                2. Select the desired audience from the results
                3. Call create_retargeting_audience with the audience object from the results

                PARAMETERS:
                - audience_data: Complete audience object from get_retargeting_audiences response (required)
                  Should include: id, name, type, subtype, channel, matchCount, externalAccountId
                  Note: This is typically the entire audience object returned by get_retargeting_audiences

                AUDIENCE DATA STRUCTURE:
                The audience_data parameter should be a dictionary containing:
                - id: Unique audience ID (required)
                - name: Audience name (required)
                - type: Audience type (e.g., GoogleAdsAudience, LinkedInAudience, FacebookAudience) (required)
                - subtype: Audience subtype (e.g., GOOGLE_ADS_RETARGETING, LINKEDIN_RETARGETING) (required)
                - channel: Channel type identifier (required)
                - matchCount: Number of matches/members in the audience
                - externalAccountId: Associated account ID on the advertising platform (required)
                - mdId: Metadata ID (optional, typically null for new imports)
                - externalName: External name (optional)
                - externalSubType: External subtype (optional)
                - seedSourcePlatform: Source platform for the audience seed (optional)

                RETURNS:
                Success confirmation with details about the created retargeting audience including:
                - Audience ID
                - Audience name
                - Type and subtype
                - Channel
                - Match count
                - Creation status

                COMMON USE CASES:
                - Create retargeting audiences from Google Ads native audiences
                - Import LinkedIn retargeting audiences into Metadata
                - Setup Facebook retargeting audiences for multi-channel campaigns
                - Consolidate native channel audiences into Metadata platform

                IMPORTANT NOTES:
                - Audience must be selected from get_retargeting_audiences results
                - The audience object must contain all required fields
                - Channel must be GOOGLE_ADS, LINKEDIN, or FACEBOOK
                - Audience creation is immediate and the audience becomes available for targeting
                - Once created, the audience can be used in campaigns across channels