-
Notifications
You must be signed in to change notification settings - Fork 34
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
* Splits documentation over multiple folders * Editor guide documentation intro * Adds segment dashboard documentation * Adds editor documenation regarding segment creation * Adds logo with padding for the documentation * Updates usage guide documentation * Splits sandbox and custom rules documentation * Improves ‘Create a variant’ documentation * Adds documentation regarding streamfield and template tags * Consistent StreamField references * Feedback from M. Dingjan * Remove ‘coming soon’ section * Enable sandbox debug toolbar * Updated documentation
- Loading branch information
Showing
33 changed files
with
537 additions
and
248 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,91 @@ | ||
Creating personalised content | ||
============================= | ||
|
||
Once you've created a segment you can start serving personalised content to your | ||
visitors. To do this, you can choose one of three methods. | ||
|
||
1. Create a page variant for a segment. | ||
2. Use StreamField blocks visible for a segment only. | ||
3. Use a template block visible for a segment only. | ||
|
||
|
||
Method 1: Create a page variant | ||
------------------------------- | ||
|
||
**Why you would want to use this method** | ||
|
||
* It has absolutely no restrictions, you can change anything you want. | ||
* That's pretty much it. | ||
|
||
**Why you would want to use a different method** | ||
|
||
* You are editing a page that changes often. You would probably rather not | ||
change the variation(s) every time the original page changes. | ||
|
||
To create a variant of a page for a specific Segment (which you can change to | ||
your liking after creating it), simply go to the Explorer section and find the | ||
page you would like to personalize. | ||
|
||
.. figure:: ../_static/images/variants_button.png | ||
:alt: The variants button that appears on personalisable pages. | ||
|
||
When you hover over a page, you'll notice a "Variants" dropdown button appears. | ||
Click the button and select the segment you would like to create personalised | ||
content for. | ||
|
||
Once you've selected the segment, a copy of the original page will be created | ||
with a title that includes the segment. Don't worry, your visitors won't be able | ||
to see this title. It's only there for your reference. | ||
|
||
.. figure:: ../_static/images/editing_variant.png | ||
:alt: The newly created page allowing you to change anything you want. | ||
|
||
You can change everything on this page you would like. Visitors that are appointed | ||
to your segment will automatically see the new variant you've created for them | ||
when attempting to visit the original page. | ||
|
||
|
||
Method 2: Use a StreamField block | ||
--------------------------------- | ||
|
||
Preparing a page and it's StreamField blocks for this method is described in the | ||
Usage guide for developers. Please refer to | ||
:ref:`implementing_streamfield_blocks` for more information. | ||
|
||
**Why you would want to use this method** | ||
|
||
* Allows you to create personalised content in the original page (without | ||
creating a variant). | ||
* Create multiple StreamField blocks for different segments inline. | ||
|
||
**Why you would want to use a different method** | ||
|
||
* You need someone tech savvy to change the back-end implementation. | ||
|
||
To create personalised StreamField blocks, first select the page you wan't to | ||
create the content for. Note that the personalisable StreamField blocks must be | ||
activated on the page by your developer. | ||
|
||
Scroll down to the block containing the StreamField and add a personalisable | ||
block. The first input field in the block is a dropdown allowing you to select | ||
the segment this StreamField block is ment for. | ||
|
||
.. figure:: ../_static/images/single_streamfield.png | ||
:alt: Create a new StreamField block and select the segment. | ||
|
||
If you want, you can even add multiple blocks and change the segment to show | ||
different content between segments! | ||
|
||
.. figure:: ../_static/images/dual_streamfield.png | ||
:alt: You can even create multiple variations of the same block! | ||
|
||
Once saved, the page will selectively show StreamField blocks based on the | ||
visitor's segment. | ||
|
||
|
||
Method 3: Use a template block | ||
------------------------------ | ||
|
||
Setting up content in this manner is described in the Usage guide for | ||
developers. Please refer to :ref:`implementing_template_blocks` for more | ||
information. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,84 @@ | ||
Creating a segment | ||
================== | ||
|
||
To create a segment, go to the "Segments dashboard" and click "Add segment". | ||
You can find the segments dashboard in the administration menu on the left of | ||
the page. | ||
|
||
.. figure:: ../_static/images/segment_dashboard_header.png | ||
:alt: The segment dashboard header containing the "Add segment" button. | ||
|
||
On this page you will be presented with two forms. One with specific information | ||
about your segment, the other allowing you to choose and configure your | ||
rules. | ||
|
||
|
||
Set segment specific options | ||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^ | ||
|
||
.. figure:: ../_static/images/edit_segment_specifics.png | ||
:alt: The form that allows you to configure specific segment options. | ||
|
||
1. Enter a name for your segment | ||
|
||
Choose something meaningful like "Newsletter campaign visitors". This will | ||
ensure you'll have a general idea which visitors are in this segment in | ||
other parts of the administration interface. | ||
|
||
2. Select the status of the segment *Optional* | ||
|
||
You will generally keep this one **enabled**. If for some reason you want | ||
to disable the segment, you can change this to **disabled**. | ||
|
||
3. Set the segment persistence. *Optional* | ||
|
||
When persistence is **enabled**, your segment will stick to the visitor once | ||
applied, even if the rules no longer match the next visit. | ||
|
||
4. Select whether to match any or all defined rules. *Optional* | ||
|
||
**Match any** will result in a segment that is applied as soon as one of | ||
your rules matches the visitor. When **match all** is selected, all rules | ||
must match before the segment is applied. | ||
|
||
5. The segment type *Required* | ||
|
||
**Dynamic**: Users in this segment will change as more or less meet the | ||
rules specified in the segment. | ||
|
||
**Static**: If the segment contains only static compatible rules the segment | ||
will contain the members that pass those rules when the segment is created. | ||
Mixed static segments or those containing entirely non static compatible | ||
rules will be populated using the count variable. | ||
|
||
6. The segment count *Optional* | ||
|
||
If this number is set for a static segment users will be added to the set | ||
until the number is reached. After this no more users will be added. | ||
|
||
7. Randomisation percentage *Optional* | ||
|
||
If this number is set each user matching the rules will have this percentage | ||
chance of being placed in the segment. | ||
|
||
Defining rules | ||
^^^^^^^^^^^^^^ | ||
|
||
.. figure:: ../_static/images/edit_segment_rules.png | ||
:alt: The form that allows you to set the rules for a segment. | ||
|
||
5. Choose the rules you want to use. | ||
|
||
Wagxperience comes with a basic set of :doc:`../default_rules` that allow | ||
you to get started quickly. The rules you define will be evaluated once a | ||
visitor makes a request to your application. | ||
|
||
The rules that come with Wagxperience are as follows: | ||
|
||
.. toctree:: | ||
:maxdepth: 2 | ||
|
||
../default_rules | ||
|
||
Click "save" to store your segment. It will be enabled by default, unless | ||
otherwise defined. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,13 @@ | ||
Editor Guide | ||
============ | ||
|
||
The editor guide is meant for content editors and marketers using Wagxperience | ||
to offer a personalised experience to their visitors. | ||
|
||
.. toctree:: | ||
:maxdepth: 2 | ||
|
||
introduction | ||
segments_dashboard | ||
creating_segments | ||
creating_personalised_content |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,22 @@ | ||
Introduction | ||
============ | ||
|
||
Wagxperience_ is an open source module developed by `Lab Digital`_ for the | ||
Wagtail_ content management system. It allows editors and marketeers to create | ||
personalised experiences by harnessing the power of segmentation and rules. | ||
|
||
.. _Wagxperience: http://wagxperience.io | ||
.. _Wagtail: https://wagtail.io | ||
.. _Lab Digital: http://labdigital.nl | ||
|
||
In this guide, we'll take you step by step through the process of offering your | ||
visitors a tailor made online experience. The subjects covered are: | ||
|
||
* Using the segments dashboard | ||
* Defining a new segment | ||
* Setting up rules used to match visitors to a segment | ||
* Personalize a page by creating a variant | ||
* Using the StreamField to personalize content blocks | ||
* And even more helpful stuff... | ||
|
||
So without further ado, let's get started! |
Oops, something went wrong.