Ads/en: различия между версиями

Материал из SmartPlayer
м (FuzzyBot переименовал страницу Создание объявлений/en в Ads/en без оставления перенаправления: Часть переводимой страницы Создание объявлений.)
(Новая страница: «== Additional Information == If this article does not help you use the functionality as intended, or if you have any questions after reading it, you can ask them in the "Discussion" section at the top of the page. thumb|center| Example of the "Discussion" tab display on the wiki page |800px»)
 
(не показано 7 промежуточных версий 2 участников)
Строка 1: Строка 1:
== '''Description of the situation''' ==  
<languages/>
In the SmartPlayer personal account, a new functionality has been added related to the creation of announcements for broadcasts with set schedules. This new feature was placed in a separate section of the personal account called "Announcements".
== Description of the Situation ==
[[File:Раздел_объявления.png|thumb|center|Section "Ads" located in your personal account|800px]]
A new functionality has been added to the SmartPlayer personal account, allowing the creation of announcements for broadcasts with scheduled times. This new functionality has been placed in a separate section of the personal account (PA) called "Announcements."
=== '''Need for functionality'' ===  
[[File:Раздел_объявления.png|thumb|center|The "Announcements" section located in the personal account|800px]]
This feature was introduced specifically to address the integration of additional advertising elements into the broadcast and fully automate this process. Previously, this could also be done, but only through complex, unclear, and makeshift actions. At the same time, the process itself required the user to perform many actions manually.
=== Need for the Functionality ===
== '''Principle of operation''' ==  
This functionality was specifically developed to address the need for integrating additional advertising elements into broadcasts and fully automating this process.<br>
=== '''Working logic''' ===  
Previously, this could also be done, but only through complex, unclear, and "hacky" methods. Moreover, the process required the user to perform many actions manually.
== How It Works ==
=== Operational Logic ===
The user needs to select a device in the "Devices" section.<br>
The user needs to select a device in the "Devices" section.<br>
Next, they should set a schedule for the selected device. This is done by clicking on the device itself and moving to the toolbar on the right. In the toolbar, there will be a "Schedule" item, on which you need to click and set the necessary settings.<br>
Next, they should set a schedule for the selected device. This is done by clicking on the device itself and navigating to the toolbar on the right. In the toolbar, there will be an item called "Schedule," where the necessary settings can be configured.<br>
An advertisement that has been created and configured is integrated into the ready-made broadcast with a schedule. The created announcement is played at specified intervals. The playback process happens as follows:
The created and configured announcement is integrated into the scheduled broadcast. The announcement plays at the specified time intervals. The playback process works as follows:
* The ongoing broadcast is interrupted and stopped when the time matches the start time of the announcement.
* The ongoing broadcast is interrupted and paused when the time coincides with the start time of the announcement.
* The announcement starts and is played for the selected period.
{{Note|It is important to set the correct duration interval for the announcement, taking into account the length of the content that will be played. If the content duration exceeds the selected announcement interval, there are likely to be issues with the integration and playback of the announcement in the broadcast.|warn}}
* After reaching the upper time boundary of the announcement, it ends and the broadcast restarts.
* The announcement starts playing according to the selected time interval.
{{Note|The announcement will be played in full even if it goes beyond the timeline (upper time boundary). |warn}}
* After reaching the upper limit of the time interval, the announcement ends, and the broadcast resumes.
{{Note|The announcement will play in full even if it exceeds the time slot (upper time limit).|warn}}
{{Note|Users can use announcements in broadcasts where multiple content elements are present.|warn}}
<br>
<br>
If the announcement had a repetition parameter set, it will be saved and will await the time for the next launch.<br>
If the announcement has a repeat parameter set, it will be saved and will await the next scheduled time for playback.<br>
If no repetition interval was set in the announcement settings, it completes its operating cycle and disappears.
If the repeat interval is not set in the announcement settings, it will complete its cycle and disappear.
[[File:Схема_создания.png|thumb|center|Scheme of work "Ads"|800px]]
[[File:Схема_создания.png|thumb|center|Workflow of "Announcements"|800px]]
=== '''Creating an Announcement''' ===  
 
{{Note|To create an announcement, you need to select a device on which a scheduled broadcast is running. If there is no schedule, it must be created first. |warn}}
=== Creating an Announcement ===
To create an announcement, you need to go to the "Announcement" section in the personal account. An announcement can be created in two ways:
{{Note|To create an announcement, you need to select a device where the broadcast is scheduled. If there is no schedule, it must be created.|warn}}
[[File:Кнопка_объявления_в_тулбаре.png|thumb|left|Add button in toolbar|150px]]
To create an announcement, go to the "Announcements" section in your personal account. There are two ways to create an announcement:
[[File:Кнопка добавить.png|thumb|right|
[[File:Кнопка_объявления_в_тулбаре.png|thumb|left|Button to add in the toolbar|150px]]
Add button to the main page of the "Ads" section|150px]]
[[File:Кнопка добавить.png|thumb|right|Button to add on the main page of the "Announcements" section|150px]]
# On the left, through the toolbar, in the "Announcements" section, there is a separate button. This method allows you to create an announcement at any time.
# Through the toolbar on the left in the "Announcements" section, there is a dedicated button. This method allows you to always create an announcement.
# On the main page of the "Announcements" section, using a separate button. This method doesn't work when there is at least one previously created announcement.
# On the main page of the "Announcements" section, using a dedicated button. This method does not work when there is at least one previously created announcement.
After using one of the options, an announcement settings window will open.
After using one of these options, the announcement settings window will open.
=== '''Announcement Settings''' ===  
=== Announcement Settings ===
{{Note|The content that can be used in advertisements is limited. In announcements, you can only use video and photo content. |warn}}
{{Note|The content that can be used in announcements is limited. Only video and photo content can be used in announcements.|warn}}
The settings page consists of three blocks:
The settings page consists of three blocks:
# Main Settings - This section specifies the primary settings.
# Main Settings - This section contains the main settings.
# Devices - Select the device to which the announcement will be applied. The selected device must have a schedule.
# Devices - Here, you select the device to which the announcement will be applied. The selected device must have a schedule.
# Summary - Final information about the announcement.
# Summary - Final information about the announcement.
==== '''Main Settings Page"''' ====
==== "Main Settings" Page ====
[[File:Список_настроек.png|thumb|center|Basic Settings Page|800px]]
[[File:Новое_окно_параметров.png|thumb|center|The "Main Settings" Page|800px]]
On the "Main Settings" page, you need to set all the settings for the correct operation of the announcements:
[[File:Настройка_времени.png|thumb|right|Location of the "pencil" icon and transition to further time playback settings.|150px]]
# Title - Here the announcement title is specified.
On the "Main Settings" page, you need to configure all the settings for the correct operation of the announcements:
# Additional Description - In this section, a description/comment about the broadcast is written.
# Name - Here you enter the name of the announcement.
# Start Date - Sets the date when the announcement will start to "intervene" in the broadcast schedule. By clicking on the "Calendar" icon, a window with dates in the form of a calendar will appear, where you can select the desired date.
# Additional Description - In this section, you can add a description/comment for the broadcast.
# End Date - Sets the date when the announcement will stop playing. By clicking on the "Calendar" icon, a window with dates in the form of a calendar will appear, where you can select the desired date.
# Start Date - Set the date when the announcement will start "intervening" in the broadcast schedule. By clicking the "Calendar" icon, a calendar window will appear where you can select the desired date.
# Play Announcement Every - An interval that allows you to choose the frequency of playing the announcement in the broadcast with a schedule. You can choose the unit of measurement for this value: minutes, seconds, hours.
# End Date - Set the date when the announcement will stop playing. By clicking the "Calendar" icon, a calendar window will appear where you can select the desired date.
# Playback Time - Sets the time to start and turn off the announcement in the broadcast with a schedule.
# Playback Type - Indicates the format of the announcement insertion that will be used. There are three options available: between content and broadcast, at a specific time, or for advertisers.
# Warning Information - Information that notifies about the mechanism of embedding the announcement in the broadcast.
# Play Announcement - Allows you to specify the interval for the announcement playback.
# More/Hide - A button that opens additional settings.
# Time Format - Allows you to choose between "UTC Time" and "Local Time." It is recommended to use "Local Time."
# Use Time Formats - Allows you to choose between "UTC time" and "Local Time". It is recommended to use "Local Time".
# "Next" Button - Allows you to proceed to the next stage of settings. The "Next" button will only work if content is selected; otherwise, a warning window will appear.
# "Cancel" and "Next" buttons - The cancel button allows you to return to the main page of the "Announcements" section. The "Next" button allows you to proceed to the next stage of settings. To activate the "Next" button, it is essential to choose content; otherwise, a warning window will pop up.
# "Cancel" Button - Allows you to return to the main page of the "Announcements" section.
[[File:Окно с предупрежедением.png|thumb|right|Warning window|150px]]
[[File:Окно с предупрежедением.png|thumb|right|Warning window|150px]]
On this page, there is also a content work window. It includes:
This page also includes a content management window, which consists of:
[[File:Страница_настройки_контента.png|thumb|center|Window for working with content|800px]]
[[File:Страница_настройки_контента.png|thumb|center|Content management window|800px]]
# Search Window - Allows you to find content by typing the file name in the search bar.
# Search Window - Allows you to find content by typing the file name in the search bar.
# Sorting - Sorts content by three parameters: creation date, name, size.
# Sorting - Sorts content by three parameters: creation date, name, size.
# Content Selection - Allows you to select all content at once or cancel the selection if the content was selected.
# Content Selection - Allows you to select all content at once or deselect it if it was already selected.
# Display Window - Offers to choose display formats of the available content either as tiles or as a list.
# Display Options - Allows you to choose how the content is displayed, either as tiles or as a list.
# Upload File - Allows you to upload content directly from the user's device.
# Upload File - Allows you to upload content directly from the user's device.
# Content Location Path - Shows the path where the content is located.
# Content Location Path - Shows the path where the content is located.
# Content Type - Allows you to sort content into "pictures" and "videos" when clicked.
# Content Type - Allows you to filter content into "images" and "videos" by clicking on it.
==== '''Settings Page''' ====
 
