Skip to content

Latest commit

 

History

History
854 lines (760 loc) · 53 KB

README.md

File metadata and controls

854 lines (760 loc) · 53 KB

Usage Tracking

Google Listings & Ads implements usage tracking, based on the native WooCommerce Usage Tracking, and is only enabled when WooCommerce Tracking is enabled.

When a store opts in to WooCommerce usage tracking and uses Google Listings & Ads, they will also be opted in to the tracking added by Google Listings & Ads.

What is tracked

As in WooCommerce core, only non-sensitive data about how a store is set up and managed is tracked. We do not track or store personal data from your clients.

  • Plugin version
  • Settings
    • WordPress.com account connection status
    • Google Merchant Center account connection status and connected ID
    • Google Ads account connected ID

Tracking events

All event names are prefixed by wcadmin_.

gla_activated_from_source

Plugin is activated from the "Add Plugins" page in the admin, and has utm query parameters indicating deep linking. Parameters currently tracked (and sent as properties):

  • utm_source
  • utm_medium
  • utm_campaign
  • utm_term
  • utm_content

gla_mc_account_reclaim_url_agreement_check

Clicking on the checkbox to agree with the implications of reclaiming URL.

Properties
checked indicate whether the checkbox is checked or unchecked.

gla_mc_url_switch

Clicking on the checkbox to agree with the implications of reclaiming URL.

Properties
action string
  • required: the Merchant Center account has a different, claimed URL and needs to be changed.
  • success: the Merchant Center account has been changed from blank, updated from a different, unclaimed URL, or after user confirmation of a required change.

gla_site_claim

Properties
action string
  • overwrite_required: the site URL is claimed by another Merchant Center account and overwrite confirmation is required
  • success: URL has been successfully set or overwritten.
  • failure
details string Used for failure action.
  • independent_account: unable to execute site claim because the provided Merchant Center account is not a sub-account of our MCA
  • google_proxy: claim failed using the user creds (in the Merchant class)
  • google_manager: claimed failed using MCA creds (paradoxically in the Middleware class)

gla_site_verify_failure

When a site verification with Google fails

Properties
step string the step of the process that failed (token, meta-tag, unknown)

gla_site_verify_success

When a site is successfully verified with Google

gla_created_campaign

When a campaign has been successfully created.

Properties

name type description
id int Campaign ID.
status string Campaign status, enabled or paused.
name string Campaign name, generated based on date.
amount float Campaign budget.
country string Base target country code.
targeted_locations string Additional target country codes.

gla_edited_campaign

When a campaign has been successfully edited.

Properties

name type description
id int Campaign ID.
status string Campaign status, enabled or paused.
name string Campaign name.
amount float Campaign budget.

gla_deleted_campaign

When a campaign has been successfully deleted.

Properties

name type description
id int Campaign ID.

gla_ads_setup_completed

Ads onboarding has been successfully completed.

Properties

name type description
campaign_count int Number of campaigns for the connected Ads account.

gla_mc_setup_completed

Merchant Center onboarding has been successfully completed.

Properties

name type description
shipping_rate string Shipping rate setup automatic, manual, flat.
offers_free_shipping bool Free Shipping is available.
free_shipping_threshold float Minimum amount to avail of free shipping.
shipping_time string Shipping time setup flat, manual.
tax_rate string Tax rate setup destination, manual.
target_countries string List of target countries or all.

gla_add_paid_campaign_clicked

"Add paid campaign" button is clicked.

Properties

name type description
context string Indicate the place where the button is located.
href string Indicate the destination where the users is directed to, e.g. '/google/setup-ads'.

Emitters

gla_ads_account_connect_button_click

Clicking on the button to connect an existing Google Ads account.

Properties

name type description
id number The account ID to be connected.

Emitters

gla_ads_account_create_button_click

Clicking on the button to create a new Google Ads account, after agreeing to the terms and conditions.

Emitters

  • TermsModal When agreed by clicking "Create account".

gla_ads_set_up_billing_click

"Set up billing" button for Google Ads account is clicked.

Properties

name type description
context string Indicates the place where the button is located, e.g. setup-ads.
link_id string A unique ID for the button within the context, e.g. set-up-billing.
href string Indicates the destination where the users is directed to.

Emitters

  • BillingSetupCard with { context: 'setup-ads', link_id: 'set-up-billing', href: billingUrl }

