Yahoo! (Verizon) Integration

The Voluum and Verizon-owned Yahoo! integration connects the two platforms to pass conversions between them. The following article describes the scope of the integration, the setup, and how to work with integrated campaigns.

HOW YOU CAN BENEFIT FROM THE INTEGRATION WITH YAHOO?

The API integration gives you the following benefits:

  • Send conversions to Yahoo!

BEFORE YOU START

Before you perform an integration, make sure that you have the following:

  • An active Voluum account

  • An active Yahoo! account

  • Yahoo! Client ID and Secret. To get them, you need to contact Yahoo representative and send them your public key. If you don't have one, you need to generate a pair of keys (public and private) before. Follow the steps below:

    1. Use the following commands in your terminal:

      >> openssl genpkey -aes256 -algorithm RSA -pkeyopt rsa_keygen_bits:2048 -out private_key.pem
    2. You should see now a private_key.pem file. This one should not be shared.

    3. Now this second command will generate a public_key.pem file using your private_key.pem file as an input. The command:

      >> openssl rsa -in private_key.pem -out public_key.pem -outform PEM -pubout
    4. You should see now public_key.pem. Share this file with your representative.

    5. Once you provide them with that public key, they’ll generate necessary authentication keys, and send them back to you in an encrypted format. You can decrypt them using your private key, with the following command:

      >> openssl rsautl -decrypt -inkey private_key.pem -in encrypted_file_bane.enc -out my_credentials.txt
    6. The my_credentials.txt file will contain the necessary Client ID and Secret for the integration to work.

Now you need at least one campaign running and tracked by Voluum. Once you have everything ready, read the further part of this guide.

I. Setting Up Integration
  1. In Voluum, go to the AUTOMIZER module.

  2. Go to the Traffic sources tab.

  3. Click the Add traffic source button.

    automizer_integration.png
  4. Click the Add integration link under the Yahoo! traffic source.

    yahoo1.png
  5. Provide the Client ID and Secret in the text fields.

  6. Click the Add integration button.

    yahoo2.png
II. Setting up passing conversions

Once you integrate, you need to generate a postback URL that you will submit to Yahoo!.

  1. In Automizer, on the list with integrated traffic sources, click the Generate button.

  2. Provide an 'Event Action' name. This must be the same name as the one used in Yahoo! Once you do so, hit Generate postback URL .

    yahoo4.png

    Caution

    Voluum Note: If you don’t have Event Action already, follow these steps:

    1. In Yahoo ad account go to Shared Library / Conversion rules and click on New rule.

    2. Select custom web events,

    3. Give your conversion a name and choose the appropriate category.

    4. Select ‘Each conversion event has a different value’ if you want Yahoo! to track payouts values passed from Voluum.

    5. In Events definition choose Action, Equals to as a condition and choose an event action name, for example ‘Purchase'.

      yahoo3.png
    6. Click Create.

  3. Put the postback in the Yahoo! traffic source setup in Voluum as a traffic source postback URL.

    yahoo5.png