# Tapsell Developers — Full Documentation
> Generated from https://developer.tapsell.ir. 170 pages.
---
# Getting Started
Source: https://developer.tapsell.ir/docs
Section: Documentation
Tapsell provides you a SDK so that you can easily use Tapsell with any type of application you have, easily implement the
Tapsell SDK in your application and earn money from ads.
Tapsell's publisher relations team is also with you from the very
beginning of the Tapsell SDK implementation to help you achieve the maximum advertising capacity without harming the user
experience and get the most profit from ads by optimally implementing the SDK.
:::success Documentations
- [Publishers docs](publishers)
- [Advertisers docs](advertisers)
:::
---
# FAQ
Source: https://developer.tapsell.ir/docs/advertisers/faq
Section: Documentation
# FAQ
---
# Getting Started
Source: https://developer.tapsell.ir/docs/advertisers/intro
Section: Documentation
# Getting Started
---
# Playable ads
Source: https://developer.tapsell.ir/docs/advertisers/playable
Section: Documentation
Playable ads are interactive ads that allow users to interact with—or play with—the core functionality of an app or game,
like a free demo. Users get to experience an app, product, or game before they commit to downloading or purchasing it.
### Upload Playable Script
First, you need to create an `index.html` file in your project according to the structure below.
Then, **[download](https://cdn.tapture.ir/tapsell/app/frontend/playable/tapsell-playable.js) `tapsell-playable.js` script** and add it to your project.
Finally, enter its path in the script tag as shown below to ensure optimal access to Tapsell functions.
```html
```
According to the code above, the `start`, `pause`, and `resume` functions are called by the Tapsell SDK,
and you can implement the relevant content in each of them:
- **`start`**: This function is called when the content of your desired ad is ready to be displayed.
Therefore, you need to begin displaying your content in this function.
- **`pause`**: This function is called when the content of your desired ad has been paused.
In this function, you should deactivate any audio content that is currently playing.
- **`resume`**: This function is called when the content of your desired ad is resumed.
Failure to implement any of the above functions may result in the ad not being displayed or experiencing disruptions.
### Show Ad
To show ad, you need to call the following function:
```js
window.PLAYABLE.isReady()
```
By calling this function, the Tapsell SDK will invoke the `start` function you have implemented above,
and your ad will be displayed. Therefore, failing to call this function will result in the ad not being displayed.
### Click
To click on ad, you need to call the following function:
```js
window.PLAYABLE.click();
```
### Destroy Ad
When the user clicks on the close button of the banner, this function needs to be called.
```js
window.PLAYABLE.close()
```
### Publish
After implementation, you need to send your project to us in the form of a `zip` file.
---
# FAQ
Source: https://developer.tapsell.ir/docs/advertisers/retargeting/faq
Section: Documentation
## General Questions
**Q1: What is the Retargeting Script?**
A: The Retargeting Script is a JavaScript library that helps you track user interactions on your website, such as clicks and form submissions, and trigger retargeting tags for advertising purposes.
**Q2: How do I install the script?**
A: Add the script script to your website and configure tag IDs with CSS selectors for the elements you want to track. See the [Installation Guide](#installation) for details.
**Q3: Is the script compatible with all browsers?**
A: The script works on all modern browsers that support standard JavaScript, including Chrome, Firefox, Edge, and Safari.
---
## Tag and Tracking
**Q4: What is a tag ID?**
A: A tag ID is a unique identifier for a specific action or conversion you want to track. It tells the script which retargeting tag to fire when the user interacts with a defined element.
**Q5: How do I find the CSS selector for an element?**
A: Inspect your page using developer tools (right-click → Inspect) and find the class or ID of the element. Use `.classname` for classes and `#idname` for IDs in your `css_selector`.
**Q6: Can I track multiple elements on the same page?**
A: Yes. Simply add multiple objects in the `window.retargetingTags` array with different tag IDs and CSS selectors.
---
## Troubleshooting
**Q7: The script isn’t firing. What should I check?**
A:
- Make sure the script is included **before the closing `` tag**.
- Verify that `{adviserId}` is correctly replaced with your adviser ID.
- Ensure the CSS selector matches an element on your page.
**Q8: Tags are not triggering on clicks.**
A:
- Check that the element exists when the page loads.
- For dynamically loaded elements (e.g., via AJAX), use a MutationObserver to ensure the script can detect them.
**Q9: Can I use the script with a single-page application (SPA)?**
A: Yes, but you may need to manually reinitialize the script or trigger tag checks after page route changes.
---
# Installation
Source: https://developer.tapsell.ir/docs/advertisers/retargeting/installation
Section: Documentation
To install the Retargeting Script on your website, follow these steps:
## 1. Add the script
Paste the following snippet **before the closing `` tag** on your pages:
```html