gla_attribute_mapping_create_rule

Creates the rule successfully

Properties

name type description
context string Indicates where this event happened

Emitters

gla_attribute_mapping_delete_rule

Deletes the rule successfully

Properties

name type description
context string Indicates where this event happened

Emitters

gla_attribute_mapping_delete_rule_click

Clicks on delete rule button

Properties

name type description
context string Indicates where this event happened

Emitters

gla_attribute_mapping_save_rule_click

Clicks on save rule button

Properties

name type description
context string Indicates where this event happened

Emitters

  • AttributeMappingRuleModal When user clicks on save rule button with { context: 'attribute-mapping-manage-rule-modal' | 'attribute-mapping-create-rule-modal' }

gla_attribute_mapping_update_rule

Updates the rule successfully

Properties

name type description
context string Indicates where this event happened

Emitters

gla_bulk_edit_click

Triggered when the product feed "bulk edit" functionality is being used

Properties

name type description
context string Name of the table
number_of_items number Edit how many items
visibility_to string ("sync_and_show" | "dont_sync_and_show")

Emitters

gla_ces_feedback

CES feedback recorded

Emitters

gla_ces_modal_open

CES modal open

Emitters

gla_ces_snackbar_closed

CES prompt snackbar closed

Emitters

gla_ces_snackbar_open

CES prompt snackbar open

Emitters

gla_chart_tab_click

Triggered when a chart tab is clicked

Properties

name type description
report string Name of the report (e.g. "reports-programs" | "reports-products")
context string Metric key of the clicked tab (e.g. "sales" | "conversions" | "clicks" | "impressions" | "spend").

Emitters

gla_contact_information_save_button_click

Triggered when the save button in contact information page is clicked.

Emitters

gla_dashboard_edit_program_click

Triggered when "continue" to edit program button is clicked.

Properties

name type description
programId string program id
url string url (free or paid)

Emitters

gla_datepicker_update

Triggered when datepicker (date ranger picker) is updated, with report name and data that comes from DateRangeFilterPicker's onRangeSelect callback

Properties

name type description
report string Name of the report (e.g. "dashboard" | "reports-programs" | "reports-products" | "product-feed")
compare string Value selected in datepicker.
period string Value selected in datepicker.
before string Value selected in datepicker.
after string Value selected in datepicker.

Emitters

gla_disconnected_accounts

Accounts are disconnected from the Setting page

Properties

name type description
context string (all-accounts|ads-account) - indicate which accounts have been disconnected.

gla_documentation_link_click

When a documentation link is clicked.

Properties

name type description
link_id string link identifier
context string indicate which link is clicked
href string link's URL

