> For the complete documentation index, see [llms.txt](https://docs.tyrads.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tyrads.com/publishers-integrations/postback-macros.md).

# Postback Macros

Within this page we will share the publisher postbacks that can be implemented within the Tyr Tracking system so that you can receive postback from our system.

We have the following macro's available for use for our publishers.

<table data-full-width="false"><thead><tr><th width="254.02083333333334">Parameter</th><th>Data Type</th><th>Description</th></tr></thead><tbody><tr><td><code>conversion_status</code></td><td>enum</td><td>The status of conversion. Enum: <code>approved</code>, <code>rejected</code>, <code>flagged</code></td></tr><tr><td><code>conversion_type</code></td><td>enum</td><td>Indicates specific identifier of the conversion. Enum: <code>install</code>, <code>event</code>, <code>rewardedPlay</code></td></tr><tr><td><code>cost</code> <sup><strong>*Recommended</strong></sup></td><td>decimal</td><td>The payout amount you earn from Tyrads in U.S. Dollars.</td></tr><tr><td><code>user_payout_amount</code></td><td>decimal</td><td>The payout amount the user earn from Tyrads in U.S.Dollars.</td></tr><tr><td><code>timestamp</code></td><td>integer</td><td>The UNIX timestamp of the conversion</td></tr><tr><td><code>publisher_user_id</code> <sup><strong>*Mandatory</strong></sup></td><td>string</td><td>The unique user id from the publisher used to identify the user, also used for user validation and also as reference point for support ticket</td></tr><tr><td><code>conversion_id</code><sup><strong>*Recommended</strong></sup></td><td>integer (format: <code>int64</code>)</td><td>The unique conversion ID can be used for deduplication if the <code>conversion_type</code> is either<code>install</code> or <code>event</code>.</td></tr><tr><td><code>postback_id</code></td><td>integer (format: <code>int64</code>)</td><td>The unique postback ID can be used for deduplication.</td></tr><tr><td><code>app_name</code></td><td>string</td><td>The name of the app</td></tr><tr><td><code>event_name</code></td><td>string</td><td>The name of a specfic event <code>(e.g. Complete%20Chapter%201%20level%2051)</code></td></tr><tr><td><code>event_identifier</code></td><td>string</td><td>The identifier for a specific event <code>(e.g. pass_level_11051)</code> </td></tr><tr><td><code>app_event_id</code><sup><strong>*Recommended</strong></sup></td><td>integer</td><td>This is a placeholder that can be used for unique identifier associated with an event that occurs within the mobile app</td></tr><tr><td><code>sub2</code></td><td>string</td><td>This is a placeholder, can be used for any value you want and can be used to send to us on the click.</td></tr><tr><td><code>sub3</code></td><td>string</td><td>This is a placeholder, can be used for any value you want and can be used to send to us on the click.</td></tr><tr><td><code>sub4</code></td><td>string</td><td>This is a placeholder, can be used for any value you want and can be used to send to us on the click.</td></tr><tr><td><code>campaign_id</code><sup><strong>*Recommended</strong></sup></td><td>integer</td><td>This parameter is the actual campaign identifier when the tracking URL is triggered</td></tr><tr><td><code>event_value</code></td><td>integer</td><td>This parameter is USD value for Purchase and AdWatch</td></tr><tr><td><code>publisher_click_id</code></td><td>string</td><td>The unique id from the publisher used to identify the specific click</td></tr></tbody></table>