[[File:Список_устройств.png|thumb|center|
==== "Devices" Page ====
General view of the "Devices" page|800px]]
[[File:Список_устройств.png|thumb|center|General view of the "Devices" page|800px]]
After filling in all the data on the "Main Settings" page and clicking the "Next" button, the user is taken to the "Devices" page.<br>
After filling in all the data on the "Main Settings" page and clicking the "Next" button, the user is taken to the "Devices" page.<br>
On this page, the user selects the device to which the advertisement will be applied. The device can be selected with a mouse click. The selected device will be marked with a "checkmark".
On this page, the user selects the device to which the announcement will be applied. You can select a device by clicking on it with the mouse. The selected device will be marked with a checkmark.
[[File:Помеченное_устройство.png|thumb|center|Marked, selected device|300px]]
[[File:Помеченное_устройство.png|thumb|center|Marked, selected device|300px]]
After selecting the device, click the "Next" button.
After selecting the device, click the "Next" button.
==== '''Summary Page''' ====
==== "Summary" Page ====
[[File:Страница_сводка.png|thumb|center|General view of the Summary page|800px]]
[[File:Страница_сводка.png|thumb|center|General view of the "Summary" page|800px]]
The final step in creating an advertisement is obtaining information from the "Summary" page. The "Summary" page can be divided into two parts:
The final step in creating the announcement is to review the information on the "Summary" page.
* General Information Zone about the Advertisement, called "Summary"
The "Summary" page can be divided into two parts:
In this zone, general information about the advertisement is detailed, which includes a description of the main parameters set in the "Main Settings" section.
* Summary Section - This area contains general information about the announcement, including the main parameters set in the "Main Settings" section.
* Information Zone about Advertisement Conflicts with the Device or Broadcast, called "Conflicts"
* Conflicts Section - This area contains information about any conflicts between the announcement and the device or broadcast, which need to be resolved. If these conflicts are not resolved, it will be impossible to create the announcement after clicking the "Resolve Conflicts and Save" button. A special pop-up notification will alert you to the problem.
This zone contains information about the advertisement's conflicts with the device or broadcast that need to be resolved. If these conflicts are not resolved, creating an advertisement will be impossible after clicking the "Resolve Conflicts and Save" button. A special pop-up line will notify about the problem.
[[File:Всплывающая_строка.png|thumb|center|Example of a pop-up notification about a conflict|800px]]
[[File:Всплывающая_строка.png|thumb|center|
After resolving all conflicts, click the "Resolve Conflicts and Save" button and proceed to the final page. On this page, the fully created announcement is displayed.
Example of a pop-up notification about a conflict|800px]]
[[File:Готовое_объявление.png|thumb|center|Completed announcement|800px]]
After resolving all conflicts, click the "Resolve Conflicts and Save" button and move on to the final page. This page displays the already completed advertisement.
==== Deleting an Announcement ====
[[File:Готовое_объявление.png|thumb|center|
A completed announcement can be deleted in one way. To do this, you need to click on it once and navigate to the right toolbar. There, the user will see the "Trash" icon, which is used to delete the announcement.
Ready ad|800px]]
[[File:Иконка_корзины.png|thumb|center|Location of the icon for deleting an announcement|800px]]
==== '''Deleting an Advertisement''' ====
 
