Developer centerAPI keys

Intelligent Ad

Overview

Intelligent Ad uses identity scoring to guide retargeting audience activation. Evaluate the customer identities available to your integration before creating or refreshing audiences, then map the returned IH Score to inclusion, exclusion, offer selection, and campaign spend priorities.

The integration must associate each scored identity with the audience record used by your advertising platform. Define how score states translate into audience rules, how unidentified identities are handled, and when audience membership is refreshed. Apply those rules through your advertising workflow; campaign delivery and bidding remain in the advertising platform.

Carry campaign and interaction references into the sessions generated by your ads. Report their outcomes through Session Disposition to evaluate whether the audiences selected for retargeting produce the intended results.

Getting Started

  1. Authentication API Key
    Request your private API Key if one has not yet been assigned. Use it in your server-side integration.
  2. Prepare Your Audience
    Identify the customer identities available for retargeting and how they map to audiences in your advertising platform. Keep existing audience exclusions in place.
  3. Identity Scoring
    Score the eligible identities before activating or refreshing retargeting audiences. Review the Action API Endpoint for a custom integration and confirm the identity fields and model to use with Intelligent Handshake®.
  4. Score-Based Activation
    Map the six IH Score states to audience inclusion, offer, and spend priorities. Activate those rules in your advertising platform; suppress states that are not worth returning to.
  5. Session Disposition Feedback Loop
    Post resulting session outcomes using Session Disposition. Preserve campaign and interaction context so outcomes can be associated with the original retargeting decision.

Start collecting session outcomes before changing retargeting rules. Use that feedback to evaluate score-based audience and spend decisions.