Emitters

  • AppDocumentationLink
  • ContactInformation
    • with { context: 'setup-mc-contact-information', link_id: 'contact-information-read-more', href: 'https://woo.com/document/google-listings-and-ads/#contact-information' }
    • with { context: 'settings-no-phone-number-notice', link_id: 'contact-information-read-more', href: 'https://woo.com/document/google-listings-and-ads/#contact-information' }
    • with { context: 'settings-no-store-address-notice', link_id: 'contact-information-read-more', href: 'https://woo.com/document/google-listings-and-ads/#contact-information' }
  • DifferentCurrencyNotice
    • with { context: "dashboard", link_id: "setting-up-currency", href: "https://support.google.com/google-ads/answer/9841530" }
    • with { context: "reports-products", link_id: "setting-up-currency", href: "https://support.google.com/google-ads/answer/9841530" }
    • with { context: "reports-programs", link_id: "setting-up-currency", href: "https://support.google.com/google-ads/answer/9841530" }
  • ChooseAudienceSection with { context: 'setup-mc-audience', link_id: 'site-language', href: 'https://support.google.com/merchants/answer/160637' }
  • ShippingTimeSection with { context: 'setup-mc-shipping', link_id: 'shipping-read-more', href: 'https://support.google.com/merchants/answer/7050921' }
  • TaxRate
    • with { context: 'setup-mc-tax-rate', link_id: 'tax-rate-read-more', href: 'https://support.google.com/merchants/answer/160162' }
    • with { context: 'setup-mc-tax-rate', link_id: 'tax-rate-manual', href: 'https://www.google.com/retail/solutions/merchant-center/' }
  • ConnectGoogleAccountCard with { context: 'setup-mc-accounts', link_id: 'required-google-permissions', href: 'https://woo.com/document/google-listings-and-ads/#required-google-permissions' }
  • RequestFullAccessGoogleAccountCard with { context: 'setup-mc-accounts', link_id: 'required-google-permissions', href: 'https://woo.com/document/google-listings-and-ads/#required-google-permissions' }
  • ConnectAds with { context: 'setup-ads-connect-account', link_id: 'connect-sub-account', href: 'https://support.google.com/google-ads/answer/6139186' }
  • TermsModal
    • with { context: 'setup-ads', link_id: 'shopping-ads-policies', href: 'https://support.google.com/merchants/answer/6149970' }
    • with { context: 'setup-ads', link_id: 'google-ads-terms-of-service', href: 'https://support.google.com/adspolicy/answer/54818' }
  • ReclaimUrlCard with { context: 'setup-mc', link_id: 'claim-url', href: 'https://support.google.com/merchants/answer/176793' }
  • TermsModal with { context: 'setup-mc', link_id: 'google-mc-terms-of-service', href: 'https://support.google.com/merchants/answer/160173' }
  • exports with { context: 'create-ads' | 'edit-ads' | 'setup-ads', link_id: 'see-what-ads-look-like', href: 'https://support.google.com/google-ads/answer/6275294' }
  • FaqsSection with { context: 'assets-faq', linkId: 'assets-faq-about-ad-formats-available-in-different-campaign-types', href: 'https://support.google.com/google-ads/answer/1722124' }.
  • ShippingRateSection
    • with { context: 'setup-mc-shipping', link_id: 'shipping-read-more', href: 'https://support.google.com/merchants/answer/7050921' }
    • with { context: 'setup-mc-shipping', link_id: 'shipping-manual', href: 'https://www.google.com/retail/solutions/merchant-center/' }
  • Faqs
    • with { context: 'faqs', linkId: 'general-requirements', href: 'https://woo.com/document/google-listings-and-ads/#general-requirements' }.
    • with { context: 'faqs', linkId: 'claiming-urls', href: 'https://support.google.com/merchants/answer/7527436' }.
    • with { context: 'faqs', linkId: 'google-merchant-center-requirements', href: 'https://woo.com/document/google-listings-and-ads/#google-merchant-center-requirements' }.
    • with { context: 'faqs', linkId: 'performance-max', href: 'https://woo.com/document/google-listings-and-ads/#google-performance-max-campaigns' }.
    • with { context: 'faqs', linkId: 'free-listings', href: 'https://woo.com/document/google-listings-and-ads/#free-listings-on-google' }.
    • with { context: 'faqs', linkId: 'campaign-analytics', href: 'https://woo.com/document/google-listings-and-ads/#getting-started-with-campaign-analytics' }.
    • with { context: 'faqs', linkId: 'terms-and-conditions-of-google-ads-coupons', href: 'https://www.google.com/ads/coupons/terms/' }.
  • GetStartedCard with { context: 'get-started', linkId: 'wp-terms-of-service', href: 'https://wordpress.com/tos/' }.
  • GetStartedWithVideoCard with { context: 'get-started-with-video', linkId: 'wp-terms-of-service', href: 'https://wordpress.com/tos/' }.
  • UnsupportedLanguage with { context: 'get-started', link_id: 'supported-languages', href: 'https://support.google.com/merchants/answer/160637' }
  • UnsupportedCountry with { context: "get-started", link_id: "supported-countries" }
  • IssuesTableDataModal with { context: 'issues-data-table-modal' }
  • ProductStatusHelpPopover with { context: 'product-feed', link_id: 'product-sync-statuses', href: 'https://support.google.com/merchants/answer/160491' }
  • EditPhoneNumber with { context: "settings-phone-number", link_id: "contact-information-read-more", href: "https://woo.com/document/google-listings-and-ads/#contact-information" }
  • EditStoreAddress with { context: "settings-store-address", link_id: "contact-information-read-more", href: "https://woo.com/document/google-listings-and-ads/#contact-information" }
  • FreeAdCredit with { context: 'setup-ads', link_id: 'free-ad-credit-terms', href: 'https://www.google.com/ads/coupons/terms/' }
  • Faqs with { context: 'faqs', link_id: 'find-a-partner', href: 'https://comparisonshoppingpartners.withgoogle.com/find_a_partner/' }
  • GoogleMCDisclaimer
    • with { context: 'setup-mc-accounts', link_id: 'comparison-shopping-services', href: 'https://support.google.com/merchants/topic/9080307' }
    • with { context: 'setup-mc-accounts', link_id: 'comparison-shopping-partners-find-a-partner', href: 'https://comparisonshoppingpartners.withgoogle.com/find_a_partner/' }

