Skip to main content
MediaBeacon University

Social Media Distribution and Analysis

MediaBeacon supports posting your assets directly to your social networks. Additionally it can be seen which assets are posted to social media and on which networks. Content can be analyzed with Mediabeacon Metrics.

(New in 8.4) Social media configutation and usage documentation.

Youtube

Configuration

The MediaBeacon YouTube plugin requires 4 properties to allow users to authenticate with YouTube.

  • redirect_uri
  • client_id
  • client_secret
  • apiKey
  1. Creating a Google Project
    1. Log in to your Google account.
    2. Open a web browser and go to https://console.developers.google.com.
    3. Click on Credentials, then Create a project.

      Youtube_Config_1.png

    4. Give your project a name, use the following options, then click create.

      Youtube_Config_2.png

    5. Click Create credentials and choose the OAuth client ID option.

      Youtube_Config_3.png

    6. Click Configure consent screen.

      Youtube_Config_4.png

    7. Add a ‘Product name shown to users’ and save.

      Youtube_Config_5.png

    8. Select ‘Web application’ give a name to the client and add the redirect URI <mburl>/wf/SocialMedia/YouTubeService?action=callback.
      1. Replace <mburl> with MediaBeacon’s url.
      2. This url needs to be publicly accessible.
      3. Copy this redirect URI to use as the redirect_uri workflow property.
      4. Click Create.

    Youtube_Config_6.png

    1. Copy the client ID and client secret, then click ok.

      Youtube_Config_7.png

    2. Next we need to create an API key, so click Create credentials and choose API key.

      Youtube_Config_8.png

    3. Copy the created API key, then click close.

      Youtube_Config_9.png

    4. Enable YouTube Data API by clicking Dashboard, then Enable API.

      YouTube_Dashboard_EnableAPI.png

    5. Choose YouTube Data API from the list of popular APIs.

      YouTube_Choose_API.png

    6. Click the Enable button.

      YouTube_DataAPI_Enable.png

  2. Adding the Properties to MediaBeacon.
    1. In MediaBeacon navigate to Manage, then Workflow.

      Youtube_Config_10.png

    2. Open Workflows > _internal > SocialMedia > YouTubeService.

      Social_Media_Workflows.png

    3. Copy the properties from above into their fields and click Save.

      YouTube_WF_Props.png

Usage

For an example of how to use the YouTube integration, in MediaBeacon, navigate to the default Omni Channel Marketing ACL and select the default Social Media workspace. Select a video to publish to YouTube, then click the “Publish to YouTube” button contained in the HTML widget.

Social_Media_Publish.png

This will launch your browser to sign in to YouTube. Once you sign in the browser will display that <Product name to display to users>, which in our example is MediaBeacon YouTube Plugin, would like to manage your YouTube account. Choose Allow.

YouTube_Allow_Manage.png

In MediaBeacon, fill out the YouTube Upload dialog that is displayed and click Upload Video. The fields will be what is shown on the video in YouTube.

YouTube_upload_dialog.png

Once an asset is published to YouTube, the asset will display a YouTube icon in the corner.

Social_Media_Published_Icons.png

(New in 8.4) Once an asset is published, information about it such as likes and views can be viewed in the Social Media M3TAForm.

Twitter

Configuration

The only configuration that must be done for the Twitter integration is to choose if everyone using your MediaBeacon should publish tweets to the same account. This choice is made in the following location.

  1. In MediaBeacon navigate to Manage, then Workflow.

    Youtube_Config_10.png

  2. Open Workflows > _internal > SocialMedia > TwitterService.

    Social_Media_Workflows.png

  3. If the value of the SingleUser property is set to true, then everyone using your MediaBeacon will publish tweets to the same account. If the value of the SingleUser property is false, each user may publish tweets to a separate account. This property can not be blank.

    Twitter_Properties.png

  4. If you would like to change which user is being used to tweet, first log out of Twitter. Then in Mediabeacon navigate to Manage then System Status.

    System_Status_header_option.png

    Click the API keys tab and remove the key named api.twitter.com. The next time you publish to Twitter, log in with the new account you would like to use.

    API_key_menu_remove.png

Usage

For an example of how to use the Twitter integration, in MediaBeacon, navigate to the default Omni Channel Marketing ACL and select the default Social Media workspace. Select an asset to publish to Twitter, then click the “Publish to Twitter” button contained in the HTML widget.

Social_Media_Publish.png

This will launch your browser that will prompt you to sign in with your Twitter account you would like to publish tweets to. Enter your account information and click Sign In. Next you will be asked if you would like to authorize MediaBeacon to use your account. Click Authorize app.

Twitter_Plugin_Authorize.png

In MediaBeacon, fill out the Tweet dialog that is displayed and click Tweet. The field will be what is shown on the tweet in Twitter.

Twitter_publish_dialog.png

Once an asset is published to Twitter, the asset will display a Twitter icon in the corner.

Social_Media_Published_Icons.png

