Wiki source code of Segment Manager

Version 17.1 by prachiti on 2021/10/25 21:17

version	line-number	content
4.1	1	{{layout}}
	2	{{layout-section ac:type="two_right_sidebar"}}
	3	{{layout-cell}}
3.1	4
	5
	6	{{id name="Start ScreenSteps Content"/}}
16.1	7	The Targeting Engine is a powerful tool that allows to quickly and easily define audience Segments and target them with specific Actions, e.g. target specific ads, display a pop-up, send an email, redirect to another page or site.
3.1	8
5.1	9	You can target segments by IP Address and User Agent. This functionality can be used to define a set of IP addresses that may be, for example, non-human traffic that you don't want to display paid banner ads to. By defining the target IP addresses and setting the action to serve only house ads, those IP addresses won't be counted as impressions/views/clicks for paid banner advertising. Or you could redirect to a page or a pop-up with a message that the IP address is suspected of being non-human traffic and a number to call if not the case. That IP could then be removed from the target segment.
3.1	10
17.1	11	The following lesson will provide details on how to use the Segment Manager.
3.1	12
	13	=== Please Note: ===
	14
	15	Segments and targeting actions can be applied to both Known and Unknown users.
	16
	17	If the defined criteria for a target segment doesn't require a user be known, e.g. viewing a particular webpage or section 3 times, as soon as a user meets that criteria by viewing the defined webpage or section 3 times, he/she is included in that segment (whether a known user or not) and the targeting action will occur.
	18
	19	Also note that both users who fit the criteria for the defined segment as of the effective start date of an action and users who meet the criteria at any time during the effective date range will be targeted.
	20
12.1	21	=== ===
3.1	22
16.1	23	{{id name="CreateSegment"/}}CREATING A NEW SEGMENTFrom the left hand side navigation bar, select Activation → Segment Manager :**
9.1	24	**
3.1	25
16.1	26	[[image:attach:image2021-10-25_15-3-35.png\|\|thumbnail="true" height="250"]]
3.1	27
9.1	28	\\
3.1	29
16.1	30	Under "User Defined Segments" tab, you will see a list of existing segments. Click "Create Segment" in the upper right-hand corner.
7.1	31
16.1	32	[[image:attach:image2021-10-25_15-11-53.png\|\|height="250"]]
3.1	33
9.1	34	\\
3.1	35
16.1	36	You'll be taken to a screen allowing you to define a new segment.
3.1	37
16.1	38	The new segment creation screen consists of total 5 tabs – Definition, Demographics (previously named as First Party), IP Address (previously named as Account based), Behavior, Action.
3.1	39
16.1	40	Demographics, IP Address, Behavior tabs allow us to define the segment rules.
	41
	42	1. Definition Tab:
	43
	44	Define your segment by giving it a name and a brief description.
	45
	46	Title is a mandatory field. It should not be blank. Without providing title, you cannot navigate to other tabs.
	47
	48	Description is an optional field and can have any types of values.
	49
	50	[[image:attach:image2021-10-25_15-42-47.png\|\|height="250"]]
	51
9.1	52	\\
3.1	53
16.1	54	A segment is a group of people. You can define that group based on any number of demographic criteria, ie., "who" the user is, or based on behavioral criteria, ie., "what" the user has done. You can also create an "IP addresses-based Segment.", which can also be called as account based segment.
7.1	55
16.1	56	\\
3.1	57
16.1	58	2. Demographics Tab:
	59
	60	If you click the "Demographics" tab, you will have the opportunity to define demographic characteristics for the segment. Multiple rules can be added with And/OR conditions as per requirements.
	61
	62	[[image:attach:image2021-10-25_15-51-28.png\|\|height="250"]]
	63
