# Sandbox Identifier

## Why you should utilize Sandbox Identifiers

A Sandbox Identifier is basically an external identifier (a User ID) that you define. Appending or passing this identifier to the offerwall will trigger the offerwall to run in sandbox mode.

Sandbox Identifiers will help you to test the offerwall across multiple devices and in different GEOs for certain predefined "Identifiers".

{% hint style="info" %}
Using Sandbox Identifiers for testing helps you to avoid triggering any of the ayeT-Studios Fraud Prevention Checks that would block your device from accessing the offerwall.
{% endhint %}

## Defining Sandbox Identifiers

Click on <mark style="color:red;background-color:red;">Edit Placement</mark> in the ayeT-Studios Publisher Dashboard and enter a identifier of your choice for the <mark style="color:red;background-color:red;">Sandbox Identifiers</mark> feature.

In the example below, the sandbox identifier is set to <mark style="color:blue;background-color:blue;">testuser123</mark>.

You can enter several identifiers if needed to make it easer to test with different devices and in different GEOs across your team.

![](/files/6QukEj4VFSwj2TJS7Wfs)

## Triggering a Test Callback

Now that the sandbox identifier is set, you have to pass the sandbox identifier to your Offerwall AdSlot that you want to test.

{% hint style="info" %}
**Note:** If you passed the sandbox identifier correctly, your offerwall will show three test offers (see screenshot below).
{% endhint %}

In the example below, the <mark style="color:blue;background-color:blue;">testuser123</mark> was passed to a Web Offerwall AdSlot. The offerwall now shows three test offers.

![](/files/U9FdYqyuHKDxJSFOxi2y)

Clicking on one of the test offers will show a detail modal with more instructions.

Clicking on the Earn Button will trigger a test callback.

![](/files/WJyprqyUqKKizM8CNS4r)

Once you clicked on an offer, you can see the click ID and additional conversion details. In this case, a test callback with 200 in virtual currency and $0.2 in USD payout was triggered.

You can also see the transaction ID and a describtion where to find more details for the callback in the ayeT-Studios dashboard.

![](/files/gmwP5qiY86INdVHpbwXR)

## Checking the Test Callback

If you navigate to <mark style="color:red;background-color:red;">Reports / Conversions</mark> in the ayeT-Studios dashboard, you are able to find the test postback with your sandbox identifier that you just triggered.

{% hint style="info" %}
**Note:** Sandbox offer conversions will generate regular callbacks with fake payouts and user currency.

<mark style="color:red;">`&is_sandbox=1`</mark> is appended to every callback url to easily allow discarding test conversions.
{% endhint %}

If you click on <mark style="color:red;background-color:red;">Details</mark> for the test callback, you are able to see all details for the test callback.

![](/files/rWrXSwW1bTGMCFb1hJgy)

The Callback Details show a list of available macros and information as well as the callback URL that was triggered, including the <mark style="color:red;background-color:red;">is\_sandbox=1</mark> macro to identifiy the callback as a test.

![](/files/j3ST3o3L2ttjpth293Fd)

{% hint style="info" %}
If your callback URL is missing information, please navigate to placements and edit your callback URL by adding additional callback macros.
{% endhint %}

To see a list of available callback macros, please go to the following section:

{% content-ref url="/pages/4uQiMxtgnAayAHR8ZeXt" %}
[Offerwall Callbacks](/v/product-docs/callbacks-and-testing/callbacks/offerwall-callbacks.md)
{% endcontent-ref %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.ayetstudios.com/v/product-docs/callbacks-and-testing/testing/sandbox-identifier.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.