Help Center

Welcome to the SourceKnowledge Help Center.

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

About the SourceKnowledge Pixels

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 pixels 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 pixels loads asynchronously so they will not interfere with the page loading time or user experience. SourceKnowledge performance technology relies on these key pixel placements:

 

  • All Pages Pixel – this pixel should be placed on all your pages to collect user browsing intent throughout your website.
  • Cart page pixel – this pixel should be placed on the event when a user adds a product to the cart.
  • Sales Confirmation Pixel – includes order ID and sales total.

 

Here’s some examples of how the SourceKnowledge pixels can be implemented on a website:

 

All Pages Pixel:

<script>
(function(d,t,u,e,f){e=d.createElement(t);f=d.getElementsByTagName(t)[0];
e.async=1;e.src=u+'&cb='+Math.floor(Math.random()*999999);f.parentNode.insertBefore(e,f);
})(document,'script','//upx.provenpixel.com/ujs.php?upx=00000&product_id=REPLACE_WITH_PRODUCT_ID');
</script>

Cart Pixel:

<script>
(function(d,t,u,e,f){e=d.createElement(t);f=d.getElementsByTagName(t)[0];
e.async=1;e.src=u+'&cb='+Math.floor(Math.random()*999999);f.parentNode.insertBefore(e,f);
})(document,'script','//upx.provenpixel.com/ujs.php?upx=00000&product_id=REPLACE_WITH_PRODUCT_ID');
</script>

Sales Confirmation Pixel:

<script>
(function(d,t,u,e,f){e=d.createElement(t);f=d.getElementsByTagName(t)[0];
e.async=1;e.src=u+'&cb='+Math.floor(Math.random()*999999);f.parentNode.insertBefore(e,f);
})(document,'script','//upx.provenpixel.com/ujs.php?upx=00000&order_id=ORDER_ID&order_amount=ORDER_AMOUNT&product_id=REPLACE_WITH_PRODUCT_ID');
</script>

Integrating SourceKnowledge Pixels Onto Your Website

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

 

Upx

This is your SourceKnowledge pixel (upx) ID. If your upx ID is 11111 then the last line of your SourceKnowledge Homepage pixel should look like this:

(document,’script’,’//upx.provenpixel.com/ujs.php?upx=11111′);

 

The implementation of the following pixels are required:

    1. All Pages Pixel
    2. Cart Pixel  
    3. Sales Confirmation Pixel

 

To activate your All Pages Pixel:

  1. Copy your SourceKnowledge Pixel from your dashboard by clicking on Get Your Pixel on the left menu.
  2. Paste it in the HTML of your website right above the end </body> tag.

 

If you are running a shopping campaign with us, the All Pages Pixel 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

 

To activate your Cart Pixel:

  1. Copy your SourceKnowledge Pixel from your dashboard by clicking on Get Your Pixel on the left menu.
  2. 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 Pixel 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

 

To activate your Sales Confirmation Pixel:

  1. Copy your SourceKnowledge Pixel from your dashboard by clicking on Get Your Pixel on the left menu.
  2. Paste it in the HTML of your website right above the end </body> tag.

 

SourceKnowledge is a CPA platform. We only charge you when you receive a sale attributed to SourceKnowledge. The Sales Confirmation Pixel 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 Pixel on your Sales Confirmation page will have to dynamically pass the order IDs and order amount.

 

Mandatory Macros for Sales Confirmation Pixel:

  1. Order ID
  2. Order Amount (total cart value)
  3. Product ID (if there are multiple products use a comma separated list)

Google Tag Manager

How Google Tag Manager Works

 

Google Tag Manager enables you insert SourceKnowledge pixels on your website. You can configure the pixel 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 pixel, the pixel’s code executes and sends relevant data back to the platform.

 

JavaScript Pixel Implementation

 

  1. Select “Add New Tag” from the Container tab, and then under “Tag Configuration”, choose “Custom HTML”.
  2. Paste the JavaScript into the area provided. 
  3. Under “Triggering” choose the correct trigger type for the pixel such as all pages, cart page, conversion event, etc. Then click save.
  4. In the upper right-hand corner, click “Publish” and continue to publish all changes.
  5. “Container Version Description” is optional. You can add a description or just click skip. Once you’ve completed these steps, you’re ready to start using SourceKnowledge.

SourceKnowledge Pixel Troubleshooting

  1. Give it time. It can take up to an hour for your SourceKnowledge Pixel to activate.
  2. Make sure your pixel is placed directly before the </body> tag. This ensures that the script loads correctly and has minimal effect on rendering your page content.
  3. Check your formatting. Altering your SourceKnowledge Pixel, including changing formatting affects the script’s ability to fire. Your SourceKnowledge Pixel should be placed on all pages of your site exactly as it was copied.
  4. Did you place the wrong pixel? If you have multiple advertiser profiles, make sure the SourceKnowledge Pixel you placed is linked to the corresponding advertiser profile. Check that the pixel ID (last line of the JavaScript) matches the ID of your SourceKnowledge Pixel 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 pixel is still not firing after 24 hours, or 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.

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:

 

  1. Sign in to Google Analytics.
  2. Click ADMIN, and navigate to view.
  3. In the VIEW column, click User Management.
  4. Under Add permissions for, enter the email address our team member’s Google Account. Contact your Account Manager for more details.
  5. Under permissions, choose Read & Analyze.
  6. Select Notify this user by email to send a notification to our team members that you have completed the process.
  7. 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.

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 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.

 

The formula is:

Clicks ÷ Impressions

 

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.

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.

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.

Domain

In order to be 100% transparent with all of our clients, you have complete access to view your top 20 performing domains by conversions, impressions, clicks and CTR. These metrics give you a picture of where your customers are likely to interact with your ads and shows you which niches and site themes perform best for your brand.

Order ID

It is important to understand as much as you can about every customer of every purchase on your website. In this section you are able to view reporting on the last ad interaction your customer had before purchase, the time and day they made the purchase, the type of conversion they made (click-through or view-through), their location (city, state/province and country) and the order amount. This can help you start to build a customer profile with key demographics and purchase behaviour with your brand.

Path to Conversion

In order to get a more in depth view of all your customers’ buying journey, this portion incorporates unique user IDs of your customers, their location (country, region, city), the operating system (OS) they use, time of the first touch with your ads, domain of the first touch with your ads, time to conversion, order ID and order amount. 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.

Additional 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.

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: 220px by 220px. 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.