12.1	64	=== ===
10.1	65
16.1	66	{{id name="CreateDemoSegment"/}}CREATE A DEMOGRAPHIC SEGMENTDefine demographic rules of your segment based on the demographic questions you have built in your database. You can use any demographic question to define a segment.
10.1	67
16.1	68	[[image:attach:image2021-10-25_15-55-34.png\|\|height="250"]]
3.1	69
16.1	70	\\
3.1	71
16.1	72	If you choose a demographic question that has a multiple choice response, simply click in the search text box and start typing one of the responses. ONEcount should pre-populate the box with the response. Multiple responses can be defined for a single question.
	73
9.1	74	To add multiple demographic questions to a segment, simply click the Add button on the right-hand side and ONEcount will allow you to add another demographic question.
3.1	75
9.1	76	In this way, you can create a demographic segment of users who are Pediatricians who live in Arizona, for example.
3.1	77
16.1	78	If you are creating purely a demographic segment, hit "Save" and ONEcount will save your segment.
9.1	79
	80	\\
	81
16.1	82	3. IP Address Tab:
9.1	83
16.1	84	The IP address-based segment can be created and targeted by providing the intended IP addresses here. There is no limit on number of IP addresses that can be added here.
	85
	86	=== ===
	87
	88	{{id name="CreateAccountSegment"/}}
	89
	90	(% style="margin-left: 30.0px;" %)
	91	=== CREATE AN IP Address-BASED SEGMENT ===
	92
	93	(% style="margin-left: 30.0px;" %)
	94	Target segments by Account – which is IP Address and User Agent. A user agent is any software that retrieves and presents Web content for end users. User agents include Web browsers, media players, and plug-ins that help in retrieving, rendering and interacting with Web content.
	95
	96	[[image:attach:image2021-10-25_16-57-14.png\|\|height="250"]]
	97
	98	This functionality can be used, among other things, to define a set of IP addresses of invalid/non-human traffic that you don't want to display paid banner ads to. By defining the target IP addresses and setting the action to serve only house ads, those IP addresses won't be counted as impressions/views/clicks for sponsored banner advertising because they won't be served sponsored ads. Or you could redirect to a page or a pop-up with a message that the IP address is suspected of being non-human traffic and a number to call if not the case. That IP could then be removed from the target segment.
	99
	100	So, in the example above, the segment will include all users coming from IP address xx.xxx.20.80 using Safari OR from IP address xx.xxx.145.194 or 24.xxx.xxx.10 using Mozilla 5.0 OR, etc...
	101
	102	Note that in IP Address based segmenting you can enter multiple IP addresses and user agents in each field.
	103
	104	To create a segment of ALL users, both known and unknown, enter the IP address 1.0.0.0/1. This will include all possible IP addresses and, by extension, all users who visit your site.
	105
	106	If you are creating purely a IP Address based segment, hit "Save" and ONEcount will save your segment.
	107
	108	\\
	109
	110	4. Behavior Tab:
	111
	112	If you would like to add behavioral characteristics to your segment (ie., Pediatricians who live in Arizona and have read at least two articles on pain), click on the Behavior tab.
	113
	114	\\
	115
	116	[[image:attach:image2021-10-25_16-35-1.png\|\|height="250"]]
	117
	118	\\
	119
