Advertiser Integration

The Encore SDK allows you to track conversions when users from Encore-integrated apps complete offers on your website. When users successfully complete your offers, you’ll be credited for the conversion.

How it works

Users discover your offers in Encore-integrated apps
Users click through to your website with a special tracking token
Your website loads our SDK to activate the tracking session
When users complete your offer, the SDK records the conversion

You’ll need two things: the JavaScript SDK included on your offer pages (frontend integration), and your own completion validation to verify users actually completed your offer before recording the conversion.

Quick start

Add the SDK to your landing pages

Include the Encore SDK on pages where users from Encore-integrated apps will land (your offer pages, sign-up pages, etc.).

HTML script tag
React (dynamic loading)

<!DOCTYPE html>
<html>
<head>
  <title>Your Offer Page</title>
</head>
<body>
  <!-- Your page content -->

  <!-- Include Encore SDK -->
  <script src="https://encore.joinyaw.com/encore-advertiser-sdk.js"></script>
  <script>
    document.addEventListener('DOMContentLoaded', async () => {
      await EncoreSDK.activateSession();
    });
  </script>
</body>
</html>

import { useEffect } from 'react';

function OfferPage() {
  useEffect(() => {
    // Dynamically load Encore SDK
    const script = document.createElement('script');
    script.src = 'https://encore.joinyaw.com/encore-advertiser-sdk.js';
    script.async = true;

    script.onload = async () => {
      await window.EncoreSDK.activateSession();
    };

    document.body.appendChild(script);

    return () => {
      document.body.removeChild(script);
    };
  }, []);

  return (
    <div>
      {/* Your offer page content */}
    </div>
  );
}

Add conversion tracking to your success pages

Add conversion tracking to your success/confirmation pages where users complete your offer.

HTML script tag
React (dynamic loading)

<!DOCTYPE html>
<html>
<head>
  <title>Success - Thank You!</title>
</head>
<body>
  <!-- Your success page content -->
  <h1>Thank you for completing our offer!</h1>

  <!-- Include Encore SDK -->
  <script src="https://encore.joinyaw.com/encore-advertiser-sdk.js"></script>
  <script>
    document.addEventListener('DOMContentLoaded', async () => {
      // Verify the user actually completed your offer
      const completionValid = await verifyOfferCompletion();

      if (!completionValid) {
        return; // Skip tracking if offer wasn't completed
      }

      // Record the conversion
      await EncoreSDK.recordCompletion(window.location.href);
    });

    // Replace with your actual completion validation logic
    async function verifyOfferCompletion() {
      // Examples:
      // - Check if purchase order exists and is paid
      // - Verify user account was created successfully
      // - Confirm subscription is active
      // - Check that required form was submitted

      return true; // Replace with your validation
    }
  </script>
</body>
</html>

import { useEffect } from 'react';

function SuccessPage() {
  useEffect(() => {
    const script = document.createElement('script');
    script.src = 'https://encore.joinyaw.com/encore-advertiser-sdk.js';
    script.async = true;

    script.onload = async () => {
      // Verify completion
      const completionValid = await verifyOfferCompletion();

      if (!completionValid) return;

      // Record conversion
      await window.EncoreSDK.recordCompletion(window.location.href);
    };

    document.body.appendChild(script);

    return () => {
      document.body.removeChild(script);
    };
  }, []);

  // Replace with your actual completion validation
  async function verifyOfferCompletion() {
    // Your validation logic here
    return true;
  }

  return (
    <div>
      <h1>Thank you for completing our offer!</h1>
      {/* Your success page content */}
    </div>
  );
}

Completion validation: always verify users actually completed your offer before calling recordCompletion().
Token detection: the SDK automatically detects Encore users via URL parameters; no additional configuration needed.

​How it works

​Quick start

How it works

Quick start