Migration Path For Upgraded URLs¶

Context & History¶

Yahoo Native added support for Upgraded URLs (UUs) in the v3 Native API in July 2017. Bulk support was also made available in both the Native UI and Bulk. Official Native UI support was provided in early October 2017.

In the past, all tracking information would be stored in landing page URLs, along with the intended destination information, except for references to param1.

With the introduction of v3 Yahoo Native API UUs, you could change the way landing page URLs are structured. Because tracking information is split into Tracking URL templates, the intended destination is placed into the Final URLs.

Adding Tracking URLs at various hierarchical levels allows you to make simple changes that cascade down as needed, and avoid the necessity of changing every object underneath. For example, adding the {device} macro to every landing page URL in an account would require updating every landing page URL. This is not the case with UUs, however. The advantages of using UUs are obvious and explicit.

Migration Timeline¶

The migration timeline is still tentative and subject to change, but these are some of the key takeaways, shown in the table below:

UI Migration Path¶

To upgrade your non-upgraded entities for search-only campaigns, do the following:

In the Yahoo Native UI, follow these steps:

1. Select edit on your Ad or Sitelink entity,

2. Click the Use final URL link.

3. Enter your Final URL.

4. Click URL Options (advanced).

5. Edit the Custom Params and Tracking Templates.

In Bulk, follow these steps:

1. Download the bulk sheet at ad/keyword/sitelink level.

2. Copy all landing page Urls to the Final Url column and remove display Url.

3. Remove the tracking macros from the Final Url and put them in the Tracking Template column, as shown in the table below.

In the Yahoo Native API, follow these steps:

1. In the v3 API endpoint, make a PUT call on the entity that you would like to upgrade.

2. Clear out the existing non-upgraded columns:

• landingUrl

• displayUrl

3. Enter the columns that you wish to upgrade:

• finalUrl

• mobileFInalUrl

• trackingUrl

• customParameters

Bulk Migration Path¶

For Bulk, follow these steps:

1. Download the bulk sheet at the ad, keyword and sitelink level.

2. Move all landing Urls to the Final Url column and remove display Url.

3. Remove the tracking macros from the Final Url and put them in the Tracking Template column (shown in the table below).

API Migration Path¶

In the Yahoo Native API, follow these steps:

1. Modify and update an existing ad, using the v3 endpoint, as described above for the API.

2. Refer to the steps outlined in Upgraded URLs.

3. Use this sample ad update request JSON.

{

...

    "finalUrl": "https://www.mywebsite.com/c/10366",
    "mobileFinalUrl": "https://m.mywebsite.com/c/10366",
    "trackingUrl": "{lpurl}?source=YAHOO&kw={keyword}&mt={matchtype}&camp={campaignid}&p1={_param1}&p2={_param2}&p3={_param3}",
    "customParameters": [
         {
                 "key": "param1",
                 "value": "abc"
         },
         {
                 "key": "param2",
                 "value": "xyz"
         }
    ],
    "displayUrlPath1": "promo",
    "displayUrlPath2": null,
...

}

FAQ¶