Toloka documentation

Project 2. Find a similar item in an online store

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

Create a project

To create a project, open Toloka for requesters.

In the interface:

  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:

    1. Use the ready-made code for this project with pre-configured validation and task layout.

      The Toloker 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 shoes <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>
      
    2. To check if the link and image submitted by the Toloker 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) {

      Warning

      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%;
      }
      
    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
        }
        }
        
      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
        }
        }
        

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

      4. Click to see the Toloker'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.

      5. In the window that opens, check if the task options work correctly. In the lower-right corner, click Submit.

      6. 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 Tolokers, 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.
      
    2. Save the changes.

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

Learn more about working with the project in the Project section.

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 Add a pool on the project page.

  3. Set the Pool name (visible only to you) field. Only you will see this pool name on the project page.

  4. Specify the pool description which will be displayed instead of the project description in the task list for Tolokers. By default, Tolokers see the description from the project settings. To use a different description, uncheck the Use project description box and set Public description. If necessary, click + Private comment to add a private project description that only you will see.

  5. Click Create.

  6. At the Select the audience for your task step, set up filters to select Tolokers for your pool.

    1. Use the Languages filter to select Tolokers with knowledge of the language.

    2. Clear My tasks may contain shocking or pornographic content if your project has none of those.

    3. Tasks in pools will be automatically available in the web version of Toloka and the mobile app. If you want to change the default settings and limit the visibility of the task for any of the versions, add the Client filter and select the desired value: Toloka web version or Toloka for mobile.

    4. Click Add skill.

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

    6. Click the Add button.

  7. (optional) In the Speed/quality balance section, specify the desired quality level. Improving quality may reduce the speed of task completion because the pool will be available to fewer Tolokers. Learn more in the Speed/quality balance section.

  8. At the Set the task price and overlap step, set up how much a single task will cost for you.

    1. In Price per task suite, $, set the amount of money to pay per task suite done by one Toloker. For example, 0.01.

    2. Enter 3 in the Overlap field.

  9. At the Setup quality control step, set quality control rules for more accurate results:

    1. Turn on the Review task responses manually option.

    2. Set the Deadline field to 7.

    3. Click Add a quality control rule.

    4. Find the Rules block in the list and select Processing rejected and accepted 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:

    1. Add another quality control rule. Click Add a quality control rule.

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

    3. 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 Tolokers must match, which is practically impossible. Learn more in Quality control.

  10. At the Prepare and upload data step, upload your task data.

    1. In the text or spreadsheet editor, open the 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.

    6. Upload the resulting file.

      1. Click Drop file here or select, and upload the file you’ve just made.

      2. Click Continue.

      3. Choose Set manually.

      4. In the Tasks per suite field, specify1.

      5. Click Combine tasks into suites.

  11. At the Double-check your project and try out tasks step, check how the task will look from the Toloker's point of view.

    Note

    This step will be enabled after you complete the previous steps. You can skip this step by clicking Do it later.

  12. Click to start the pool.

What's next

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