A completed advertisement can be deleted in one way. To do this, click on it once and move to the right toolbar. There the user can see a "Trash" icon, which is used to delete the advertisement.
=== Useful Information ===
[[File:Иконка_корзины.png|thumb|center|Icon location for deleting an ad|800px]]
* The announcement will play in full, even if it exceeds the timeline (upper time limit).
=== '''Useful Information''' ===
* To create an "Announcement," there must be a scheduled broadcast on the device. If there is no schedule, it must be created.
* An advertisement plays in full, even if it goes beyond the timeline's upper boundary (time limit).
* Only photo and video content should be used in announcements.
* To create an "Ad" on a device, there must be a scheduled broadcast. If there is no schedule, it needs to be created.
* A schedule with a single zone and a single page must be used. Otherwise, the system will not allow the announcement to be created and will request that you return to the beginning of the announcement creation process.
* In advertisements, only photo and video content should be used.
* If the announcement does not appear in the list after creation, the issue might be with the filter settings. Check the status filter and try other options.
* You should use a schedule with one zone and one page. Otherwise, the system won't allow the creation of the advertisement and will ask to start over.
* Each announcement is assigned its own ID upon creation. This hidden parameter may affect the operation of the announcement within the schedule.
* If an advertisement doesn't appear in the list after creation, the issue might be due to filter settings. Check the current filter status and try different ones.
* If multiple types of content are added to the announcement, they will play in the order they were added. The content added first will play first. This is related to the assignment of IDs to each announcement. The first announcement will receive a lower ID value, meaning it will play first.
* Every advertisement gets an ID upon creation. This invisible parameter can influence the ad's behavior in the schedule.
* If there are two announcements in the schedule, and the first one is edited, it will play last. This is because the announcement is deleted and recreated when edited, and it receives a new numeric ID, which is naturally higher than that of the second announcement.
* If multiple content types are added to an advertisement, they will play in the order they were added. Meaning, the one added earlier will play first. This is related to the assignment of IDs for each ad. The first ad gets a smaller ID value and thus will be the first to play.
* By default, it is recommended to use local time when creating an announcement.
* If there are two ads in the schedule, and the first one is modified, it will play last. This is because when modified, the ad is deleted and recreated. At this moment, it gets a new ID, which is naturally larger than the second ad's.
* If content is not selected when creating an announcement and the "Next" button is clicked, a pop-up message will appear with the text: "Advertising content not selected."
* By default, it's recommended to use local time when creating an ad.
* Announcements can be applied to both online and offline devices, as long as there is at least one schedule on the device.
* If you don't choose content when creating an ad and press "Next," a pop-up message will appear saying, "Ad content not selected."
* All identified conflicts when creating an announcement are highlighted in the "Summary" section. All conflicts must be resolved to complete the announcement creation.
* Ads can be applied to both online and offline devices. The main thing is that the device has at least one schedule.
* If you need to delete multiple announcements, it is recommended to do so individually and sequentially.
* In the "Summary" section, all conflicts found during ad creation are highlighted. To complete the ad creation, all conflicts need to be resolved.
* Double-clicking on a completed announcement allows you to edit it.
* If you need to delete several ads, it's recommended to do them one by one.
* If the schedule ends while the announcement is playing, the announcement will stop.
* Double-clicking on a completed ad allows you to edit it.
* To save device memory, the announcement will be deleted after the "End * Date" has passed and if there is no repeat event.
* If the schedule ends and the ad is still playing, the ad will stop.
* Announcements affect the content playback statistics.
* To save device memory, the ad will be deleted after the "End Date" passes and if there's no repeat event set.
* After the device connects to the server, it will receive information about the announcement within one minute.
* Ads affect content playback statistics.
== Additional Materials ==
* After connecting the device to the server, the device will receive advertisement information within a minute.
* [[Announcement at the End of the Broadcast Schedule]]
== '''Final Result''' ==
* [[Announcement Playback Type "Between Content and Broadcast"]]
Users can easily and seamlessly integrate "Ads" into their broadcasts.
* [[Announcement Playback Type "At a Specific Time"]]
* [[Announcement Playback Type "Advertisers"]]
 
