Ensure your content is correctly delivered to Snapplify by preparing your XML metadata according to these guidelines. Use the provided XSD file to validate your files, format your filenames correctly, and associate your content files precisely.


Snapplify uses a subset of the ONIX 3.0 XML standards.


The pricing provided in your metadata must either be inclusive or exclusive of VAT (sales tax), based on what has been agreed in your distribution agreement.


To Prepare Your XML Metadata


XML Filename


The name of the XML file must be in the format YYYYMMDD_HHmm.xml

  • Example:20140213_1532.xml

Associated Content Files

Filenames are inferred from the following metadata fields:

  • IDValue (for ProductIDType = 15) in the <ProductIdentifier> element

  • ProductFormDetail in the <DescriptiveDetail> element

Images:

  • Follow the same naming convention as content files

  • Are independent of the ProductFormDetail element

  • Supported formats: .jpg, .png, or .gif

  • Only one image per record is supported


Example 1:

  • The asset file associated with this record will be 9780801448157.epub
  • The jacket image file associated with this record will be 9780801448157.jpg/png
<Product>

<ProductIdentifier>

<ProductIDType>15</ProductIDType>

<IDValue>9780801448157</IDValue>

</ProductIdentifier>

<DescriptiveDetail>

<ProductFormDetail>E101</ProductFormDetail>

</DescriptiveDetail>

</Product>


Example 2:

  • The asset file associated with this record will be 9781600608667.pdf
  • The jacket image file associated with this record will be 9781600608667.jpg/png
<Product>

<ProductIdentifier>

<ProductIDType>15</ProductIDType>

<IDValue>9781600608667</IDValue>

</ProductIdentifier>

<DescriptiveDetail>

<ProductFormDetail>E107</ProductFormDetail>

</DescriptiveDetail>

</Product>


Assigning DRM restrictions in XML metadata


Specifying if DRM is enabled on a product is done via the EpubTechnicalProtection:


ElementEpubTechnicalProtection
Allowed valuesDescription
00None – product doesn't require DRM
01DRM enabled

If EpubTechnicalProtection = 01, then optional EpubUsageConstraint elements can be supplied.

If none are supplied, the default DRM scheme will be used.


The EpubUsageContraint element is described in Snapplify’s XSD.


Currently, only ePUB and PDF types may support DRM.


DRM Restriction XML Snippets


User is restricted to downloading title, on the same device, or multiple devices, a total of 5 times: 

<EpubUsageConstraint>

<!-- 04 = use on multiple devices, 10 = licence days -->

<EpubUsageType>04</EpubUsageType>

<!--01 - unlimited, 02 = limited -->

<EpubUsageStatus>02</EpubUsageStatus>

<EpubUsageLimit>

<Quantity>5</Quantity>

<!-- 06 - devices, 09 - days -->

<EpubUsageUnit>06</EpubUsageUnit>

</EpubUsageLimit>

</EpubUsageConstraint>


User licence will expire 365 days after first licence acquisition:


<EpubUsageConstraint>

<!-- 04 = use on multiple devices, 10 = licence days -->

<EpubUsageType>10</EpubUsageType>

<!--01 - unlimited, 02 = limited, 03 = prohibited -->

<EpubUsageStatus>02</EpubUsageStatus>

<EpubUsageLimit>

<Quantity>365</Quantity>

<!-- 06 - devices, 09 - days -->

<EpubUsageUnit>09</EpubUsageUnit>

</EpubUsageLimit>

</EpubUsageConstraint>



Need help? Contact the Marketplace Team at marketplace@snapplify.com