Create

Creates a Hire Group Campaign.

Request

POST https://ttv.microworkers.com/api/v2/hire-group-campaigns

Request Body

{
  "availablePositions": integer,
  "categoryId": string,
  "groupId": string,
  "maxPositionPerWorker": integer,
  "numberOfWorkerOnSamePosition": integer,
  "internalTemplate": {
    "id": string,
    "adminInstructions": string,
    "numberOfSubTasks": integer,
    "ratingMethodId": integer,
    "displaySubTasksOnSamePage": boolean,
    "allowedFileTypes": [
      string
    ],
    "numberOfFileProofs": integer
  },
  "externalTemplate": {
    "url": string,
    "height": string,
    "width": string,
    "parameters": [
      string
    ],
    "timeToWaitAfterSlotExpiration": integer
  },
  "minutesToFinish": integer,
  "title": string,
  "qtRequired": boolean,
  "description": string,
  "paymentPerTask": float,
  "maximumJobLimit": {
    "enabled": boolean,
    "limitPerDay": integer
  },
   "autoSkipTask": {
    "enabled": boolean,
    "timeLimit": integer
  },
  "ttr": integer,
  "taskOrder": integer,
  "tasks": [
    {
      "id": string,
      "data": [
        {
          "key": string,
          "value": string
        }
      ],
      "testCases": [
        {
          "questionId": string,
          "answers": [
            string
          ]
        }
      ]
    }
  ],
  "notificationSettings": [
    {
      "url": string,
      "type": string,
      "notificationTypes": [
        string
      ]
    }
  ]
}

HireGroupCampaignPostRequest

Property Type Description
availablePositions integer How many initial positions Campaign has.
categoryId string The ID of Category which best match to your Task requirements.
groupId string Hire Group (Group of Workers) ID which best match to your Task requirements.
maxPositionPerWorker integer How many positions each worker can take. 0 – unlimited. [1]
numberOfWorkerOnSamePosition integer How many workers should complete same position. Required, if Campaign utilize unique positions.
internalTemplate InternalTemplateRequest Internal Template Campaign settings. internalTemplate cannot be used together with externalTemplate.
externalTemplate ExternalTemplateRequest External Template Campaign settings. externalTemplate cannot be used together with internalTemplate
minutesToFinish integer Allocated time in minutes to complete position.
title string The title of Campaign.
qtRequired boolean If set to true, only workers who passed Microworkers Qualification/Admission test [2] will be able to work on Tasks from this Campaign.
description string Campaign description which will be shown to worker on accept/start Task page.
paymentPerTask float How much money worker will earn in American $ for Satisfied Task.
maximumJobLimit MaximumJobLimitRequest Max Positions per Day settings. [3]
ttr integer Limit in days allocated to Employer to rate submitted Task. If Task wasn’t rated on time – it will be automatically rated as Satisfied.
taskOrder integer

Order in which Tasks will be assigned to workers. [4]

  • 1 – Random
  • 2 – Ascending order

Required, if Campaign utilize unique positions.

tasks array[TaskDataRowRequest] A list of Tasks details. Required, if Campaign utilize unique positions.
notificationSettings array[AmazonSqsNotificationSettingRequest] A list of notifications settings.
autoSkipTask AutoSkipTaskRequest Auto-skip position settings.

InternalTemplateRequest

Property Type Description
id string The ID of Template (Internal).
adminInstructions string Instructions to Microworkers staff how to review/rate Tasks. Required if ratingMethodId is 1 or 2. If ratingMethodId is 3 – must be omitted.
numberOfSubTasks integer Number of Tasks each position has. Required, if Campaign utilize unique Tasks, in other cases – it must be absent.
ratingMethodId integer
  • 1 - Admin Rate
  • 2 - Admin Review & Employer Rate
  • 3 - Employer Rate Only.

[5]

displaySubTasksOnSamePage boolean

Display Spreadsheet [6] sub-tasks on same page flag.

Required, If Template has Spreadsheet, in all other cases must be absent.

allowedFileTypes array[string] A list of allowed file extensions.
numberOfFileProofs integer Value can be in range 1 to 3.

ExternalTemplateRequest