== Additional Information ==
If this article does not help you use the functionality as intended, or if you have any questions after reading it, you can ask them in the "Discussion" section at the top of the page.
[[File:Обсуждения_объявлений.png|thumb|center| Example of the "Discussion" tab display on the wiki page |800px]]

Текущая версия от 14:22, 20 августа 2024

Другие языки:

Description of the Situation

A new functionality has been added to the SmartPlayer personal account, allowing the creation of announcements for broadcasts with scheduled times. This new functionality has been placed in a separate section of the personal account (PA) called "Announcements."

The "Announcements" section located in the personal account

Need for the Functionality

This functionality was specifically developed to address the need for integrating additional advertising elements into broadcasts and fully automating this process.
Previously, this could also be done, but only through complex, unclear, and "hacky" methods. Moreover, the process required the user to perform many actions manually.

How It Works

Operational Logic

The user needs to select a device in the "Devices" section.
Next, they should set a schedule for the selected device. This is done by clicking on the device itself and navigating to the toolbar on the right. In the toolbar, there will be an item called "Schedule," where the necessary settings can be configured.
The created and configured announcement is integrated into the scheduled broadcast. The announcement plays at the specified time intervals. The playback process works as follows:

  • The ongoing broadcast is interrupted and paused when the time coincides with the start time of the announcement.
