Collaborative Ads is a solution built on top of Advantage+ catalog ads. It enables brand advertisers to safely collaborate with a retailer or a marketing partner and achieve advertising goals such as target product for sales using retailer-provided content.
The retailer or marketing partner should share a catalog segment with the brand advertiser with all their products. This segment is a portion of their catalog or a superset of product sets. The brand advertiser can then accept this catalog segment and start running Advantage+ catalog ads using this catalog segment. Brand advertisers cannot edit the catalog segment but they can create their own product sets from it.
An advertiser essentially runs a Advantage+ catalog ads campaign for catalog sales with a product catalog. Therefore they can use standard Facebook ads reports which now include metrics related to the catalog segment.
In addition, you can use product-level reporting and retailer-level reporting to show only the brand’s purchases to the brand advertiser.
For retailers and marketing partners:
To complete this step, your app needs business_management
and catalog_management
permissions.
Currently, this is not supported via API, and must be completed via UI. To start this process, click ‘Become a Retail Partner’ in the Collaborative Ads Retailer Directory.
To complete this step, your app needs business_management
and catalog_management
permissions.
Create a catalog segment from one of your existing catalogs. The segment must contain all the products you would like to share with your brand partner.
To create a catalog segment via API, make a POST
request to the owned_product_catalogs
edge. The following fields are required for catalog segment creation:
parent_catalog_id
: The parent catalog from which your segment was created. This catalog needs to be Collaborative Ads compliant. You can find your catalog’s status in Commerce Manager.catalog_segment_filter
: A JSON-encoded rule used to create the catalog segment.To complete this step, your app needs business_management
and catalog_management
permissions.
Share your catalog segment with your brand partner. To do this via API, make a POST
request to /{catalog_segment_id}/agencies
. In your call, you can add the following fields:
Field | Description |
---|---|
type: numeric string or integer | Required. ID for the business the catalog will be shared with. |
type: array < enum {MANAGE, ADVERTISE} > | Required. Tasks the business will be allowed to execute. Available options are: |
type: JSON object {enum{campaign_source,campaign_medium,campaign_name}: string} | Optional. You can specify For example: |
To complete this step, your app needs the business_management
permission. The API call must include a user access token and that user needs to have permission on the suggested partner, business, or collaboration request.
As a marketing partner, you should provide a way for brands to discover possible Collaborative Ads partners. You can use the following endpoints to find retailers to work with:
GET {business-id}?fields=collaborative_ads_suggested_partners
— Find partners for a specific business.GET collaborative_ads_directory?fields=collaborative_ads_merchants
— Get the complete list of collaborative ads retailers.GET {cpas-advertiser-partnership-recommendation-id}?fields=advertiser_business_id,brand_business_id,brands,countries,merchant_business_id,status,status_reason
— Get one single retailer recommendation.If a brand finds a partner, you can reach out to the retailer with a collaboration request. Do that by making the following POST
request to /{cpas-collaboration-request-id}
:
{business-id}/collaborative_ads_collaboration_requests? brands=”[“[BRAND NAME]”, “[BRAND NAME 2]”]”& contact_email=[CONTACT_EMAIL]& contact_first_name=[CONTACT_FIRST_NAME]& contact_last_name=[CONTACT_LAST_NAME]& phone_number=[PHONE NUMBER]& receiver_business=[RECEIVING BUSINESS ID] requester_agency_or_brand=[REQUESTING ENTITY - AGENCY, BRAND or MERCHANT]
Keep track of your reach outs with the following endpoints:
If your brand has not accepted the Terms of Service for the new shared business, you must do so.
After receiving the shared asset, the business admin user needs to:
After accepting the terms, your brand can add people to the catalog segment using the /{product-catalog-id}/assigned_users
endpoint. Note: This requires the business_management
permission.
To complete this step, your app needs business_management
and ads_management
permissions.
Your brand can use the accepted catalog segment to create ad campaigns. You should use a separate ad account for each retailer you want to run Collaborative Ads for. Once the dedicated ad account is linked to a retailer, it can only select catalog segments belonging to that specific retailer.
To create and run ads you do as you normally do for your own product catalog, however you should provide catalog_segment_ID
instead of a catalog ID:
curl \ -F 'name=Product Catalog Sales Campaign' \ -F 'objective=PRODUCT_CATALOG_SALES' \ -F 'promoted_object={"product_catalog_id":"<CATALOG_SEGMENT_ID>"}' \ -F 'status=PAUSED' \ -F 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/campaigns
On success, you get a new ad campaign ID:
{ "id": "<CAMPAIGN_ID>" }
There are four fields which you can normally set with Advantage+ catalog ads which you cannot with a catalog segment:
multi_share_end_card
is set to false
by default and you cannot changedescription
in template_data
template_url_spec
which you can use for deeplink URLs must point to merchant's websiteOnce the ads are running, Brand Advertisers can get metrics on how ads are performing. We have several new insights metrics at different ad object levels. See catalog_segment_value
and related metrics for:
catalog_segment_value
includes a breakdown of the conversion events, including purchases, add-to-carts and view products for the catalog segment at each ad object level. It aggregates events across website, mobile and omni-channel sources. Learn more about Estimated and In-Development Insights Metrics.
Brands should now troubleshoot and debug any issues running their Advantage+ catalog ads for the catalog segment.
The following estimated metrics are related to Collaborative Ads —see About Estimated, In development, and Third-party metrics.
To query any of our reporting metrics:
ads_management
and business_management
permissions. See App Review.Queries can be made on the following objects: ad account, ad campaign, ad set, and ad.
The action_converted_product_id
breakdown is not supported on the ad account level.
Metric | Description |
---|---|
| Value from conversion events, including a breakdown of purchases, add-to-carts and view products for the catalog segment at each ad object level. |
| Total return on ad spend (ROAS) from purchases of items shared between Brand and Retailer. This number is based on information received from one or more Retailer' connected Facebook Business Tools. The amount is attributed to your ads. |
| Total return on ad spend (ROAS) from website purchases of items shared between Brand and Retailer. This number is based on information received from one or more Retailers' connected Facebook Business Tools. The amount is attributed to your ads. |
| The total return on ad spend (ROAS) from mobile app purchases of items shared between Brand and Retailer. This number is based on information received from one or more Retailers' connected Facebook Business Tools. The amount is attributed to your ads. |
| Similar to |
| Value of conversions driven by your ads for a given product ID. This number is recorded by your Retailer partner's Pixel or App SDK. The API only returns Product IDs —see |
| Quantity of conversions driven by your ads for a given product ID. This number is recorded by your Retailer partner's Pixel or App SDK. The API only returns Product IDs —see |
Breakdowns are used to group your insights results into different sets —see Breakdowns. You can use following breakdowns with Collaborative Ads metrics:
Date: Get insights for a specific date range. To use this breakdown, add time_range
to your query. For example: &time_range[since]=2020-03-01&time_range[until]=2020-04-01
.
Product Level: Get insights for a specific product. Use this breakdown for converted_product_value
and converted_product_quantity metrics
by adding &action_breakdowns=action_converted_product_id
to your query.
Use the following combining breakdowns for Collaborative Ads:
The action_converted_product_id
breakdown is not supported on the ad account level.
action_converted_product_id
action_type
, action_converted_product_id