Dokumen ini memberikan panduan cara pembuatan sumber data produk XML dalam format Atom 1.0. Kami telah menautkan atribut standar ke masing-masing bagian dalam spesifikasi Atom 1.0 resmi untuk membantu Anda menemukan informasi tambahan mengenai komponen dari contoh kami. Meskipun kami menyediakan contoh file Atom 1.0, kami hanya memberikan sedikit informasi tentang Atom 1.0 itu sendiri.
Jika Anda tertarik untuk mempelajari standar ini lebih lanjut, sebaiknya lihat spesifikasi ini di Atom Syndication Format.
Untuk mendownload file contoh Atom 1.0, klik di sini.
Bagian 1: Atom 1.0
Berdasarkan spesifikasi Atom 1.0, terdapat lima elemen yang telah ditetapkan di tingkat entri, yaitu judul [title], ID [id], link [link], ringkasan [summary], dan diperbarui [updated]. Meskipun kelima elemen ini bersifat opsional di standar Atom 1.0, sumber data produk mewajibkan elemen-elemen tersebut.
Sumber data produk juga memerlukan elemen tambahan seperti harga dan kondisi. Untuk menyertakan informasi yang lebih mendetail tentang suatu item, kami memperluas Atom 1.0 dengan menambahkan namespace Google Merchant Center. Dengan menetapkan namespace Google Merchant Center, Anda dapat menggunakan elemen tambahan, yang disebut "atribut", dan meningkatkan jumlah informasi yang dapat diberikan terkait setiap produk di sumber data produk.
Di bawah ini adalah contoh dokumen Atom 1.0 dasar yang berisi satu item:
<?xml version="1.0"?>
<feed xmlns="http://w3.org/2005/Atom"
xmlns:g="http://base.google.com/ns/1.0">
<title>Nama sumber data produk Anda</title> <link href="http://example.com" rel="alternate" type="text/html" /> <updated>2006-06-11T18:30:02Z</updated> <author> <name>Google</name> </author>
<id>tag:example.com,2006-06-11:/support/products</id> <entry>
<title>Sweter wol merah</title> <id>1a</id> <link href="http://example.com/item1-info-page.html" /> <summary>Sweter ini akan menjaga Anda tetap hangat di malam musim dingin yang dingin karena terbuat dari bahan yang nyaman dan lembut.</summary>
<updated>2005-10-13T18:30:02Z</updated>
<g:image_link>http://google.com/images/google_sm.gif</g:image_link> <g:price>25</g:price> <g:condition>new</g:condition>
</entry> </feed>
Dua penambahan utama pada contoh ini adalah tambahan pernyataan namespace dan penyertaan tiga atribut (link gambar [image_link] , harga [price], dan kondisi [condition]).
Pernyataan Namespace Google Merchant Center
Pernyataan ruang nama berikut ini diwajibkan untuk menggunakan atribut yang hanya ditetapkan hanya di ruang nama Google Merchant Center.
xmlns:g="http://base.google.com/ns/1.0"
Sebagai tambahan untuk menyatakan nama ruang Google Merchant Center, Anda harus menyertakan awalan pada setiap tag atribut. Kami menambahkan awalan ini pada atribut untuk membedakan atribut yang ditetapkan di nama ruang kami dari elemen yang ditetapkan pada Atom 1.0. Awalan yang dipilih untuk pernyataan namespace ini adalah "g":
<g:image_link>http://google.com/images/google_sm.gif</g:image_link>
Atribut di namespace Google Merchant Center harus disertai awalan ini. Jika tidak, atribut dan semua nilai yang termuat di dalamnya akan diabaikan.
Atribut
Anda dapat menggunakan sebanyak mungkin atribut yang khusus dibuat untuk produk. Menyediakan informasi tambahan tentang produk Anda dengan menggunakan atribut ini dapat meningkatkan peluang munculnya produk di hasil penelusuran. Selain itu, beberapa atribut yang ditetapkan di namespace Google Merchant Center dapat digunakan lebih dari sekali pada satu produk. Dengan demikian, Anda dapat menambahkan lebih banyak informasi yang tersedia tentang suatu produk dalam sumber data produk Anda.
Bagian 2: Checklist Penting
Sebelum Anda mengirimkan sumber data produk, sebaiknya periksa kembali daftar berikut untuk membantu memastikan file Anda diformat dengan benar:
Nama file harus berakhiran dengan ekstensi .xml.
Nama file sumber data produk yang didaftarkan di akun Google Merchant Center harus cocok dengan nama yang ditetapkan ke file Anda.
Jangan lupa untuk menyertakan pernyataan namespace. Nilai tersebut harus sama persis seperti yang ditunjukkan berikut ini.
- Namespace Google Merchant Center:
xmlns:g="http://base.google.com/ns/1.0". - Namespace atribut khusus:
xmlns:[prefix]="http://base.google.com/cns/1.0", dengan [prefix] digantikan oleh awalan yang Anda sertakan dalam file.
Verifikasi bahwa awalan yang disertakan dalam tag atribut Google Merchant Center dan Google Merchant Center Khusus cocok dengan awalan yang ditetapkan di pernyataan namespace.
Hapus atribut yang tidak berisi nilai.
Bagian 3: Catatan akhir
Contoh entri yang disertakan dalam dokumen ini disederhanakan untuk lebih fokus pada dasar-dasar pembuatan sumber data produk XML Google Merchant Center. Meskipun kami menerima sumber data produk yang berisi elemen lain yang ditetapkan dalam standar Atom 1.0 atau dalam namespace Anda sendiri, informasi apa pun yang terdapat dalam elemen ini akan diabaikan selama pemrosesan dan tidak akan muncul di iklan atau listingan produk gratis Anda. Saat ini, kami hanya akan memproses data yang terdapat di elemen Atom 1.0 default dan di atribut pada namespace Google Merchant Center dan Google Merchant Center Khusus.