gla_edit_mc_phone_number

Triggered when phone number edit button is clicked.

Properties

name type description
path string The path used in the page, e.g. "/google/settings".
subpath string The subpath used in the page, or undefined when there is no subpath.

Emitters

gla_edit_mc_store_address

Trigger when store address edit button is clicked. Before 1.5.0 this name was used for tracking clicking "Edit in settings" to edit the WC address. As of >1.5.0, that event is now tracked as edit_wc_store_address.

Properties

name type description
path string The path used in the page from which the link was clicked, e.g. "/google/settings".
subpath string|undefined The subpath used in the page, e.g. "/edit-store-address" or undefined when there is no subpath.

Emitters

gla_edit_product_click

Triggered when edit links are clicked from product feed table.

Properties

name type description
status string ("approved" | "partially_approved" | "expiring" | "pending" | "disapproved" | "not_synced")
visibility string ("sync_and_show" | "dont_sync_and_show")

Emitters

gla_edit_product_issue_click

Triggered when edit links are clicked from Issues to resolve table.

Properties

name type description
code string Issue code returned from Google
issue string Issue description returned from Google

gla_edit_wc_store_address

Triggered when store address "Edit in WooCommerce Settings" button is clicked. Before 1.5.0 it was called edit_mc_store_address.

Properties

name type description
path string The path used in the page from which the link was clicked, e.g. "/google/settings".
subpath string|undefined The subpath used in the page, e.g. "/edit-store-address" or undefined when there is no subpath.

Emitters

gla_faq

Clicking on faq item to collapse or expand it.

Properties

name type description
id string FAQ identifier
action string (expand|collapse)
context string Indicates which page / module the FAQ is in

Emitters

  • FaqsSection
    • with { context: 'campaign-management', id: 'what-will-my-ads-look-like', action: 'expand' | 'collapse' }.
    • with { context: 'campaign-management', id: 'what-makes-these-ads-different-from-product-ads', action: 'expand' | 'collapse' }.
  • Faqs
    • with { context: 'get-started', id: 'what-do-i-need-to-get-started', action: 'expand' }.
    • with { context: 'get-started', id: 'what-do-i-need-to-get-started', action: 'collapse' }.
    • with { context: 'get-started', id: 'what-if-i-already-have-free-listings', action: 'expand' }.
    • with { context: 'get-started', id: 'what-if-i-already-have-free-listings', action: 'collapse' }.
    • with { context: 'get-started', id: 'is-my-store-ready-to-sync-with-google', action: 'expand' }.
    • with { context: 'get-started', id: 'is-my-store-ready-to-sync-with-google', action: 'collapse' }.
    • with { context: 'get-started', id: 'what-is-a-performance-max-campaign', action: 'expand' }.
    • with { context: 'get-started', id: 'what-is-a-performance-max-campaign', action: 'collapse' }.
    • with { context: 'get-started', id: 'what-are-free-listings', action: 'expand' }.
    • with { context: 'get-started', id: 'what-are-free-listings', action: 'collapse' }.
    • with { context: 'get-started', id: 'where-to-track-free-listings-and-performance-max-campaign-performance', action: 'expand' }.
    • with { context: 'get-started', id: 'where-to-track-free-listings-and-performance-max-campaign-performance', action: 'collapse' }.
    • with { context: 'get-started', id: 'how-to-sync-products-to-google-free-listings', action: 'expand' }.
    • with { context: 'get-started', id: 'how-to-sync-products-to-google-free-listings', action: 'collapse' }.
    • with { context: 'get-started', id: 'can-i-run-both-shopping-ads-and-free-listings-campaigns', action: 'expand' }.
    • with { context: 'get-started', id: 'can-i-run-both-shopping-ads-and-free-listings-campaigns', action: 'collapse' }.
    • with { context: 'get-started', id: 'how-can-i-get-the-ad-credit-offer', action: 'expand' }.
    • with { context: 'get-started', id: 'how-can-i-get-the-ad-credit-offer', action: 'collapse' }.
  • Faqs
    • with { context: 'setup-mc-accounts', id: 'why-do-i-need-a-wp-account', action: 'expand' }.
    • with { context: 'setup-mc-accounts', id: 'why-do-i-need-a-wp-account', action: 'collapse' }.
    • with { context: 'setup-mc-accounts', id: 'why-do-i-need-a-google-mc-account', action: 'expand' }.
    • with { context: 'setup-mc-accounts', id: 'why-do-i-need-a-google-mc-account', action: 'collapse' }.

