New Features (Beta)

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

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.

RefreshAds

refreshAds allows for placehodlers to be refreshed without needing to call destroyPlaceholders and showAds. This is useful for sites with dynamic content or infinite scroll where the content changes but the placeholders remain the same.

Multiple placeholders can be passed in as an array of IDs.

Example

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