Property Type Description
url string URL of Task details page which will be displayed in iframe. Required, if Campaign doesn’t utilize unique positions.
height string Iframe height. Required, if Campaign doesn’t utilize unique positions.
width string Iframe width. Required, if Campaign doesn’t utilize unique positions.
parameters array[string] A list of parameters you wish to store on submission to Callback URL [7] .
timeToWaitAfterSlotExpiration integer How many minutes to wait to release lock from the Slot with expired lock.

MaximumJobLimitRequest

Property Type Description
enabled boolean Flag which controls if maximum positions per day is turned on.
limitPerDay integer Maximum number of positions which may be completed on daily basis. If maximum number reached - Campaign automatically became paused and will be resumed at 00:00:00 CDT. Required if maximum positions per day is turned on.

TaskDataRowRequest

Property Type Description
id string The ID of Task. If present - value must be unique and contain alpha-numeric characters only. If it’s omitted - system will generate random value
data array[KeyValueRequest] The list of key/value objects.
testCases array[TestCaseRequest] The list of expected Answers for Questions.

AmazonSqsNotificationSettingRequest

Property Type Description
url string Amazon SQS Queue URL
type string Notification settings type. Fixed value: sqs.
notificationTypes array[string] List of turned on Notification Types.

KeyValueRequest

Property Type Description
key string Key
value string Value

TestCaseRequest

Property Type Description
questionId string The ID of Question.
answers array[string] The list of expected Answers.

AutoSkipTaskRequest

Property Type Description
enabled boolean Flag which controls If auto-skip position is turned on.
timeLimit integer If browser didn’t refresh the session within allocated time in seconds – position will be auto-skipped. Required if auto-skip position flag is turned on.

Notification Types

Notification Type        
CampaignApproved CampaignPausedByAdmin CampaignRunning SlotNotSatisfied SlotSubmitted
CampaignBlocked CampaignPausedBySystem CampaignSubmitted SlotReadyForRating TaskGroupCreated
CampaignCanceled CampaignRejected SlotCreated SlotRemoved  
CampaignCreated CampaignRestartApproved SlotLocked SlotRevised  
CampaignFinished CampaignRestartRejected SlotLockExpired SlotReviseRequested  
CampaignPaused CampaignRestartRequested SlotLockReleased SlotSatisfied  

Response

Response HTTP Codes

Http Code Response Type Description
202   Accepted (OK)
400   Validation Failed
401   Unauthorized

Response HTTP Headers

On successful response API returns queue-job-id header.

Examples

Internal Template - fixed task details

Settings:

  • Fixed Task details.
  • 10 initial positions.
  • Search, Click, and Engage Category.
  • I want to rate Tasks ASAP. (Employer rate) [5]
  • 5 minutes allowed for Worker to complete the position.
  • Allow Workers who failed Microworkers Qualification/Admission test [2] to take position in this Campaign.
  • Worker base earning $0.10 for satisfied position.
  • Allocated time to rate position - 2 days.
  • I want to assign this Campaign to “MW: English Speaking Countries” Hire Group (Default).
  • Each Worker can take 1 position only.
{
  "availablePositions": 10,
  "categoryId": "10",
  "internalTemplate": {
    "id": "T550bd781e36b5",
    "ratingMethodId": 3
  },
  "minutesToFinish": 5,
  "title": "Search website in Google",
  "qtRequired": false,
  "description": "Lorem ipsum ac eleifend justo quis blandit congue aliquam, porta himenaeos mattis adipiscing vestibulum tincidunt diam conubia, tellus ut proin luctus viverra nisi turpis felis semper pellentesque sapien praesent netus.",
  "paymentPerTask": 0.1,
  "ttr": 2,
  "groupId": "18f477773330",
  "maxPositionPerWorker": 1
}

Internal Template - unique task details

