For more information about the benefits to publishers and creators, and the available platforms, see About Social Catalog Integrations.

Before You Start

These instructions assume that you:

• Are familiar with Tipser’s product export feed API.
• Have set up Tipser’s product page element, or another custom solution that uses the product’s Tipser ID to render the product details.
• Have set up analytics for Tipser Elements to track events.

Integration Overview

1. Publisher generates publisher domain URL with the following format: www.domain.com/
2. Publisher provides the product page URL to Tipser so they can create a customized product feed:
   • URLs must use the following format: www.domain.com/product/{productID} where {productID} is the product’s ID in the Tipser catalog.
   • Note: this feed contains all products at the publisher level. Filtering and curation is performed in a later step, using the social platform’s tools.
3. Publisher creates catalog in their social networks.
4. Publisher uses the platform’s tools to sort, group, and curate products.
5. Publisher selects products from inside the platform to be tagged in advertised or promoted content.
6. The content will now redirect to the publisher domain product page and the user can purchase.

Considerations

• When you fetch the product feed, Tipser automatically filters the included products so that the feed only includes products with high variant availability. This creates a better experience for publishers to maximize return on investment, and a better experience for shoppers so they don’t get frustrated when they can’t order the variant they want.

Pinterest

To integrate with Pinterest, you’ll set up a catalog to ingest your product feed and tag products in content. This integration provides product data from all of your creators to your Pinterest account so you can easily make Product Pins and drive sales.

Before You Start

Publishers must meet the following criteria to be eligible to integrate with Pinterest:

• Have a Pinterest business account
• Have a claimed website which meets Pinterest’s Merchant guidelines
• Has Product Feed Export API established 
• Has a domain URL that accepts Tipser product IDs: www.domain.com/{productID}

Make sure you have your Tipser API Key handy for the data source URL. Tipser’s Customer Success team sends this key along with the feed URL.

Add Data Source

To add the first data source on an account, you must be the account owner. 

1. Log into your Pinterest business account and navigate to Ads > Catalogs.
2. Click New data source and enter the following information:
   • Name: Enter the name of your data source. For example, Tipser.
   • Product feed URL: Enter your feed export URL.
     • US Example: https://api.tipser.com/v4/export/feed?market=US&apiKey=<your_api_key>&format=SocialPlatforms
     • UK Example: https://api.tipser.com/v4/export/feed?market=UK&apiKey=<your_api_key>&format=SocialPlatforms
   • File format: Select XML.
   • Default availability: Select the default availability setting for the ingested products.
   • Country/region: Select your country or region. You will not be able to update this setting.
   • Language: Select the language of content in your data source. You will not be able to update this setting.
   • Default currency: Select the currency of your products. 
   • Time: Select the time and timezone for the products to be ingested, as specified by Tipser.
3. Click Test your feed.
4. In Catalogs Feed Debugger, paste a portion of your feed, including the header, into the box.
5. Click Validate feed. 
   • If there are errors, they will appear below the box. Follow the instructions in What to Do to resolve them.
   • If there are no errors, click Back ( < ) to return to the data source details.
6. Click Create Pins.
7. Pinterest sends a confirmation email when your data source has been successfully processed. 

For more information, see Pinterest’s Data Source Ingestion.

Set Up Events Tracking

Pinterest enables publishers to funnel events data back to Tipser via a tag integration. This configuration involves a base code that you embed on every page of your site, and an event code that enables specific conversion tracking.

To set up this configuration, use Pinterest’s Install the Pinterest tag and choose an implementation method that works for your business. 

If you use Tipser Elements, use Analytics to quickly configure a pixel.

Create Product Groups

Product groups enable you to filter your data feed of products down to curated collections.

1. Log into your Pinterest business account and navigate to Ads > Catalogs >  View product groups > Create product group.
2. Click Filters to expand the filters component.
3. Use the filter options to select the products for this group.
4. Click Apply filter, and the filtered products appear in a list.
5. Click Add filter + to apply additional filters.
6. Click Next step.
7. Enter a name for this product group.
8. Click Done.

For more information, see Pinterest’s Create Product Groups.

Tag Products in Pins

To connect your content to the catalog data, use Pinterest’s Tag Products in Pins. This links the items that shoppers see in your pins to your shoppable products.

Product Pins are organic content. To create promoted content, set up Pinterest’s Shopping Ads.

Considerations

