Binom Actions

​

Overview

AffZero provides a full suite of actions for Binom self-hosted trackers, covering campaigns, landing pages, offers, rotations, and paths. These let you view and update your Binom configuration without logging into the Binom interface directly. All Binom actions require a configured Binom connection.

---

​

Campaign Actions

​

Get Campaign

Retrieve the basic details of a campaign by its numeric Binom campaign ID. Returns: Campaign name, domain, redirect type, postback settings, and status. Parameters: Campaign ID (required)

​

Get Campaign (Full)

Retrieve the complete campaign configuration including all routing paths and rules. Results are shown in a structured hierarchical view (Campaign > Rotation > Paths > Landings/Offers > Rules), with a toggle to switch to raw JSON. Returns: Everything from Get Campaign, plus the full path structure — all landings, offers, weights, and routing conditions assigned to each path. Use this when: You need to understand the full traffic routing logic before making changes, or when troubleshooting an unexpected routing behavior. Parameters: Campaign ID (required)

​

Get Campaign Path

Retrieve a complete campaign path (its landing pages and offers) by looking up the campaign by name. Returns: The path structure for the matching campaign — landings, offers, weights. Parameters: Campaign name (required, partial match supported)

​

Edit Campaign

Update a campaign’s core settings. Click Load Campaign to fetch current values and pre-fill all fields before editing. Editable fields: Parameters: Campaign ID (required) → Load Campaign → modify fields → Execute

---

​

Landing Page Actions

​

Get Landing Page

Retrieve details for a specific landing page by its Binom ID. Returns: Landing page name, URL, weight, and status. Parameters: Landing page ID (required)

​

Get All Landing Pages

Retrieve a list of all active landing pages in your Binom tracker. Returns: Full list with IDs, names, and URLs — useful for finding the ID of a landing page before editing it. Parameters: None

​

Edit Landing Page

Update a landing page’s settings. Click Load Landing to fetch current values and pre-fill all fields before editing. Editable fields: Parameters: Landing page ID (required) → Load Landing → modify fields → Execute

---

​

Offer Actions

​

Get Offer

Retrieve details for a specific offer in Binom by its ID. Returns: Offer name, URL, geo targeting, group, and payout settings. Parameters: Offer ID (required)

​

Get All Offers

Retrieve a list of all active offers in your Binom tracker. Returns: Full list with IDs, names, and URLs. Parameters: None

​

Edit Offer

Update an offer’s settings in Binom. Click Load Offer to fetch current values and pre-fill all fields before editing. Editable fields: Parameters: Offer ID (required) → Load Offer → modify fields → Execute

---

​

Rotation Actions

​

Get Full Rotation

Retrieve the complete configuration of a rotation (Binom’s traffic distribution feature) including all paths, landings, offers, and routing rules. Results are shown in a structured hierarchical view, with a toggle to switch to raw JSON. Returns: Rotation name, type, all paths with their landings (name, type, split, status), offers (name, geo, network, payout, split, status), and rules with criteria and nested paths. Loading mode: Use the segmented toggle to switch between loading by Rotation ID or Campaign ID — only one mode is active at a time. Parameters: Rotation ID or Campaign ID (one is required, selected via toggle)

​

Edit Rotation

Update a rotation’s name and type. Use the segmented toggle to choose whether to look up the rotation by Rotation ID or Campaign ID, then click Load Rotation to pre-fill current values. Editable fields: Parameters: Rotation ID or Campaign ID (selected via toggle) → Load Rotation → modify fields → Execute

​

Manage Rotation — Unified Campaign Editor

The most interactive Binom action — a unified hierarchical editor for viewing and adjusting an active campaign/rotation’s traffic distribution. What you can do:

• Load by Campaign ID (shows campaign basics + full rotation) or Rotation ID using the segmented toggle
• Edit campaign basics (name, status) inline when loaded by Campaign ID, saved independently via campaign_edit
• See the full Campaign > Rotation > Main Paths > Landings/Offers hierarchy
• See Rules with criteria summaries and their nested paths (expandable)
• Pause or enable individual offers and landings within any path (main or rule) with a single click
• Adjust split weights between offers and landings in real time
• Add new offers to any path (main or rule) from your full offer list — searchable by name, ID, or geo
• See instant weight validation (should sum to 100 per path)
• Click Save Rotation to write the full updated routing (including rule path changes) back to Binom

Use this for:

• Real-time optimization of a running campaign
• Quickly pausing a low-performing offer without touching anything else
• Shifting budget/weight to a top performer
• Adding a new offer directly into a running rotation path
• Adjusting rule path weights or toggling offer/landing status within rules

Parameters: Campaign ID or Rotation ID (selected via toggle) → Load → edit → Save Rotation

---

​

Routing Path Actions

​

Get Path

Retrieve basic details for a specific routing path by its Binom path ID. For a full view of path contents including offers and landings, use Manage Rotation. Returns: Path name, split weight, rule flag, and status. Parameters: Path ID (required)

​

Edit Path

Update a routing path’s basic settings. Click Load Path to fetch current values and pre-fill all fields before editing. For managing offers, landings, and weights within a path, use Manage Rotation which provides a full visual editor. Editable fields: Parameters: Path ID (required) → Load Path → modify fields → Execute

---

​

Update Costs

Update the traffic costs for a Binom campaign by time period. Useful for:

• Recording ad spend after importing traffic
• Keeping ROI calculations accurate in Binom reporting
• Updating costs after reconciling a traffic source invoice

Parameters:

---

​

Bulk Cost Update

Update costs for multiple campaigns at once in a single action. Internally, AffZero runs the full three-step cost update sequence for each campaign and returns a per-campaign result summary. Useful for:

• Reconciling ad spend across many campaigns after a traffic run
• Running cost updates as part of an automated workflow driven by AI analysis
• Updating costs for a batch of campaigns without manually repeating the single Update Costs action

Parameters: Response: A summary with total, updated, failed, and a results array showing each campaign’s outcome and job ID.

---

​

Tips for Binom Users

• Load before Edit — all Edit actions (Campaign, Rotation, Landing, Offer, Path) have a Load button that fetches current values and pre-fills the form. Use it to confirm what you’re changing before executing.
• Single-mode toggle — Get Full Rotation, Edit Rotation, and Manage Rotation use a segmented toggle to choose between Rotation ID and Campaign ID. Only one is active at a time — no confusion about which field to fill.
• Structured views — Get Full Rotation and Get Campaign (Full) show results in a structured hierarchical view (Campaign > Rotation > Paths > Landings/Offers > Rules), with a toggle to see the raw JSON.
• Manage Rotation is the unified editor — it handles the full hierarchy: campaign basics, rotation, main paths, rule paths, landings, and offers. Use it as the central place for routing edits.
• Rules are viewable and editable — in Manage Rotation, rules show their criteria summary and can be expanded to reveal nested paths. You can toggle offer/landing status and adjust weights within rule paths.
• Get All Landing Pages / Get All Offers are useful reference actions — run them first to build a mental map of your tracker’s contents and find IDs.
• Add Offer — click the + Add Offer button inside any path (main or rule) to pick from your full offer list (searchable by name, ID, or geo) and add it to the rotation in a single action.
• Path Get/Edit are lightweight standalone tools for basic path properties. For deeper edits (offers, landings, weights), use Manage Rotation.
• Update Costs integrates with Binom’s ROI reporting — keep costs updated to get accurate profit/loss data in your Binom stats.
• Bulk Cost Update is the automation-friendly version of Update Costs — pair it with an AI Analyze step to automatically compute and post costs across all active campaigns in one run.