(New in 8.4) Once an asset is published, information about it such as favorites and retweets can be viewed in the Social Media M3TAForm.

Instagram

Configuration

The MediaBeacon Instagram plugin requires three properties to allow users to authenticate with Instagram.

  • client_id
  • client_secret
  • redirect_uri
  1. Creating an Instagram Client.
    1. Navigate your browser to https://www.instagram.com/developer/
    2. Log in.
    3. Under Getting Started click Register.

      Instagram_Developer_Landing_Page.png

    4. Click Register a New Client.

      Instagram_Register_Client_Button.png

    5. Enter an Application Name and Valid redirect URI then click Register. Your URI should be: <mburl>/wf/SocialMedia/InstagramService?action=callback In my example I used http:www.testurl.com for <mburl>. Copy this URI and save it somewhere. We will use it later.

      Instagram_Register_New_Client_ID_Form.png

    6. Click Manage.

      Instagram_Register_Client_Success.png

    7. Copy the Client ID and the Client Secret. Save them somewhere so we can use them later.

      Instagram_Manage_Client.png

  2. Adding the Properties to MediaBeacon.
    1. In MediaBeacon, navigate to Manage > Workflow.

      Worfkflow_From_Top_Menu.png

    2. Open Workflows > _internal > SocialMedia > InstagramService
    3. Copy the properties from steps above into their respective fields and click Save.

      Instagram_Workflow_Properties.png

Usage

For an example of how to use the Instagram integration, in MediaBeacon, navigate to the default Omni Channel Marketing ACL and select the default Social Media workspace. Select an asset to link an Instagram post’s metadata to, then click the Link to Instagram button contained in the HTML widget. The asset will not be published to Instagram.

Social_Media_Publish.png

This will launch your browser which will prompt you to sign in with the Instagram account you would like to gather metadata from. Next you will be asked if you would like to authorize MediaBeacon to use your account. Click Authorize.

Instagram_Authorization.png

In MediaBeacon, click an Instagram post to link the selected asset in the Link to Instagram dialog that is displayed. You can hover over a possible link to see the post’s caption. Click the Link to Instagram button to finish.

Instagram_Link_Dialog.png

Once an asset is linked to an Instagram post the asset will display an Instagram icon in the corner. Additionally, information about the chosen Instagram post such as likes and comments can now be viewed in the Social Media M3TAForm. This M3TAForm also contains a link to the Instagram post.

Instagram_Icon_On_Asset.png

Facebook

Configuration

The MediaBeacon Facebook plugin requires three properties to allow users to authenticate with Facebook.

  • client_id
  • client_secret
  • redirect_uri
  1. Creating a Facebook App.
    1. Go to https://developers.facebook.com/apps
    2. Log in.
    3. Click Register Now.

      Facebook_Register_Now.png

    4. Select Technical and click Register.

      Facebook_Register_Technical_Or_Business.png

    5. Click Create App ID.

      Facebook_Create_App_ID_Button.png

    6. Fill in the Display Name and Contact email. These values will be visible to any user who signs into Facebook through MediaBeacon.

      Facebook_Create_App_ID_Dialog.png

    7. In the left column click Add Product then Get Started next to Facebook Login.
    8. On the left column select Facebook Login > Settings.
    9. Enable the following:
      1. Client OAuth Login.
      2. Web OAuth Login.
      3. Embedded Browser OAuth Login.
    10. Add <mburl>/wf/SocialMedia/FacebookService?action=callback to Valid OAuth Redirect URIs.
      1. Keep this value for later.

        Facebook_Login_Settings.png

    11. In the left column select Settings then Basic.
    12. At the bottom Click Add Platform then Website.
    13. Add your MediaBeacon URL under Site Url.
    14. Copy the App ID and the App Secret (click show).

      Facebook_Basic_Settings.png

  2. Adding the Properties to MediaBeacon
    1. In MediaBeacon navigate to Manage > Workflow

      Worfkflow_From_Top_Menu.png

    2. Open Workflow > _internal > SocialMedia > FacebookService
    3. Copy the properties from steps above into their respective fields. Use the App ID for client_id and App Secret for client_secret. Click Save.

      Facebook_Service_Workflow_Properties.png

Usage

For an example of how to use the Facebook integration, in MediaBeacon, navigate to the default Omni Channel Marketing ACL and select the default Social Media workspace. Select an asset to publish to Facebook, then click the “Publish to Facebook” button contained in the HTML widget.

Social_Media_Publish.png

This will launch your browser that will prompt you to sign in with your Facebook account you would like to publish to. Enter your account information and click Sign In. Next you will be asked if you would like to authorize MediaBeacon to use your account. Allow this.

In MediaBeacon, fill out the Facebook Post dialog’s Message field and click Post. The field will be what is shown on the post in Facebook.

Facebook_Post_Dialog.png

Once an asset is published to Facebook, the asset will display a Facebook icon in the corner and information about it such as likes and comments can be viewed in the Social Media M3TAForm.

  • Was this article helpful?