This page explains how to update elements configuration.
{resource-id}: the object ID
Attribute | Value | Mandatory | Default |
---|---|---|---|
title | A non-empty string | NO | |
label | A non-empty string. A non-empty string.
Specifica in questo campo un'etichetta di riconoscimento della configurazione. Questo campo sarà utilizzato per un'eventuale parametrizzazione del codice embed. Aggiungendo l'attributo data-bulk-label='mylabel' al tag div del codice embed si forzerà l'embed a prendere le proprietà della configurazione indipendentemente dalla pagina che sta erogandoL'etichetta deve essere scelta univocamente per tutte le configurazioni inserite. Non è possibile modificarne il valore una volta che la configurazione è stata associata ad uno o più embed |
NO | |
context_rules | Regole di contesto della configurazione separate da carattere | .By context rule we mean a rule on domains where the configuration will take effect. Specifying the * character as the context rule means that the configuration will take effect in any domain.
Each context rule, with the exception of the * rule, must start with the http or https protocol, followed by the domain name and ending with the * character indicating that the configuration takes effect on every page of the specified domain.Ex: - http://domain.com* the configuration will take effect in all the URL's in the domain "domain.com" - * The configuration always takes effect It is not possible to differentiate the context rules within the same domain |
NO | |
skin | Il nome della skin del player. Le opzioni disponibili sono visualizzabili nel pannello Meride CMS | NO | default |
responsive | 1 if you want the player to be responsive. 0 otherwise |
NO | 0 |
background_color | The background color of the player in HEX code. | NO | 000000 |
background_image | URL of the player's background image. | NO | |
autoplay | 1 if you want the video of the player to start in autoplay. 0 otherwise |
NO | 0 |
controlbar_visible | 0 if you want to hide the control bar in the player. 1 otherwise |
NO | 1 |
seekable | 0 if you want to disable the player scrolling forward. 1 otherwise |
NO | 1 |
wmode | The wmode property of the object / embed element on Flash player. Possible values:direct , window , opaque , transparent , gpu |
NO | direct |
skip_preroll | 1 and if you want to bring up the link to skip the preroll. 0 otherwise |
NO | 0 |
skip_time | Integer. Specify the number of seconds after which the link appears to skip the preroll | NO | 5 |
setting_volume | Google DART volume.-1 Predefined. none No check. defaultOn Volume active. defaultOff Volume disabled |
NO | -1 |
adblock_policy | If specified, indicate the anti-AdBlock policy. Possible values: black_preroll ,block_video |
NO | |
adblock_policy_ad_video_id | If the field value adblock_policy is roll_video specify the ID of the advideo object that you want to render as a preroll in this field in cases where AdBlock is active by the user |
NO | |
player_adv_manager | Indicates the player's ad manager. Possible values: default ,ima |
NO | default |
ima_vpaid_mode | Possible values: ENABLED ,INSECURE ,DISABLED |
NO | ENABLED |
desktop_player | Indicates the type of player to be used for desktop users. Possible values: flash ,html5 |
NO | flash |
preroll_id | L'ID del preroll da utilizzare (rispetto al tipo di preroll) nel player Flash per utenti desktop. Qual'ora si vogliano associare più di un preroll passare una stringa della forma id1|id2|id3 con i 3 id dei preroll che si vogliono associare. E' possibile associare più di un singolo preroll solo di adv di tipo dart linear |
NO | |
preroll_tipo | Il tipo di preroll da utilizzare. (dart per oggetti Google DART, video per contenuti Roll) |
NO | |
postroll_id | L'ID dell'postroll da utilizzare (rispetto al tipo di endroll) nel player Flash per utenti desktop. | NO | |
postroll_tipo | Il tipo di postroll da utilizzare. (dart per oggetti Google DART, video per contenuti Roll) |
NO | |
overlay_initial_id | L'ID dell'overlay iniziale da associare nel player Flash per utenti desktop. Possono essere assegnati come overlay solo adv dart non-linear. Se l'overlay iniziale è specificato bisogna obbligatoriamente settare anche i campi overlay_initial_stay_time e overlay_initial_after_time | NO | |
overlay_initial_after_time | Intero che esprime in secondi il delay di entrata dell'overlay iniziale. | NO | |
overlay_initial_stay_time | Intero che esprime in secondi il tempo di permanenza dell'overlay iniziale. Il tempo di permamenza deve essere di minimo 15 secondi | NO | |
overlay_main_id | L'ID dell'overlay principale da associare nel player Flash per utenti desktop. Possono essere assegnati come overlay solo adv dart non-linear. Se l'overlay principale è specificato bisogna obbligatoriamente settare anche i campi overlay_initial_fixed, overlay_initial_after_time, overlay_main_max_width e overlay_main_max_height | NO | |
overlay_main_after_time | Intero che esprime in secondi il delay di entrata dell'overlay principale. | NO | |
overlay_main_fixed | 1 If you want the main overlay to remain fixed throughout the duration of the embed. 0 Se si vuole temporizzare le chiamate all'overlay principale. Se viene scelta la modalità temporizzata bisogna obbligatoriamente specificare un valore anche per i campi overlay_main_stay_time e overlay_main_delay_time |
NO | |
overlay_main_stay_time | Intero che esprime in secondi il tempo di permanenza della singola chiamata all'overlay principale. Il tempo di permamenza deve essere di minimo 15 secondi. Il valore per questo campo va specificato solo se l'overlay non è fisso | NO | |
overlay_main_delay_time | Intero che esprime in secondi l'intervallo di tempo tra una chiamata e l'altra all'overlay principale. Il valore per questo campo va specificato solo se l'overlay non è fisso | NO | |
overlay_main_max_width | Intero che esprime la dimensione massima in pixel della larghezza dell'overlay principale. -1 Se si vuole lasciare libera la dimensione. La coppia larghezza e altezza dell'overlay deve essere una tra le seguenti: 300x250 180x150 160x600 728x90 300x600 550x480 |
NO | |
overlay_main_max_height | Intero che esprime la dimensione massima in pixel dell'altezza dell'overlay principale. -1 Se si vuole lasciare libera la dimensione. La coppia larghezza e altezza dell'overlay deve essere una tra le seguenti: 300x250 180x150 160x600 728x90 300x600 550x480 |
NO | |
html5_preroll_id | L'ID del preroll da utilizzare (rispetto al tipo di preroll) nel player HTML5 utilizzato per i dispositivi mobili. Qual'ora si vogliano associare più di un preroll passare una stringa della forma id1|id2|id3 con i 3 id dei preroll che si vogliono associare. Solo adv di tipo dart sono supportati dal player HTML5 |
NO | |
html5_preroll_tipo | Il tipo di preroll da utilizzare. (dart per oggetti Google DART) |
NO | |
html5_postroll_id | L'ID dell'postroll da utilizzare (rispetto al tipo di endroll) nel player HTML5 utilizzato per i dispositivi mobili. Solo adv di tipo dart sono supportati dal player HTML5 | NO | |
html5_postroll_tipo | Il tipo di postroll da utilizzare. (dart per oggetti Google DART) |
NO | |
html5_overlay_initial_id | L'ID dell'overlay iniziale da associare nel player HTML5 utilizzato per i dispositivi mobili. Possono essere assegnati come overlay solo adv dart non-linear. Se l'overlay iniziale è specificato bisogna obbligatoriamente settare anche i campi html5_overlay_initial_stay_time e html5_overlay_initial_after_time | NO | |
html5_overlay_initial_after_time | Intero che esprime in secondi il delay di entrata dell'overlay iniziale per i dispositivi mobili. | NO | |
html5_overlay_initial_stay_time | Intero che esprime in secondi il tempo di permanenza dell'overlay iniziale. Il tempo di permamenza deve essere di minimo 15 secondi | NO | |
html5_overlay_main_id | L'ID dell'overlay principale da associare nel player HTML5 utilizzato per i dispositivi mobili. Possono essere assegnati come overlay solo adv dart non-linear. Se l'overlay principale è specificato bisogna obbligatoriamente settare anche i campi html5_overlay_initial_fixed, html5_overlay_initial_after_time, html5_overlay_main_max_width e html5_overlay_main_max_height | NO | |
html5_overlay_main_after_time | Intero che esprime in secondi il delay di entrata dell'overlay principale per i dispositivi mobili. | NO | |
html5_overlay_main_fixed | 1 If you want the main overlay to remain fixed throughout the duration of the embed. 0 Se si vuole temporizzare le chiamate all'overlay principale. Se viene scelta la modalità temporizzata bisogna obbligatoriamente specificare un valore anche per i campi html5_overlay_main_stay_time e html5_overlay_main_delay_time |
NO | |
html5_overlay_main_stay_time | Intero che esprime in secondi il tempo di permanenza della singola chiamata all'overlay principale. Il tempo di permamenza deve essere di minimo 15 secondi. Il valore per questo campo va specificato solo se l'overlay non è fisso | NO | |
html5_overlay_main_delay_time | Intero che esprime in secondi l'intervallo di tempo tra una chiamata e l'altra all'overlay principale. Il valore per questo campo va specificato solo se l'overlay non è fisso | NO | |
html5_overlay_main_max_width | Intero che esprime la dimensione massima in pixel della larghezza dell'overlay principale. -1 Se si vuole lasciare libera la dimensione. La coppia larghezza e altezza dell'overlay deve essere una tra le seguenti: 300x250 180x150 160x600 728x90 300x600 550x480 |
NO | |
html5_overlay_main_max_height | Intero che esprime la dimensione massima in pixel dell'altezza dell'overlay principale. -1 Se si vuole lasciare libera la dimensione. La coppia larghezza e altezza dell'overlay deve essere una tra le seguenti: 300x250 180x150 160x600 728x90 300x600 550x480 |
NO | |
watermark | A reference to the image file path of the watermark you want to apply. Allowed extensions:jpg ,png ,gif |
NO | |
watermark_width | Width of the watermark in pixels for resize | NO | |
watermark_height | Height of the watermark in pixels for resize | NO | |
watermark_opacity | Watermark transparency level. Allowed values0 ,0.1 ,0.2 ,0.3 ,0.4 ,0.5 ,0.6 ,0.7 ,0.8 ,0.9 ,1 |
NO | |
watermark_displaytime | If specified, indicate the dwell time of the watermark in seconds | NO | |
watermark_hide | 1 If you want the watermark to disappear along with the player control bar. 1 otherwise. |
NO | |
watermark_link | If specified, it makes the watermark clickable by redirecting the user to the specified URL | NO | |
watermark_[position] | It is possible to use two of these fieldswatermark_bottom , watermark_right , watermark_top , watermark_left to specify the placement of the watermark inside the player. Values can be expressed in px or in % . For example, to place the watermark at the bottom right, pass the parameters watermark_bottom=5px, watermark_right=5px |
NO | |
webtrekk_account_id | L'ID di Meride dell'account Webtrekk da utilizzare. Passare stringa vuota se non si vuole associare alcun account. Passare stringa vuota se si vuole cancellare l'eventuale configurazione associata | NO | |
ama_configuration_id | L'ID di Meride della configurazione Akamai Media Analytics da utilizzare. Passare stringa vuota se si vuole cancellare l'eventuale configurazione associata | NO | |
comscore_account_id | L'ID di Meride dell'account Comscore da utilizzare. Passare stringa vuota se si vuole cancellare l'eventuale account associato | NO | |
nielsen_account_id | L'ID di Meride dell'account Nielsen da utilizzare. Passare stringa vuota se si vuole cancellare l'eventuale account associato | NO |
Note The advertisements associated with a single configuration must all be of the same type
Field | Value | Description |
---|---|---|
id | string | Object ID |
title | string | Il titolo della configurazione |
label | string | The label field associated with the configuration |
context_rules | array | Set of context rules |
data_inserimento | string | La data di inserimento che segue il formato Y-m-d H:i:sY(year) m(month) d(day) H(hours) i(minutes) s(seconds) |
skin | string | The skin of the player chosen during create |
responsive | boolean | 1 if autoplay is responsive. 0 otherwise |
background_color | string | The background color of the player in HEX code. |
background_image | string | URL of the player's background image. |
autoplay | boolean | 1 if the video is published in autoplay. 0 otherwise |
controlbar_visible | boolean | 0 if the player's control bar is hidden. 0 otherwise |
seekable | boolean | 0 if the player's scroll bar is disabled. 0 otherwise |
wmode | string | The wmode property of the object/embed element on Flash player |
skip_preroll | boolean | 1 if the user has the option to skip the preroll. 0 otherwise |
skip_time | integer | The number of seconds after which the link to skip the preroll appears |
setting_volume | string | Google DART volume.-1 Predefined. none No check. defaultOn Volume active. defaultOff Volume disabled |
adblock_policy | string | Anti-AdBlock policy |
adblock_policy_ad_video | advideo | Advideo object to be used as a preroll for the anti-AdBLock policy |
player_adv_manager | string | Player Ad Manager |
ima_vpaid_mode | string | IMA Vpaid Mode |
desktop_player | string | Player type for desktop users |
preroll | advideo | addart | Il preroll utilizzato nel player Flash per utenti desktop. Qual'ora sono associati più di un singolo preroll verrà restituito un array con tutti i preroll associati |
postroll | advideo | addart | Il postroll utilizzato nel player Flash per utenti desktop |
overlay_initial | addart | L'overlay iniziale utilizzato nel player Flash per utenti desktop |
overlay_main | addart | L'overlay principale utilizzato nel player Flash per utenti desktop |
html5_preroll | addart | Il preroll utilizzato nel player HTML5 utilizzato per i dispositivi mobili. Qual'ora sono associati più di un singolo preroll verrà restituito un array con tutti i preroll associati |
html5_postroll | addart | Il postroll utilizzato nel player HTML5 utilizzato per i dispositivi mobili. |
html5_overlay_initial | addart | L'overlay iniziale utilizzato nel player HTML5 utilizzato per i dispositivi mobili. |
html5_overlay_main | addart | L'overlay principale utilizzato nel player HTML5 utilizzato per i dispositivi mobili. |
watermark | string | URL to the image of the watermark |
watermark_width | int | Watermark resize width |
watermark_height | int | Watermark height resize |
watermark_opacity | float | Watermark transparency level |
watermark_displaytime | int | Watermark dwell time in seconds |
watermark_hide | boolean | 1 If the watermark disappears together with the player controls. 0 otherwise |
watermark_link | string | URL to redirect by clicking on the watermark. |
watermark_bottom | string | Placement of the watermark from the bottom |
watermark_right | string | Placement of the watermark from the right |
watermark_top | string | Placement of the watermark from the top |
watermark_left | string | Placement of the watermark from the left |
webtrekk_account | webtrekk | The associated Webtrekk object |
ama_configuration | ama | The associated Akamai Media Analytics object |
comscore_account | comscore | The associated Comscore object |
nielsen_account | nielsen | The associated Nielsen object |
tipo_adv
che specifica la tipologia di advertising: dart
per oggetti Google DART, video
per contenuti Roll) { "id":"39", "titolo":"Titolo updated configuration", "label":"conf1", "context_rules":{ "0":"http:\/\/www.meride.tv*", "1":"http:\/\/www.mosaicolab.com*" }, "skin":"default", "data_inserimento":"2012-09-24 09:12:49", "responsive":"0", "background_color":"000000", "background_image":"", "autoplay":"1", "controlbar_visible":"1", "seekable":"1", "wmode":"direct", "skip_preroll":"", "skip_time":"", "setting_volume" : "-1", "adblock_policy":"", "adblock_policy_ad_video_id":null, "player_adv_manager":"default", "ima_vpaid_mode":null, "desktop_player":"flash", "preroll":{ "tipo_adv":"dart", "id":"2", "titolo":"Google dart", "url_sorgente":"http:\/\/googledarturl.com/advertising.xml", "tags":"lorem, ipsum", "descrizione":"Lorem ispum dolor sit amet", "data_inserimento":"2012-09-21 20:26:18" }, "postroll":null, "overlay_initial":{ "tipo_adv":"dart", "id":"59", "tipo":"non-linear", "titolo":"Overlay", "url_sorgente":"http:\/\/googledarturl.com/advertising2.xml", "descrizione":"", "data_inserimento":"2012-12-17 11:38:26", "stay_time":"15" "after_time":"0" }, "overlay_main":null, "html5_preroll":{ "tipo_adv":"dart", "id":"2", "titolo":"Google dart", "url_sorgente":"http:\/\/googledarturl.com/advertising.xml", "tags":"lorem, ipsum", "descrizione":"Lorem ispum dolor sit amet", "data_inserimento":"2012-09-21 20:26:18" }, "html5_postroll":null, "html5_overlay_initial":null, "html5_overlay_main":{ "tipo_adv":"dart", "id":"33", "tipo":"non-linear", "titolo":"Overlay", "url_sorgente":"http:\/\/googledarturl.com/advertising3.xml", "descrizione":"", "data_inserimento":"2012-05-23 18:26:20", "fixed":"0", "after_time":"0" "stay_time":"15", "delay_time":"20", "max_width":"728", "max_height":"90" }, "watermark":null, "watermark_width":null, "watermark_height":null, "watermark_opacity":null, "watermark_displaytime":null, "watermark_hide":null, "watermark_link":null, "watermark_bottom":null, "watermark_right":null, "watermark_top":null, "watermark_left":null, "webtrekk_account":null, "ama_configuration":null, "comscore_account" : { "id":"1", "titolo":"Comscore title", "clientid":"14267511", "predefinito":"1", "descrizione":null, "data_inserimento":"2013-02-06 17:11:03" }, "nielsen_account" : null }
Note The updated object will be returned as a response
Note The PUT method is not supported by all systems. In case of problems, add the parameter to the Header of the callX-HTTP-Method-Override: PUT
ed utilizzare il metodo POST
come default