• Pinterest fetches the feed file every 24 hours, so product availability is not guaranteed to be up-to-date. We recommend that publishers choose to highlight products with high amounts of inventory and regular availability.

TikTok

To integrate with TikTok, you’ll set up a catalog and connect it to your product data feed. This enables you to add shoppable products to posts.

You can also reference the TikTok article How to Set Up TikTok Shopping Partner Integration Manually.

Before You Start

Publishers must meet the following criteria to be eligible to integrate with TikTok:

• Registered with TikTok Business and has an assigned account manager
• Is based in the US or UK
• Has Product Feed Export API established 
• Has a domain URL that accepts Tipser product IDs: www.domain.com/{productID}

Make sure you have your Tipser API Key handy for the feed export URL. Tipser’s Customer Success team sends this key along with the feed URL.

Create a Catalog

1. Go to the TikTok Ads Manager and log in.
2. Navigate to Assets > Catalog and click Add Catalog.
3. Enter the required information about this catalog, and give it a descriptive name.
4. Click Create.

For more information, see TikTok Catalogs.

Configure Scheduled Data Feed Import

1. From your new catalog, navigate to Manage > Products > Add Products > Data Feed Schedule.
2. In Data Feed URL, enter the product export feed URL, and replace `<your_api_key>` with your Tipser API key:
   • US Example: https://api.tipser.com/v4/export/feed?market=US&apiKey=<your_api_key>&format=GoogleShopping
   • UK Example: https://api.tipser.com/v4/export/feed?market=UK&apiKey=<your_api_key>&format=GoogleShopping
3. Set the schedule to run at least once daily, preferably overnight. If you have products with stock counts that fluctuate dramatically, you may choose to run it more often.
4. In Update Method, select Update your data feed.
5. Click Import.
6. After the initial feed upload completes, navigate to the Products tab to validate that the import was successful.

For more information, see Data Feed Schedule.

Create and Bind Your Store

You’ll need to create a TikTok store and bind it to your product catalog and TikTok account.

1. From your new catalog, navigate to Overview and copy the page URL.
2. Contact your TikTok account manager to request that they create a store and bind it to your catalog. Include the copied URL in your request.
3. Your TikTok account manager configures your store.
4. Log into TikTok Business Manager and navigate to Assets > Store.
5. Click your new store. The TikTok Store Manager appears.
6. Open a new tab in the same browser and log into the TikTok account to which you want to bind your storefront.
7. In the TikTok Store Manager tab, navigate to Settings > Link to TikTok Account.
8. Click Authorize.
9. Your storefront is now connected to the TikTok account that you logged into.

Set Up Events Tracking

To funnel platform catalog events to Tipser’s analytics, you can either use a TikTok pixel or connect via the TikTok server-to-server Events API. Each method can benefit your business in a different way.

Before you implement events tracking, make sure to obtain consent from each creator that it will be used with.

Create TikTok Pixel and Connect Event Sources

If you use Tipser Elements, use Analytics to quickly configure a pixel.

Otherwise, use the TikTok guide Get Started with Pixel. Then, use the following steps to connect an event source:

1. Go to the TikTok Ads Manager and log in.
2. Navigate to Assets > Catalog and click your catalog.
3. Navigate to Configure > Event Sources > Connect Event Sources.
4. In Catalog, select Pixel Event Sources.

For more information, use the TikTok guide Connect Events Sources to connect your catalog.

Connect to Events API

Use TikTok Events API reference documentation to implement this API.

Manage Store

Create Product Sets

Optionally, use Create Product Sets to group products into curated collections. This enables you to create ad groups that promote specific products instead of your entire product catalog.

Add Products to Store

1. Log into TikTok Business Manager and navigate to Assets > Store.
2. Find a product via search or filter options.
3. To add the product to the store, toggle Storefront Status to On. To add products in bulk, select the checkbox for multiple products and click In Storefront.
4. To remove a product from the store, toggle Storefront Status to Off. To remove products in bulk, select the checkbox for multiple products and click Out of Storefront.

Note: Products appear in the order in which you added them, with the newest products appearing at the top of the store.

Add Products to TikTok Post

1. Create a video on the TikTok app.
2. From the Post module, click Add Link > Products.
3. From the Showcase module, click Add and select a product that you want to feature in the video.
4. Enter a product name and click Add.
5. Repeat steps 3-4 for each product you want to add to your video.
6. Finish creating your video, and click Post.

For more information, see How to Add Product Links to TikTok Videos.