10.1	120	To define behavioral characteristics of your segment, choose a behavior type from the Category pull-down. The sub-category pull-down will change depending on the Category that was chosen. For the target, you can enter keywords in the Target box if the value(s) are free text.
9.1	121
10.1	122	If the Target values are multiple choice, you can put your cursor in the box, hit back-space, and then start typing possible values. ONEcount will show matching values, just hit enter and ONEcount will add the value to the target.
9.1	123
10.1	124	You can add multiple values to a single behavioral target; they will be "OR" values, meaning the segment will be true if any of the values is present.
9.1	125
16.1	126	Define the frequency of the action in the Frequency box. This means how many times within the given date range this event has happened, and enter a date range for the given event.
9.1	127
10.1	128	If you add multiple behavioral criteria to your segment (hit Add) to add more behavioral criteria, be sure to define whether this criteria is AND/OR, meaning, whether this segment will match when both criteria are met (AND), or when either of the criteria is met (OR).
9.1	129
10.1	130	There is a wide range of behavioral criteria that can be used for behavioral segments:
9.1	131
10.1	132	Banner: Users are selected based on the banner ads they have viewed on your site. The sub-category for Banners is Viewed or Clicked. Target is the name of the banner(s).
9.1	133
10.1	134	Content: Users are selected based on the meta keywords contained on the pages a user visits. The sub-category for Content is Viewed or Clicked. Target is the content keyword.
3.1	135
10.1	136	Email: Users are selected based on the emails (from your ONEcount-integrated ESP or ONEmail) that the user has engaged with. The sub-category for Email is Opened or Clicked. Target is the name or subject of the e-mail campaign.
3.1	137
10.1	138	Form: Users are selected based on the ONEcount form they have engaged with. The sub-category for Form is Completed. Target is the name of the form.
3.1	139
14.1	140	Package Transaction: Users are selected based on the ONEcount package transaction they have executed. The sub-categories for Package Transaction are Subscribed/Purchased, Currently Subscribed, Not Subscribed, Expired, Will Expire, Unsubscribed. The Target is the name of the package. The selected date range will query on Request Date (Not Transaction Date).
3.1	141
10.1	142	Package Status: Users are selected based on the status of a package they have purchased or subscribed to. Best when used with a Package Transaction criteria. The sub-categories for Package Status are any of the package Statuses that you've defined in the Package Status section under the Inventory menu in ONEcount. There are no targets for this option.
3.1	143
10.1	144	Source Code: Users are selected based on the source code for any transaction they have executed within ONEcount. The sub-category is Selected. The target is the specific source codes that are used. Possible options are the source codes defined in the Source Code manager under the Inventory section of ONEcount.
3.1	145
10.1	146	Web: Users are selected based on the web URLs that they have visited. The sub-category is Viewed. The target is a URL or URL fragment.
3.1	147
14.1	148	Product Transaction: Users are selected based on products that they have purchased. The sub-categories are Subscribed/Purchased, Currently Subscribed, Not Subscribed and Unsubscribed. The target is the product name. The selected date range will query on Request Date (Not Transaction Date).
3.1	149
10.1	150	Product Attribute: Users are selected based on specific attributes of the products they have purchased. The sub-categories are the attributes (ie., category, type, state, etc.) The target is the value of that attribute (ie., blue, edible, New York, etc.) If the sub-category is a multiple-choice list, then your target must be the name of one of those elements of the list. If the sub-category is a free text field, you can enter any value in the target box.
3.1	151
16.1	152	Quiz: Users are selected based on whether the quiz is completed. It has only one subcategory 'completed'. You can enter the target in the text box.
3.1	153
16.1	154	Geo: Users are selected based on specific geographic location from anywhere in the world. The sub-category is 'coordinate'. When this geo category is selected, the world map is popped up and you can select any region on that map, where you want to target your users. Once, the selection of region is made, you will see the corresponding geographic coordinates are added to the target field. This geo-based targeting is one of the important functionalities introduced recently. Like other behavior categories, geo can also be added any number of times along with any other rules, by using ‘Add’ button on the screen as per your requirements.
	155
	156	Once you have defined your Behavioral criteria for your segment and you do not wish to add any other rules/action, be sure to HIT SAVE.
	157
15.1	158	Note: There can be only one rule for each criteria like web, banner. If you have multiple target values all of them can be added into 1 rule by adding multiple values into target box.
	159
10.1	160	\\
3.1	161
16.1	162	5. Action tab:
12.1	163
16.1	164	Any action to be associated for segment targeting is defined in this tab.
12.1	165
16.1	166	Date range is a mandatory field (both start and end dates) to add any form of action. You can select any form of action from the dropdown. Once you provide action details, you can save the changes made.
3.1	167
16.1	168	[[image:attach:image2021-10-25_16-59-19.png\|\|height="250"]]
3.1	169
12.1	170	== ==
3.1	171
16.1	172	{{id name="CreateAction"/}}ADD AN ACTIONGo to the Action tab of create/edit segment. This is where you define the action to be taken for a segment, e.g. a website pop-up or ad targeting. Types of available Actions include: Pop-Up, Redirect, Ad Target, Email, Social Target, Subscribe to a Product, Unsubscribe to a Product, Subscribe to a Package, Unsubscribe to a Package, Add to Segment, Remove from Segment. Any action can be selected from action type dropdown.
3.1	173
12.1	174	===
	175	===
