Event metadata available for Reddit Pixel
Below is a pretty big table with all the metadata you can leverage for 5 of our standard conversion events: AddToCart, Purchase, AddToWishlist, Lead, SignUp, plus Custom, along with important things to note as you plug the metadata in.
| Conversion Event Name | Event Metadata | Field Type | Description |
|---|---|---|---|
| AddToCart | itemCount | integer | Total items in the cart. Example: itemCount:2 |
| value | integer | Total AddToCart Value (in decimal points). Example: For a value of $19.99, the value that should be passed is 19.99. | |
| currency | string | ISO 4217 3 letter currency code of total AddToCart Value Examples: | |
| conversionId | string | Unique conversion ID that corresponds to a distinct conversion event. Used for deduplication and should be passed as a unique value per event. Note: We recommend Conversion ID configuration only if implementing both the Reddit Pixel and Conversions API to prevent the same conversion event from being double counted if it is sent across both sources. If this value is passed improperly, it will impact attribution and campaign performance. If the conversion ID is unhashed, Reddit will use SHA256 to hash the ID before it is stored in our system. Examples: conversionId:'UniqueConversionID' conversionId:’7e49017773393111f57afac4f536700fe4be5e3b903be66eba0d4beb66dd9aea’ | |
| Purchase | itemCount | integer | Total items purchased Example: itemCount:2 |
value | integer | Total Purchase Value (in decimal points). Example: For a value of $19.99, the value that should be passed is 19.99. | |
| currency | string | ISO 4217 3 letter currency code of total Purchase Amount Examples: | |
| conversionId | string | Unique Conversion ID that corresponds to a distinct conversion event. Conversion ID is used for deduplication and should be passed as a unique value per event. | |
| AddToWishlist | itemCount | integer | Total items in the wish list Example: itemCount=2 |
| value | integer | Total AddToWishlist Value (in decimal points). Example: For a value of $19.99, the value that should be passed is 19.99. | |
| currency | string | ISO 4217 3 letter currency code of total Wishlist value Examples: | |
| conversionId | string | Unique Conversion ID that corresponds to a distinct conversion event. Conversion ID is used for deduplication and should be passed as a unique value per event. Note: We recommend Conversion ID configuration only if implementing both the Reddit Pixel and Conversions API to prevent the same conversion event from being double counted if it is sent across both sources. If this value is passed improperly, it will impact attribution and campaign performance. If the conversion ID is unhashed, Reddit will use SHA256 to hash the ID before it is stored in our system. Examples: conversionId:'UniqueConversionID' conversionId:’7e49017773393111f57afac4f536700fe4be5e3b903be66eba0d4beb66dd9aea’ | |
| Lead | value | integer | Total Lead Value (in decimal points). Example: For a value of $19.99, the value that should be passed is 19.99. |
| currency | string | ISO 4217 3 letter currency code of Lead value Examples: | |
| conversionId | string | Unique Conversion ID that corresponds to a distinct conversion event. Conversion ID is used for deduplication and should be passed as a unique value per event. | |
| SignUp | value | integer | Total SignUp Value (in decimal points). Example: For a value of $19.99, the value that should be passed is 19.99. |
| currency | string | ISO 4217 3 letter currency code of SignUp value Examples: | |
| conversionId | string | Unique Conversion ID that corresponds to a distinct conversion event. Conversion ID is used for deduplication and should be passed as a unique value per event. | |
| Custom | itemCount | integer | Total number of custom event items. Example: itemCount:2 |
| value | integer | Advertiser assigned value to the custom event (in decimal points). Example: For a value of $19.99, the value that should be passed is 19.99. | |
| currency | string | ISO 4217 3 letter currency code of Custom value Examples: | |
| conversionId | string | Unique Conversion ID that corresponds to a distinct conversion event. Conversion ID is used for deduplication and should be passed as a unique value per event. |
How to set up event metadata manually
In order to set up event metadata manually, you’ll need to replace 'EventName' in the rdt('track','EventName') function with the specific Reddit Pixel event name you’re looking to fire.
But first:
- You’ll need to have installed the Reddit Pixel. Instructions here.
We recommend adding the base PageVisit pixel as usual on the page, and then passing the metadata values in a separate pixel event call on the same page.
Example: Say you wanted to capture AddToCart metadata. With the base PageVisit pixel already added, you’d simply add a pixel event call and pass the metadata like this:
<script>
rdt('track', 'AddToCart', {
itemCount: 2,
value: 19.99,
currency: 'USD'
});
</script> |
And here's another: Purchase event including a conversionID:
<script>
rdt('track', 'Purchase', {
itemCount: 2,
value: 19.99,
currency: 'USD',
conversionId:’7e49017773393111f57afac4f536700fe4be5e3b903be66eba0d4beb66dd9aea’
});
</script> |
How to set up event metadata with Google Tag Manager(GTM)
You can set up event metadata using Google Tag Manager (GTM) during tag creation.
But first:
- You’ll need to have installed the Reddit Pixel. Instructions here.
From GTM:
- As you configure a new tag, and you select one of the pixel events that supports metadata (AddToCart, Purchase, AddToWishlist, Lead, SignUp), you’ll see the optional metadata fields appear for the supported events. Note: Make sure you’ve entered your Reddit advertiser ID (i.e. t2_xxxxxx) into the “Advertiser ID” field. You can find this ID on your pixel conversions page.
- When you’re ready, you can grab and add your site’s metadata macros to the corresponding fields.
- Pick which Triggers (user actions) you want to make the pixel fire.
Next steps:
Verify event metadata is passing correctly
Reporting:
Here are the metadata reporting metrics you can expect to see in the Ads Dashboard.
Remember: We display reporting metrics according to the account's selected currency.
Conversion event | Description |
Total Value (AddToCart) | Total value of the shopping cart |
Average Value (AddToCart) | Average shipping cart value |
Cart Size (AddToCart) | Total size of the shopping cart i.e number of items in the cart |
Total Value (AddToWishlist) | Total value of the wishlist |
Average Value (AddToWishlist) | Average wishlist value |
Cart Size (AddToWishlist) | Total size of the wish list i.e number of items in the wish list |
Total Value (Lead) | Advertiser assigned value to the lead |
Average Value (Lead) | Advertiser assigned average value of a lead |
Total Value (SignUp) | Advertiser assigned value to the sign up Example: It could be a subscription that has a value tied to it |
Average Value (SignUp) | Advertiser assigned average value of a sign up Example: It could be a subscription that has a value tied to it |
Total Value (Purchase) | Total value of the purchase |
Average Value (Purchase) | Average purchase value |
Checkout Size (Purchase) | Total size of the purchase e.g. number of items purchased |
Purchase ROAS (Return On Ad Spend) | Calculated as ‘TotalValue (purchase)’ / ’Total Ad Spend’ |
