Voluum Documentation

Using Yeesshh as a Traffic Source

Voluum TRK Integration Yeesshh

Yeesshh is a provider of the pop traffic that works mostly with direct advertisers. They offer vast targeting options (for example, GEO targeting down to the single zip code) and interesting features, such as Auto-Blocker. Read the following guide to learn how to start a Yeesshh campaign that is tracked with Voluum.

Table of Contents
Before You Start

Make sure you have the following prerequisites:

  • An active Voluum account

  • An active Yeesshh account, with some funds added (min. deposit is $150).

I. Create a Campaign in Voluum

Before you can create a campaign in Yeessh, you need to create one in Voluum. This will provide you with a campaign URL that you will submit as a destination URL in Yeesshh. In order to create a campaign in Voluum, perform the following steps:

  1. Create an offer element. Read the Creating an Offer Element article to learn how to do that.

  2. (Optionally) Create a lander element. Read the Create a Lander Element article to learn more.

  3. Create a traffic source element:

    1. Go to the Traffic sources tab.

    2. Click the New traffic source button.

      new_TS.png
    3. Click the Create custom button. The New traffic source form will appear.

      custom_TS.png
    4. Provide a name for your traffic source in the Traffic source name text field.

    5. Paste the following URL in the Traffic source postback URL text field:

      http://xml.yeesshh.com/conversion?c={externalid}&value={payout}

      This URL is used to report conversions from Voluum (after Voluum has received this information from an affiliate network) to Yeesshh. The correct parameters have already been appended to this URL. You can see them after the ? character. They consist of the parameter_name={token} pair, where:

      • parameter_name is a description of a value that has to be recognized by the target platform (Yeesshh in this case). Yeesshh uses the c parameter name to receive their own click ID value back from Voluum (after it has been passed in the campaign URL in the {conversion} token and matched with Voluum's {externalid} token) and the value parameter name to receive information about conversion value.

      • {token} is a placeholder that will be automatically replaced with a concrete value, that is specific for the source platform (Voluum in this case). Voluum uses the {externalid} token to store and pass back a traffic source click ID value and the {payout} token to store and pass the conversion value.

      Reporting conversions will allow you to see payout information in Yeesshh and use their automatic optimization options.

      vlm_yeesshh1.png
    6. Scroll down to the Advanced parameters section. In this section you need to submit Yeesshh's tokens (in Yeesshh referred to as "macros"), so they will be correctly recognized by Voluum.

      Provide the following tokens in the Token column:

      • {conversion}

      • {bid}

      • {banner}

      • {keyword}

      • {pubfeed}

      • {pubpoint}

      • {pubzone}

      Note

      Voluum Info: The list above does not contain all Yeesshh tracking tokens. You can add more if you want. Keep in mind that many information, such as visitor's country, IP or user agent will be provided by Voluum and there is no need to pass it from Yeesshh.

      Provide your own parameter names that describe values passed in tokens in the Parameter column. Example names are shown in the image below.

      Provide a name for a custom variable that will be visible in Voluum reports in the Name column.

    7. Click the Save button.

      vlm_yeesshh2.png
  4. Create a campaign

    In Voluum, click the New campaign button that is available in CampaignsOffersLanders, and Traffic sources tabs. The New campaign form will appear.

    voluum_campaign1.png

    Caution

    Voluum Note: If you have Voluum DSP available on your account, you will have to additionally select the New TRK campaign option from the drop-down menu. 

    1. Provide basic campaign information.

      1. In the New Campaign form in the GENERAL tab, provide the name of your campaign in the Campaign name text field.

      2. (Optional) If you have the Workspaces feature enabled on your account, select the Private Workspace from the drop-down menu that you want this campaign to be assigned to. Read the Workspaces: Overview article to learn more.

      3. Select the Yeesshh traffic source that you have just created from the drop-down menu.

      4. Click the Next button.

        vlm_yeesshh3.png
    2. Provide traffic destination information.

      1. In the DESTINATION tab, select the campaign destination type radio button.

      2. Select offer and lander elements that you have created. Read the Flows, Paths and Listicles article to learn more.

      3. Click the Save button.

        vlm_campaign2.png
    3. Copy the campaign URL by clicking the Copy button.

      vlm_yeesshh4.png
II. Create a Campaign in Yeesshh

You are half-way through the setup process. You have now created the campaign in Voluum and got the campaign URL. Now, you need to create a campaign in Yeesshh. In order to do so, perform the following steps:

  1. In Yeesshh, click the Campaigns menu and select the New campaign option.

    yeesshh1.png
  2. In the Campaign and budget tab: Provide a name for your campaign in the Name text field.

  3. Set all required budget and bid options.

  4. Click the Next button.

    yeesshh2.png
  5. In the Ad group targeting tab: Set the location options.

  6. Set the day parting options.

    yeesshh3.png
  7. Scroll down and set the required device options.

  8. Click the Next button.

    yeesshh4.png
  9. In the Keywords tab: If you want to target all sources, leave the RON option enabled. If not, provide keywords that you want to target. Click the Next button.

    yeesshh5.png
  10. In the TQ & Analytics tab: Click the Show conversion tracking.

  11. Click the New goal button. Creating a goal is required for reporting conversions to Yeesshh.

  12. Provide a name for your goal and, if needed, change the coefficient (multiplier) value.

  13. Click the Next button.

    yeesshh6.png
  14. In the Pop ads tab: Click the New Pop Ad button.

    yeesshh7.png
  15. Paste the copied campaign URL from Voluum in the Destination URL text field.

  16. Click the Submit button.

    yeesshh8.png
  17. Click the Finish button.

    yeesshh9.png