3.1	176
12.1	177	{{id name="CreateAdAction"/}}
	178
16.1	179	=== ADD AN AD ACTION ===
12.1	180
10.1	181	Here, we are defining an Ad Target. This will allow ONEcount to tell Google Ad Manager (DFP) what ad to target when a specific user is on your web site. The specific users will be defined in the Segment that you link to this target.
3.1	182
16.1	183	In the screen below, you'll see the options for an Ad Target. The first three options are Target Domain and Target Content, Section. These are used to// limit// the scope of this action, not to define it. It's important to understand the difference.
3.1	184
10.1	185	In content-based targeting, you define a specific page or web site section (or a whole site) to be targeted with a banner or banner campaign. In effect you are saying, whenever someone comes to this section or this web site, show them this banner.
3.1	186
10.1	187	ONEcount targets ads based on identity. ONEcount is saying in effect, for this specific person (as defined by the Segment linked to this Action), show this ad. Period.
	188
	189	The Target Domain and Section options are used to limit this behavior. So what we are saying then is that for this specific person (as defined by the Segment linked to this Action) show this ad, but ONLY on these domains and in these specific sections of the site.
	190
	191	Why would we do that? Generally, this is limitation is used because we want to target a user with one ad campaign on one site, and a different campaign on another site.
	192
	193	For example, say we have a pediatrician who we want to target with an ad for a skin medicine on our dermatology site, but an ad for a different drug when he visits a site on diabetes.
	194
16.1	195	\\
10.1	196
16.1	197	[[image:attach:image2021-10-25_17-16-33.png\|\|height="250"]]
	198
	199	\\
	200
10.1	201	The Target Domain and Section parameters are only required if you want to limit the banner. If you leave them blank, the user will be targeted across all your web sites.
	202
	203	The last property is the Key/Value pair that you will use to tell Google Ad Manager which banners or Line Items to target at this user. Consult for Google Ad Manager documentation on Key/value pair targeting. You may specify more than one Key/Value pair for this target. This allows Google Ad Manager or DFP to decide which banners to show.
	204
11.1	205	* In Revive/OpenX, these variables are created under Inventory > Banner > Delivery Options > Add Delivery Limitation > Site-Variable > Add > enter Key and Value variables. These variables are of your choosing and can be text or num
	206
10.1	207	For example, say you wanted to target users who read stories about high school basketball. You could create a segment of users who viewed content tagged "high school boys basketball." You could then create three Key/Value pairs for the action you link to that segment: one for high school boys basketball, one for high school sports, and one for high school boys sports. You could then use Google Ad Manager or DFP to determine how the user is targeted and the prioritization of each banner.
	208
	209	NOTE: Prioritization of banners is done in Google Ad Manager (or DFP) based on rules you configure in GAM.
	210
12.1	211	===
	212	===
10.1	213
12.1	214	{{id name="CreatePopupAction"/}}
	215
