Merchandiser for iTunes - Apple
Merchandiser for iTunes - Apple
Merchandiser for iTunes - Apple
You also want an ePaper? Increase the reach of your titles
YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.
<strong>Merchandiser</strong> <strong>for</strong> <strong>iTunes</strong><br />
LinkShare, in partnership with <strong>Apple</strong> <strong>iTunes</strong>, has enhanced the data you receive in<br />
your <strong>iTunes</strong> <strong>Merchandiser</strong> File. Your <strong>iTunes</strong> file will have richer content data and<br />
include product in<strong>for</strong>mation <strong>for</strong> <strong>iTunes</strong> Videos and Applications.<br />
The tables that follow describe the new <strong>iTunes</strong> <strong>Merchandiser</strong> fields. The field<br />
contents differ <strong>for</strong> each of the four categories: Songs, Albums, Applications, and<br />
Videos. You’ll notice that several of the fields have multiple elements, which are<br />
delimited with double tildas (~~), the same way the Product Categories field is in a<br />
normal <strong>Merchandiser</strong> file.<br />
Note: the enhanced <strong>iTunes</strong> <strong>Merchandiser</strong> file is approximately twice the size of the<br />
old <strong>iTunes</strong> <strong>Merchandiser</strong> File. Please make sure you are able to download this larger<br />
file. It is possible to download <strong>Merchandiser</strong> files <strong>for</strong> individual product categories,<br />
such as <strong>for</strong> Songs and Videos. These individual category files are smaller in size.<br />
Copyright © 2010 LinkShare Corporation. Confidential in<strong>for</strong>mation.
<strong>iTunes</strong> Songs<br />
Name Definition<br />
Required/<br />
Optional<br />
<strong>iTunes</strong> Key<br />
1 Product ID Number Required song.song_id<br />
2 Product Name VarChar2(255) Required song.name<br />
3 SKU Number VarChar2(40) Required song.song_id<br />
4 Primary Category VarChar2(50) Required "music"<br />
5 Secondary Category(ies) VarChar2(2000) Optional<br />
genre_artist.genre_id<br />
genre.genre_name (delimited with double tildas ~~)<br />
6 Product URL VarChar2(2000) Required song.view_url<br />
7 Product Image URL VarChar2(2000) Required collection.artwork_url<br />
8 Buy URL VarChar2(2000) Optional N/A<br />
9<br />
Short Product<br />
Description<br />
VarChar2(500) Required<br />
artist.name (delimited with double tildas ~~)<br />
song.name<br />
artist.artist_id (delimited with double tildas ~~)<br />
artist_translation.translation<br />
10 Long Product Description VarChar2(2000) Optional<br />
song.name<br />
song_translation.translation<br />
song_match.isrc<br />
song_match.amg_track_id<br />
11 Discount Number Optional N/A<br />
12 Discount Type VarChar2(255) Optional N/A<br />
13 Sale Price Number Optional song_price.hq_price<br />
14 Retail Price Number Required song_price.hq_price<br />
15 Begin Date Date(mm/dd/yyyy) Optional song.itunes_release_date<br />
16 End Date Date(mm/dd/yyyy) Optional N/A<br />
17 Brand VarChar2(255) Optional N/A<br />
18 Shipping Number Optional N/A<br />
song_match.isrc (delimited with double tildas ~~)<br />
song_match.amg_track_id<br />
19 Keyword(s) VarChar2(500) Optional<br />
song_translation.translation<br />
artist_translation.translation<br />
20 Manufacturer Part # VarChar2(50) Optional song_match.isrc<br />
21 Manufacturer Name VarChar2(250) Optional N/A<br />
22 Shipping In<strong>for</strong>mation VarChar2(50) Optional N/A<br />
23 Availability VarChar2(50) Optional N/A<br />
24 Universal Product Code VarChar2(15) Optional N/A<br />
25 Class ID Number Required 20<br />
26 Currency VarChar2(3) Required USD/CAD/JPY/GBP<br />
27 M1 VarChar2(2000) Optional N/A<br />
1x1 pixel tag used to track impression data <strong>for</strong><br />
28 Pixel VarChar2(128) Optional the link. This is a full tag with all appropriate<br />
attributes.<br />
29 Class Name VarChar2(128) Optional<br />
Music:ID20 or Computer Software:ID50 or<br />
Movies: ID30 or Books:ID10<br />
30 Link ID VarChar2(128) Optional song.song_id<br />
31 Attribution Code VarChar2(128) Optional 20<br />
32 Comments VarChar2(128) Optional N/A<br />
33<br />
34<br />
35<br />
36<br />
37<br />
Genre / Plat<strong>for</strong>m / Title /<br />
Title<br />
Artist / Category / Format<br />
/ Author<br />
Format / Age / Director /<br />
ISBN<br />
Album / - / Actor /<br />
Publisher<br />
Song Title / - / Rating /<br />
Publisher Date<br />
VarChar2(128) Optional<br />
VarChar2(128) Optional artist_translation.translation<br />
VarChar2(128) Optional N/A<br />
VarChar2(128) Optional collection.name<br />
VarChar2(128) Optional song.name<br />
38 Label / - / Studio / - VarChar2(128) Optional<br />
39<br />
Release Date/ - /Released<br />
Date / -<br />
VarChar(128) Optional Same as link effective date.<br />
Copyright © 2010 LinkShare Corporation. Confidential in<strong>for</strong>mation.<br />
genre_artist.genre_id (delimited with double tildas ~~)<br />
genre.genre_name<br />
song.p_line (delimited with double tildas ~~)<br />
song.copyright
<strong>iTunes</strong> Albums<br />
Name Definition<br />
Required/<br />
Optional<br />
<strong>iTunes</strong> Key<br />
1 Product ID Number Required collection.collection_id<br />
2 Product Name VarChar2(255) Required collection.name<br />
3 SKU Number VarChar2(40) Required collection.collection_id<br />
4 Primary Category VarChar2(50) Required "collection"<br />
5 Secondary Category(ies) VarChar2(2000) Optional<br />
genre_collection.genre_id<br />
genre.genre_name<br />
6 Product URL VarChar2(2000) Required collection.view_url<br />
7 Product Image URL VarChar2(2000) Required collection.artwork_url<br />
8 Buy URL VarChar2(2000) Optional N/A<br />
9<br />
Short Product<br />
Description<br />
VarChar2(500) Required<br />
artist.name (delimited with double tildas ~~)<br />
collection.name<br />
artist.artist_id (delimited with double tildas ~~)<br />
artist_translation.translation<br />
10 Long Product Description VarChar2(2000) Optional<br />
collection.name<br />
collection_translation.translation<br />
collection_match.amg_album_id<br />
collection_match.upc<br />
11 Discount Number Optional N/A<br />
12 Discount Type VarChar2(255) Optional N/A<br />
13 Sale Price Number Optional hq_price<br />
14 Retail Price Number Required hq_price<br />
15 Begin Date Date(mm/dd/yyyy) Optional collection.itunes_release_date<br />
16 End Date Date(mm/dd/yyyy) Optional N/A<br />
17 Brand VarChar2(255) Optional N/A<br />
18 Shipping Number Optional N/A<br />
collection_match.amg_album_id<br />
19 Keyword(s) VarChar2(500) Optional<br />
collection_match.upc (delimited with double tildas ~~)<br />
collection_translation.translation<br />
artist_translation.translation<br />
20 Manufacturer Part # VarChar2(50) Optional amg_album_id<br />
21 Manufacturer Name VarChar2(250) Optional N/A<br />
22 Shipping In<strong>for</strong>mation VarChar2(50) Optional N/A<br />
23 Availability VarChar2(50) Optional N/A<br />
24 Universal Product Code VarChar2(15) Optional collection_match.upc<br />
25 Class ID Number Required 20<br />
26 Currency VarChar2(3) Required USD/CAD/JPY/GBP<br />
27 M1 VarChar2(2000) Optional N/A<br />
1x1 pixel tag used to track impression data <strong>for</strong><br />
28 Pixel VarChar2(128) Optional the link. This is a full tag with all appropriate<br />
attributes.<br />
29 Class Name VarChar2(128) Optional<br />
Music:ID20 or Computer Software:ID50 or<br />
Movies: ID30 or Books:ID10<br />
30 Link ID VarChar2(128) Optional collection.collection_id<br />
31 Attribution Code VarChar2(128) Optional 20<br />
32 Comments VarChar2(128) Optional N/A<br />
33<br />
34<br />
35<br />
36<br />
37<br />
Genre / Plat<strong>for</strong>m / Title<br />
/ Title<br />
Artist / Category /<br />
Format / Author<br />
Format / Age / Director /<br />
ISBN<br />
Album / - / Actor /<br />
Publisher<br />
Song Title / - / Rating /<br />
Publisher Date<br />
VarChar2(128) Optional<br />
VarChar2(128) Optional artist_translation.translation<br />
VarChar2(128) Optional N/A<br />
VarChar2(128) Optional collection.name<br />
VarChar2(128) Optional collection.name<br />
38 Label / - / Studio / - VarChar2(128) Optional<br />
39<br />
Release Date/ -<br />
/Released Date / -<br />
VarChar(128) Optional Same as link effective date.<br />
Copyright © 2010 LinkShare Corporation. Confidential in<strong>for</strong>mation.<br />
genre_collection.genre_id<br />
genre.genre_name (delimited with double tildas ~~)<br />
collection.p_line (delimited with double tildas ~~)<br />
collection.copyright
<strong>iTunes</strong> Applications<br />
Name Definition<br />
Required/<br />
Optional<br />
<strong>iTunes</strong> Key<br />
1 Product ID Number Required application.application_id<br />
2 Product Name VarChar2(255) Required application_detail.title<br />
3 SKU Number VarChar2(40) Required application.application_id<br />
4 Primary Category VarChar2(50) Required "application"<br />
5 Secondary Category(ies) VarChar2(2000) Optional<br />
genre_application.genre_id<br />
genre.genre_name (delimited with double tildas ~~)<br />
6 Product URL VarChar2(2000) Required application.view_url<br />
7 Product Image URL VarChar2(2000) Required application.artwork_url_small<br />
8 Buy URL VarChar2(2000) Optional N/A<br />
9<br />
Short Product<br />
Description<br />
VarChar2(500) Required<br />
application.artistname (delimited with double tildas ~~)<br />
application_detail.description<br />
application.recommended_age<br />
application.artist_name<br />
application.seller_name<br />
application.view_url<br />
10 Long Product Description VarChar2(2000) Optional<br />
application.copyright (delimited with double tildas ~~)<br />
application.version<br />
application.itunes_version<br />
application.download_size<br />
application_company_url<br />
application_support_url<br />
11 Discount Number Optional N/A<br />
12 Discount Type VarChar2(255) Optional N/A<br />
13 Sale Price Number Optional application_price.retail_price<br />
14 Retail Price Number Required application_price.retail_price<br />
15 Begin Date Date(mm/dd/yyyy) Optional application.itunes_release_date<br />
16 End Date Date(mm/dd/yyyy) Optional N/A<br />
17 Brand VarChar2(255) Optional N/A<br />
18 Shipping Number Optional N/A<br />
application_detail.title<br />
19 Keyword(s) VarChar2(500) Optional application.artist_name (delimited with double tildas ~~)<br />
genre.name<br />
20 Manufacturer Part # VarChar2(50) Optional application.version<br />
21 Manufacturer Name VarChar2(250) Optional application.seller_name<br />
22 Shipping In<strong>for</strong>mation VarChar2(50) Optional N/A<br />
23 Availability VarChar2(50) Optional N/A<br />
24 Universal Product Code VarChar2(15) Optional N/A<br />
25 Class ID Number Required 50<br />
26 Currency VarChar2(3) Required USD/CAD/JPY/GBP<br />
27 M1 VarChar2(2000) Optional N/A<br />
1x1 pixel tag used to track impression data <strong>for</strong><br />
28 Pixel VarChar2(128) Optional the link. This is a full tag with all appropriate<br />
attributes.<br />
29 Class Name VarChar2(128) Optional<br />
Music:ID20 or Computer Software:ID50 or<br />
Movies: ID30 or Books:ID10<br />
30 Link ID VarChar2(128) Optional application.application_id<br />
31 Attribution Code VarChar2(128) Optional 50<br />
32 Comments VarChar2(128) Optional N/A<br />
33<br />
34<br />
35<br />
Genre / Plat<strong>for</strong>m / Title /<br />
Title<br />
Artist / Category / Format<br />
/ Author<br />
Format / Age / Director /<br />
ISBN<br />
VarChar2(128) Optional device_type.name<br />
VarChar2(128) Optional<br />
Copyright © 2010 LinkShare Corporation. Confidential in<strong>for</strong>mation.<br />
genre_application.genre_id<br />
genre.genre_name (delimited with double tildas ~~)<br />
VarChar2(128) Optional application.recommended_age
<strong>iTunes</strong> Videos<br />
Name Definition<br />
Required/<br />
Optional<br />
<strong>iTunes</strong> Key<br />
1 Product ID Number Required video.video_id<br />
2 Product Name VarChar2(255) Required video.name<br />
3 SKU Number VarChar2(40) Required video.video_id<br />
4 Primary Category VarChar2(50) Required "video"<br />
5 Secondary Category(ies) VarChar2(2000) Optional<br />
genre_video.genre_id<br />
genre.genre_name (delimited with double tildas ~~)<br />
6 Product URL VarChar2(2000) Required video.view_url<br />
7 Product Image URL VarChar2(2000) Required video.artwork_url<br />
8 Buy URL VarChar2(2000) Optional N/A<br />
9<br />
Short Product<br />
Description<br />
VarChar2(500) Required<br />
artist.name<br />
video.name<br />
artist.artist_id<br />
artist_translation.translation<br />
video.name (delimited with double tildas ~~)<br />
10 Long Product Description VarChar2(2000) Optional video_translation.translation<br />
video_match.isrc<br />
video_match.amg_video_id<br />
video_match.upc<br />
11 Discount Number Optional N/A<br />
12 Discount Type VarChar2(255) Optional N/A<br />
13 Sale Price Number Optional video_price.hq_price<br />
14 Retail Price Number Required video_price.hq_price<br />
15 Begin Date Date(mm/dd/yyyy) Optional video.itunes_release_date<br />
16 End Date Date(mm/dd/yyyy) Optional N/A<br />
17 Brand VarChar2(255) Optional N/A<br />
18 Shipping Number Optional N/A<br />
video_match.isrc<br />
video_match.amg_video_id<br />
19 Keyword(s) VarChar2(500) Optional video_match.upc (delimited with double tildas ~~)<br />
video_translation.translation<br />
artist_translation.translation<br />
20 Manufacturer Part # VarChar2(50) Optional video_match.isrc<br />
21 Manufacturer Name VarChar2(250) Optional N/A<br />
22 Shipping In<strong>for</strong>mation VarChar2(50) Optional N/A<br />
23 Availability VarChar2(50) Optional N/A<br />
24 Universal Product Code VarChar2(15) Optional video_match.upc<br />
25 Class ID Number Required 20<br />
26 Currency VarChar2(3) Required USD/CAD/JPY/GBP<br />
27 M1 VarChar2(2000) Optional N/A<br />
1x1 pixel tag used to track impression data <strong>for</strong><br />
28 Pixel VarChar2(128) Optional the link. This is a full tag with all appropriate<br />
attributes.<br />
29 Class Name VarChar2(128) Optional<br />
Music:ID20 or Computer Software:ID50 or<br />
Movies: ID30 or Books:ID10<br />
30 Link ID VarChar2(128) Optional video.video_id<br />
31 Attribution Code VarChar2(128) Optional 20<br />
32 Comments VarChar2(128) Optional N/A<br />
33<br />
34<br />
35<br />
36<br />
37<br />
Genre / Plat<strong>for</strong>m / Title /<br />
Title<br />
Artist / Category /<br />
Format / Author<br />
Format / Age / Director /<br />
ISBN<br />
Album / - / Actor /<br />
Publisher<br />
Song Title / - / Rating /<br />
Publisher Date<br />
VarChar2(128) Optional<br />
Copyright © 2010 LinkShare Corporation. Confidential in<strong>for</strong>mation.<br />
genre_video.genre_id<br />
genre.genre_name (delimited with double tildas ~~)<br />
VarChar2(128) Optional artist_translation.translation<br />
VarChar2(128) Optional N/A<br />
VarChar2(128) Optional N/A<br />
VarChar2(128) Optional video.name<br />
38 Label / - / Studio / - VarChar2(128) Optional<br />
39<br />
Release Date/ - /<br />
Release Date / -<br />
video.p_line (delimited with double tildas ~~)<br />
video.copyright<br />
VarChar2(128) Optional Same as link effective date.
Change language