Settings:

  • Unique Task details.
  • 10 initial positions.
  • Transcription Category.
  • I want Microworkers Staff to review positions before they will come to me for rating (Admin review, Employer rate) [5]
  • Each position has 1 Task.
  • 30 minutes allowed for Worker to complete the position.
  • Disallow Workers who failed Microworkers Qualification/Admission test [2] to take position in this Campaign.
  • Worker base earning $0.50 for satisfied position.
  • Allocated time to rate position - 5 days.
  • I want to assign this Campaign to “Favorite” Hire Group (Custom).
  • Each Worker can take 2 positions.
  • I want to assign each position to 3 unique Workers.
  • Tasks will be allocated to Workers in ascending order. [4]
{
  "availablePositions": 10,
  "categoryId": "07",
  "internalTemplate": {
    "id": "T58b74ba469d61",
    "ratingMethodId": 2,
    "adminInstructions": "Review completed tasks carefully and rejects these which don't match.",
    "numberOfSubTasks": 1
  },
  "minutesToFinish": 30,
  "title": "Audio Transcription",
  "qtRequired": true,
  "description": "You need to transcript 5 minutes length audio file.",
  "paymentPerTask": 0.5,
  "ttr": 5,
  "groupId": "ioReem0BAhm4",
  "maxPositionPerWorker": 2,
  "numberOfWorkerOnSamePosition": 3,
  "taskOrder": 2,
  "tasks": [
    {
      "id": "1",
      "data": [
        {
          "key": "audio",
          "value": "https://microworkers.com/im/qt/ds/tmplts/sample.mp3"
        }
      ]
    },
    {
      "id": "2",
      "data": [
        {
          "key": "audio",
          "value": "https://microworkers.com/im/qt/ds/tmplts/sample.mp3"
        }
      ]
    },
    {
      "id": "3",
      "data": [
        {
          "key": "audio",
          "value": "https://microworkers.com/im/qt/ds/tmplts/sample.mp3"
        }
      ]
    },
    {
      "id": "4",
      "data": [
        {
          "key": "audio",
          "value": "https://microworkers.com/im/qt/ds/tmplts/sample.mp3"
        }
      ]
    },
    {
      "id": "5",
      "data": [
        {
          "key": "audio",
          "value": "https://microworkers.com/im/qt/ds/tmplts/sample.mp3"
        }
      ]
    },
    {
      "id": "6",
      "data": [
        {
          "key": "audio",
          "value": "https://microworkers.com/im/qt/ds/tmplts/sample.mp3"
        }
      ]
    },
    {
      "id": "7",
      "data": [
        {
          "key": "audio",
          "value": "https://microworkers.com/im/qt/ds/tmplts/sample.mp3"
        }
      ]
    },
    {
      "id": "8",
      "data": [
        {
          "key": "audio",
          "value": "https://microworkers.com/im/qt/ds/tmplts/sample.mp3"
        }
      ]
    },
    {
      "id": "9",
      "data": [
        {
          "key": "audio",
          "value": "https://microworkers.com/im/qt/ds/tmplts/sample.mp3"
        }
      ]
    },
    {
      "id": "10",
      "data": [
        {
          "key": "audio",
          "value": "https://microworkers.com/im/qt/ds/tmplts/sample.mp3"
        }
      ]
    }
  ]
}

Internal Template - File proof with file type restrictions

Settings:

  • Fixed Task details.
  • 5 initial positions.
  • Search, Click, and Engage Category.
  • I don’t have time to rate positions and would like to assign this to Microworkers Staff. (Admin rate) [5]
  • Worker must upload 2 screenshots as confirmation. File types allowed: JPG, JPEG, GIF, TIFF and PNG.
  • 5 minutes allowed for Worker to complete the position.
  • Allow Workers who failed Microworkers Qualification/Admission test [2] to take position in this Campaign.
  • Worker base earning $0.15 for satisfied position.
  • Allocated time to rate position - 1 day.
  • I want to assign this Campaign to “Favorite” Hire Group (Custom).
  • Each Worker can take 1 position only.
{
  "availablePositions": 5,
  "categoryId": "10",
  "internalTemplate": {
    "id": "T550bd781e36b5",
    "ratingMethodId": 1,
    "adminInstructions": "Company logo must be present on the screenshot provided by Worker.",
    "allowedFileTypes": [
      "jpg",
      "jpeg",
      "gif",
      "tiff",
      "png"
    ],
    "numberOfFileProofs": 2
  },
  "minutesToFinish": 5,
  "title": "Search website in Google",
  "qtRequired": false,
  "description": "Lorem ipsum ac eleifend justo quis blandit congue aliquam, porta himenaeos mattis adipiscing vestibulum tincidunt diam conubia, tellus ut proin luctus viverra nisi turpis felis semper pellentesque sapien praesent netus.",
  "paymentPerTask": 0.15,
  "ttr": 1,
  "groupId": "ioReem0BAhm4",
  "maxPositionPerWorker": 1
}