16.1	216	=== ADD A POP-UP ACTION ===
12.1	217
16.1	218	You can also create a pop-up target for your segments. Any pop-up created under form-builder section od ONEcount cxan be used for pop-up action for segment.
10.1	219
16.1	220	Choose Pop-Up from the Action Type pull-down.
10.1	221
16.1	222	The next three options are Target Domain, Target Content and Section. These are used to// limit// the scope of this action, not to define it. It's important to understand the difference.
10.1	223
	224	In content-based targeting, you define a specific page or web site section (or a whole site) to be targeted with a pop-up. In effect you are saying, whenever someone comes to this section or this web site, show them this pop-up.
	225
	226	ONEcount targets pop-ups based on identity. ONEcount is saying in effect, for this specific person (as defined by the Segment linked to this Action), show this pop-up. Period.
	227
	228	The Target Domain and Section options are used to limit this behavior. So what we are saying then is that for this specific person (as defined by the Segment linked to this Action) show this pop-up, but ONLY on these domains and in these specific sections of the site.
	229
	230	Why would we do that? Generally, this is limitation is used because we want to target a user with pop-up campaign on one site, and a different campaign on another site.
	231
	232	For example, say we have a pediatrician who we want to target with a pop-up for a skin medicine on our dermatology site, but a pop-up for a conference when he visits our site on diabetes.
	233
	234	The Target Domain and Section parameters are only required if you want to limit the banner. If you leave them blank, the user will be targeted across all your web sites.
	235
16.1	236	\\
10.1	237
16.1	238	[[image:attach:image2021-10-25_17-54-54.png\|\|height="250"]]
	239
	240	\\
	241
11.1	242	Next we determine the priority of this pop-up relative to other pop-ups that may be targeted at this segment. It's possible that a user is in multiple segments and may be subject to multiple pop-ups. This setting will help ONEcount determine how important this pop-up is relative to other marketing efforts.
10.1	243
11.1	244	Frequency allows you determine how frequently this pop-up will appear to this user. Options include once, always (on every page load), daily (once per day), weekly, bi-weekly, monthly, or annually.
10.1	245
16.1	246	Last, select the pop-up (it can be any pop-up form builder pop-up or A/B test pop-up).
3.1	247
16.1	248	Review your Action details and finally click Save to save it.
3.1	249
7.1	250	(% style="margin-left: 30.0px;" %)
16.1	251	=== ===
3.1	252
12.1	253	{{id name="CreateRedirectAction"/}}
	254
	255	(% style="margin-left: 30.0px;" %)
16.1	256	=== ADD A REDIRECT ACTION ===
3.1	257
16.1	258	Choose redirect from the list of Type of Action. The redirect action is very similar to the Pop-Up action, except that instead of displaying a pop-up message, ONEcount will redirect the user to a URL of your choosing.
3.1	259
11.1	260	One use case for this might be users who have a subscription that is running out; you could create a segment of users whose subscription expires in the next 10 days, and target that segment with an Action that redirects them to your subscription form when they first come to your site.
	261
	262	As with pop-up and ad targeting, the Target Domain and Section parameters are optional.
	263
	264	\\
	265
16.1	266	[[image:attach:image2021-10-25_18-2-56.png\|\|height="250"]]
3.1	267
16.1	268	\\
3.1	269
7.1	270	(% style="margin-left: 30.0px;" %)
16.1	271	=== ===
3.1	272
12.1	273	{{id name="CreateEmailAction"/}}
	274
7.1	275	(% style="margin-left: 30.0px;" %)
16.1	276	=== ADD EMAIL ACTION ===
12.1	277
	278	(% style="margin-left: 30.0px;" %)
16.1	279	To send a transactional e-mail to a user, choose Email from the Action Type pull-down.
3.1	280
7.1	281	(% style="margin-left: 30.0px;" %)
16.1	282	\\
3.1	283
7.1	284	(% style="margin-left: 30.0px;" %)
16.1	285	[[image:attach:image2021-10-25_18-6-13.png\|\|height="250"]]
3.1	286
7.1	287	(% style="margin-left: 30.0px;" %)
16.1	288	\\
3.1	289
16.1	290	When an email action is in effect, the email will be sent to the specified target segment on the designated domains and sections at the set frequency and priority level.
3.1	291
16.1	292	\\
3.1	293
16.1	294	If you wish to cancel the changes, click the "Cancel" button to go to the segment listing page.
3.1	295
12.1	296	\\
3.1	297
12.1	298	==
	299	==
