Yahoo developer network
Native
Yahoo developer network logo
  • Open Source
  • APIs
  • Advertising
  • Blog
  • Events
  • Podcasts
  • Apps
  • Native
  • Documentation

    • Yahoo Native to Yahoo DSP API Migration Guide
      • Understanding Domain Models
      • Migration scenarios
      • Campaign package structure
      • Understanding DSP packages
      • Seat types
      • Authorization
      • Advertiser
      • Campaigns
      • Lines
      • Blocked cases
      • Pixels
      • Reporting
      • Targeting
      • Postman toolkit
      • Appendix
      • Sample code
        • Create DSP shell
        • Create DSP creative
        • Flatten & Filter Targeting attributes
    • What’s New
    • Latest Updates
    • Get Started - API Endpoints
    • Navigating the API
      • Authentication
      • Testing - Sandbox
      • Versioning
      • API v1 Deprecation & v2 Changes
      • FAQs
    • Objects
      • Advertisers
      • Campaigns
      • Ad Group
      • Ad
      • Keyword
      • Targeting Attribute
      • Ad Extensions
      • Shared Sitelink
      • Shared Sitelink Setting
      • Ad Site Setting
    • Matrix View of Ad Types
    • Postman API Toolkit
    • Upgraded URLs
      • Migration path
    • Yahoo Native Ads
      • Native Ad Matrix View
      • Moments Ads
      • Search Ads
      • Image Ads
      • Mail Ads
      • Carousel Ads
      • Tiles Ads
      • Native Video Ads
      • App Install Ads
    • Frequency Cap
    • Reach and Performance
    • Dynamic Product Ads
    • Enhanced Attribution
    • Account Change History
    • Bulk Operations
      • Bulk File Schema & Fields
      • Bulk Upload API
      • Bulk Download API
      • Best Practices
    • Shared Set Libraries
      • Create shared sets
      • Populate shared sets
      • Associate shared sets
    • Audience Management
      • Audiences from websites
      • Audiences from customer lists
      • Audiences from your app
      • Audiences from email lists
      • Lookalike audiences
      • Conversion rule audiences
      • Dot tags
      • Conversion rules
      • Utilize Dot tags & conversion rules
      • Custom audience strategies
    • Reporting
      • Cubes
      • Dimensions
      • FAQs
    • Reseller Management API
    • Resources
      • Dynamic Parameters
      • Data Dictionary
      • Best Practices
      • Error Codes and Responses
      • Release Notes - Archived
    • Glossary
      • Glossary of Yahoo Native Terms
    • Partner Support
      • Product bulletin 2023 February
      • Product bulletin 2023 January
      • Product bulletin 2022 December
      • Product bulletin 2022 November
      • Product bulletin 2022 October
      • Product bulletin 2022 September
    • Policies
    • Advertiser Guide - UI
    • Technical Notes
      • Search on native
      • Create, serve & filter shared sitelinks
    • Server-to-Server Specifications
      • App Install Spec
      • In-app Events Spec
      • Post-install Spec
  • Sign In
  • Language:
    • English (U.S.)
    • 中文(香港)
    • 中文(台灣)

Carousel Ads¶

The Yahoo Native Carousel offers advertisers the ability to tell a visual story by grouping up to five cards (images and captions) in a single execution. Each image that users swipe though can link to a unique landing page to drive deeper user engagement.

Carousel Ads can drive 2X to 3X higher CTR compared to single image ads.

Example¶

Your browser does not support HTML5 video.

How-To¶

Follow these steps to create Carousel Ads:

  1. Create a Campaign with the objective set to VISIT_WEB or PROMOTE_BRAND.

  2. Create an Ad Group with a CPC or CPM bid for Native.

  3. Create an Ad object with an Assets array: - In your asset array ensure the type is set to MULTI_IMAGE. - Include your basic and HQ image in ImageURL and ImageUrlHQ. - Set the order of your images in the Index parameter.

Note

You are required to have a minimum of 3 cards per asset that can only be JPG or PNG formats with a maximum file size of 2MB.

  1. Set all levels to Active. If the ad passes approval, it will be eligible to serve within 24-48 hours.

Important: New Restrictions for Square Image (imageLargeUrl)¶

When creating your ad, you will need to include an imageUrl and imageUrlHQ. Note that the imageLargeUrl must have a 1:1 aspect ratio. A square image (imageLargeUrl) is mandatory. If you upload an 800x1000 image, for example, the asset will be cropped to 800x800 pixels. Also ensure a 1:1 aspect ratio and exact size of 627x627 for a square asset for single image ads.

This applies to the API and to BULK. Ensure that you follow these requirements when creating single image and carousel ads. Use a 1:1 aspect ratio and an exact size of 627x627 for a square asset for carousel ads.

The image requirements for various assets is shown in the table below:

Asset

Native UI

Native API

Aspect ratio enforced?

Rectangle image - 1200x627px

Required

Required

Yes - 1.9.1

Square image - 627x627px

Required

Required

Yes - 1:1

Thumbnail - 180x180px

Optional

Optional

No - 1:1

Account logo - Height: 180px min, Width: 180px - 2560px

Optional

Optional

No - 10.1 maximum

Account icon - Height: 180px min, Width: 180px - 2560px

Optional

Optional

No - 1:1

For Portrait Moments native ads, we recommend using 720p to 1080p high resolution images. The dimensions for this vertical image is 1080px by 1920px (9:16 aspect ratio). The min dimension should be 720px by 1280px

For Panorama Moments native ads, the image must be 2276px by 1280px or wider (max of 6826px by 1280px) high resolution image. The mage aspect ratio must be between 16:9 and 48:9.

Required Fields¶

The following table defines the fields required when serving a Carousel Ad type:

Ad Type

Campaign-Channel

Campaign-Objective

Campaign-defaultLandingUrl

Bid types

Ad-imageUrl

Ad-imageUrlHQ

Ad-videoPrimaryUrl

Assets

Ad-mailAssetUrl

Ad-imageUrlThumbnail

Native Carousel Ad

Native

VISIT_WEB, PROMOTE_BRAND

CPC, CPM

required

required

required

Learn More¶

For more detailed information on Carousel Ad specifications, deliverables and guidelines, refer to Native Carousel.

For more information on using Carousel Ads in the Native UI, refer to Use Carousel Ads To Deliver Impactful Storytelling Messages.

Support
Terms and Privacy Policy
Your Privacy Choices
About Us Jobs Developer Privacy Developer Terms Developer Policies Site Feedback
Brands Yahoo Developer Analytics Reporting Yahoo Edgecast Developer Ad Platform Help Center
Group 5 Group 7 Group 4 Group 3 Group 14
Yahoo Logo