Internal Template (Spreadsheet) [6]

Settings:

  • Unique Task details.
  • 5 initial positions.
  • Data Mining/Extraction/Collection Category.
  • I want to rate positions myself. (Employer rate) [5]
  • Every position has 2 Tasks which should be displayed in Spreadsheet [6] on same page.
  • 5 minutes allowed for Worker to complete the position.
  • Allow Workers who failed Microworkers Qualification/Admission test [2] to take position in this Campaign.
  • Worker base earning $0.04 for satisfied position.
  • Allocated time to rate position - 1 day.
  • I want to assign this Campaign to “MW: Data Services” Hire Group (Default).
  • Each Worker can take unlimited number of positions.
  • I want to assign each position to 2 unique Workers.
  • Tasks will be allocated to Workers in random order. [4]
{
  "availablePositions": 5,
  "categoryId": "09",
  "internalTemplate": {
    "id": "T56b259b765593",
    "ratingMethodId": 3,
    "displaySubTasksOnSamePage": true,
    "numberOfSubTasks": 2
  },
  "minutesToFinish": 5,
  "title": "Collect university name from URL",
  "qtRequired": false,
  "description": "Lorem ipsum ac eleifend justo quis blandit congue aliquam, porta himenaeos mattis adipiscing vestibulum tincidunt diam conubia, tellus ut proin luctus viverra nisi turpis felis semper pellentesque sapien praesent netus.",
  "paymentPerTask": 0.04,
  "ttr": 1,
  "groupId": "80f83edc0558",
  "maxPositionPerWorker": 0,
  "numberOfWorkerOnSamePosition": 2,
  "taskOrder": 1,
  "tasks": [
    {
      "id": "1",
      "data": [
        {
          "key": "website",
          "value": "http:\/\/www.yundt.com\/laboriosam-ut-inventore-suscipit-iusto-at-dolor-veritatis-eos"
        },
        {
          "key": "name",
          "value": "Hayes Group"
        },
        {
          "key": "employees_name",
          "value": "Rylee Cummerata DVM"
        },
        {
          "key": "employees_email",
          "value": "[email protected]"
        }
      ]
    },
    {
      "id": "2",
      "data": [
        {
          "key": "website",
          "value": "http:\/\/quitzon.com\/non-molestiae-quidem-ea-illo-est"
        },
        {
          "key": "name",
          "value": "Wintheiser LLC"
        },
        {
          "key": "employees_name",
          "value": "Mrs. Maida Pacocha IV"
        },
        {
          "key": "employees_email",
          "value": "[email protected]"
        }
      ]
    },
    {
      "id": "3",
      "data": [
        {
          "key": "website",
          "value": "http:\/\/goodwin.net\/qui-et-est-unde-et-incidunt-maiores.html"
        },
        {
          "key": "name",
          "value": "Barton, Treutel and Legros"
        },
        {
          "key": "employees_name",
          "value": "Amir Bogisich"
        },
        {
          "key": "employees_email",
          "value": "[email protected]"
        }
      ]
    },
    {
      "id": "4",
      "data": [
        {
          "key": "website",
          "value": "http:\/\/block.com\/nisi-inventore-nisi-eos-esse-quia-cum-doloremque"
        },
        {
          "key": "name",
          "value": "Lebsack Group"
        },
        {
          "key": "employees_name",
          "value": "Fletcher Durgan"
        },
        {
          "key": "employees_email",
          "value": "[email protected]"
        }
      ]
    },
    {
      "id": "5",
      "data": [
        {
          "key": "website",
          "value": "http:\/\/www.okeefe.org\/"
        },
        {
          "key": "name",
          "value": "Gleason-Muller"
        },
        {
          "key": "employees_name",
          "value": "Leonardo Keebler I"
        },
        {
          "key": "employees_email",
          "value": "[email protected]"
        }
      ]
    },
    {
      "id": "6",
      "data": [
        {
          "key": "website",
          "value": "http:\/\/klein.com\/incidunt-rerum-adipisci-est-cumque-veritatis-tempora-placeat.html"
        },
        {
          "key": "name",
          "value": "Walker-Bartoletti"
        },
        {
          "key": "employees_name",
          "value": "Greta Schiller"
        },
        {
          "key": "employees_email",
          "value": "[email protected]"
        }
      ]
    },
    {
      "id": "7",
      "data": [
        {
          "key": "website",
          "value": "http:\/\/pacocha.info\/"
        },
        {
          "key": "name",
          "value": "Parker-Gutmann"
        },
        {
          "key": "employees_name",
          "value": "Bud Steuber"
        },
        {
          "key": "employees_email",
          "value": "[email protected]"
        }
      ]
    },
    {
      "id": "8",
      "data": [
        {
          "key": "website",
          "value": "http:\/\/www.king.net\/"
        },
        {
          "key": "name",
          "value": "Will, Schulist and Pacocha"
        },
        {
          "key": "employees_name",
          "value": "Yessenia Hessel"
        },
        {
          "key": "employees_email",
          "value": "[email protected]"
        }
      ]
    },
    {
      "id": "9",
      "data": [
        {
          "key": "website",
          "value": "http:\/\/hand.org\/et-libero-ut-ut-quia-aspernatur-et.html"
        },
        {
          "key": "name",
          "value": "Little LLC"
        },
        {
          "key": "employees_name",
          "value": "Kirsten Gaylord"
        },
        {
          "key": "employees_email",
          "value": "[email protected]"
        }
      ]
    },
    {
      "id": "10",
      "data": [
        {
          "key": "website",
          "value": "http:\/\/schoen.com\/accusantium-qui-qui-quae-id-laboriosam-facilis"
        },
        {
          "key": "name",
          "value": "Dach Ltd"
        },
        {
          "key": "employees_name",
          "value": "Perry Shanahan III"
        },
        {
          "key": "employees_email",
          "value": "[email protected]"
        }
      ]
    }
  ]
}

Internal Template - Amazon SQS Notifications

Settings:

  • Fixed Task details.
  • 30 initial positions.
  • Search, Click, and Engage Category.
  • I want to rate Tasks ASAP. (Employer rate) [5]
  • 5 minutes allowed for Worker to complete the position.
  • Allow Workers who failed Microworkers Qualification/Admission test [2] to take position in this Campaign.
  • Worker base earning $0.10 for satisfied position.
  • Allocated time to rate position - 2 days.
  • I want to assign this Campaign to “MW: Data Services” Hire Group (Default).
  • Each Worker can take 1 position.
  • I want to be notified via Amazon SQS when position is ready for rating and when Campaign is finished.
  • I configured https://sqs.us-east-1.amazonaws.com/12345678/myqueue Queue and granted SendMessage permission to arn:aws:iam::017419115111:user/akanunov.
{
  "availablePositions": 30,
  "categoryId": "10",
  "internalTemplate": {
    "id": "T550bd781e36b5",
    "ratingMethodId": 3
  },
  "minutesToFinish": 5,
  "title": "Search website in Google",
  "qtRequired": false,
  "description": "Lorem ipsum ac eleifend justo quis blandit congue aliquam, porta himenaeos mattis adipiscing vestibulum tincidunt diam conubia, tellus ut proin luctus viverra nisi turpis felis semper pellentesque sapien praesent netus.",
  "paymentPerTask": 0.1,
  "ttr": 2,
  "groupId": "80f83edc0558",
  "maxPositionPerWorker": 1,
  "notificationSettings": [
    {
      "url": "https://sqs.us-east-1.amazonaws.com/12345678/myqueue",
      "type": "sqs",
      "notificationTypes": [
        "CampaignFinished",
        "SlotReadyForRating"
      ]
    }
  ]
}

Internal Template - Maximum jobs per day limit [3]

Settings:

  • Fixed Task details.
  • 50 initial positions.
  • Search, Click, and Engage Category.
  • I want to rate Tasks ASAP. (Employer rate) [5]
  • 5 minutes allowed for Worker to complete the position.
  • Allow Workers who failed Microworkers Qualification/Admission test [2] to take position in this Campaign.
  • Worker base earning $0.10 for satisfied position.
  • Allocated time to rate position - 2 days.
  • I want to assign this Campaign to “MW: Global Users” Hire Group (Default).
  • Each Worker can take 1 position.
  • I want to allow Workers to complete up to 5 positions per day.
{
  "availablePositions": 50,
  "categoryId": "10",
  "internalTemplate": {
    "id": "T550bd781e36b5",
    "ratingMethodId": 3
  },
  "minutesToFinish": 5,
  "title": "Search website in Google",
  "qtRequired": false,
  "description": "Lorem ipsum ac eleifend justo quis blandit congue aliquam, porta himenaeos mattis adipiscing vestibulum tincidunt diam conubia, tellus ut proin luctus viverra nisi turpis felis semper pellentesque sapien praesent netus.",
  "paymentPerTask": 0.1,
  "ttr": 2,
  "groupId": "18f477774339",
  "maxPositionPerWorker": 1,
  "maximumJobLimit": {
    "enabled": true,
    "limitPerDay": 5
  }
}

