🛠️ AppLixir Integration FAQ

Getting Started & Setup

• Which platforms does AppLixir support?

  • AppLixir supports HTML5 Web, iOS, and Android (including Unity WebGL and mobile wrappers).

• How do I start the integration?

  • Sign up at AppLixir.com, register your site/app, and download the specific SDK for your platform.

• What is the **ads.txt** file and why is it mandatory?

  • It is a text file you must host on your root domain to prove you are authorized to sell the ad space. Without a correctly updated ads.txt file, ads will not serve.

Technical Execution

• What JS function do I call to show a video?

  • You typically use the invokeApplixirVideoUnit(options) function after initializing the SDK.

• Can I check if an ad is available before trying to play it?

  • Yes, you can use the API to check availability to avoid showing a "Watch Ad" button when no inventory is present.

• How do I handle the ad completion?

  • You must set up a callback function. This function is triggered when the ad ends, allowing you to programmatically grant the reward to the user.

Server & Security

• What is a Server-to-Server (S2S) Callback?

  • This is a secure way to notify your backend server directly when a reward is earned, preventing users from "hacking" the client-side code to get free rewards.

• Can I test ads on **localhost**?

  • Yes, but specific configurations are often required for the ad server to recognize a local environment.

• How do I filter out specific types of ads?

  • Ad filtering is usually handled via your AppLixir dashboard settings rather than directly in the code.

Troubleshooting & Testing

• Why am I seeing "No Ads VAST Response" (Error 303)?

  • This usually means there is no current ad inventory available for that user's specific region or device at that moment.

• How do I test without affecting my live revenue?

  • The SDK includes a "Test Mode" or "Debug" flag. In Unity, for example, you can set a Debug Play result to simulate success/failure during development.

• What is the behavior when no videos are available?

  • The SDK will trigger the callback with a specific status (usually false or no-ad), allowing you to hide the ad prompt or show an "Unavailable" message.

---

Integration Workflow Overview

1. Initialize: Load the SDK and ads.txt.

2. Invoke: Call the video unit when the user clicks "Reward."

3. Callback: Receive notice that the video reached the 25–100% mark.

4. Reward: Update the user's balance in your database.

Would you like me to provide the specific code snippets for any of these steps (e.g., the JavaScript function or the S2S callback setup)?