gla_filter

Triggered when changing products & variations filter, with data that comes from FilterPicker's onFilterSelect callback.

Properties

name type description
report string Name of the report (e.g. "reports-products")
filter string Value of the filter (e.g. "all" | "single-product" | "compare-products")
variationFilter string | undefined Value of the variation filter (e.g. undefined | "single-variation" | "compare-variations")

Emitters

gla_free_ad_credit_country_click

Clicking on the link to view free ad credit value by country.

Properties

name type description
context string Indicates which page the link is in.

Emitters

gla_free_campaign_edited

Saving changes to the free campaign.

Emitters

gla_google_account_connect_button_click

Clicking on the button to connect Google account.

Properties

name type description
context string (setup-mc|setup-ads|reconnect) - indicate the button is clicked from which page.
action string (authorization|scope) - authorization is used when the plugin has not been authorized yet and requests Google account access and permission scopes from users. - scope is used when requesting required permission scopes from users in order to proceed with more plugin functions. Added with the Partial OAuth feature (aka Incremental Authorization).

Emitters

gla_google_account_connect_different_account_button_click

Clicking on the "connect to a different Google account" button.

Emitters

gla_google_ads_account_link_click

Clicking on a Google Ads account text link.

Properties

name type description
context string Indicates which page / module the link is in
href string Where the user is redirected
link_id string A unique ID for the link within the page / module

Emitters

gla_google_mc_link_click

Clicking on a Google Merchant Center link.

Properties

name type description
context string Indicates which page / module the link is in
href string Link's URL

Emitters

gla_help_click

"Help" button is clicked.

Properties

name type description
context string Indicates the place where the button is located, e.g. setup-ads.

Emitters

gla_import_assets_by_final_url_button_click

Clicking on the "Scan for assets" button.

Properties

name type description
type string The type of the selected Final URL suggestion to be imported. Possible values: post, term, homepage.

Emitters

gla_launch_paid_campaign_button_click

Triggered when the "Launch paid campaign" button is clicked to add a new paid campaign in the Google Ads setup flow.

Properties

name type description
audiences string Country codes of the paid campaign audience countries, e.g. 'US,JP,AU'. This means the campaign is created with the multi-country targeting feature. Before this feature support, it was implemented as 'audience'.
budget string Daily average cost of the paid campaign

Emitters

gla_mc_account_connect_button_click

Clicking on the button to connect an existing Google Merchant Center account.

Properties

name type description
id number The account ID to be connected.

Emitters

gla_mc_account_connect_different_account_button_click

Clicking on the "connect to a different Google Merchant Center account" button.

Emitters

gla_mc_account_create_button_click

Clicking on the button to create a new Google Merchant Center account, after agreeing to the terms and conditions.

Emitters

gla_mc_account_reclaim_url_button_click

Clicking on the button to reclaim URL for a Google Merchant Center account.

Emitters

gla_mc_account_switch_account_button_click

Clicking on the "Switch account" button to select a different Google Merchant Center account to connect.

Properties

name type description
context string (switch-url|reclaim-url) - indicate the button is clicked from which step.

Emitters

gla_mc_account_switch_url_button_click

Clicking on the button to switch URL for a Google Merchant Center account.

Emitters

gla_mc_account_warning_modal_confirm_button_click

Clicking on the "Yes, I want a new account" button in the warning modal for creating a new Google Merchant Center account.

Emitters

gla_mc_phone_number_check

Check for whether the phone number for Merchant Center exists or not.

Properties

name type description
path string the path where the check is in.
exist string whether the phone number exists or not.
isValid string whether the phone number is valid or not.

Emitters

gla_mc_phone_number_edit_button_click

Clicking on the Merchant Center phone number edit button.

Properties

name type description
view string which view the edit button is in. Possible values: setup-mc, settings.

