Integrating with Invoca

Invoca integration is a special option available to enterprise clients. Talk to your account manager about getting your network set up with Invoca.

Create Pay Per Call Offer

From the Create Offer page, click the Add PayPerCall Offer link above the Details panel.

Creative Code and Phone Numbers

Invoca works by giving partners unique phone numbers that are tied to a specific marketing campaign. To get the creative code, tracking links and phone numbers, you need to log into Invoca from a partner account on. Invoca has advanced features for requesting and managing phone numbers that can only be completed from their system.

TUNE Partner Interface

When viewing a Pay Per Call offer from the partner interface, click the link for “Click here to get your Campaign specific Pay Per Call phone numbers to promote.”

Invoca Partner Interface

Once logged into the partner interface for Invoca, you can see all the pay per call campaigns you have access to. Click on the name of the Campaign you want to promote.

After applying to the campaign or agreeing to any terms of conditions, the Getting Started tab generates phone numbers and links unique for your partner account. Once these are set up, the Promo Numbers tab gives you a list of all your phone numbers for the offer. You can use the phone number in your campaigns or you can get a tracking link.

Invoca Tracking Link

From the Promo tab, click the “Get Link” link.

A tracking link looks something like this:

http://networkid.ringrevenue.com/c/142/7419-43943-833064?us=%2Faff_c%3Foffer_id%3D45%26aff_id%3D23%26aff_sub%3D8886532941%26PPCPN%3D8886532941

The Invoca tracking link automatically redirects to a partner link for your TUNE network so the clicks on the tracking links can be tracked.

http://networkid.go2cloud.org/aff_c?PPCPN=8886532941&aff_id=23&aff_sub=8886532941&debug=1&offer_id=45

Note that Invoca uses aff_sub (partner Sub ID 1) for their tracking ID, so you and your partners can’t use aff_sub.

Additional Sub IDs in Tracking Links

To include additional sub IDs in Invoca tracking links, you’ll need to encode them and append them on to the end of the link. If you want to include &aff_sub2=12345 you’ll need to URL encode it like this: %26aff_sub2%3D12345

Then you can append the encoded aff_sub2 parameter onto the end of the Invoca tracking link, like this:

http://networkid.ringrevenue.com/c/142/7419-43943-833064?us=%2Faff_c%3Foffer_id%3D45%26aff_id%3D23%26aff_sub%3D8886532941%26PPCPN%3D8886532941%26aff_sub2%3D12345

You can include aff_sub2, aff_sub3, aff_sub4, aff_sub5 and source in Invoca tracking links.

Pay Per Call Tracking

Every 10 minutes a script runs to check for new call transactions in your Invoca account. If there are new call transactions, the scripts downloads them and parses the call transactions. Depending on the status of call_result_description_detail, the call will be recorded as a Conversion with the status based on the following. So you don’t need to implement any conversion pixels or server postback URLs. The integration with Invoca already imports and records calls as conversions.

Invoca ID

Invoca passes in their click/transaction ID as partner Sub ID 1 into TUNE tracking links. You can reconcile activity between your Invoca account and your TUNE network based on the Invoca ID.

As of 11/1/2014, the format of the following four fields will change slightly:
transaction_id (Transaction ID)

complete_call_id (Call Record ID)

original_order_id (Order ID)

corrects_transaction_id (Corrects Call ID)

The format of the fields will be updated with the following changes:

Up to 32-character string

These can contain alphanumeric characters “0-9”, “A-Z”, and “-“

 

Approved Conversions

If the transactions have a value of one of the following for call_result_description_detail, then conversions are recorded in TUNE as Approved:

  • notpaid
  • paid
  • repeattrueup

Pending Conversions

If the transactions have a value of one of the following for call_result_description_detail, then conversions are recorded in TUNE as Pending. Once the call is set to an approved status, the conversion is updated according in TUNE.

  • affiliatecall
  • advertiserclicktocall
  • advertiserdirectpromotion
  • advertisercampaignvirtualline
  • nosale
  • pending
  • sale

Rejected Conversions

If the transactions has a value of one of the following for call_result_description_detail, then conversions are recorded in TUNE as Rejected:

  • repeat
  • notapproved
  • expired
  • test
  • policybasedprice
  • advertisersuspended

Partner Pixels / URLs

Since pay per call uses server-to-server tracking postback URLs can be added for your partners and publishers. When a call transaction is recorded as an approved conversion, then any corresponding postback URLs are called. Note that aff_sub ( partner Sub ID1) is reserved and used by Invoca already. Thus, partners can only use aff_sub2 to aff_sub5.

Postback URLs

You can add a postback URL to the main pay per call conversion. When TUNE imports a call record and records it as a conversion, any partner postback URLs are called as well. If your postbacks require a unique ID to be passed in from click, then you need to include it as aff_sub2, etc. on the end of the Invoca tracking link.

If you want to include &aff_sub2=12345 you’ll need to URL encode it like this: %26aff_sub2%3D12345

Then you can append the encoded aff_sub2 parameter on to the end of the Invoca tracking link like this:

http://networkid.ringrevenue.com/c/142/7419-43943-833064?us=%2Faff_c%3Foffer_id%3D45%26aff_id%3D23%26aff_sub%3D8886532941%26PPCPN%3D8886532941%26aff_sub2%3D12345

Then when you add the postback URL in the TUNE interface, you would include {aff_sub2} to get the variable back you passed in on click.

http://affiliatepostback.com/conversion.php?id={aff_sub2}

On conversions, TUNE ad servers would action load this partner postback URL:

http://affiliatepostback.com/conversion.php?id=12345

Pixel Tracking

If the campaign as a web form or some other action, you can set up the pay per call offer to have Offer Goals.

Your default Goal (the main offer conversion event), uses the Pay Per Call tracking protocol. It can’t be changed. So when you enable Offer Goals on the offer, you want to name the Pay Per Call event like Sale or Pay Per Call.

For pixel tracking set up an offer goal and name it something like Lead. Then set the conversion tracking protocol to be iFrame pixel or Image pixel. If you want to pay for an additional amount for the lead (separate from any pay per call payout or revenue) you can set the amounts accordingly, or set them to $0 like the example below.

Then you’ll need to place this pixel after a user submits a web form. This web form usually collects the user’s phone number for a call center to then call. Because the user-submitted their information as a lead, you will display the pixel. Since the pixel is loaded on a web page, partner pixels can be piggy-backed and displayed.