External Template - fixed task details

Settings:

  • Fixed Task details.
  • 30 initial positions.
  • Search, Click, and Engage Category.
  • I have a website where I prepared Task details page.
  • My website uses HTTPS protocol.
  • My Task details page doesn’t return X-Frame-Options DENY or SAMEORIGIN HTTP header.
  • Task details page will post data back to Microworkers [7].
  • I want to store contact_email parameter value on Microworkers side.
  • 5 minutes allowed for Worker to complete the position.
  • Allow Workers who failed Microworkers Qualification/Admission test [2] to take position in this Campaign.
  • Worker base earning $0.10 for satisfied position.
  • Allocated time to rate position - 1 day.
  • I want to assign this Campaign to “MW: Data Services” Hire Group (Default).
  • Each Worker can take 1 position.
{
  "availablePositions": 30,
  "categoryId": "10",
  "externalTemplate": {
    "url": "https://mywebsite.com/microworkers-task/{{CAMP_ID}}?worker_id={{MW_ID}}&random_key={{RAND_KEY}}",
    "height": "500px",
    "width": "100%",
    "parameters": [
      "contact_email"
    ]
  },
  "minutesToFinish": 5,
  "title": "Find contact email on website",
  "qtRequired": false,
  "description": "Lorem ipsum ac eleifend justo quis blandit congue aliquam, porta himenaeos mattis adipiscing vestibulum tincidunt diam conubia, tellus ut proin luctus viverra nisi turpis felis semper pellentesque sapien praesent netus.",
  "paymentPerTask": 0.1,
  "ttr": 1,
  "groupId": "80f83edc0558",
  "maxPositionPerWorker": 1
}

External Template - unique task details

Settings:

  • Unique Task details.
  • 5 initial positions.
  • Transcription Category.
  • 30 minutes allowed for Worker to complete the position.
  • Disallow Workers who failed Microworkers Qualification/Admission test [2] to take position in this Campaign.
  • Worker base earning $0.50 for satisfied position.
  • Allocated time to rate position - 5 days.
  • I want to assign this Campaign to “MW: English Speaking Countries” Hire Group (Default).
  • Each Worker can take unlimited number of positions.
  • I want to assign each position to 3 unique Workers.
  • Tasks will be allocated to Workers in ascending order. [4]
  • I have a website where I prepared Task details pages.
  • My website uses HTTPS protocol.
  • My Task details pages doen’t return X-Frame-Options DENY or SAMEORIGIN HTTP header.
  • Task details pages will post data back to Microworkers [7].
  • From privacy perspective I don’t want to store any Answers provided by Workers on Microworkers side.
{
  "availablePositions": 5,
  "categoryId": "07",
  "minutesToFinish": 30,
  "title": "Audio Transcription",
  "qtRequired": true,
  "description": "You need to transcript 5 minutes length audio file.",
  "paymentPerTask": 0.5,
  "ttr": 5,
  "groupId": "18f477773330",
  "maxPositionPerWorker": 0,
  "numberOfWorkerOnSamePosition": 3,
  "taskOrder": 2,
  "tasks": [
      {
        "id": "1",
        "data": [
          {
            "key": "URL",
            "value": "https://example.com/4b542222-15ee-11e9-ab14-d663bd873d93?campaign={{CAMP_ID}}&worker={{MW_ID}}&rand_key={{RAND_KEY}}"
          },
          {
            "key": "Height",
            "value": "500px"
          },
          {
            "key": "Width",
            "value": "100%"
          }
        ]
      },
      {
        "id": "2",
        "data": [
          {
            "key": "URL",
            "value": "https://example.com/4b5424fc-15ee-11e9-ab14-d663bd873d93?campaign={{CAMP_ID}}&worker={{MW_ID}}&rand_key={{RAND_KEY}}"
          },
          {
            "key": "Height",
            "value": "500px"
          },
          {
            "key": "Width",
            "value": "100%"
          }
        ]
      },
      {
        "id": "3",
        "data": [
          {
            "key": "URL",
            "value": "https://example.com/4b54284e-15ee-11e9-ab14-d663bd873d93?campaign={{CAMP_ID}}&worker={{MW_ID}}&rand_key={{RAND_KEY}}"
          },
          {
            "key": "Height",
            "value": "500px"
          },
          {
            "key": "Width",
            "value": "100%"
          }
        ]
      },
      {
        "id": "4",
        "data": [
          {
            "key": "URL",
            "value": "https://example.com/4b5429a2-15ee-11e9-ab14-d663bd873d93?campaign={{CAMP_ID}}&worker={{MW_ID}}&rand_key={{RAND_KEY}}"
          },
          {
            "key": "Height",
            "value": "500px"
          },
          {
            "key": "Width",
            "value": "100%"
          }
        ]
      },
      {
        "id": "5",
        "data": [
          {
            "key": "URL",
            "value": "https://example.com/4b542ae2-15ee-11e9-ab14-d663bd873d93?campaign={{CAMP_ID}}&worker={{MW_ID}}&rand_key={{RAND_KEY}}"
          },
          {
            "key": "Height",
            "value": "500px"
          },
          {
            "key": "Width",
            "value": "100%"
          }
        ]
      }
   ]
}