3.1	300
12.1	301	{{id name="CreateTarget"/}}
	302
	303	\\
	304
	305	\\
	306
	307	\\
	308
	309	\\
	310
	311	\\
	312
	313	\\
	314
	315	\\
	316
	317	\\
	318
	319	\\
	320
	321	\\
	322
13.1	323	\\
	324
12.1	325
	326
3.1	327	{{id name="End ScreenSteps Content"/}}
4.1	328	{{/layout-cell}}
	329
	330	{{layout-cell}}
6.1	331	{{panel title="Search All Documentation:"}}
4.1	332
	333
	334	{{livesearch/}}
6.1	335	{{/panel}}
4.1	336
6.1	337	{{panel title="Search USER OPERATIONS Documentation:"}}
4.1	338
	339
6.1	340	{{pagetreesearch rootPage="User Operations - Managing Your Data"/}}
	341	{{/panel}}
4.1	342
6.1	343	{{panel title="On this page:"}}
4.1	344
	345
6.1	346	{{toc/}}
	347	{{/panel}}
4.1	348
6.1	349	{{panel title="More USER OPERATIONS Documentation"}}
	350	{{expand}}
	351	**Add Users
4.1	352	**
	353
	354	(% style="margin-left: 60.0px;" %)
	355
	356
	357	(% style="margin-left: 60.0px;" %)
8.1	358	[[Preparing for Data Import>>doc:Getting Started - Preparing for Data Import]]
4.1	359
	360	(% style="margin-left: 60.0px;" %)
9.1	361	[[doc:Pre-Import Checklist]]
4.1	362
	363	(% style="margin-left: 60.0px;" %)
	364
6.1	365
4.1	366	(% style="margin-left: 60.0px;" %)
8.1	367	[[How to Create an Import Mapping Template>>doc:Import - How to Create an Import Mapping Template]]
4.1	368
	369	(% style="margin-left: 60.0px;" %)
8.1	370	[[How to Use an Import Mapping Template>>doc:Import - How to Use an Import Mapping Template]]
4.1	371
	372	(% style="margin-left: 60.0px;" %)
9.1	373	[[doc:Add Audience]]
4.1	374
	375	(% style="margin-left: 30.0px;" %)
	376	Batch Operations
	377
	378	(% style="margin-left: 60.0px;" %)
9.1	379	[[doc:Bulk Operation - How to Perform a Batch Delete]]
4.1	380
	381	(% style="margin-left: 60.0px;" %)
9.1	382	[[doc:Bulk Operation - How to Perform a Batch Product Change]]
4.1	383
	384	(% style="margin-left: 60.0px;" %)
9.1	385	[[doc:Bulk Operation - How to Perform a Batch Status Change]]
4.1	386
	387	(% style="margin-left: 60.0px;" %)
8.1	388	[[Bulk Operation - How to Perform a Batch Suscribe>>doc:Bulk Operation - How to Perform a Batch Subscribe]]
4.1	389
	390	(% style="margin-left: 60.0px;" %)
8.1	391	[[Bulk Operation - How to Perform a Batch Unsubscribe>>doc:Bulk Operation - How to Perform a Batch UnsubscribeKill]]
4.1	392
	393	(% style="margin-left: 60.0px;" %)
8.1	394	[[Bulk Operation - How to Perform a Merge of Duplicate Users>>doc:Bulk Operation - How to Perform a Bulk Merge of Duplicate Users]]
4.1	395
	396	(% style="margin-left: 30.0px;" %)
	397	Target Audience Segments
	398
	399	(% style="margin-left: 60.0px;" %)
	400	(% style="color: rgb(0,51,102);" %) __
	401	__
	402
9.1	403	\\
4.1	404
9.1	405	\\
4.1	406	{{/expand}}
6.1	407	{{/panel}}
	408
9.1	409	\\
6.1	410
9.1	411	\\
6.1	412
9.1	413	\\
6.1	414
9.1	415	\\
6.1	416
9.1	417	\\
6.1	418
9.1	419	\\
4.1	420	{{/layout-cell}}
	421	{{/layout-section}}
	422	{{/layout}}