Help Center

Welcome to the SourceKnowledge Help Center.

Here, you will be able to gain all the knowledge you need to know about our tags, ad terms, creatives and so much more.

How Do I Set Up My First Campaign?

How Do I Define My Campaign CPC and Budget?

Navigate to the Campaign Settings page once you have signed up.

How Do I Create a Successful Campaign?

By setting a realistic ROAS.
By maintaining an up to date catalog.
By managing inventory levels.
By using coupons and discounts to entice customers to make a purchase.

Which Sites Will I Appear On?

SourceKnowledge does not disclose it’s entire Partner Channel for proprietary reasons. You are able to see what partner ID has generated sales for you.

What Regions Does SourceKnowledge Support?

SourceKnowledge is able to support your sales efforts in all geos across the US and Canada, Australia, New Zealand, Latin America, and Europe.

What Metrics Should I Focus On?

You should focus on your ROAS metric as well as how much revenue your campaign is delivering to your store.

Tracking Order IDs for Shopify-Built Stores

We display the Global Shopify Order ID which is unique across all Shopify stores. Using the ID in our Order ID report, you should be able to enter into your Shopify Orders page and the equivalent order will be returned.

Why Am I Not Receiving Conversions?

Check to make sure your campaign is running.
Increase your CPC bid and check to make sure you have enough monthly budget to keep you account active.

How Do I View My Conversions in the Dashboard?

Go to your Campaign Summary page.

Shopify Clients

For Shopify ecommerce stores, there is a SourceKnowledge Shopping Ads app that you can install from the Shopify app store to facilitate exporting your shopping catalog and placing the SourceKnowledge tag on your website. Here are the steps:

Install the app from the Shopify app store. This will export your product catalog and install SourceKnowledge tags on your store.
Create a SourceKnowledge account if you haven’t already done so.
Your catalog is now connected to your SourceKnowledge account and you are ready to start your shopping campaign.

Shopping Feed Requirements

