Using Tealium
Tealium is a tag management system that is available exclusively for Studio campaigns. To add Tealium to your account, contact our Care team.
Once added, the following events are added to Tealium’s data layer.
Events in Tealium:
custom_page_view
This event occurs when a supporter lands on a Studio campaign page.
{
event: "custom_page_view",
campaign_id: "campaignId",
campaign_name: "campaignName",
campaign_currency_code: "fundraisingGoalCurrencyCode",
campaign_default_designation_id: "defaultProgramDesignation",
campaign_goal: "goalInCampaignCurrency",
campaign_type: "studio",
campaign_is_embedded: false,
campaign_created_at: "campaignCreatedAt",
campaign_features: "Array", // available values: [], [cart"]
organization_id: "organizationId",
organization_name: "organizationName",
page_path: "pagePath", // e.g. /campaign/123/donate
page_name: "pageName", // i.e. the page title
member_id: "memberId" // if available
}
begin_checkout
This event occurs when a supporter enters the checkout flow.
{
event: "begin_checkout",
label: "Begin Checkout",
action: "checkout",
currency: "USD",
value: "amount", // total transaction amount including DCF in donor's chosen currency
items_item_id: "donation_programDesignationID", // e.g. ["donation_132"]
items_item_category: "categories", // for now, this will always be "donation"
items_price: "itemAmountInDonorCurrency",
items_quantity: "quantity",
items_frequency: "donationFrequency", // one-time, monthly, weekly, bi-weekly, quarterly, semi-annually, yearly
items_designation_id: "programDesignationID",
items_designation_name: "programDesignationName",
campaign_id: "campaignID",
campaign_name: "campaignName",
campaign_features: "features", // only available options either [] or ["cart"]
organization_id: "organizationID",
organization_name: "organizationName",
member_id: "memberId" // if available
}
form_submit
This event occurs when a supporter tries to proceed to the next step of the checkout flow, regardless of whether they encounter an error that prevents them from doing so.
{
event: 'form_submit'
}
form_error
This event will be sent to Tealium whenever someone tries to move on to the next step of the checkout flow and runs into an error.
{
event: 'form_error',
form_section: "section", // "Payment Method", "Payment Details", "Options", "Information", "Complete Payment"
form_error: "errorMessage"
}
purchase
This event will be sent to Tealium whenever someone completes a purchase.
Note: Normalized amounts are unavailable for Giving Cart campaigns.
{
event: "purchase",
transaction_id: "transactionID or orderConfirmationID",
currency: "currencyCode", // donor's chosen currency
value: "amount", // total transaction amount including DCF in donor's chosen currency
tax: 0,
shipping: 0,
affiliation: "Classy",
coupon: "promoCode", // if applicable
status: "success",
created_at: "dateUTC",
fees_covered: "feesCovered", // either "1" (true) or "0" (false)
has_dedication: "hasDedication", // either "1" (true) or "0" (false)
refunded_at: null,
billing_zip_code: "zipCode",
is_gift_aid: "giftAid", // either "1" (true) or "0" (false)
tax_entity_id: "taxEntity",
payment_source: "paymentSource", // "APPLE_PAY", "GOOGLE_PAY", "MANUAL", "PAYPAL", "PLAID", "VENMO", "MANUAL_ACH"
displayed_currency_code: "currencyCode", // donor's chosen currency
displayed_overhead_amount: "amount", // non-tax deductible amount in donor's chosen currency (for now this will always be 0)
displayed_donation_amount: "amount", // tax deductible amount in donor's chosen currency
displayed_total_gross_amount: "amount", // total transaction amount including DCF in donor's chosen currency
normalized_currency_code: "currencyCode", // NPO's default currency
normalized_overhead_amount: "amount", // non-tax deductible amount in NPO's default currency (for now this will always be 0)
normalized_donation_amount: "amount", // tax deductible amount in NPO's default currency
normalized_total_gross_amount: "amount", // total transaction amount including DCF in NPO's default currency
normalized_fees_covered: "amount", // amount of fees covered in NPO's default currency
items_item_id: "donation_programDesignationID", // e.g. "donation_132"
items_item_category: "donation", // for now, this will always be "donation"
items_quantity: 1, // for now, this will always be 1
items_frequency: "donationFrequency", // one-time, monthly, weekly, bi-weekly, quarterly, semi-annually, yearly
items_price: "itemAmountInDonorCurrency",
items_fundraising_page_id: null, // for now, this will always be null
items_fundraising_team_id: null, // for now, this will always be null
items_designation_id: "programDesignationID",
items_designation_name: "programDesignationName",
items_designation_external_reference_id: "programDesignationExternalReference",
company_match_id: "companyMatchId",
company_match_name: "companyMatchName",
campaign_id: "campaignID",
campaign_name: "campaignName",
campaign_features: "features", // only available options either [] or ["cart"]
campaign_type: "studio",
campaign_is_embedded: false,
campaign_currency_code: "fundraisingGoalCurrencyCode",
campaign_default_designation_id: "defaultProgramDesignation",
campaign_goal: "goalInCampaignCurrency",
campaign_created_at: "campaignCreatedAt",
organization_id: "organizationID",
organization_name: "organizationName",
supporter_id: "supporterID",
supporter_first_name: "supporterFirstName",
supporter_last_name: "supporterLastName",
supporter_postal_code: "supporterPostalCode", //only first 3 digits
supporter_email_address: "supporterEmail",
supporter_company_name: "companyName", // if applicable
supporter_is_anonymous: "isAnonymous", // either "1" (true) or "0" (false)
member_id: "memberID"
}