It is important to set the correct duration interval for the announcement, taking into account the length of the content that will be played. If the content duration exceeds the selected announcement interval, there are likely to be issues with the integration and playback of the announcement in the broadcast.
  • The announcement starts playing according to the selected time interval.
  • After reaching the upper limit of the time interval, the announcement ends, and the broadcast resumes.
The announcement will play in full even if it exceeds the time slot (upper time limit).
Users can use announcements in broadcasts where multiple content elements are present.


If the announcement has a repeat parameter set, it will be saved and will await the next scheduled time for playback.
If the repeat interval is not set in the announcement settings, it will complete its cycle and disappear.

Workflow of "Announcements"

Creating an Announcement

To create an announcement, you need to select a device where the broadcast is scheduled. If there is no schedule, it must be created.

To create an announcement, go to the "Announcements" section in your personal account. There are two ways to create an announcement:

Button to add in the toolbar
Button to add on the main page of the "Announcements" section
  1. Through the toolbar on the left in the "Announcements" section, there is a dedicated button. This method allows you to always create an announcement.
  2. On the main page of the "Announcements" section, using a dedicated button. This method does not work when there is at least one previously created announcement.

After using one of these options, the announcement settings window will open.

Announcement Settings

The content that can be used in announcements is limited. Only video and photo content can be used in announcements.

The settings page consists of three blocks:

  1. Main Settings - This section contains the main settings.
  2. Devices - Here, you select the device to which the announcement will be applied. The selected device must have a schedule.
  3. Summary - Final information about the announcement.

"Main Settings" Page

The "Main Settings" Page
Location of the "pencil" icon and transition to further time playback settings.

On the "Main Settings" page, you need to configure all the settings for the correct operation of the announcements:

  1. Name - Here you enter the name of the announcement.
  2. Additional Description - In this section, you can add a description/comment for the broadcast.
  3. Start Date - Set the date when the announcement will start "intervening" in the broadcast schedule. By clicking the "Calendar" icon, a calendar window will appear where you can select the desired date.
  4. End Date - Set the date when the announcement will stop playing. By clicking the "Calendar" icon, a calendar window will appear where you can select the desired date.
  5. Playback Type - Indicates the format of the announcement insertion that will be used. There are three options available: between content and broadcast, at a specific time, or for advertisers.
  6. Play Announcement - Allows you to specify the interval for the announcement playback.
  7. Time Format - Allows you to choose between "UTC Time" and "Local Time." It is recommended to use "Local Time."
  8. "Next" Button - Allows you to proceed to the next stage of settings. The "Next" button will only work if content is selected; otherwise, a warning window will appear.
  9. "Cancel" Button - Allows you to return to the main page of the "Announcements" section.
