New Features (Beta)

Overview

These are new features that are available to be implemented but are still in Beta and may change before being fully released.

ShowAds Advanced Usage

The advanced implementation provides additional functionality by accepting an array of objects. Each object can include the following attributes:

  • id (required): The unique identifier of the placeholder where the ad should be shown.
  • required (optional, boolean): A flag indicating whether the ad must be displayed. If set to `true`, the system will force an ad to be shown in the specified placeholder, even if it would not normally be displayed.
  • sizes (optional, string or array of strings): Specifies the allowed sizes for the ad in the format `'{width}x{height}'`. You can provide a single size as a string or multiple sizes as an array of strings. This allows you to control the dimensions of the ad that will be displayed.

Example Implementation

1<script>
2var placeholders = [
3    { id: 103, required: true, sizes: ['336x280', '126x126'] },
4    { id: 104, sizes: '1000x450' },  
5    { id: 105, required: true },
6];
7
8ezstandalone.showAds(placeholders);
9</script>

In this example:

  1. Placeholder 103:

    • An ad will always be displayed in placeholder `103`.
    • The allowed sizes for the ad are `336x280` and `126x126`.

  2. Placeholder 104:

    • An ad will be displayed in placeholder `104` if Ezoic decides this ad should be shown.
    • The allowed size for the ad is `1000x450`.

  3. Placeholder 105:

    • An ad will always be displayed in placeholder `105`.
    • No specific sizes are provided, so Ezoic will decide the best size for this placeholder.

Notes

  • Specificity of Ad Sizes: The ad sizes specified in the `sizes` attribute are treated as specific requests. Ezoic will attempt to find the best possible ad that fits the given size. If an exact match is not available, the system will choose the closest available size that can best fit within the specified dimensions.
  • If the `required` attribute is set to `true`, Ezoic will prioritize showing the ad in that placeholder, ensuring it is displayed even if other conditions might normally prevent it.
  • If `sizes` are specified, the ad will only be displayed if an ad of the specified sizes is available. If the `sizes` attribute is omitted or left empty, Ezoic will use its default behavior to determine the ad size.

Use Cases

  • Guaranteed Ad Placement: Use the `required` attribute to ensure that ads are shown in critical placeholders, regardless of other conditions.
  • Size-Specific Ads: Use the `sizes` attribute to control the dimensions of the ads being displayed. This is particularly useful for responsive designs or specific layout requirements where certain sizes are more effective.

This advanced method offers flexibility and control over ad placement, making it suitable for scenarios where more than just the placeholder ID is needed to dictate ad behavior.

RefreshAds

refreshAds is a new function in ezstandalone that allows for refreshing the ad for specific placeholders. This can be used if you would specifically like to refresh an ad for a viewer at a specific time. Below is an example of the function being used.

Current:

1<script>
2    ezstandalone.cmd.push(function() {
3        ezstandalone.refreshAds(101, 102)
4    });
5</script>