Field	Description	Information
id	A unique identifier for the item	ID must be unique for each item in your catalog. If you have multiple feeds, IDs of items across different feeds still need to be unique.
title	Title of the item	Use relevant titles that match with what users are searching for with key information first in the title.
description	Item description	No HTML and no promotional text. Do not enclose in quotes. The description from the landing page of your offer must be the same description as indicated in the feed.
link	Direct URL of the item’s page on your website	Link should point to the specific product instead of your store’s home page or pages with multiple products.
price	Base price, excluding tax and shipping, submitted in local currency	Use two decimal places and no symbols (e.g. $). The price from the landing page of your offer must be the same price as indicated in the feed.
sale_price	(Optional) Your product’s sale price	Meet the requirements for the priceattribute Submit the sale_price in addition to the price attribute with the non-sale price Accurately submit the product’s sale price, and match the sale price from your landing page
image_link	URL of an image of the item	Image must be: bmp, gif, exif, jpg, png, tiff. Minimum size: 500px by 500px. Cannot exceed 3.9 MB. Do not include any text within your images, including promotional messaging.
availability	Your product’s availability	Supported values in stock out of stock preorder
google_product_category	Required (for Apparel & Accessories (166), Media(783), and Software (2092) categories) Optional for all other products Google-defined product category for your product Example Apparel & Accessories > Clothing > Outerwear > Coats & Jackets	Include only 1 category Include the most relevant category Include either the full path of the category or the numerical category ID Include a specific category for certain products: Alcoholic beverages must be submitted with one of these categories: Food, Beverages & Tobacco > Beverages > Alcoholic Beverages(499676), or any of its subcategories Arts & Entertainment > Hobbies & Creative Arts > Homebrewing & Winemaking Supplies (3577), or any of its subcategories Mobile devices sold with contract must be submitted as Electronics > Communications > Telephony > Mobile Phones (267) for phones or Electronics > Computers > Tablet Computers (4745) for tablets Gift Cards must be submitted as Arts & Entertainment > Party & Celebration > Gift Giving > Gift Cards & Certificates (53)
product_type	Optional but recommended Product category that you define for your product Example Home > Women > Dresses > Maxi Dresses	Include the full category. For example, include Home > Women > Dresses > Maxi Dresses instead of just Dresses Only the first product_type value will be used to organize bidding and reporting in Google Ads Shopping campaigns
IMPORTANT: 2 of 3 are required from brand/GTIN/MPN in all feeds.
brand	The brand name of the product	Provide the brand name of the product generally recognized by consumers Only provide your store name as the brand in case you manufacture the product, or your product falls into a generic brand category. For example, you could submit your store name as the brand if you sell white label products or customized jewelry If you don’t have a brand to provide, don’t provide a value. For example, don’t use N/A, Generic, No brand, or Does not exist For compatible products: Submit the GTIN and brand from the manufacturer who actually built the compatible product Don’t provide the Original Equipment Manufacturer (OEM) brand to indicate that your product is compatible with or a replica of the OEM brand’s product
gtin	Required for all new products with a gtin assigned by the manufacturer Optional for all other products Your product’s Global Trade Item Number (GTIN)	Exclude dashes and spaces Submit only valid GTINs as defined in the official GS1 validation guide, which includes these requirements: The checksum digit is present and correct The GTIN is not restricted (GS1 prefix ranges 02, 04, 2) The GTIN is not a coupon (GS1 prefix ranges 98 – 99) For compatible products: Submit the GTIN and brand from the manufacturer who actually built the compatible product Don’t provide the Original Equipment Manufacturer (OEM) brand to indicate that your product is compatible with or a replica of the OEM brand’s product For multipacks: Use the product identifiers that relates to the multipack For bundles: Use the product identifiers for the main product in the bundle If you offer customization, engraving, or other personalization of a product that’s been assigned a GTIN by the manufacturer: Submit the GTIN and use the is_bundle attribute to let us know that the product includes customization If your product doesn’t have both a GTIN and MPN: Set identifier_exists to no (FALSE)
MPN	Required only if your new product does not have a manufacturer assigned gtin Optional for all other products	Only submit MPNs assigned by a manufacturer Use the most specific MPN possible. For example, different colors of a product should have different MPNs If your product doesn’t have both a GTIN and MPN: Set identifier_exists to no (FALSE)
condition	Required if your product is used or refurbished Optional for new products The condition of your product at time of sale Supported values new Brand new, original, unopened packaging refurbished Professionally restored to working order, comes with a warranty, may or may not have the original packaging used Previously used, original packaging opened or missing
age_group	Required for all apparel items that are focused on people in Brazil, France, Germany, Japan, the UK, and the US as well as all products with assigned age groups Optional for all other products and countries of sale The demographic for which your product is intended Supported values newborn Up to 3 months old infant Between 3-12 months old toddler Between 1-5 years old kids Between 5-13 years old adult Typically teens or older
color	Required for all apparel items in feeds that target Brazil, France, Germany, Japan, the UK, and the US as well as all products available in different colors Optional for all other products and countries of sale Your product’s color(s)	Don’t use a number such as 0 2 4 6 8 Don’t use characters that aren’t alphanumeric such as #fff000 Don’t use only 1 letter such as R (For Chinese, Japanese, or Korean languages, you can include a single character such as 红) Don’t reference the product or image such as “see image” Don’t combine several color names into 1 word, such as RedPinkBlue. Instead, separate them with a /, such as Red/Pink/Blue. Don’t use a value that isn’t a color, such as multicolor, various, variety, men’s, women’s, or N/A. If your product features multiple colors, list the primary color first. For variants Include with the same value for item_group_id and different values for color
gender	Required for all apparel items in feeds that are focused on people in Brazil, France, Germany, Japan, the UK, and the US as well as all gender-specific products Optional for all other products and countries of sale The gender for which your product is intended Supported values male female unisex	For some Apparel & Accessories (166) categories like Shoelaces (1856), this attribute is recommended instead of required since these categories aren’t dependent on gender For variants Include with the same value for item_group_id and different values for gender
material	Required if relevant for distinguishing different products in a set of variants Optional for all other products Your product’s fabric or material	To indicate multiple materials for a single product (not variants), add a primary material, followed by up to 2 secondary materials, separated by a /. For example, instead of CottonPolyesterElastane, use cotton/polyester/elastane For variants Include with the same value for item_group_id and different values for material
pattern	Required if relevant for distinguishing different products in a set of variants Optional for all other products Your product’s pattern or graphic print	For variants Include with the same value for item_group_id and different values for pattern
size	Required for all apparel items in the Apparel & Accessories > Clothing and Apparel & Accessories > Shoes product categories focused on people in Brazil, France, Germany, Japan, the UK, and the US as well as all products available in different sizes Optional for all other products and countries of sale Your product’s size	For variants Include with the same value for item_group_id and different values for size If sizes contain multiple dimensions, condense them into 1 value. For example, “16/34 Tall” for neck size 16 inches, sleeve length 34 inches, and “Tall” fit If your item is one size fits all or one size fits most, you can use one size, OS, one size fits all, OSFA, one size fits most, or OSFM
item_group_id	Required for Brazil, France, Germany, Japan, the United Kingdom, and the US if the product is a variant Optional for all other products and countries of sale ID for a group of products that come in different versions (variants)	Use a unique value for each group of variants. Use the parent SKU where possible Keep the value the same when updating your product data Use only valid unicode characters Use an item group ID for a set of products that differ by one or more of these attributes: color size pattern material age group gender Include the same attributes for each product in the item group. For example, if a product varies by size and color, submit sizeand color for every product that share the same value for item_group_id If your products differ by design elements that aren’t represented by the attributes above, don’t use item_group_id
custom_label_0	Optional but recommended Label that you assign to a product to help organize bidding and reporting in Shopping campaigns Example seasonal clearance holiday sale price range	Use a value that you’ll recognize in your Shopping campaign. The value won’t be shown to users who see your ads Submit up to 5 custom labels per product by including this attribute multiple times: custom_label_0 custom_label_1 custom_label_2 custom_label_3 custom_label_4

