Last modified by Admin User on 2025/03/11 18:15
Show last authors
1 {{layout}}
2 {{layout-section ac:type="two_right_sidebar"}}
3 {{layout-cell}}
4 {{id name="Start ScreenSteps Content"/}}
5 The directions below provide detail on how to create a new Product. Once a Product is created it can be attached to a Package.
6
7 Products may be created in the Products tool (as described in this lesson) prior to being attached to a Package, or they can be created during the Package creation process. Please refer to [[Packages - How to Create a Package Part 3: Attach / Remove / Create a Product >>doc:OD.Packages - How to Create a Package Part 3: Attach Remove Create a Product]]for details creating Products during the Package creation process and attaching to a Package.
8
9 Please refer to the [[Quick Start Guide - Products >>doc:Quick Start Guide - Packages and Products]]for information on basic concepts and rules relating to Packages, terms, and Products.
10
11 === CREATE A NEW Product ===
12
13 There are four different types of Products: File, Newsletter, Page, and Section. Details on each type of Product are given below.
14
15 **~1. Select SETUP from the main menu.**
16
17 [[image:attach:Screen Shot 2021-09-23 at 4.20.31 PM (2).png||thumbnail="true" height="250"]]
18
19
20 **2. Select Products form the SETUP sub-menu.**
21
22 [[image:attach:Screen Shot 2021-10-08 at 3.22.01 PM (2).png||thumbnail="true" height="250"]]
23
24 This will open the Products listing page, where all existing Products are listed in alphabetical order. Note the Search and page-through functionality.
25
26
27 **3. Click "Create New Product" found in upper right of the Product list.  This will open the New Product window.**
28
29 [[image:attach:Screen Shot 2021-10-08 at 3.40.35 PM (2).png||height="250"]]
30
31
32
33 **4. Enter a title and description for the Product.**
34
35 [[image:attach:media_1433259152985.png||style="vertical-align:middle"]]
36
37 The title should be as brief but descriptive as possible. For example if the Product is a newsletter, the title could be the name of the newsletter; or if the Product is access to a video series, then the title could be the name of the video series.
38
39
40 **5. Select the type of Product (File, Newsletter, Page, Section).**
41
42 [[image:attach:media_1433259276492.png||style="vertical-align:middle"]]
43
44 Further detail on the different types of Products is given below.
45
46 ----
47
48 ==== __Product Type: File__ ====
49
50 **To restrict access to a file and/or identify it for a dashboard, such as a specific whitepaper or other document select Product Type: File.**
51
52 When you select "File" from the "Product Type:" drop-down menu, you will see the message “Files in the [[root folder>>doc:root folder]] directory can be protected from unauthorized downloads”.
53
54 **~1. Under "Choose File" select the file you wish to restrict access to.**
55
56 [[image:attach:media_1366403738301.png||style="vertical-align:middle"]]
57
58 The directory tree of your root folder will be displayed, and you can select your file here.
59
60
61 **2. Click "Save", and the file-type Product will be saved.**
62
63 [[image:attach:media_1404935503453.png||style="vertical-align:middle"]]
64
65 You will receive a confirmation message, as shown above, indicating the time the Product was saved.
66 To return to the Products listing page, which will show your new Product in the alphabetical list, click on the Go Back button.
67
68 Note: You may cancel Product creation by clicking on the Go Back button **before** clicking Save. Doing so will bring you back to the Products listing page without creating a Product.
69
70
71 ----
72
73 ==== __Product Type: Function__ ====
74
75 Gating is currently done based on the a REGEX match of a url segment on page load. This function is designed to allow customers to gate content where gating can not be sufficiently managed using URL segments or where content must be gated without a page load.
76
77 The Function-type Product works in conjunction with ONEcount's javascript widgets, and it expects one parameter which is the numeric Product id. **The ProductId is required**. Product Ids are available in ONEcount on the Product listing page.
78
79 For more information on ONEcount javascript widgets and their functionality, see the ONEcount Javascript Widgets and ONEcount Javascript Widget Changes sections.
80
81
82 **~1. Select "Product Type:" of Function and enter a text return value in the Value field.**
83
84 [[image:attach:media_1479414072383.png||style="vertical-align:middle"]]
85
86 The text return value is currently ignored, but it may be used to trigger gating in the future.
87
88 Save the Product
89
90 *
91 ** Note that the users entering from the following referrers will be bypassed: Bing, Google, Facebook, Twitter, LinkedIn. i.e. if a user comes to an article from one of these referrers they'll be granted access. If they click on another article link, they'll then be required to register. This can be disabled, but doing so may prevent bots from indexing.
92
93 *
94 **
95 *** You can use the Function-type Product in conjunction with a free pass, i.e. any non-registered/logged in user can view x articles before having to register for the "Article Access" Package. After registering for the "Article Access" Package, if you've enabled the access frequency the user will be able to view x articles in n timeframe before being required to subscribe to a paid Package/package.
96
97 Save the Product.
98
99
100 **2. On the template of the page(s) you wish to gate/identify, add the following ONEcount function:     GCN.onecount.gate(Productid)**
101
102 For example, if the function-type Product ID is 25, the js function would be **GCN.onecount.gate(25)**
103
104 The Product id of the Function-type Product you created is required.
105
106 You can place this anywhere on the template.
107
108 ----
109
110 ==== __Product Type: Newsletters__ ====
111
112 [[image:attach:media_1433259708825.png||style="vertical-align:middle"]]
113
114 **To create a Newsletter-type Product and a newsletter list in the Email Engine, select Product Type: Newsletters.**
115
116 When you select "Newsletters" from the "Product Type:" drop-down menu, you will see the message "Please Select Newsletters to associate with this Product" with a drop-down check box list of all existing newsletter lists (called subscriber lists the Email Engine). This list of Newsletters shows all of the existing newsletter/subscriber lists that reside in the EMail Engine.
117
118 (% style="color:#ff0000" %)***If using the Email Engine to manage your newsletter/email lists, when a newsletter Product is created, ONEcount will automatically create a newsletter list** in the Email Engine. When users submit the subscription form for the Package with the newsletter Product, they will automatically be placed on the newsletter list in the Email Engin. Their demographic and subscription data will also be added the ONEcount database. If you are using a different email marketing provider (such as Magnet Mail or Silverpop), please check with GCN to verify if an API is available.
119
120 (% style="color:#ff0000" %)The Product must be created and attached to a Package prior to an import or user subscription via an online form. ONEcount won't push Package subscribers to a newsletter Product created (% style="color:#ff0000; text-decoration:underline" %)after(% style="color:#ff0000" %) the user subscribed to a Package (either through import or user action)(% style="color:#000000" %).
121
122
123
124 **1a. To associate the Newsletter Product with an existing Newsletter list that has been created in the Email Engine, check the box beside the newsletter list(s) you wish to associate with the Newsletter Product.**
125
126 [[image:attach:media_1433259752525.png||style="vertical-align:middle"]]
127
128 You can select the newsletter(s) you wish to associate with the Product - and by extension with the Package - or create a new Newsletter list (subscriber list).
129
130 When you create a new Newsletter-type Product you, in effect, create a new, empty list in the Email Engine that is associated with the Newsletter Product.
131
132 (% style="color:#000000" %)A newsletter Product may have more than one list associated with it. For example, you may have a newsletter Package/Product where a user can sign up to receive multiple newsletters (sent on different schedules, e.g. one weekly and one monthly) as part of a bundled package. In such an instance, you could attach more than one newsletter list to the Product, and when a person subscribes to the Package/Product, he/she will be placed on both newsletter lists.
133
134
135
136 **1b. To create a new newsletter list in the Email Engine, click on +"Add New Newsletter" link.**
137
138 [[image:attach:media_1433259811030.png||style="vertical-align:middle"]]
139
140
141 **2b. Enter the Newsletter List Name (1) and Description (2) then click "Add" (3).**
142
143 [[image:attach:media_1433259848182.png||style="vertical-align:middle"]]
144
145
146 You will see the newly created newsletter list, with a check mark, at the top of the newsletter list, as shown below.
147
148 [[image:attach:media_1433260091890.png||style="vertical-align:middle"]]
149
150 Select any other newsletter lists (if any) you wish to associate with this Product, as shown below.
151
152 [[image:attach:media_1433260212319.png||style="vertical-align:middle"]]
153
154
155 **3b. Click the "Save" button, and the newsletter list will be saved.**
156
157 [[image:attach:media_1404935553287.png||style="vertical-align:middle"]]
158
159 You will receive a confirmation message, as shown above, indicating the time the Product was saved.
160 To return to the Products listing page, which will show your new Product in the alphabetical list, click on the **Go Back** button.
161
162 Note: You may cancel Product creation by clicking on the Go Back button **before** clicking Save. Doing so will bring you back to the Products listing page without creating a Product.
163
164
165 ----
166
167 ==== __Product Type: URL__ ====
168
169
170 **To restrict access to a web page on your site and/or identify it for a dashboard, select Product Type: URL.**
171
172 When you select "URL" from the "Product Type:" the Edit Product screen will change to give you some additional options which we will discuss here.
173
174 First, give you product is a Title. This is what will appear on any gating or subscription forms on your site, and on all internal, ONEcount menus where this product is listed.
175
176 If you would like an image displayed on forms using this product, put a link to the image in the Image URL box. For example, if the product is for a web-site or print product, you can put a link to the cover-image of the product in this box.
177
178 **Primary Form or Landing URL: **This box is important. This tells ONEcount what form to present when a user clicks on the URLs covered by this product. If you are using a ONEcount form to register or subscribe users, then choose "Form" from the pull-down and then select the appropriate form from the pull-down on the right. If you are connecting to a different registration system to register or subscribe users, choose URL, and enter the URL you want the user directed to in the box on the right.
179
180 ~*~**IMPORTANT NOTE: If you are directing users to a third-party site for gating, you will need to make sure that that site or form enters a subscription for the user into the ONEcount API before returning the user to the site ONEcount is gating. Failure to submit that transaction will cause the user to get caught in a loop, because if the user is not subscribed to the asset, they will be sent to the form defined here.
181
182 **~*~**IMPORTANT NOTE: **If you will be using ONEcount to Gate the content on this URL using a registration or Paywall, change the Gating option to YES. **NOTHING ELSE IS REQUIRED TO GATE THIS URL. IF YOU TYPE THE URL OF YOUR WEB SITE INTO THE URL BOX, IT WILL BE GATED WHEN YOU SAVE THIS PRODUCT!**
183
184 (% style="color:#ff0000" %)**~*~**REALLY IMPORTANT NOTE: MAKE SURE YOU HAVE THE CORRECT URL AND HAVE SET UP A FORM FOR THIS PRODUCT PRIOR TO TURNING GATING ON. FAILURE TO SET UP A FORM WILL SEND USERS TO AN ERROR PAGE.**
185
186
187 [[image:attach:URL-product-creation.png||width="800"]]
188
189 **Free Pass: **If you set this option to "Enable," ONEcount will provide a box where you can determine how many free views of this URL a user may have before being forced to register or subscribe. Free pass is a number and a time period, such as 1 per week, 3 per month, etc. Setting a number and choosing Unlimited means ONEcount will only allow the user the specified number of views //forever.//
190
191 The Free Pass option is cross-device, meaning if a user visits once on their desktop computer and once on their mobile phone, ONEcount will count that as two views.
192
193 [[image:attach:Product-free-pass.png||width="800"]]
194
195 If you are charging for access to this URL and have configured ONEcount for your Merchant Services provider, you may enter a price for access to this URL. Please note that this is a one-time payment. If you would like to charge an amount for a specified period of time, please visit setting up Packages in this documentation.
196
197
198 [[image:attach:URL-product-URLS.png||width="800"]]
199
200
201 Now enter the URLs or URL fragments you would like protected. ONEcount uses a REGEX string match to match the URLs in the product against the URL in the user's web browser. You may enter any number of URLs or URL fragments into a single product, just click the plus sign next to the URL to add a new URL.
202
203 Note that ONEcount uses a string match, so in the example above, the fourth line will match ANY URL on ANY site if the URL contains /Chicago-Farmer/, while the third line will only match URLs on the site [[www.farmprogress.com>>url:http://www.farmprogress.com||shape="rect"]] that are in the /Chicago-Farmer section of the site. Be careful of sites that can be accessed by http or https, and sites that do not require the www host name. These will require a more general version of the URL, such as farmprogress.com/Chicago-Farmer.
204
205 Once you have entered the URLs for this product, you can save it.
206
207
208 **2. Click "Save", and the Product will be saved.**
209
210
211 [[image:attach:media_1404935573677.png||style="vertical-align:middle"]]
212
213 You will receive a confirmation message, as shown above, inidicating the time the Product was saved.
214 To return to the Products listing page, which will show your new Product in the alphabetical list, click on the Go Back button.
215
216 Note: You may cancel Product creation by clicking on the Go Back button **before** clicking Save. Doing so will bring you back to the Products listing page without creating a Product.
217
218
219 ----
220
221 ==== **__Product Type: Section__** ====
222
223 [[image:attach:media_1404935663623.png||style="vertical-align:middle"]]
224
225 **To restrict access to an entire section of your site and/or to identify it for a dashboard, select Product Type: Section.**
226
227 When you select "Section" from the "Product Type:" drop-down menu, you will see the message “Entire sections of the web site can be protected by specifying a part of the URL that every page in that section has in common. ((% style="color:#ff0000" %)DO NOT put in the intitial http:~/~/(%%))"
228
229
230 **~1. Enter the part of the URL that every page in the section has in common.**
231
232 [[image:attach:media_1404935899669.png||style="vertical-align:middle"]]
233
234 This will restrict access to all pages to access whitepapers in the gcnmedia.com site. (The URL that all pages have in common is the highest level page in the page hierarchy – all sub-pages below "/whitepapers" will be restricted, e.g. onecount/whitepapers/whitepaper1, onecount/whitepapers/whitepaper2, etc.)
235
236
237 **2. Click "Save", and the section-type Product will be saved.**
238
239 [[image:attach:media_1404936058551.png||style="vertical-align:middle"]]
240
241 You will receive a confirmation message, as shown above, inidicating the time the Product was saved.
242 To return to the Products listing page, which will show your new Product in the alphabetical list, click on the Go Back button.
243
244 Note: You may cancel Product creation by clicking on the Go Back button **before** clicking Save. Doing so will bring you back to the Products listing page without creating a Product.
245
246
247 ----
248
249 === **ATTACH Product TO A Package** ===
250
251 Please refer to [[Packages - How to Create a Package Part 3: Attach / Remove / Create a Package>>doc:OD.Packages - How to Create a Package Part 3: Attach Remove Create a Product]] for directions on how to attach a Product to a Package.
252
253
254
255 {{id name="End ScreenSteps Content"/}}
256 {{/layout-cell}}
257
258 {{layout-cell}}
259 {{panel title="On this page:"}}
260 {{toc maxLevel="4"/}}
261 {{/panel}}
262
263 {{panel title="More INVENTORY Documentation:"}}
264 {{expand title="Click here to expand..."}}
265 (% style="margin-left: 30.0px;" %)
266 [[Inventory - Getting Started>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=66180||shape="rect"]]
267
268 (% style="margin-left: 30.0px;" %)
269 [[Quick Start Guide - Packages & Products>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=66207||shape="rect"]]
270
271 (% style="margin-left: 30.0px;" %)
272 [[Packages - How to Create a Package Part 1: Create, Name, Attach Forms>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=66214||shape="rect"]]
273
274 (% style="margin-left: 30.0px;" %)
275 [[Packages - How to Create a Package Part 2: Package Terms>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=66234||shape="rect"]]
276
277 (% style="margin-left: 30.0px;" %)
278 [[Packages - How to Create a Package Part 3: Attach/Remove/Create a Product>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=66253||shape="rect"]]
279
280 (% style="margin-left: 30.0px;" %)
281 [[Packages - How to Manage Packages>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=66294||shape="rect"]]
282
283 (% style="margin-left: 30.0px;" %)
284 [[Quick Start Guide - Questions and Forms>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=66310||shape="rect"]]
285
286 (% style="margin-left: 30.0px;" %)
287 [[Question Builder - Create and Manage Questions>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=66312||shape="rect" style="text-decoration: underline;"]]
288
289 (% style="margin-left: 30.0px;" %)
290 [[Forms - How to Create a Form>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=66345||shape="rect"]]
291
292 (% style="margin-left: 30.0px;" %)
293 [[Forms - How to Manage Forms>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=66370||shape="rect"]]
294
295 (% style="margin-left: 30.0px;" %)
296 [[Forms - How to Enable/Disable Lookup/Login Page>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=66386||shape="rect"]]
297
298 (% style="margin-left: 30.0px;" %)
299 [[Brand - How to Create and Manage Brands>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=66391||shape="rect"]]
300
301 (% style="margin-left: 30.0px;" %)
302 [[Products - How to Create a Product>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=66411||shape="rect"]]
303
304 (% style="margin-left: 30.0px;" %)
305 [[Products - How to Manage Products>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=66435||shape="rect"]]
306
307 (% style="margin-left: 30.0px;" %)
308 [[Promo Codes - How to Create and Manage Promo Codes>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=66445||shape="rect"]]
309
310 (% style="margin-left: 30.0px;" %)
311 [[Package Status - How to Create and Manage Package Statuses>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=66479||shape="rect"]]
312
313 (% style="margin-left: 30.0px;" %)
314 [[Source Codes - How to Create and Manage Source Codes>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=66463||shape="rect"]]
315 {{/expand}}
316 {{/panel}}
317
318
319
320
321
322
323
324
325
326
327
328 {{/layout-cell}}
329 {{/layout-section}}
330 {{/layout}}