Project 2. Find a similar item in an online store

In this project, performers will search in an online store for shoes that are similar to the ones shown. Use the results from project 1 as source images.

  1. Create a project
  2. Create a pool
  3. Prepare and upload a TSV file with tasks

Create a project

To create a project, open Toloka for requesters.

  1. Choose a template:

    1. Click Create project.

    2. Select the Product photo search template.

  2. Provide general information:

    1. In the Project title field, enter Find the same or similar shoes in an online store.

    2. In the Description field, enter Go to an online store and provide a link and an image of the same or similar pair of shoes.

    3. Optionally add a Private comment.

    4. Save the changes.

  3. Edit the task interface in the editor you selected:

    Template Builder
    HTML/CSS/JS editor
    1. Use the ready-made code for this project with pre-configured validation and task layout.

      The performer won't be able to submit the response until they:

      • Click the button to go to the online store.
      • Add a link to the product.
      • Upload an image of the product.
    2. Click Show specifications to see the input and output data fields.

      • Input data field: image — A link to an image.

      • Output data fields:

        • found_link — The link to the product in the online store.
        • found_image — For uploading the image of the product.
    1. In the Task Interface, delete the template code from the HTML block and paste the following code:

      {{img src=image width="50%" height="400px"}}
      <div class='answers'>
          <p>Find similar <b>shoes</b> in the ASOS online store</p>
      {{field type="button-clicked" name="button" label="ASOS" href="https://www.asos.com" action=true}}
      <p>Shoes must be similar in color, material, length, and style.</p>
      <p>Paste the link here</p>
      {{field width="100%" type="input" name="found_link"}}
      <p>Upload the image here</p>    <div>
      {{field width="100%" type="file-img" name="found_image" preview=true}}
      </div>
      </div>
      Copied to clipboard
    2. To check if the link and image submitted by the performer are valid, go to line 5 in the JS block and replace the following code:

      if (!solution.output_values.image && !solution.output_values.no_image) {

      with

      if (!solution.output_values.found_image) {

      Attention.

      Be careful when changing the code. If you have issues with the preview, contact support or compare your code with the code sample in the Appendix.

    3. Replace the template code in the CSS block with the following code, which is responsible for setting the proportional image size.

      .task {
        display: block;
        height: 500px;
        width: 800px;
      }
      .img {
        float: left; 
        width: 50%;
      }
      .answers {
        float: left; 
        width: 40%;
        margin: 5%;
      }
      Copied to clipboard
    4. Edit the input and output data in the Data specification block.

      1. Click to switch graphic mode to JSON format.

      2. In the Input data field, enter:

        {
          "image": { 
              "type": "url",
              "hidden": false, 
              "required": true 
           } 
        }
        Copied to clipboard
      3. In the Output data field, enter:

        Note.

        If you want to choose a different online store, change "pattern": "https://www.asos.com/.*" to "pattern": "your_store.*".

        {
          "button": {
            "type": "boolean",
            "hidden": false,
            "required": true,
            "allowed_values": [
              true
            ]
          },
          "found_link": {
            "type": "string",
            "hidden": false,
            "pattern": "https://www.asos.com/.*",
            "required": true
          },
          "found_image": {
            "type": "file",
            "hidden": false,
            "required": true
          }
        }
        Copied to clipboard

        Learn more about the Specification parameters in Input and output data.

      4. Click to see the performer's view of the task.

        Note. The project preview shows one task with standard data. You can define the number of tasks to show on the page later.
        1. In the window that opens, check if the task options work correctly. In the lower-right corner, click Submit.

        2. Exit preview mode.

          In the lower-left corner, click Exit. If there were errors when testing, check the code blocks that you entered.

  4. Save the changes.

  5. In Instructions for performers, enter the instructions.

    1. Instructions:
      Look at what the person is wearing in the picture. 
      Then go to the ASOS online store and search for the same pair of shoes. 
      It should be similar in category, style, color, and length.
      Copied to clipboard
    2. Save the changes.

  6. To go back to the Projects page, click Finish editing.

Learn more about working with the project in Project.

Create a pool

To create a pool:

  1. Open the page of the project titled Find the same or similar shoes in an online store.

  2. Click the Add pool button.

  3. Specify the pool name.

  4. (optional) Enter the Private description.

    1. Turn on the Add a private description option.

    2. In the Private description field, enter the pool description. This information is available only to you.

  5. In the Price per task suite section, go to the Price in US dollars field and specify 0.01. You can see more examples of pricing here.

  6. In the Performers section, filter performers by language:

    1. Click Add filter.

    2. Find the Performer profile block in the list and choose the Languages skill.

    3. In the ? field specify =.

    4. In the Value field, specify Russian.

  7. In the Performers section, add a new skill:

    1. Click Create skill.

    2. In the Title field of the window that opens, enter Found_shoes.

    3. Click the Add button.

  8. In the Quality control section, specify quality control settings for the pool:

    1. Turn on the Non-automatic acceptance option.

    2. Set the Deadline field to 7.

    3. Click Add quality control rule.

    4. Find the Rules block in the list and choose Recompletion of rejected assignments.

    5. Set a rule for rejected tasks: if a task is rejected, increase overlap by 1. In addition, turn on the Open pool if closed option:

    6. Add another quality control rule. Click Add quality control rule.

    7. Find the Rules block in the list and choose Submitted responses.

    8. Set a rule for completed assignments: if the number of submitted assignments is greater than or equal to 1, set the value of the Found_shoes skill to 1.

      Note.

      If the Found_shoes skill is missing from the list, save the pool and reopen it to edit it.

    Control tasks and majority vote aren't used in this type of project, because links submitted by performers must match, which is practically impossible. Learn more in Quality control.

  9. In the Overlap section, go to the Overlap field and enter 3.

  10. (optional) In the Speed/quality section, specify the percentage of top-rated users who will get access to the pool. Learn more in Speed/quality balance.

  11. Click Save.

Prepare and upload a TSV file with tasks

  1. In the text or spreadsheet editor, open the TSV file that you received after aggregating the results in project 1.

  2. Select images that are appropriate for the current project (OK or your value if you changed it for the result field).

  3. Copy the column with the selected links to a new sheet or document.

  4. Name it INPUT:image. If you want to set a different name, rename the column in the source file with the results, too.

  5. Save the file in TSV format.

  6. Upload the resulting TSV file.

    1. Click Upload. In the window that opens, configure the file upload settings.

    2. Choose Set manually.

    3. In the Tasks per page field, specify1.

    4. Click Upload.

    5. In the window that opens, choose the TSV file with tasks to upload and click Open.

    6. In the window that opens, check the number of tasks and click Add.

  7. Click to start the pool.

    Attention.

    The tasks will be completed by real performers in Toloka. Recheck your project setup before you start the pool.

What's next

  • Create Project 3 to compare the original image with the results from Project 2.