Cruise ads' dynamic data feeds
Cruise ads' dynamic data feeds
Get details about required, recommended, and optional Cruise ads feed attributes.A dynamic feed file is a spreadsheet that contains attributes. This file tells Microsoft Advertising the information you want inserted in your ads and under which condition each attribute should be inserted. Some attributes will be featured in the ad itself.
Upload a feed file-
From the top menu, select Tools > Business data > Dynamic data feeds.
If you're using the new Microsoft Advertising navigation, from the navigation menu on the left, select Tools > Business data > Dynamic data feeds.
- Select Upload > Cruises.
- Enter the Name and select the feed file to upload.
- You can Upload and preview to view your changes or Upload and apply to create your feed.
-
From the top menu, select Tools > Business data > Dynamic data feeds.
If you're using the new Microsoft Advertising navigation, from the navigation menu on the left, select Tools > Business data > Dynamic data feeds.
- Select the feed file you want to create a schedule for.
- Select the Schedules tab.
- Select Schedule feed uploads and enter the scheduling information and URL for your feed.
- Select Save.
Dynamic feed file attributes
Your dynamic feed file is a spreadsheet comprised of attributes, which we use to generate your ads. Below is a list of required, recommended, and optional attributes for Cruise ads' feed files.
Your feed file should be tab-delimited plain text saved as any of the following file types: CSV, TSV, XLSX, or ZIP. We recommend you use UTF-8 encoding.
Required attributes
Your dynamic data feed file must include the following attributes:
| Attribute | Description | Example |
|---|---|---|
| Cruise brand |
The brand that operates the cruise. This will not be shown in the ad. |
Contoso cruises |
| Cruise region |
The region the cruise travels to. This will not be shown in the ad. |
Caribbean |
| Departure port city | The city the cruise departs from. | Fort Lauderdale |
| Destination port city | The cruise's destination port city. | Barbados |
| Final URL |
The same domain as your website. Must begin with http:// or https://. This will not be shown in the ad. |
http://www.cruiseexample.com/caribbeanluxury/id |
| ID |
Unique ID of the item comprised of any sequence of letters and digits. This will not be shown in the ad. |
AB1234 |
| Image URLs |
The URLs for the image used in your ad, which must not be redirected. URLs cannot exceed 2,048 characters and must begin with http:// or https://. Any commas must be encoded. If you are listing multiple Image URLs, use a semicolon (;) as delimiter. We support PNG, BMP, GIF, JPEG, ICO, and MS-DDS, all of which must be saved in RGB color code with an ICC profile. The recommended aspect ratios are: 4:3, 1.5:1, or 16:9. The recommended resolution is: minimum 640x360 pixels and maximum 1920x1080 pixels. Images shouldn't be blurry or contain people, borders, animation, watermarks, or promotional text. Placeholder images will be disapproved. |
http://www.contoso.com/image1.png |
| Itinerary days |
The number of days included in the cruise offering. Either "Nights onboard" or "Itinerary days" is required. If both are provided, "Nights onboard" will be selected. |
9 |
| Nights onboard |
The number of nights included in the cruise offering. Either "Nights onboard" or "Itinerary days" is required. If both are provided, "Nights onboard" will be selected. |
8 |
| Starting price | Starting price for the item. Numeric value followed by currency code (ISO 4217 standard). Use "." as the decimal mark regardless of the local currency. | 900 USD |
| Target ad group |
The name of the targeted Cruise ad group. If you don't specify a target ad group, we will apply this feed to all ad groups in your targeted campaign. See Target campaign above. This will not be shown in the ad. |
Cruises-Ads-placement_AdGroup1 |
| Target campaign |
The name of the targeted Cruise ads campaign. In addition to targeting a campaign, you can also target a specific ad group within the campaign. See Target ad group below. This will not be shown in the ad. |
EMBD_Cruises_ |
| Title | The title of the cruise offering. | 9 Day Southern Caribbean Cruise |
Recommended attributes
Your dynamic data feed file may include any of the following attributes, which we highly recommend:
| Attribute | Description | Example |
|---|---|---|
| Inclusions | A list of amenities, separated by ";". | Drinks included; Free Wi-Fi; Flight packages available |
| Itinerary URL | The URL of the cruise itinerary. Begin with http:// or https://. | http://cruiseexample.com/caribbeanluxury/itinerary |
| Ports |
A list of ports the cruise stops in, separated by ";". This will not be shown in the ad. |
Saint Lucia; Saint Maarten; Saint Kitts |
| Ratings | The rating for the item on a scale of 0-5. | 4.5 |
| Reviews | The number of reviews for the item in numerical value. | 2370 |
| Reviews URL | The URL for the cruise's ratings. | http://www.examplecruise.com/caribbeanluxury/ratings |
Optional attributes
Your dynamic data feed file may include any of the following optional attributes:
| Attribute | Description | Example |
|---|---|---|
| Book now URL |
The booking landing page. This will not be shown in the ad. |
http://cruiseexample.com/caribbeanluxury/booknow |
| Cancellation policy text |
The cancellation policy for the cruise booking. This will not be shown in the ad. |
Free cancellation until 7 days before departure |
| Contextual keywords |
Specific cruise details used to power relevancy matching, separated by ";". If provided, the information in this column will help the Microsoft AI create more relevant ads for your campaign. This will not be shown in the ad. |
FL cruises; Caribbean cruises |
| Cruise name |
The name of the cruise. This will not be shown in the ad. |
Southern Caribbean Getaway |
| Custom parameter |
Include up to three key and value pairs, which automatically fill up in the click URL. List the key and value pairs within braces. Each term should be set in quotation marks. Separate each phrase of the pair with a colon and separate key and value pairs with commas and without any spaces. The maximum limit is 16 characters or 200 bytes. This will not be shown in the ad. |
{"region" : "caribbean", "destination port" : "ft lauderdale"} |
| Departure date | The date that the cruise begins from its departure port in yyyy/mm/dd format.
This will not be shown in the ad. |
2022/07/30 |
| Departure port country |
The country/region that the cruise departs from (ISO 3166-1 standards or full country name). This will not be shown in the ad. |
US |
| Departure port state |
The state or province the cruise departs from. This will not be shown in the ad. |
Florida |
| Description |
A short description of the cruise offering. This will not be shown in the ad. |
9-day cruise looping around the gorgeous Southern Caribbean islands, where you can explore relaxing beaches while having the comfort of a luxurious cruise to return to. |
| Excursions |
A list of excursions for the cruise offering, separated by ";". This will not be shown in the ad. |
Authentic tastes of the Caribbean; Scuba diving |
| Final mobile URL |
The item's mobile-optimized landing page when you have a different URL for mobile and computer traffic. This will not be shown in the ad. |
http://www.m.contoso.com/asp/sp.asp?id=abc123 |
| Free cancellation |
Whether free cancellation is allowed. True or False is supported. This will not be shown in the ad. |
TRUE |
| Number of countries |
The number of countries the cruise travels through. This will not be shown in the ad. |
5 |
| Promotions |
Any offered promotions can be listed here. This will not be shown in the ad. |
Summer special 20% off |
| Safety procedure |
Use this to mark whether cruise has COVID and/or other safety precautions and requirements. True or False is supported. This will not be shown in the ad. |
TRUE |
| Safety procedure URL |
The URL of the page where your cruise's COVID safety procedures are outlined. This will not be shown in the ad. |
http://cruiseexample.com/safetyprocedures |
| Ship name |
The name of the cruise ship. This will not be shown in the ad. |
Celebrity Reflection |
| Tracking template |
Include any tracking parameters, custom parameters, or tracking redirects for your item URL. This will not be shown in the ad. |
http://www.trackingtool.com/?source=Microsoft&pcategory={_pcategory}&city={_city} |
| Video URLs |
The URL for the video used in your ad. Must begin with http:// or https://. We support MPG, MP4, AVI, etc. |
http://www.contoso.com/video1.mpg |
| Wheelchair accessible |
Whether the cruise is wheelchair accessible. True or False is supported. This will not be shown in the ad. |
TRUE |