1. Technical implementation

What are the (required) fields in my XML?

 

The fields below are split into mandatory and optional fields. Mandatory fields are required for the XML to be successfully integrated. Optional fields are not needed for the core functionality to work. The XML will be integrated by the development team.

XML fields:

Mandatory
  • Job title
  • Category
  • Company
  • City
  • Country
  • Reference number
  • (Landing page) URL 

Images in XML:

  • Facebook
    • Image size is at least 600 x 600 pixels
    • Image ratio is 1:1 or 1:91:1
    • The maximum file size is 30 MB
    • The file type is JPG or PNG
  • Instagram
    • Image size is at least 500 pixels
    • Image ratio is 1:1
    • The maximum file size is 30 MB
    • The file type is JPG or PNG
  • LinkedIn
    • Image size is at least 640 x 360 pixels for Landscape

    • Image size is at least 360 x 360  pixels for Square

    • The maximum size is 7680 x 4320 for Landscape

    • The maximum size is 4320 x 4320 for Square

    • Recommended the image ratio is 1:1  or 1:91:1

    • The file type is JPG or PNG

Optional

  • Start + end date
  • Images
  • Package id
  • Description (used for LeadForm templates)
  • Custom Template ID
  • Campaign status

Please note: changing the campaign status from 'active' to 'inactive' is a one-way and one-time action!

To confirm whether your XML is following the requested setup, please check it in Wonderkind's XML validator

XML examples

 

XML example with all possible fields

<job>
<title>Business Development Manager</title>
<company>Wonderkind</company>
<country>Netherlands</country>
<category>Sales</category>
<city>Amsterdam</city>
<referencenumber>123456789</referencenumber>
<description>Ready for a new challenge at Wonderkind?<description>
<url><http://www.testwonderkind.com</url>
<package_hash>B6BD67C6-EDDD-4A90-B8A2-68FBC7E3C421</package_hash>
<custom_template_id>B6BD67C6-EDDD-4A90-B8A2 68FBC7E3C421</custom_template_id>
<image_1>https://testwonderkind.com/creatives/image1_1234567.png</image_1>
<image_2>https://testwonderkind.com/creatives/image2_1234567.png</image_2>
<status>active</status>
</job>

Tip: already include every field in your XML. This way you don't have to update it once you'd like to use a feature with another XML field


Basic XML example:

<job>
<title>Business Development Manager</title>
<company>Wonderkind</company>
<country>Netherlands</country>
<category>Sales</category>
<city>Amsterdam</city>
<referencenumber>123456789</referencenumber>
<url><http://www.testwonderkind.com</url>
</job>


XML with package ID:

<job>
<title>Business Development Manager</title>
<company>Wonderkind</company>
<country>Netherlands</country>
<category>Sales</category>
<city>Amsterdam</city>
<referencenumber>123456789</referencenumber>
<url><http://www.testwonderkind.com</url>
<package_hash>B6BD67C6-EDDD-4A90-B8A2-68FBC7E3C421</package_hash>
</job>

XML with image URL (same image for all channels) option 1:

<job>
<title>Business Development Manager</title>
<company>Wonderkind</company>
<country>Netherlands</country>
<category>Sales</category>
<city>Amsterdam</city>
<referencenumber>123456789</referencenumber>
<url><http://www.testwonderkind.com</url>
<image_1>https://testwonderkind.com/creatives/image1_1234567.png</image_1>
<image_2>https://testwonderkind.com/creatives/image2_1234567.png</image_2>
</job>

XML with image URL (same image for all channels) option 2:

<job>
<title>Business Development Manager</title>
<company>Wonderkind</company>
<country>Netherlands</country>
<category>Sales</category>
<city>Amsterdam</city>
<referencenumber>123456789</referencenumber>
<url><http://www.testwonderkind.com</url>
<media>
  <all>
     <images>
       <image>...all channel image url...</image>
       <image>...</image>
     </images>
  </all>
</media>
</job>

XML with image URL (different per channel):

<job>
<title>Business Development Manager</title>
<company>Wonderkind</company>
<country>Netherlands</country>
<category>Sales</category>
<city>Amsterdam</city>
<referencenumber>123456789</referencenumber>
<url><http://www.testwonderkind.com</url>
<media>
  <facebook>
    <images>
      <image>...facebook channel image url...</image>
      <image>…</image>
    </images>
  </facebook>
  <instagram>
    <images>
      <image>...instagram channel image url...</image>
      <image>…</image>
    </images>
  </instagram>
</media>
</job>

 

XML with description

<job>
<title>Business Development Manager</title>
<company>Wonderkind</company>
<country>Netherlands</country>
<category>Sales</category>
<city>Amsterdam</city>
<referencenumber>123456789</referencenumber>
<description>Ready for a new challenge at Wonderkind?<description>
<url><http://www.testwonderkind.com</url>
<image_1>https://testwonderkind.com/creatives/image1_1234567.png</image_1>
<image_2>https://testwonderkind.com/creatives/image2_1234567.png</image_2>
</job>

XML example with custom template id

<job>
<title>Business Development Manager</title>
<company>Wonderkind</company>
<country>Netherlands</country>
<category>Sales</category>
<city>Amsterdam</city>
<referencenumber>123456789</referencenumber>
<url><http://www.testwonderkind.com</url>
<custom_template_id>B6BD67C6-EDDD-4A90-B8A2 68FBC7E3C421</custom_template_id>
</job>

XML example with campaign status

<job>
<title>Business Development Manager</title>
<company>Wonderkind</company>
<country>Netherlands</country>
<category>Sales</category>
<city>Amsterdam</city>
<referencenumber>123456789</referencenumber>

<status>active</status>
<url><http://www.testwonderkind.com</url>
</job>