Emitters

gla_modal_closed

A modal is closed.

Properties

name type description
context string Indicates which modal is closed
action string Indicates the modal is closed by what action (e.g. maybe-later|dismiss | create-another-campaign) - maybe-later is used when the "Maybe later" button on the modal is clicked - dismiss is used when the modal is dismissed by clicking on "X" icon, overlay, generic "Cancel" button, or pressing ESC - create-another-campaign is used when the button "Create another campaign" is clicked - create-paid-campaign is used when the button "Create paid campaign" is clicked - confirm is used when the button "Confirm", "Save" or similar generic "Accept" button is clicked

Emitters

gla_modal_content_link_click

Clicking on a text link within the modal content

Properties

name type description
context string Indicates which link is clicked
href string Link's URL

Emitters

gla_modal_open

A modal is open

Properties

name type description
context string Indicates which modal is open

Emitters

gla_onboarding_complete_button_click

Clicking on the skip paid ads button to complete the onboarding flow. The 'unknown' value of properties may means:

  • the paid ads setup is not opened
  • the final status has not yet been resolved when recording this event
  • the status is not available, for example, the billing status is unknown if Google Ads account is not yet connected

Properties

name type description
opened_paid_ads_setup string Whether the paid ads setup is opened, e.g. 'yes', 'no'
google_ads_account_status string The connection status of merchant's Google Ads addcount, e.g. 'connected', 'disconnected', 'incomplete'
billing_method_status string aaa, The status of billing method of merchant's Google Ads addcount e.g. 'unknown', 'pending', 'approved', 'cancelled'
campaign_form_validation string Whether the entered paid campaign form data are valid, e.g. 'unknown', 'valid', 'invalid'

Emitters

gla_onboarding_complete_with_paid_ads_button_click

Clicking on the "Complete setup" button to complete the onboarding flow with paid ads.

Properties

name type description
budget number The budget for the campaign
audiences string The targeted audiences for the campaign

Emitters

gla_onboarding_open_paid_ads_setup_button_click

Clicking on the "Create a paid ad campaign" button to open the paid ads setup in the onboarding flow.

Emitters

gla_paid_campaign_step

Triggered when moving to another step during creating/editing a campaign.

Properties

name type description
triggered_by string Indicates which button triggered this event
action string User's action or/and objective (e.g. go-to-step-2)
context string | undefined Indicates where this event happened

Emitters

  • CreatePaidAdsCampaign
    • with { context: 'create-ads', triggered_by: 'step1-continue-button', action: 'go-to-step2' }.
    • with { context: 'create-ads', triggered_by: 'stepper-step1-button', action: 'go-to-step1' }.
  • EditPaidAdsCampaign
    • with { context: 'edit-ads', triggered_by: 'step1-continue-button', action: 'go-to-step2' }.
    • with { context: 'edit-ads', triggered_by: 'stepper-step1-button', action: 'go-to-step1' }.

gla_request_review

Triggered when request review button is clicked

Emitters

gla_request_review_failure

Triggered when the request review fails

Emitters

gla_request_review_issues_solved_checkbox_click

Triggered when clicking on the checkbox

Properties

name type description
action 'check'|'uncheck' Indicates if the checkbox is checked or unchecked

Emitters

gla_request_review_success

Triggered when the request review is successful

Emitters

gla_reselect_another_final_url_button_click

Clicking on the "Or, select another page" button.

Emitters

gla_setup_ads

Triggered on events during ads onboarding

Properties

name type description
triggered_by string Indicates which button triggered this event
action string User's action or/and objective (e.g. leave, go-to-step-2)
target string | undefined (Deprecated: this property should not be used after Q1 2024) Button ID
trigger string | undefined (Deprecated: this property should not be used after Q1 2024) Action (e.g. click)

Emitters

  • AdsStepper
    • with { triggered_by: 'step1-continue-button' | 'step2-continue-button' , action: 'go-to-step2' | 'go-to-step3' }.
    • with { triggered_by: 'stepper-step1-button' | 'stepper-step2-button', action: 'go-to-step1' | 'go-to-step2' }.
  • SetupAdsTopBar with given { triggered_by: 'back-button', action: 'leave', target: 'back', trigger: 'click' } when back button is clicked.

gla_setup_ads_faq

Clicking on faq items to collapse or expand it in the Onboarding Flow or creating/editing a campaign

