> For the complete documentation index, see [llms.txt](https://developer.prodege.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.prodege.com/surveys-feed/api-reference/panelist-matching/survey-url.md).

# Survey URL

Pass data into the survey entry URL

### Profile Data

In addition to updating profile data for a VPID via /update-user (see Update Panelist), panelist profiles can also be updated by passing the data into the survey URL (/survey-click) after the hsh param.

Profile data can be passed into separate URL params for each question where the param name is “q“ + the question\_id and the value is the option\_id as referenced in [/lookup­-question-­by-­country](https://www.prodege.com/prodegemrapi/?section=lookup-questions-by-countryid). For example, when attempting to pass a response to the Gender profile question (question\_id 3) as Male (option\_id 1), it should be passed as q3=1.

[`https://www.prsrvy.com/g/survey-click?projectid=123456789&sourceid=12345&vpid=987654321&cpi=1.05&hsh=123654789654123ytrewq&`<mark style="color:yellow;">`q3=1`</mark>](#user-content-fn-1)[^1]

Profile data for multi-select questions should be passed as comma-separated option\_ids. For example, when attempting to pass a response to the Language profile question (question\_id 20) as English (option\_id 1) and Spanish (option\_id 2), it should be passed as q20=1,2.

[`https://www.prsrvy.com/g/survey-click?projectid=123456789&sourceid=12345&vpid=987654321&cpi=1.05&hsh=123654789654123ytrewq&q3=1&`<mark style="color:yellow;">`q20=1,2`</mark>](#user-content-fn-1)[^1]

You can add as much profile data to the survey URL as you’d like.

### Identity Data

In addition to profile data, identity attributes may be passed through the survey URL (/survey-click) and stored for the panelist.

| Parameter Name         | Required    | Description                                                                   |
| ---------------------- | ----------- | ----------------------------------------------------------------------------- |
| hashed\_email\_address | No          | Panelist email address, converted to lowercase and then hashed using SHA-256. |
| mobile\_ad\_id         | No          | Mobile advertising identifier for the panelist.                               |
| mobile\_ad\_id\_type   | Conditional | Required when `mobile_ad_id` is provided. Valid values: `gaid`, `idfa`.       |

**Validation Rules**

* `mobile_ad_id_type` is required whenever `mobile_ad_id` is provided.
* Valid values for `mobile_ad_id_type` are:
  * `gaid` (Google Advertising ID)
  * `idfa` (Apple Identifier for Advertisers)

### Appending pass-through variables

You can pass whatever you wish to the end of the surveyurl, and we’ll return it upon survey completion in the following format:&#x20;

[`https://www.prsrvy.com/g/survey-click?projectid=123456789&sourceid=12345&vpid=987654321&cpi=1.05&hsh=123654789654123ytrewq&q3=1&`](#user-content-fn-1)[^1][<mark style="color:yellow;">`var1=12345&var2=67890`</mark>](#user-content-fn-1)[^1]

<br>

<br>

[^1]:
