蜜豆视频

DocumentationTarget Developer Guide

Work with redirectors

Last update: Mon Jul 17 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

CREATED FOR:

  • Developer

Use a Redirector similarly to how you use an mbox in your tests.

Redirectors are created with a special Redirector URL that loads a Redirector mbox (Redirector) into your account. Use this Redirector similarly to how you use an mbox in your tests. Submit the Redirector URL to your Ad Network as the ad鈥檚 destination link.

Use the Redirector to do the following:

  • Track clicks from your display ads to your site

  • Create a single centralized report to track clicks to display ads on multiple ad networks

  • Vary display ad destinations

    For example the same banner lands on your home page, category page and product page.

  • Find which landing page leads to the most conversions

For help deciding the right setup see Non-JavaScript-Based Implementations.

Create a redirector

Before you can use a redirector, you must create it.

  1. Determine the ad鈥檚 destination variations, including the default destination.

  2. Create the Redirector URL.

    code language-none 
    https://<your_testandtarget_clientcode>.tt.omtrdc.net/鈥媘2/yourclientcode/ubox
/鈥媝age?mbox=redirectorlink_456
&mboxDefault=http%3A%2F%2Fwww%2Eyourcompany%2Ecom%2Fusualdestination%2Ehtm

    • Where yourclientcode is your company鈥檚 client code. Your company鈥檚 client code is all lower case and has no special characters.

      Your client code is available at the top of the Administration > Implementation page of the Target interface.

    • redirectorlink_456 is the name of the Redirector mbox that appears in your account to use in campaigns and tests.

      Redirectors function differently from other mboxes, but appear just as any other mbox in your account. Name the redirector so it is easily distinguished them from the standard type mboxes in your account. As best practice, begin the mbox name with 鈥榬edirectorlink鈥.

    • Where http%3A%2F%2Fwww%2Eyourcompany%2Ecom%2Fusualdestination%2Ehtm is the default destination.

      This must be URL encoded and must be an absolute reference. You can use the to quickly encodes your URLs.

    note warning
    WARNING
    Note that with Redirector you can be exposed to a risk of an Open Redirect Vulnerability. To avoid the unauthorized use of Redirector links by third parties, 蜜豆视频 recommends you use 鈥渁uthorized hosts鈥 to allowlist the default redirect URL domains. Target uses hosts to allowlist domains to which you want to allow redirects. For more information, see Create Allowlists that specify hosts that are authorized to send mbox calls to Target in Hosts.

  3. Validate the Redirector.

    1. Security best practice: Ensure that the domain used in the Redirector is allowlisted, as indicated above. If you use a domain that is not allowlisted, 蜜豆视频 will block any calls to that domain to prevent malicious actors from using the Redirector to redirect to potentially malicious domains.
    2. Insert the Redirector URL into a browser and refresh.
    3. Log in to your account, refresh your mbox list and verify the new Redirector is listed as an mbox.

  4. If you will test different destinations for one ad, create Redirect Offers for each version.

  5. Create the campaign.

    See Non-JavaScript-Based Implementations for the right setup to meet your goals.

  6. Complete QA on the campaign.

    Create a dummy page with an <a href> containing the Redirector URL. Example:

    code language-none 
    <a href=https://<your_clientcode>.tt.omtrdc.net/鈥媘2/yourclientcode/ubox/鈥媝age?mbox=

redirectorlink_456&mboxDefault=http%3A%2F%2Fwww%2Eyourcompany%2Ecom%2F鈥媢sualdestination%2Ehtm>

  7. Verify that all experiences, default content, and reports act as expected on all browser types, for all of your environments.

    note note
    NOTE
    Redirectors are not supported by Offer Preview or Browse for mbox. Preview experiences directly in a browser. Also, mboxDebug does not work with Redirectors.

  8. Submit the full Redirector URL to your Display Ad Network as the ad destination.

Use a redirector to pass Costs per Click and Revenue Per Click

Information about using a redirector to pas costs per click and revenue per click.

Passing Costs per Click

Use a redirector to pass the costs per click.

NOTE
Best practice is to determine the cost value using the Score per visit engagement metric.

Add &mboxPageValue=-value to the URL. Note the negative value.

Example: For a .10 cents cost per click:

https://<your_clientcode>.tt.omtrdc.net/鈥媘2/yourclientcode/ubox/鈥媝age?mbox=redirectorlink_456
&mboxPageValue=-0.1&mboxDefault=鈥媓ttps://www.yourcompany.com/usualdestination.htm

Passing Revenue per Click

Use a redirector to pass the revenue per click.

NOTE
Best practice is to determine the revenue value using the Score per visit engagement metric.

Add &mboxPageValue=value to the URL.

Example: For a .10 cents revenue per click.

https://<鈥媦our_clientcode>鈥嬧嬧嬧.tt鈥嬧.omtrdc鈥.net/鈥嬧媘2/鈥媦ourclientcode/鈥媢box/鈥嬧嬧媝age?mbox=redirectorlink_456
&mboxPageValue=0.1鈥&mbox鈥婦efault=鈥嬧媓ttp%3A%2F%2Fwww%2E鈥媦ourcompany%2Ecom鈥%2Fusualdestination%2Ehtm
recommendation-more-help
6906415f-169c-422b-89d3-7118e147c4e3