Can't Find What You're Looking For?

If you have any additional questions, please contact the Customer Support team by filling out the form below.

About the SourceKnowledge Tags

SourceKnowledge’s performance technology delivers your CPA goals through display ads, search, shopping and social campaigns using intent markers based on how your customers interact with your site. Some indicators we use are the product pages customers have viewed or sales confirmations and cart abandonment.

The SourceKnowledge tags are JavaScript code snippets that need to be implemented within the header code of your site. They are unique to your advertiser profile. If you manage more that one website, you will need to create an advertiser profile for each website. The tags load asynchronously so they will not interfere with the page loading time or user experience.

SourceKnowledge performance technology relies on these key tag placements:

Lead/Home Tag – this tag should be placed on all your pages to collect user browsing intent throughout your website.
Cart Page Tag- this tag should be placed on the event when a user adds a product to the cart.
Sales Confirmation Tag- includes order ID and sales total.

Integrating SourceKnowledge Tags Onto Your Website

The tags will recognize and adapt automatically to the protocol of your site: http or https.

Upx

This is your SourceKnowledge tag (upx) ID. If your upx ID is 11111 then the last line of your SourceKnowledge Homepage tag should look like this: (document,’script’,’//upx.provenpixel.com/ujs.php?upx=11111′);

The implementation of the following tags are required:

Lead/Home Tag
Cart Tag
Sales Confirmation Tag

How to activate your Lead/Home Tag:

Copy your SourceKnowledge Tag from your dashboard, located in the right rail menu under your username.
Paste it in the HTML of your website right above the end </body> tag.

If you are running a shopping campaign with us, the Lead/Home Tag is used to identify visits to particular product pages using a product ID macro. It is important to populate this macro for each product view.

The macro is: REPLACE_WITH_PRODUCT_ID

How to activate your Cart Tag:

Copy your SourceKnowledge Tag from your dashboard, located in the right rail menu under your username.
Paste it in the HTML of your website right above the end </body> tag.

If you are running a shopping campaign with us, the Cart Tag is used to identify products that have been placed in your users’ carts. Use the product ID macro. If there are multiple products within the cart, you may specify by a comma separated list.

The macro is: REPLACE_WITH_PRODUCT_ID

How to activate your Sales Confirmation Tag:

Copy your SourceKnowledge Tag from your dashboard, located in the right rail menu under your username.
Paste it in the HTML of your website right above the end </body> tag.

The Sales Confirmation Tag must be placed on the Sales Confirmation page to track the item purchased by your users. The Sales Confirmation page is displayed after a completed purchase on your site, always displaying an order ID and a summary of the order. Capturing this information will allow you to measure the CPA from SourceKnowledge.

The Sales Confirmation Tag on your Sales Confirmation page will have to dynamically pass the order IDs and order amount.

Mandatory Macros for Sales Confirmation Tag:

Order ID
Order Amount (total cart value)
Product ID (if there are multiple products use a comma separated list, for example: “product_id=1,2,3”)

Custom Tag Integration

Macro supported currency:

We only support one kind of currency at a time and default to USD.

Listing multiple values within tags:

For multiple products at checkout, use a comma separated list and it should look like this: “product_id=1,2,3”.

Woo Commerce Conversion Tracking:

WooCommerce has a dedicated plugin to set up conversion tracking. Please place our sales confirmation tag there. The sales confirmation is required to run your campaign. The rest of the tags are optional and there are plugins that you can get for WooCommerce that help with implementation.

You’ll see the following line inside our tag code:

&order_id=ORDER_ID&order_amount=ORDER_AMOUNT&product_id=REPLACE_WITH_PRODUCT_ID

It must be replaced to fit the WooCommerce criteria:

&order_id=(order_number)&order_amount=(order_subtotal)&product_id=REPLACE_WITH_PRODUCT_ID

Ignore the Product_ID macro, however please populate the Order_ID, and Order_Amount macros.

If you use Google Tag Manager to implement tags follow the instructions above, however, simply insert the Google Tag Manager equivalent of “order_number” and “order_subtotal”.

Additional help is here : https://wedevs.com/docs/woocommerce-conversion-tracking/custom-channel-integration/custom.

Sales Confirmation Pixel:

You’ll see the following line inside our tag code:

coupon_code=COUPON_CODE&customer_type=CUSTOMER_TYPE

-The COUPON_CODE macro should be populated by the discount code used in a transaction.

-The CUSTOMER_TYPE macro should be populated with “0” if a new customer, or with “1” if an existing customer.

Google Tag Manager

How Google Tag Manager Works:

Google Tag Manager enables you insert SourceKnowledge tags on your website. You can configure the tag trigger when an event — such as a pageview, click, or form submission — occurs as well as which pages it is used on. When the trigger fires the tag, the tag’s code executes and sends relevant data back to the platform.

How To Install Our Tags:

https://tagmanager.google.com/gallery/#/owners/sokno/templates/gtm-template

SourceKnowledge Tag Troubleshooting

Give it time. It can take up to an hour for your SourceKnowledge Tag to activate.
Make sure your tag is placed directly before the </body> tag. This ensures that the script loads correctly and has minimal effect on rendering your page content.
Check your formatting. Altering your SourceKnowledge Tag, including changing formatting affects the script’s ability to fire. Your SourceKnowledge Tag should be placed on all pages of your site exactly as it was copied.
Did you place the wrong tag? If you have multiple advertiser profiles, make sure the SourceKnowledge Tag you placed is linked to the corresponding advertiser profile. Check that the tag ID (last line of the JavaScript) matches the ID of your SourceKnowledge Tag in the source code of the intended domain.

Can't Find What You're Looking For?

If you’ve met all of the requirements and your tag is still not firing after 24 hours, or have any additional questions, please contact the Customer Support team by filling out the form below.

Overview

The SourceKnowledge dashboard allows you to view all conversions and various key metrics in one simple interface. In one login, you are prompted to an at a glance summary of your campaign in real time which includes a spend overview and overall conversions, cost per acquisition (CPA), spend, impressions, effective cost per impression (eCPM), clicks, clickthrough rate (CTR) and their status. You can also view all this information within several different timeframes (today, yesterday, last 7 days, last 30 days, this month, last month, all time as well as custom date ranges). These timelines and metrics will be found throughout the entire reporting dashboard.

In the SourceKnowledge sidebar, you will be able to toggle from “summary” to more in depth reporting options. Your reporting options that are categorized by:

Date
Domain
Order ID
Path to Conversion
Additional Insights

Date

In this section of the dashboard, you will be able to view day-by-day metrics from as far back as your campaign start. To gain insight on these metrics, you can easily understand which days perform best, as well as seasonality of your campaigns.

Order ID and Time to Conversion Report

In order to get a more in depth view of all your customers’ buying journey, the Order ID Report also shows you the time of the first touch with your ads and the time to time to conversion. This reporting gives you an in depth look on how your customers interact with your brand as well as how long they take to make their buying decision.

Visual Insights

In this portion of the dashboard, you will be able to take a look at several cards with overall stats of your spend, impressions, clicks, conversions and geography. You are able to view the cards in all the available timelines (today, yesterday, last 7 days, last 30 days, this month, last month, all time as well as custom date ranges) and filter the view on a per day, week or month basis.

Can't Find What You're Looking For?

If you have any additional questions, please contact the Customer Support team by filling out the form below.

Billing Glossary

Threshold: How much spend your campaign accumulates before a payment occurs.

Payments Page: List of all payments made for selected billing period.

AutoPayment: A payment triggered automatically once the current spend is greater than or equal to the threshold.

Current Spend: Charges your campaign generated since the last payment.

Billing Statement: Statement of all transactions that occurred during a given month. This becomes available 7 days after the end of the period.

Traffic charges: Charges that your campaign accumulated during a given period.

Closing balance: The amount owing at the end of a given month.

Starting Balance: The current owing balance carried over from the previous billing period.

Applicable Tax: If your company resides in Canada, taxes will be applied.

Billing Cycle

As your campaign spends, we will charge your account at pre-defined spending thresholds during the month. For example, if your account’s threshold is $100, you will be charged each time your campaign spends $100 . Thresholds are automatically set per account and will increase incrementally as your billing history expands.

Taxes

For companies and individuals with a billing address in Canada, sales tax will be added to the amount in accordance with the tax laws for each province.

How Do I Reactivate My Account After it's Been Disabled for Billing Issues?

Please contact the billing department at billing@sourceknowledge.com.

Adding Users & Permissions

In order for our team to track SourceKnowledge conversions, you will need to provide view access of your Google Analytics. To do this, please follow the following steps:

Sign in to Google Analytics.
Click ADMIN, and navigate to view.
In the VIEW column, click User Management.
Under Add permissions for, enter the email address our team member’s Google Account. Contact your Account Manager for more details.
Under permissions, choose Read & Analyze.
Select Notify this user by email to send a notification to our team members that you have completed the process.
Click Add.

Can't Find What You're Looking For?

If you have any additional questions, please contact the Customer Support team by filling out the form below.

Display

Text:

Headline 1 – 35 characters max.
Headline 2 – 35 characters max.
Description – 80 characters max.

Image:

Required Dimensions – JPG or GIF: 160x600px, 300x250px, 728x90px, 300x600px, 320x50px.

Native

Image (Large) – 1200x627px – JPG, PNG or GIF – 2MB max file.

Image (Basic) – 627x627px – JPG or PNG – 2MB max file.

Image (Thumbnail) – 180x180px – JPG or PNG – 2MB max file.

Title – 50 characters max.
Description – 150 characters max.

Social

Image – 1200x628px – JPG or GIF – No text in the image.
Title – 25 characters max.
Description – 90 characters max.

Search

Headline 1 – 30 characters max.
Headline 2 – 30 characters max.
Description – 80 characters max.

Responsive

Image:

Landscape: 600x314px.
Square: 300x300px.
Logo: 128x128px or greater. The recommended size for the square logo is 1200x1200px.
Avoid text. Text may cover no more than 20% of the image.
- Note: To fit in some ad spaces, your image may be cropped horizontally—up to 5% on each side.

Copy:

Short Headline – 25 characters max.
Long Headline – 90 characters max.
Description – 90 characters max.
Business Name
Final URL
Optional: Promotion Text

Dynamic

Image:

Landscape: 1200x627px.
Square: 627x627px.
Logo: 128x128px or greater.
Avoid too much text. Text may cover no more than 20% of the image.

Additional Guidelines

Required:

Note that SourceKnowledge must have standard click URL with tracking parameters included to run a campain.

Optional:

Standard banner creative, JavaScript or HTML5 tags.
Any standard keyword list, including negative lists.

Can't Find What You're Looking For?

If you have any additional questions, please contact the Customer Support team by filling out the form below.

What is Spend?

The total amount of money invested into campaigns within SourceKnowledge. Spend can be viewed on a daily, weekly and monthly basis.

What are Impressions?

The point in which an ad is viewed once by a site visitor or displayed once on a webpage. The number of impressions of an ad is determined by the number of times the page is located and loaded. Impressions can be viewed on a daily, weekly and monthly basis.

What are Conversions?

When the user completes an advertiser’s goal. Conversions can range from purchases to form completions and everything in between. Conversions can be viewed on a daily, weekly and monthly basis.

What is Conversion Type?

The different interactions that users have made with the ad that have lead them to a conversion. The conversion types for each campaign is based on specific goals. Some examples are: click-through, view-through, etc.

What is CPA?

Also known as cost per acquisition, the price advertisers pay when users make a conversion. SourceKnowledge advertisers are billed on a CPA basis.

What is CPC?

Also known as cost per click, the price advertisers pay each time a user clicks on their ad.

What is eCPM?

The effective cost per thousand ad impressions. eCPM is used as a tool by advertisers when they are comparing ad networks or evaluating the success of an ad-based monetization strategy.

eCPM is calculated by dividing total earnings by total number of impressions in thousands. It is a great performance measure for your various ad units, so when comparing, we use eCPM to compare your results.

The formula is: (Total Spend ÷ Impressions) x 1000

What is CTR?

The number of clicks that your ad receives based on the number of times your ad is shown.

A high CTR is a good indication that users find your ads helpful and relevant. Note that a good CTR is relative to what you’re advertising and on which networks.

The formula is: Clicks ÷ Impressions

What is RoAS?

Also known as return on ad spend, this metric measures gross revenue generated for every dollar spent on advertising. It is an advertiser-centric metric that gauges the effectiveness of online advertising campaigns.

The formula is: Revenue From Ad Campaign ÷ Cost Of Ad Campaign

What is a Viewthrough Conversion?

When a user sees your ad and does not click on it, but later visits your website organically or through search within a specified time window.

What is a Clickthrough Conversion?

When a user sees an ad and clicks to perform the specific call to action.