Properties

name type description
id string FAQ identifier
action string (expand|collapse)

Emitters

gla_setup_mc

Setup Merchant Center

Properties

name type description
triggered_by string Indicates which button triggered this event
action string User's action or/and objective (e.g. leave, go-to-step-2)
context string | undefined Indicates which CTA is clicked
target string | undefined (Deprecated: this property should not be used after Q1 2024) Button ID
trigger string | undefined (Deprecated: this property should not be used after Q1 2024) Action (e.g. click)

Emitters

  • GetStartedCard with { triggered_by: 'start-onboarding-button', action: 'go-to-onboarding', context: 'get-started', target: 'set_up_free_listings', trigger: 'click' }.
  • GetStartedWithVideoCard with { triggered_by: 'start-onboarding-button', action: 'go-to-onboarding', context: 'get-started-with-video', target: 'set_up_free_listings', trigger: 'click' }.
  • SavedSetupStepper
    • with { triggered_by: 'step1-continue-button' | 'step2-continue-button', 'step3-continue-button', action: 'go-to-step2' | 'go-to-step3' | 'go-to-step4', target: 'step1_continue' | 'step2_continue' | 'step3_continue', trigger: 'click' }.
    • with { triggered_by: 'stepper-step1-button' | 'stepper-step2-button' | 'stepper-step3-button', action: 'go-to-step1' | 'go-to-step2' | 'go-to-step3' }.
  • SetupMCTopBar with { triggered_by: 'back-button', action: 'leave', target: 'back', trigger: 'click' }.

gla_submit_campaign_button_click

Clicking on the submit button on the campaign creation or editing page. If a value is recorded as unknown, it's because no assets are imported and therefore unknown.

Properties

name type description
context string Indicate the place where the button is located. Possible values: campaign-creation, campaign-editing.
action string Indicate which submit button is clicked. Possible values: submit-campaign-and-assets, submit-campaign-only.
audiences string Country codes of the campaign audience countries, e.g. US,JP,AU.
budget string Daily average cost of the campaign.
assets_validation string Whether all asset values are valid or at least one invalid. Possible values: valid, invalid, unknown.
number_of_business_name string The number of this asset in string type or unknown.
number_of_marketing_image string Same as above.
number_of_square_marketing_image string Same as above.
number_of_portrait_marketing_image string Same as above.
number_of_logo string Same as above.
number_of_headline string Same as above.
number_of_long_headline string Same as above.
number_of_description string Same as above.
number_of_call_to_action_selection string Same as above.
number_of_final_url string Same as above.
number_of_display_url_path string Same as above.

Emitters

gla_table_go_to_page

When table pagination is changed by entering page via "Go to page" input.

Properties

name type description
context string Name of the table
page string Page number (starting at 1)

Emitters

gla_table_header_toggle

Toggling display of table columns

Properties

name type description
report string Name of the report table (e.g. "dashboard" | "reports-programs" | "reports-products" | "product-feed")
column string Name of the column
status 'on' | 'off' Indicates if the column was toggled on or off.

Emitters

gla_table_page_click

When table pagination is clicked

Properties

name type description
context string Name of the table
direction string Direction of page to be changed. ("next" | "previous")

Emitters

gla_table_sort

Sorting table

Properties

name type description
report string Name of the report table (e.g. "dashboard" | "reports-programs" | "reports-products" | "product-feed")
column string Name of the column
direction string (asc|desc)

Emitters

gla_tooltip_viewed

Viewing tooltip

Properties

name type description
id string Tooltip identifier.

Emitters

gla_wc_store_address_validation

Track how many times and what fields the store address is having validation errors.

Properties

name type description
path string The path used in the page from which the event tracking was sent, e.g. "/google/setup-mc" or "/google/settings".
subpath string|undefined The subpath used in the page, e.g. "/edit-store-address" or undefined when there is no subpath.
country_code string The country code of store address, e.g. "US".
missing_fields string The string of the missing required fields of store address separated by comma, e.g. "city,postcode".

Emitters

  • StoreAddressCard Whenever the new store address data is fetched after clicking "Refresh to sync" button.

gla_wordpress_account_connect_button_click

Clicking on the button to connect WordPress.com account.

Properties

name type description
context string (setup-mc|reconnect) - indicates from which page the button was clicked.

Emitters