Create Retargeting Audience
create_retargeting_audienceCreate 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 channelsInput Schema
| Name | Required | Description | Default |
|---|---|---|---|
| audience_data | Yes | Complete audience object from get_retargeting_audiences response. Should contain: id, name, type, subtype, channel, matchCount, externalAccountId, and other relevant fields. |