Dynamic Ads for Display
Ad specifications for Dynamic Ads for Display
Feed items
Notes of using symbols1. Data feed (item list)
| Feed items *Do not delete the items if uploading with no values. *Sorting the feed item is acceptable. Use names as listed below. | ||||||
| No. | Header name | Item name | Setting | Display | Description | Example |
| 1 | Item ID | Item ID | Required | - | -Unique ID for items. -Up to 50 in half-width alphanumeric characters, underscore, and hyphen. *Set the same Item ID with Site retargeting item_id. ・Learn more on Site retargeting on Dynamic Ads for Display. | P001 |
| 2 | Item Name | Product item name | Required | Displayed | -Product item name displayed on your ads.
| Autumn trip to xx for 2 nights. |
| 3 | Description | Item description | Required | Displayed | -Product item description displayed in your ads. -Up to 5,000 characters (except forbidden characters). Line breaks and HTML are not allowed. -Our system registers the first 200 characters. | ○○ホテル デラックス (xx Hotel, luxury) |
| 4 | Tracking URL | Tracking URL | Optional | - | -URL of the landing page with ad click.
| http://keisokuvendor. com?device={device} |
| 5 | Landing Page URL | Landing page URL | Required | - | -URL of the final landing page after the ad click.
| http://www.example. com |
| 6 | Smartphone Landing Page URL | Smartphone landing Page URL | Optional | - | - URL of the final landing page for smartphone with ad click
| http://www.example. sp.com |
| 7 | Image URL | Item image URL | Optional | Image specified by URL | - Up to 1,024 characters, single-byte alphanumeric characters -You need to upload images to your website in advance. Image format: JPEG, GIF, PNG (animation not allowed) Recommended image size: 300×300 pixels Image file size: up to 2 MB - Automatically compresses the file with 150 KB or more. Example: shrinks width to 600 pixels, deletes exif data - Returns an error if not compressed 150 KB or less. - Other: transparent images not allowed | http://travel.yahoo.co.jp /dhotel/xxxx001/aaａ.jpg |
| 8 | Category ID | Category ID | Optional | - | -Category ID of the product (set same Category ID with site retargeting tag). -Up to 50 in half-width alphanumeric characters, underscore, and hyphen. | A123456B |
| 9 | Availability | Stock status | Optional | Displayed depending on the condition | - Stock status IN_STOCK: available OUT_OF_STOCK: unavailable PREORDER: reserved *If not entered, regard as IN_STOCK *If OUT_OF_STOCK, no ad delivered *If PREORDER is specified, shipping date can be specified based on “Availability Date” | IN_STOCK |
| 10 | Capacity | Capacity | Optional | - | -Number of products in stock. *Up to 10 digits. | 100 |
| 11 | Price | Price | Optional | Displayed | - Single-byte value only, 10 digits - Numbers only. Do not include letters such as “￥” and “,”. - Automatically puts “,” in the price.
| 100000 |
| 12 | Sale Price | Sale price | Optional | Displayed | - Single-byte value only, 10 digits • Numbers only. Do not include letters such as “￥” and “,”. - Automatically puts “,” in the price.
| 90000 |
| 13 | Formatted Price | Price with a specific format | Optional | Displayed | -When using a specific sale price format, enter up to 50 characters (except forbidden characters). -This value appears in your ad. | 10万円 (100 thousand JPY) ￥10万 (￥ 100 thousand) 10万〜20万円 (100-200 thousand JPY) |
| 14 | Formatted Sale Price | Sale price with a specific format | Optional | Displayed | -When using a specific sale price format, enter up to 50 characters (except forbidden characters). -This value appears in your ad. | 5万円 (50 thousand JPY) |
| 15 | Rating | Rating by users | Optional | Displayed | -Enter the rating from 1-5. Available to the first decimal point. -The stars (★) stand for points entered. | Example setting - display 2 → ★★☆☆☆ 4.2 → ★★★★☆ |
| 16 | Reviews | Number of reviews | Optional | Displayed | -Enter the number of reviews in numbers. Up to 4 digits. -The ads show the number and "件" ("cases" in Japanese). *To use this item, enter "Rating." | Example setting - display 13 - (13 reviews) |
| 17 | Badge | Badge type | Optional | Displayed | -Add an icon to your ad. Select one of the following icons. NEW_EN (appears as: NEW) NEW_JA (appears as: 新着) UPDATE_JA (appears as: 更新) RECOMMEND_JA (appears as: おすすめ) HOT_JA (appears as: 新着) BEST_JA (appears as: 売れ筋) FREESHIPPING_JA (appears as: 送料無料) SAMEDAYSHIPPING_JA (appears as: 即日発送) | NEW_EN |
| 18 | Display Settings | Display Settings | Optional | - | -Use this item to control ad delivery by each product. -Enter 0 for "Off" and 1 for "On." *Ads won't be delivered if "0" is entered. Taken as "On" when this column is empty. | 1 |
| 19 | Availability Date | The date you will have stocks | Optional | Displayed | -When you enter PREORDER for Availability, you can enter the date when your product becomes available. -Enter numbers in the "YYYY-MM-DD" format. | YYYY-MM-DD |
| 20 | GTIN | Global trade item number | Optional | - | - Enter JAN code as product identification number - Up to 50 half-width characters | 0001234560012 |
| 21 | MPN | Manufacturer part number | Optional | - | - Enter unique manufactured number for each product - Up to 70 half-width characters | YJ4060882 |
| 22 | Brand | Brand name | Optional | - | - Describe a brand name of the product - Half or full-width, up to 70 characters | Brand A |
| 23 | Product Type | Product category | Optional | - | - Specify a product category using characters - Divide categories with “>” (>) - When specifying multiple categories, divide with “,” - Half or full-width, up to 500 characters | 家電>掃除機 |
| 24 | Google Product Category | Categories on Google | Optional | - | - Product category by Google rule - Select a most relevant category if multiple categories exist for a product - Enter a category id or category path with half-width numbers | 2234 Apparel & Accessories > Clothing > Dresses [ファッション・アクセ |
| 25 | Age Group | Age | Optional | - | -Select the applicable ages for your ad from the following groups. -This doesn't target the audience. Use age targeting to specify the audience. NEWBORN: from 0 to 3 months old INFANT: from 3 to 12 months old TODDLER: from 1 to 5 years old KIDS: from 5 to 13 years old ADULT: usually over 13 years old. | ADULT |
| 26 | Gender Group | Gender | Optional | - | -Select the applicable gender for your ad from the following list. -This doesn't target the audience. Use gender targeting to specify the audience. MALE FEMALE UNISEX | MALE |
| 27 | Location | Locations | Optional | - | -Enter the applicable location code for your ad in numbers. *The only available values are in the "tiiki-code" row of the location code that is provided by the Ministry of Internal Affairs and Communications. Available only in Japanese. | 1000 |
| 28 | Sales Rank | Sales Ranks | Optional | - | -Enter the sales rank from 1 to 10 in numbers. | 1 |
| 29 | Delete | Delete | Optional | - | -Used when deleting item with partial updates. -Enter "1" with single-byte numeric characters to delete the item information on partial updates. *This item can be omitted from the Item list. This is not included in the template downloaded from the "Item Lists" screen. You will need to add the item when necessary. This can't be used with All updates. This will cause an error when "Delete" is in the item at All updates. | 1 |
| Note | *Do not include same Item ID in the same feed. If the same ID exists, which one of the setting is displayed can’t be guaranteed. *Notes on Sale Price and Price display. *When changing (updating) the item list the timing to take effect varies between items. When changing multiple items the former item and the changed item may be displayed in one ad. "Display setting" and "Stock information" are changed with priority. | |||||
| Notes of using symbols | ||
| ■Available symbols only for feed | ■ □ ◆ ◇ ● ○ ▲ △ ▼ _ ‥ ─ 〇 〓 〔 〕 ヽ ヾ ▽ ★ ☆ ◎ 〈〉 《》 ― ｜ | |
| ■Symbols converted on the system | Before | After |
| & | ＆ | |
| " | ” | |
| ' | ’ | |
| < | ＜ | |
| > | ＞ | |
| ￥ | ||
| = | ＝ | |
| # | ＃ | |
| $ | ＄ | |
| % | ％ | |
| * | ＊ | |
| @ | ＠ | |
| [ | ［ | |
| ] | ］ | |
| / | ／ | |
| 〜 | ～ | |
| − | ― | |
| ‖ | ∥ | |
2. Ad insertion rules
| Required | Details | |||
| No | Title | Item information is used. | ||
No | Description | Item information is used. | ||
| Required | Description URL | Number of characters | Up to 1,024 | |
| Supported characters | Single-byte alphanumeric characters (RFC3986) | |||
| Note | URL start with "." is not available. URL not based on RFC3986, such as Japanese characters in URL, is not available. | |||
| Required | Display URL | Number of characters | Enter URL that will be displayed as ad. Enter within 29 single-byte characters, not including http:// and https://. Example | |
| Supported characters | Single byte alphanumeric characters (RFC3986) | |||
| Domain extensions | Must contain a domain extension, e.g., www.yahoo.co.jp | |||
| Note | URLs beginning with a “.” (dot) cannot be used. You cannot register URLs deviating to RFC3986, such as URLs including Japanese characters. | |||
| Required | Button | Pull-down selection | Select one from the pull-down menu on the UI. | |
| Required | Advertiser indication | Number of characters | Up to 20 | |
| Supported character types, space type and Symbol types | See following items Supported character types, space type and Symbol types (for Advertiser indication, Prefix and Suffix) | |||
| Required | Logo image | *Create images with all three sizes. | Pixel size (width x length) | 400 x 200 pixels 600 x 80 pixels 600 x 600 pixels |
| File size | Up to 3 MB per file * When the file size is more than 150 KB, it will be automatically compressed when uploading. If the file size doesn't become 150 KB or less by this compression, you will get an error and not able to upload. | |||
| File type | JPEG (RGB only): extension ".jpg" or ".jpeg" GIF89a: extension ".gif" PNG: extension is ".png" | |||
| Transparency | No | |||
| Alternative text (ALT attribute) | No | |||
| Border-image | No | |||
| Animated GIF | No | |||
| Optional | Campaign banner | * To display campaign banner, you need to add one or more sizes of banner | Pixel size (width x length) | 600pixel ×500pixel 600pixel ×80pixel 600pixel ×600pixel 600pixel ×1200pixel |
| File size | Up to 3 MB per file * When the file size is more than 150 KB, it will be automatically compressed when uploading. If the file size doesn't become 150 KB or less by this compression, you will get an error and not able to upload. | |||
| File type | JPEG (RGB only): extension".jpg" or ".jpeg" GIF89a: extension ".gif" PNG: extension is “.png” | |||
| Transparency | No | |||
| Alternative text (ALT attribute) | No | |||
| Border-image | No | |||
| Animated GIF | No | |||
| Optional* | Prefix | Word or sign which is placed in front of price value. Example: ￥、＄ | *When you have entered ‘Price’ or ‘Sale price’ on your Item List file, you need to set this item or ‘Suffix of price’. Supported character types, space type and Symbol types (for Advertiser indication, Prefix and Suffix) | |
| Suffix | Word or sign which is placed after price value. Example: | |||
Supported character types, space type and Symbol types
(for Advertiser indication, Prefix and Suffix)
Supported Character Types
| Hiragana | Double byte |
| Katakana | Double byte |
| Alphanumeric | Double byte/Single byte |
Supported Space Type
| Space | Single byte |
Supported Symbol Types
| Types | Symbols |
| Parentheses | （ ） ［ ］ 「」 『』 ｛ ｝ ＜＞ ≪≫ 《 》 【】 (Double byte) ( ) [ ] (Single byte) |
Quotation mark | ‘ ’ ｀ ´（Double byte） “ ” （Double byte）“ '（Single byte） |
Punctuation mark | 。 、（Double byte） |
Middle dot | ・ （Double byte） |
| Comma | ， （Double byte） , （Single byte） |
Dot | ． （Double byte） . （Single byte） |
Underbar | ＿ （Double byte） |
Wave dash | 〜（Wave dash, Double byte）*Unicode: U+301C ～（Tilde, Double byte）*Unicode: U+FF5E *When you enter a "wave dash" ～ (UnicodeU+301C), the system converts it to "full-width tilde" ～ (Unicode U+FF5E). |
| Percent | ％ （Double byte） %（Single byte） |
Ampersand | ＆ （Double byte） &（Single byte） |
Colon/semicolon | ： ； （Double byte） : ; （Single byte） |
Three dot leader | … （Double byte） |
| Hyphen | － （Double byte）-（Single byte） |
| Operator | ＋ － ± × ÷ ＝ ≠ ∞ （Double byte） - +（Single byte） |
| Slash | ／ ＼ （Double byte） /（Single byte） |
Question/exclamation mark | ？ ！ （Double byte） ? ! （Single byte） |
| Arrows | ⇒ ⇔ → ← ↑ ↓ （Double byte） |
| Other | ￥ ＄ ＊ ＃ ♪ ＠ 〃 〆 ※ 〒 ♯（Double byte） @ # $（Single byte） |
Greek /Cyrillic characters | ΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩ （Double byte） αβγδεζηθικλμνξοπρστυφχψω （Double byte） АБВГДЕЁЖЗИЙКЛМНОПРСТУФХЦЧШЩЪЫЬЭЮЯ （Double byte） абвгдеёжзийклмнопрстуфхцчшщъыьэюя （Double byte） |
| Yahoo! JAPAN Advertisement Editorial Guidelines is applied on Dynamic Ads for Display. Please comply following rules for each item of entity. *The English version of these Guidelines is merely a translation of the Japanese original prepared for your reference. | |
| Advertiser indication | Must be expressed with company name, registered product name, brand name, or service name. Must be related to the product or service on the feed. |
| Logo | Please comply following pixel sizes. <600 x 600 pixels> |
| Button | Must be appropriate to the content feed |
| Prefix, Suffix | Must be a word or currency symbol such as "￥, tax included, thousand yen, ～" to complement the price |
| Formatted Price, Formatted Sale Price | It must be a combination of a notation such as "1,000円、￥1,000" (1,000 JPY) or a phrase that supplements the monetary notation such as "セール価格1,000円～、往復1万円" (Sale price 1,000 yen -, 10,000 yen round trip). |