# nats\_encode

*Article Topics:* [*Smarty*](https://docs.toomuchmedia.com/getting-started/common-topics/smarty)*,* [*Customization*](https://docs.toomuchmedia.com/getting-started/common-topics/customization)

## **Parameters**

(*Required parameters in **bold**)*

| Parameter                                                                                                                                 | Description                                                                                     | Possible Values                            | Default Value                                          | Example                |
| ----------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- | ------------------------------------------ | ------------------------------------------------------ | ---------------------- |
| programid                                                                                                                                 | The [program](https://docs.toomuchmedia.com/additional-resources/common-terms#program) number   | Any valid program number.                  | The default program ID number                          | programid="123"        |
| campaign                                                                                                                                  | The [campaign ](https://docs.toomuchmedia.com/additional-resources/common-terms#campaign)number | Any valid campaign number.                 | The default campaign ID number                         | campaign="123"         |
| siteid                                                                                                                                    | The [site](https://docs.toomuchmedia.com/additional-resources/common-terms#site) number         | Any valid site number.                     | The default site ID number                             | siteid="123"           |
| tourid                                                                                                                                    | The [tour](https://docs.toomuchmedia.com/additional-resources/common-terms#tour) number         | Any valid site number                      | No tour number                                         | tourid="123"           |
| adtoolid                                                                                                                                  | The [ad tool's](https://docs.toomuchmedia.com/additional-resources/common-terms#ad-tool) number | Any valid adtool number                    | No adtool number                                       | adtoolid="123"         |
| subid1                                                                                                                                    | First optional tracking number.                                                                 | Any valid tracking number.                 | Doesn't use a tracking number                          | subid1="123"           |
| subid2                                                                                                                                    | Second optional tracking number.                                                                | Any valid tracking number                  | Doesn't use a tracking number                          | subid2="123"           |
| userid                                                                                                                                    | The affiliate's I.D. number (loginid)                                                           | Any valid affiliate I.D. number            | No affiliate                                           | userid="123"           |
| url                                                                                                                                       | If set, output contains an fully-qualified URL instead of just the linkcode.                    | 0 or 1 (exclusive).                        | Not set; doesn't create a banner link.                 | url="1"                |
| banner                                                                                                                                    | If set, creates a banner link.                                                                  | 0 or 1 (exclusive)                         | Not set; doesn't create banner link.                   | banner="1"'            |
| unencoded                                                                                                                                 | If set, overrides the affiliate default encoding                                                | 0 (encoded) or 1 (unencoded) - (exclusive) | Not set; outputs affiliate default version of linkcode | unencoded="1"          |
| [assign](https://docs.toomuchmedia.com/nats-admin/skins-and-templates/further-reading/template-function-parameters/assign)                | Store output in this variable                                                                   | Any valid Smarty variable name             | *See output section below*                             | assign="my\_var"       |
| [assign\_prefix](https://docs.toomuchmedia.com/nats-admin/skins-and-templates/further-reading/template-function-parameters/assign_prefix) | Prefix output variables with this word. (Click link for details)                                | Any valid Smarty variable name             | *None.* (No prefix is used)                            | assign\_prefix="myvar" |

## Note

To create an array of linkcodes, please see the [nats\_list\_linkcodes](https://docs.toomuchmedia.com/nats-admin/skins-and-templates/further-reading/template-functions/nats_list_linkcodes) page.

## Example

```
URL?nats={nats_encode userid=$toid program=# site=# tourid=# }{$encoded}
```

Outputs a linkcode. For example: [www.examplesite.com?nats=MS4yLjMuNS4wLjAuMC4wLjA](http://www.examplesite.com?nats=MS4yLjMuNS4wLjAuMC4wLjA). *userid =$toid* encodes the link specifically for the affiliate that the email is sent to. The linkcode is also placed in the variable, {$encoded}.

## Related Articles 

{% content-ref url="nats\_decode" %}
[nats\_decode](https://docs.toomuchmedia.com/nats-admin/skins-and-templates/further-reading/template-functions/nats_decode)
{% endcontent-ref %}