mirror of
https://github.com/jazzband/django-analytical.git
synced 2026-03-16 22:20:25 +00:00
74af25be8e
It should be possible to understand the service documentation pages without having come from the index page. This is a first step in making them context-independent.
80 lines
2.6 KiB
ReStructuredText
80 lines
2.6 KiB
ReStructuredText
============================
|
|
HubSpot -- inbound marketing
|
|
============================
|
|
|
|
HubSpot_ helps you get found by customers. It provides tools for
|
|
content creation, convertion and marketing analysis. HubSpot uses
|
|
tracking on your website to measure effect of your marketing efforts.
|
|
|
|
.. _HubSpot: http://www.hubspot.com/
|
|
|
|
|
|
.. hubspot-installation:
|
|
|
|
Installation
|
|
============
|
|
|
|
To start using the HubSpot integration, you must have installed the
|
|
django-analytical package and have added the ``analytical`` application
|
|
to :const:`INSTALLED_APPS` in your project :file:`settings.py` file.
|
|
See :doc:`../install` for details.
|
|
|
|
Next you need to add the HubSpot template tags to your templates. This
|
|
step is only needed if you are not using the generic
|
|
:ttag:`analytical.*` tags. If you are, skip to
|
|
:ref:`hubspot-configuration`.
|
|
|
|
The HubSpot tracking code is inserted into templates using a template
|
|
tag. Load the :mod:`hubspot` template tag library and insert the
|
|
:ttag:`hubspot` tag. Because every page that you want to track must
|
|
have the tag, it is useful to add it to your base template. Insert
|
|
the tag at the bottom of the HTML body::
|
|
|
|
{% load hubspot %}
|
|
...
|
|
{% hubspot %}
|
|
</body>
|
|
</html>
|
|
|
|
|
|
.. _hubspot-configuration:
|
|
|
|
Configuration
|
|
=============
|
|
|
|
Before you can use the HubSpot integration, you must first set your
|
|
portal ID and domain.
|
|
|
|
|
|
.. _hubspot-portal-id:
|
|
|
|
Setting the portal ID and domain
|
|
--------------------------------
|
|
|
|
Your HubSpot account has its own portal ID and primary websit, and the
|
|
:ttag:`hubspot` tag will include them in the rendered Javascript code.
|
|
You can find the portal ID and domain by going to the *Domains* tab in
|
|
your HubSpot account. The domain you need to use is listed as *Primary
|
|
Domain* on that page, and the portal ID can be found in the footer. Set
|
|
:const:`HUBSPOT_PORTAL_ID` and :const:`HUBSPOT_DOMAIN` in the
|
|
project :file:`settings.py` file::
|
|
|
|
HUBSPOT_PORTAL_ID = 'XXXX'
|
|
HUBSPOT_DOMAIN = 'XXXXXXXX.web101.hubspot.com'
|
|
|
|
If you do not set the portal ID and domain, the tracking code will not
|
|
be rendered.
|
|
|
|
|
|
.. _hubspot-internal-ips:
|
|
|
|
Internal IP addresses
|
|
---------------------
|
|
|
|
Usually you do not want to track clicks from your development or
|
|
internal IP addresses. By default, if the tags detect that the client
|
|
comes from any address in the :const:`HUBSPOT_INTERNAL_IPS` setting,
|
|
the tracking code is commented out. It takes the value of
|
|
:const:`ANALYTICAL_INTERNAL_IPS` by default (which in turn is
|
|
:const:`INTERNAL_IPS` by default). See :ref:`identifying-visitors` for
|
|
important information about detecting the visitor IP address.
|