External Template - Amazon SQS Notifications

Settings:

  • Fixed Task details.
  • 7 initial positions.
  • Search, Click, and Engage Category.
  • I have a website where I prepared Task details page.
  • My website uses HTTPS protocol.
  • My Task details page doesn’t return X-Frame-Options DENY or SAMEORIGIN HTTP header.
  • Task details page will post data back to Microworkers [7].
  • I want to store contact_email parameter value on Microworkers side.
  • 5 minutes allowed for Worker to complete the position.
  • Allow Workers who failed Microworkers Qualification/Admission test [2] to take position in this Campaign.
  • Worker base earning $0.10 for satisfied position.
  • Allocated time to rate position - 1 day.
  • I want to assign this Campaign to “MW: English Speaking Countries” Hire Group (Default).
  • Each Worker can take 1 position.
  • I want to be notified via Amazon SQS on any Slot status change.
  • I configured https://sqs.us-east-1.amazonaws.com/12345678/myqueue Queue and granted SendMessage permission to arn:aws:iam::017419115111:user/akanunov.
{
  "availablePositions": 7,
  "categoryId": "10",
  "externalTemplate": {
    "url": "https://mywebsite.com/microworkers-task/{{CAMP_ID}}?worker_id={{MW_ID}}&rand_key={{RAND_KEY}}",
    "height": "500px",
    "width": "100%",
    "parameters": [
      "contact_email"
    ]
  },
  "minutesToFinish": 5,
  "title": "Find contact email on website",
  "qtRequired": false,
  "description": "Lorem ipsum ac eleifend justo quis blandit congue aliquam, porta himenaeos mattis adipiscing vestibulum tincidunt diam conubia, tellus ut proin luctus viverra nisi turpis felis semper pellentesque sapien praesent netus.",
  "paymentPerTask": 0.1,
  "ttr": 1,
  "groupId": "18f477773330",
  "maxPositionPerWorker": 1,
  "notificationSettings": [
    {
      "url": "https://sqs.us-east-1.amazonaws.com/12345678/myqueue",
      "type": "sqs",
      "notificationTypes": [
        "SlotReadyForRating",
        "SlotRemoved",
        "SlotLocked",
        "SlotRevised",
        "SlotLockExpired",
        "SlotReviseRequested",
        "SlotLockReleased",
        "SlotSatisfied"
      ]
    }
  ]
}
[1]Multiple Workers In One Task Microworkers Blog.
[2]“QT Optional” Feature Microworkers Blog.
[3]Max Positions per Day Microworkers Blog.
[4]Display Tasks in Random, Collect Organized Results Microworkers Blog.
[5]Checking and Rating Submitted Tasks on TTV Microworkers Blog.
[6]Default Spreadsheet Templates Microworkers Blog.
[7]Submit Proof URL For External Template Campaign.