Warning window

This page also includes a content management window, which consists of:

Content management window
  1. Search Window - Allows you to find content by typing the file name in the search bar.
  2. Sorting - Sorts content by three parameters: creation date, name, size.
  3. Content Selection - Allows you to select all content at once or deselect it if it was already selected.
  4. Display Options - Allows you to choose how the content is displayed, either as tiles or as a list.
  5. Upload File - Allows you to upload content directly from the user's device.
  6. Content Location Path - Shows the path where the content is located.
  7. Content Type - Allows you to filter content into "images" and "videos" by clicking on it.

"Devices" Page

General view of the "Devices" page

After filling in all the data on the "Main Settings" page and clicking the "Next" button, the user is taken to the "Devices" page.
On this page, the user selects the device to which the announcement will be applied. You can select a device by clicking on it with the mouse. The selected device will be marked with a checkmark.

Marked, selected device

After selecting the device, click the "Next" button.

"Summary" Page

General view of the "Summary" page

The final step in creating the announcement is to review the information on the "Summary" page. The "Summary" page can be divided into two parts:

  • Summary Section - This area contains general information about the announcement, including the main parameters set in the "Main Settings" section.
  • Conflicts Section - This area contains information about any conflicts between the announcement and the device or broadcast, which need to be resolved. If these conflicts are not resolved, it will be impossible to create the announcement after clicking the "Resolve Conflicts and Save" button. A special pop-up notification will alert you to the problem.
Example of a pop-up notification about a conflict

After resolving all conflicts, click the "Resolve Conflicts and Save" button and proceed to the final page. On this page, the fully created announcement is displayed.

Completed announcement

Deleting an Announcement

A completed announcement can be deleted in one way. To do this, you need to click on it once and navigate to the right toolbar. There, the user will see the "Trash" icon, which is used to delete the announcement.

Location of the icon for deleting an announcement

Useful Information

  • The announcement will play in full, even if it exceeds the timeline (upper time limit).
  • To create an "Announcement," there must be a scheduled broadcast on the device. If there is no schedule, it must be created.
  • Only photo and video content should be used in announcements.
  • A schedule with a single zone and a single page must be used. Otherwise, the system will not allow the announcement to be created and will request that you return to the beginning of the announcement creation process.
  • If the announcement does not appear in the list after creation, the issue might be with the filter settings. Check the status filter and try other options.
  • Each announcement is assigned its own ID upon creation. This hidden parameter may affect the operation of the announcement within the schedule.
  • If multiple types of content are added to the announcement, they will play in the order they were added. The content added first will play first. This is related to the assignment of IDs to each announcement. The first announcement will receive a lower ID value, meaning it will play first.
  • If there are two announcements in the schedule, and the first one is edited, it will play last. This is because the announcement is deleted and recreated when edited, and it receives a new numeric ID, which is naturally higher than that of the second announcement.
  • By default, it is recommended to use local time when creating an announcement.
  • If content is not selected when creating an announcement and the "Next" button is clicked, a pop-up message will appear with the text: "Advertising content not selected."
  • Announcements can be applied to both online and offline devices, as long as there is at least one schedule on the device.
  • All identified conflicts when creating an announcement are highlighted in the "Summary" section. All conflicts must be resolved to complete the announcement creation.
  • If you need to delete multiple announcements, it is recommended to do so individually and sequentially.
  • Double-clicking on a completed announcement allows you to edit it.
  • If the schedule ends while the announcement is playing, the announcement will stop.
  • To save device memory, the announcement will be deleted after the "End * Date" has passed and if there is no repeat event.
  • Announcements affect the content playback statistics.
  • After the device connects to the server, it will receive information about the announcement within one minute.

Additional Materials

Additional Information

If this article does not help you use the functionality as intended, or if you have any questions after reading it, you can ask them in the "Discussion" section at the top of the page.

Example of the "Discussion" tab display on the wiki page
Источник — https://wiki.smartplayer.org/index.php?title=Ads/en&oldid=13441