How to Add a Supported Macro to your Standard Player Tag Embed Code

 

To add a supported Macro to your standard player tag embed code, perform the following steps:

  1. Obtain one of your Player Tags from the portal. For further details, please see How to Copy your Player Tag Embed Code.

  2. Go to your preferred text editor, and paste your Player Tag into it.

    Your player tag should resemble the following example:
    <!-- TAG START { player: "Player Events", owner: "Support", for: "Support" } -->
    <div id="56e547dbe4b09eb92cf71b7d" class="vdb_player vdb_56e547dbe4b09eb92cf71b7d56d5921ce4b0f5991ad44713">
    <script type="text/javascript" src="//delivery.vidible.tv/jsonp/pid=56e547dbe4b09eb92cf71b7d/vid=56f17cc8e4b05b1a3f583e69/56d5921ce4b0f5991ad44713.js"></script>
    </div>
    <!-- TAG END { date: 04/10/16 } -->



  3. Check if your player tag has any existing macros by locating the "vdb_params" declaration within your player tag. 

    Note: An exitsitng "vdb_params" decleration means that your player Tag already has at least one specified macro.


    The following table describes how to proceed in each case:


    My Player Tag Has a "vdb_params" decleration

    Add the following text to these two places in your Player Tag:

    1. At the end of the first <div> tag, within the existing 'vdb_params' declaration, right after the existing macro within the existing double quote (") symbols.
    2. At the end of the <script> tag, within the query string, right after the existing macro, within the existing double quote (") symbols. 
      &m.MACRO_NAME=MACRO_VALUE


    Your Player Tag should resemble the following:

    Note: An existing macro parameter and value are highlighted in blue, while the new parameter and value are highlighted in red.

    Important! Macro parameters and values are passed in two places within your Player Tag, first on the <div> level, and second to the server by adding it to the <script> tag query string.

    <!-- TAG START { player: "Player Events", owner: "Support", for: "Support" } -->
    <div id="56e547dbe4b09eb92cf71b7d" class="vdb_player vdb_56e547dbe4b09eb92cf71b7d56d5921ce4b0f5991ad44713" vdb_params="m.parameterX=valueY&m.MACRO_NAME=MACRO_VALUE">
    <script type="text/javascript" src="//delivery.vidible.tv/jsonp/pid=56e547dbe4b09eb92cf71b7d/vid=56f17cc8e4b05b1a3f583e69/56d5921ce4b0f5991ad44713.js?m.parameterrX=valueY&m.MACRO_NAME=MACRO_VALUE"></script>
    </div>
    <!-- TAG END { date: 04/10/16 } -->


     

    My Player Tag Does not have a "vdb_params" decleration

     

    1. Add the following text at the end of the first <div>, right before the closing angled bracket (>):
      vdb_params="m.MACRO_NAME=MACRO_VALUE"
    2. Add the following text at the end of the <script> tag, right before the closing double quote (") and closing bracket (>) symbols:
      ?m.MACRO_NAME=MACRO_VALUE 
      Note: Verify that you have added the question mark (?) symbol prefix.


    Your Player Tag should resemble the following:

    Note: The macro declaration including the macro parameter and value are highlighted in red.
    Note: The macros are declared both on the <div> and the <script> levels.

    Important! Macro parameters and values are passed in two places within your Player Tag, first on the <div> level, and second to the server by adding it to the <script> tag query string.

    <!-- TAG START { player: "Player Events", owner: "Support", for: "Support" } -->
    <div id="56e547dbe4b09eb92cf71b7d" class="vdb_player vdb_56e547dbe4b09eb92cf71b7d56d5921ce4b0f5991ad44713" vdb_params="m.MACRO_NAME=MACRO_VALUE">
    <script type="text/javascript" src="//delivery.vidible.tv/jsonp/pid=56e547dbe4b09eb92cf71b7d/vid=56f17cc8e4b05b1a3f583e69/56d5921ce4b0f5991ad44713.js?m.MACRO_NAME=MACRO_VALUE"></script>
    </div>
    <!-- TAG END { date: 04/10/16 } -->

     

  4. Replace both the 'MACRO_NAME' and 'MACRO_VALUE' placeholders with the required macro parameter and value by referring to the Supported Macros List.

  5. Copy your complete Player Tag from your text editor and embed it in your web site.

    In this summary example we have set a 'Responsive' macro parameter with a value of '1' meaning that responsive sizing is activated:

    <!--TAG START { player: "Player Events", owner: "Support", for: "Support" } -->
    <div id="56e547dbe4b09eb92cf71b7d" class="vdb_player vdb_56e547dbe4b09eb92cf71b7d56d5921ce4b0f5991ad44713" vdb_params="m.responsive=1">
    <script type="text/javascript" src="//delivery.vidible.tv/jsonp/pid=56e547dbe4b09eb92cf71b7d/vid=56f17cc8e4b05b1a3f583e69/56d5921ce4b0f5991ad44713.js?m.responsive=1"></script>
    </div>
    <!-- TAG END { date: 04/10/16 } -->


Have more questions? Submit a request