🧭 1. Find Your Client’s Pixel UUID

To generate a tracking pixel, follow these steps:

Go to agencies.audiohook.com and log in

From the Clients List, click your client’s name

This will open a new tab at app.audiohook.com in the advertiser view

Go to the Account Details section

Copy the Basic Pixel Code — this contains your client’s unique ID (UUID)

🔐 Reminder: You must create a separate Audiohook account for each client. This ensures reporting and event tracking stays client-specific.

📌 2. Pixel Types You Can Provide to Clients

✅ Pageview Pixel (Recommended for All Clients)

Use this to track visitors and attribute impressions. This pixel should be placed on all pages that the advertiser wants to measure traffic on:

<img src="https://listen.audiohook.com/{{COMPANY-ID}}/pixel.png?type=pageview" style="display: none;">

Replace:

{{COMPANY-ID}} with the UUID from the client’s Account Details

🧩 Optional: Event-Based Pixels

If your client has a specific action or conversion goal (like purchases, leads, signups, etc.), you can also provide a custom event pixel.

<img src="https://listen.audiohook.com/{{COMPANY-ID}}/pixel.png?type={{EVENT-TYPE}}&order={{UNIQUE-ID}}&value={{AMOUNT}}" style="display: none;">

Custom Event Guidelines:

type is the event name (e.g., purchase, signup, booking, lead)

order is an optional unique identifier for that action (e.g., transaction or submission ID)

value is the dollar amount of the action (optional)

⚠️ Important: Do not use spaces in custom event names. Use lowercase and underscores or hyphens if needed (e.g., newsletter_signup, booking-confirmation).

🧱 Placement Best Practices

✅ All pixel tags should be added within the <body> of the page

🚫 Do not place them inside the <head> — some browsers may prevent the image from loading

📍 For event-based pixels, install them on the confirmation or success page for that action

🔎 Verifying Events

As an agency, you can verify that pixels are firing by:

Logging into the advertiser account at app.audiohook.com

Going to Events > Pixel

Check for successful pageview and custom event fires

Confirm parameters like order and value if included

📋 Example Scenarios

Client Type	Pixel Usage
Awareness-only brand	Use only the `pageview` pixel
Lead gen client	Add a `lead` pixel on form success
Ecommerce brand	Add a `purchase` pixel on checkout. Recommend including order and value parameters
Booking service	Add a `booking` pixel to confirmation page. Recommend including order (and if applicable value) parameters

Implementing via POST Request

The Audiohook Pixel allows advertisers to track and measure the performance of their audio campaigns. While the basic implementation is typically done via client-side GET requests, you can also implement it server-side using POST requests.

Server-side Implementation

Server-side implementation requires passing parameters in the request body. The mandatory parameters include:

ip_address: Hashed IP address of the user.

ua: User Agent String (encoded) of the user.

type: event type to track in reporting (ie. pageview, purchase, booking, etc)

Here's an example using curl:

curl -X POST https://listen.audiohook.com/unique-advertiser-specific-uuid/pixel.png \
-H "Content-Type: application/json" \
-d '{"ip_address": %%hashed_user_ip_address%%, "ua": %%user_agent_string%%, "type": "pageview"}'

Optional Parameters

You can include additional parameters as needed:

order: %%order_id%% (Order ID)

value: %%value_of_purchase_usd%% (Value of purchase in USD)

userid: %%anonymous_1st_party_user_id%% (Anonymous 1st party user ID)

session: %%current_session_id%% (Current session ID)

referralurl: %%url_of_previous_page%% (URL of previous page)

Regardless of the programming language used (e.g., Python, Java), ensure the parameters are correctly encoded and passed in the POST request body.

How to Verify Client Pixel

1. Login to your client’s Audiohook advertiser account at https://app.audiohook.com. To check pixel events fired click "Pixel"

2. Events can either be displayed as charts or click "Start Pivot" to switch to a table view

3. Drag "Type" into the rows field

4. View the daily breakout by type by clicking the drop down

5. Compare the breakout to what client has for visitors to the pages that have the associated pixel type. Export the data if needed.

6. For purchases or other events with values associated, check that the total number of events and the total value matches the purchase events the client shows have occurred.

7. Hover over a number when they are large enough to get abbreviated to see the full value

8. Look for errors with the type name and correct or remove pixels to avoid unnecessary signals. In the example below, there is a valid pageview pixel and a pixel that was entered incorrectly

9. Click on the event type in the Chart style view to filter and see details. As seen in this screenshot, the pixel type has since been discontinued and is no longer firing

Audiohook Pixel Instructions for Agencies