Collaborative Ads

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.

High-Level Steps

For retailers and marketing partners:

• Step 1: Onboard into Collaborative Ads
• Step 2: Create Catalog Segment - The segment must contain products belonging to one of its prospective brand partners.
• Step 3: Share Catalog Segment with Brand Partner
• (For Marketing Partners Only) Step 4: Provide Discovery Tools for Brands

For brands:

• Step 1: Accept Catalog Segment
• Step 2: Create Ad Campaign with Catalog Segment
• Step 3: View Reporting - View reporting related to the products in the catalog segment.
• Optional Step 4: Debugging - Use tools to diagnose and resolve problems, see Advantage+ catalog ads, Debugging Tools.

Steps For Retailers and Marketing Partners

Step 1: Onboard into Collaborative Ads

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.

Step 2: Create Catalog Segment

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.

Step 3: Share Catalog Segment

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:

(For Marketing Partners Only) Step 4: Provide Discovery Tools for Brands

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]

Keep track of your reach outs with the following endpoints:

• GET {business-id}/collaborative_ads_collaboration_requests
• GET {cpas-collaboration-request-id}/fields=phone_number,receiver_business,request_type,source,status

Steps For Brands

Step 1: Accept Catalog Segment

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:

1. Go to the Collaboration Center.
2. Select the business you're accepting Terms of Service for.
3. Select Partners from the left side navigation.
4. Click the Accept assets button to begin the acceptance workflow.

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.

Step 2: Create Ad Campaign

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 change
• You cannot change description in template_data
• template_url_spec which you can use for deeplink URLs must point to merchant's website
• Custom tracking specs are disabled

Step 3: View Reports

Once 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:

• Ad Account
• Ad Campaign
• Ad Set
• Ad

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.

Step 4: Debug and Diagnose Issues

Brands should now troubleshoot and debug any issues running their Advantage+ catalog ads for the catalog segment.

See Advantage+ Catalog Ads Debugging Tools.

Insights

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:

• Your app needs to have ads_management and business_management permissions. See App Review.
• You need to have a user access token and this user must be allowed to view reporting for the ad account in question.

Queries can be made on the following objects: ad account, ad campaign, ad set, and ad.

Breakdowns

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.

Combining Breakdowns

Use the following combining breakdowns for Collaborative Ads:

• action_converted_product_id
• action_type, action_converted_product_id