Skip to main content

Shareable Tags between Ringba Accounts

Amanda Cross
Updated

This feature lets you share tags between Ringba accounts. For example, if your target/buyer has a Ringba account, you can share the caller's ZIP code or other tag with their account in real-time. Without this feature, you would have to create a Ring Tree Target to ping their IDE URL.

Note: Contact your Account Manager to activate Shareable Tags for your Ringba account.
You can choose the tags that you want to share at the buyer, target, or campaign level.

This article contains the following sections:

Sharing Ringba Default Tags

You can configure sharable tags at the campaign, buyer, and target level. A tool similar to the one pictured below appears on the Campaign, Buyer, and Target screens to let you choose what tags to share:

The column on the left has all the available tags and the column on the right has the tags that you are selecting to share. If you don't want to share any tags, leave the column on the right empty.

Sharing tags at the campaign level

All the targets on this campaign share the selected tags unless you override by buyer or target. Use the following steps to share tags at the campaign level: 

  1. Click Campaigns in the left navigation and then select a campaign.
  2. Scroll down to the Shareable Tags section.
  3. Click the check boxes next to the tags you want to share at this level to select them. The tags appear in the box on the right. Click them again to deselect.
    Tip: You can click the down arrow to the left of the check box to see child tags. You can also use the search fields above the boxes to find particular tags.
  4. Click Save to update your settings.

Sharing tags at the buyer and target level

Use the following steps to share tags at the buyer or target level:

  1. Click Targets in the left navigation. 
  2. Click Manage Buyers and select a buyer to configure shareable tags at the buyer level. Click Manage Targets and select a target to configure them at the target level.
  3.  Scroll down to the Shareable Tags section and toggle on the Override Shareable Tags switch.
  4. Click the check boxes next to the tags you want to share at this level to select them. The tags appear in the box on the right. Click them again to deselect.
    Tip: You can click the down arrow to the left of the check box to see child tags. You can also use the search fields above the boxes to find particular tags.
  5. Click Update to save the settings.

Special note on sharing multiple sharable tags with the same name

If you set up a Ring Tree Target to ping an RTB campaign, you must use the RTB shareable tags feature. In that case, if you select two or more shareable tags with the same name, the feature fails. For example, you might have multiple ZIP code tags with the same name.

To correct this problem, in the Request Settings section of the Ring Tree Target, you can switch to the  Advanced editor and use the coalescing functionality ( | ) to combine the tags. In the example below, Ringba shares the first available tag from the list. 

{
"zipcode": "[[user:zipcode]|[Gather:zipcode]]"
}

Sharing Custom Tags

To share a custom tag (meaning not a Ringba default tag), you must create a URL parameter.

Learn more: See the URL Parameters article.

Sharing Inbound Call ID

When you enable the Share Inbound Call ID, the system sends the Inbound Call ID to your Buyer, if the Buyer also has a Ringba account. The Inbound Call ID is a unique identifier for each incoming call on your account.

You must send Inbound Call ID if you need your revenue to be updated by your Buyer through a Webhook. Set the target to convert on Webhook/Postback on your Routing Plan and provide them with the Webhook URL. The Buyer sets up a Pixel on their account with the Webhook URL that you provided. The Inbound Call ID parameter is sent to the buyer in the following format:

publisherInboundCallId

Therefore, the Buyer should use the following token when referencing the callUUID is

[tag:user:publisherInboundCallId]

Example:

https://webhook.ringba.com/hook/<WebhookID>?call_id=[tag:user:publisherInboundCallId]&call_revenue=[Call:ConversionPayout]&sale_successful=ye

Learn more: For more details on how to create a Webhook URL, see the Webhooks article.

Getting Help with Shareable Tags

If you still have questions about Ringba’s Shareable Tags feature, contact our support team to get personalized support from Ringba engineers.

Related articles