Wiki source code of 02 Quick Start Guide

Last modified by Louisa Kluessendorf on 2023/09/22 09:28
Show last authors
1 {{box cssClass="floatinginfobox" title="**Inhalt**"}}
2 {{toc/}}
3 {{/box}}
4
5 = 1 First data collection =
6
7 == 1.1 Create a project ==
8
9 After you have started the SNH Titan Desktop, please click on "Your projects" and on the blue button "Create project".
10
11 (% class="box infomessage" %)
12 (((
13 ℹ   A project is basically the same as a case in SNH 1. The biggest difference is that a project can contain content from different social networks.
14 )))
15
16 (% class="wikigeneratedid" %)
17 Choose a project name, a case name that differs from it if necessary, and add a description if desired.
18
19 (% class="wikigeneratedid" %)
20 Under the "Tag Schema Template" item you get the option to add a few default tags to the project. You can either choose nothing and set up your tags on your own later, or select one of the templates.
21
22 (% class="wikigeneratedid" %)
23 If you want to import an SNH1 case, this is the right place to do it. Under the item "Import SNH1 project data", you can import an existing case. For more detailed information on importing SNH 1 cases, please go to "Switchover SNH -> Titan" in the manual.
24
25 == 1.2 Collect the data of a target profile ==
26
27 (% class="box infomessage" %)
28 (((
29 We recommend installing the SNH-Titan Browser Extension beforehand. Depending on your browser, you can find this extension under one of the following links:
30 **Chrome:** [[https:~~/~~/chrome.google.com/webstore/detail/snh-titan-browser-extensi/bhajampliglbihiecgcppjajijeechbl>>https://chrome.google.com/webstore/detail/snh-titan-browser-extensi/bhajampliglbihiecgcppjajijeechbl]]
31
32 However, it is also possible to use the SNH-Titan without a browser.
33 )))
34
35 (((
36 In your usual browser, search for a profile whose data (friends, timeline, etc.) you would like to back up with SNH Titan. Once you have found a profile, there are generally two ways to back it up in SNH Titan.
37 )))
38
39 (((
40
41 )))
42
43 === 1.2.1 Target selection ===
44
45 ==== 1.2.1.a Using the Browser Extension ====
46
47 Provided you have installed the SNH Titan Browser Extension, you should already see a sidebar on the right side on the identified target profile.
48
49 |(% style="width:856px" %)[[image:attach:browser-ext1.png||height="443" width="612"]]|(% style="width:664px" %)[[image:attach:ext-2.png||height="336" width="465"]]
50 |(% style="width:856px" %)In collapsed state, you will see a small preview of the identified profile. Click on this preview box to display the backup options.|(% style="width:664px" %)In the expanded sidebar you will see the possible backup options. For a first "quick start", we recommend keeping the default values for the time being, unless your profile contains extreme amounts of data. For example, backing up a newspaper's Facebook page might be an inconvenient way to start, due to the enormous number of posts that need to be backed up.
51
52 Click on "Send to SNH Titan" to send the backup job to the SNH Titan. **Important: Allow the browser to access the SNH Titan!**
53
54 The SNH Titan Desktop application will open and offer you a few more backup options. You will be asked to select a project. Here, the project you just created should be selected by default. You will also be asked to select a collection profile. More about this in step 1.2.2.
55
56 ==== 1.2.1.b Backup without browser extension ====
57
58 You can also start a backup without a browser extension. To do this, simply click Collection in the main menu of your open project. You will be asked to enter a URL. This is the URL of the profile you want to backup. For example, on Facebook this might look like this:
59
60 [[https:~~/~~/facebook.com/max.mustermann>>https://facebook.com/max.mustermann]]
61
62 or
63
64 [[https:~~/~~/facebook.com/profile.php?id=12345678>>https://facebook.com/profile.php?id=12345678]]
65
66 Please take this URL from your browser and copy it into the field provided. You can then set further options. More about this in the next step.
67
68 === 1.2.2 Select and create crawling profiles ===
69
70 In order for the SNH Titan to be able to correctly save the data in full, it must log into a so-called crawling profile. These are mostly profiles created specifically for this purpose on the corresponding social networks. Please note that these profiles can occasionally also be blocked. **Therefore, never use your private profile for collecting data **to prevent the loss and blocking of your main profile.
71
72 To provide the SNH Titan with the data to log into such a profile, please create a crawling profile in the SNH Titan. To do this, click on "Create crawling profile" under Crawling profile.
73
74 A sidebar will open. Please fill in the following data there:
75
76
77 |(% style="width:222px" %)**Name (irrelevant for login)**|(% style="width:1298px" %)You define this name yourself to be able to identify the profile later in the software. For example, "Max Mustermann".
78 |(% style="width:222px" %)**Username / Vanity Name / E-Mail**|(% style="width:1298px" %)This is the username or email address, or occasionally the phone number, that you would use to log into the network if you were also logging into the browser.
79 |(% style="width:222px" %)**Password**|(% style="width:1298px" %)This is the password you use to log in. In special cases (e.g. Telegram or TikTok) the password can be left blank because other login methods are used.
80 |(% style="width:222px" %)**Network**|(% style="width:1298px" %)Select here for which network the crawling profile is valid.
81 |(% style="width:222px" %)**Check login status**|(% style="width:1298px" %)Here you can select whether the SNH Titan should directly check and update the login status of the profile in the background. This is optional and offers you the possibility to find out in advance if the profile you have selected has possibly already been blocked and if the specified data is valid.
82
83 Click Save. You can now select the profile in the crawling profiles overview.
84
85 (% class="box infomessage" %)
86 (((
87 If you have executed a login status check, this happens in the background and can take a few seconds to minutes, depending on the internet connection and network. 
88 It may happen in individual cases that the SNH Titan needs your help to authenticate the login profile. E.g. for TikTok scanning a QR code, or for other networks entering a confirmation code sent by SMS or email. This would be communicated to you by means of a non-closable popup.
89 )))
90
91 === 1.2.3 Further adjustment of the backup options ===
92
93 You can further customize in detail which data should be saved for the profile. This is particularly relevant to ensure data protection. Please only back up data that is relevant to your case or investigation. In particular, when backing up friends or friends of friends, make sure that the collection of this data is relevant. You can add or remove individual options by checking or unchecking the checkboxes.
94
95 === 1.2.4 Add more URLs ===
96
97 You can repeat the above steps as many times as you like to save multiple target profiles in one go. Click on "Add URL" to define additional targets. For each of these targets, you can customize your backup options and used crawling profiles. You can also add targets from different networks in one query.
98
99 === 1.2.5 Sending the task request ===
100
101 Click on "Send to server" to start the backup. The page will now refresh and after a few seconds you will see the status of the currently executed crawling tasks in the top right menu bar.
102
103 == 1.3 Waiting for results / explanation of basic concepts ==
104
105 While you're waiting for the backup, it's best to use the time to introduce you to a few new concepts of the SNH Titan. We'll briefly answer the question: **What's happening in the background right now? **
106
107 So-called collection servers run in the background of SNH Titan. These are separate processes that wait for the very jobs you have just submitted. As soon as you send a collection request, these servers start collecting data from the social networks. Depending on the license you purchased, one or three of these collection servers will run simultaneously in the background. This gives you the option of sending multiple task requests, which can be processed simultaneously depending on the number of servers. This speeds up the backup enormously. In particular, it gives you the opportunity to start several small tasks in addition to a long-running backup (e.g. the backup of a single profile in addition to the backup of friends). Furthermore, if you have already collected data, you can continue your analysis even though a task is running in the background. Below is a brief summary of the most important terms:
108
109 (% border="1" %)
110 |(% style="width:138px" %)**Crawling task / task**|(% style="width:1382px" %)An order to collect data from a target (e.g., profile or posting) on a social network
111 |(% style="width:138px" %)**Collection server**|(% style="width:1382px" %)A process in the background that executes the orders and collects the data and imports it into the SNH Titan
112 |(% style="width:138px" %)**Crawling profile**|(% style="width:1382px" %)A profile that SNH Titan uses to log into the social network. Only data accessible to this profile can be backed up by the SNH Titan.
113
114 We collect the data in a way which preserves the crawling profile. Using various methods, we simulate "human" use of the browser to prevent the crawling profile from being blocked. However, this means that the backup may take longer than with other software. Only when the backup job has been completely finished, the data is inserted into your project and is available for further data analysis.
115
116 = 2 Data analysis =
117
118 One of the strengths of SNH Titan is the visualization of the collected data. There are several areas within the software for this purpose.
119
120 == 2.1 Explorers ==
121
122 There is a separate explorer for each of the 4 main SNH data types. These are profiles, media items, postings and chat messages. Within the explorers, different data is displayed, but the principle of operation is relatively similar. The data explorers for each are tables, with a wide range of filtering and organization options. The number that appears above each main menu item indicates the number of objects of that type that have been collected. For example, in the screenshot below we see that 3,557 profiles have been collected.
123
124 == 2.1.1 Simple view ==
125
126 The first time you open a data explorer, e.g. the Profile Explorer, you will see the data collected so far in this project in table form. The Data Explorer is divided into two main areas, the menu and the table view.
127
128 [[The structure of the SNH Titan Data Explorer>>image:attach:Data Explorer.png||height="486" width="809"]]
129
130
131 The menu helps you to filter the data quickly. By default you will see all the collected data. You can see this on the left side, as the item "All profiles" is activated.
132
133 In the current menu you will see the data pools (more about that in a moment) related to a network, as well as the tags you have already assigned.
134
135
136 You now have a separate submenu per network, which can be opened by clicking on it and is again structured like the first menu.
137
138 **Important: You will only see menu items for networks for which data has already been collected!**
139
140 You will again see your data pools, your tags, but also your target profiles collected so far.
141
142 (% class="box infomessage" %)
143 (((
144 **What are target profiles?**
145 Target profiles are profiles for which you have collected data, or which you have manually marked as a target profile. So if you send a backup request for a certain profile, this profile will be marked as a target profile after the import into your project. In various places within SNH Titan you have the possibility to quickly access target profiles, e.g. when viewing dashboards or in Analytics.
146 )))
147
148 === 2.1.2 Friends and connected profiles ===
149
150 (((
151 If you unfold the target profiles, then you will get a choice of "Friends" or "All connected users". Below is a brief explanation of the differences:
152 )))
153
154 (((
155
156 )))
157
158 (((
159 |(% rowspan="2" style="width:314px" %)[[image:attach:insta-menu.png||height="266" width="288"]]|(% style="width:162px" %)**Friends**|(% style="width:1061px" %)Under the Friends menu item you can see all users who have a friendship with the collected profile. In Facebook, this means an assumed bidirectional friendship, or in Instagram, for example, that one person follows the other.
160 |(% style="width:162px" %)**All connected users**|(% style="width:1061px" %)Besides an explicit friendship, users can also be connected in other ways. For example, a user is connected to another user if he has reacted to a post of the target person or has commented on a post. Also connected are users who have mentioned each other in posts, or shared a target's post. There are more of these connections, which will also be explained in detail later in the manual.
161
162 Click on one of the two menu items to view the corresponding connected users in the table view.
163
164 === 2.2.3 Postings ===
165
166 |(% style="width:328px" %)(((
167 [[Example of the menu structure in the Posting Explorer>>image:attach:postings.png]]
168
169
170 )))|(% style="width:1192px" %)To view all saved postings, click on "Postings" in the menu. Again, all postings are loaded first, regardless of the network. You can then select by the corresponding networks in the menu. If you would like to see all postings that a specific profile has written, you must first define this profile as the target profile. If it is the target profile you have collected, then it will have already been automatically marked as a target profile. You will then see it in the menu under, for example, "Instagram target profiles". Then unfold your target profile and click on "Author of". You will then only see your target profile in the author column. This means that all the posts that are now displayed were written by the target profile you selected.
171
172 === 2.2.4 Media items ===
173
174 (% style="width:740px" %)
175 |(% style="width:275px" %)(((
176 [[Example of the Media Explorer menu structure>>image:attach:image (5).png]]
177
178
179 )))|(% style="width:461px" %)(((
180 To view all media, click on the "Media" menu item. Here, too, you will first be shown a list of all media. Media are all images and videos that have been collected so far. Not included are profile pictures, as these are usually not collected as separate media, unless a profile picture is also part of an album or the timeline of a target profile.
181
182 If you want to view a person's media, you can go back over the network, unfold the target profile, and then have the choice of either viewing all of the person's media, or viewing the media per album by unfolding the "Albums" submenu item.
183 )))
184
185 === 2.2.4 Chat messages ===
186
187 The menu structure for chat messages is also based on the previous menu structures. To select the chat messages of a specific person, simply select your target profile in the menu structure and display the corresponding chat messages. If you want to display all chat messages from a group (e.g. in Telegram), simply select the group in the navigation.
188
189 === 2.2.5 Detail view ===
190
191 If you want to see more details for one of the objects (profile, posting, media or chat message), click once on the object in the table. A sidebar will open where you can see all the collected information of the profile.** There you can also manually mark a profile as a target profile so that it appears in the left side. To do this, click on the bookmark icon at the top right.**
192
193 |(% style="width:47px" %)[[image:attach:not_bookmarked.png]]|(% style="width:1473px" %)This icon means that the selected profile is not a target profile yet.
194 |(% style="width:47px" %)[[image:attach:bookmarked.png]]|(% style="width:1473px" %)This icon means that the selected profile has now been marked as a target profile and should appear in the Explorer menu.
195
196
197 )))