Navigating the API¶
The Verizon Media API provides you with the tools and resources you need to create, manage and retrieve advertiser data for your ads, ad groups and campaigns programmatically.
Developers are encouraged to take advantage of the API as mobile traffic continues to increase rapidly, with the majority of ads on Yahoo mobile search inventory being served by Verizon Media. Native advertising across Verizon Media mobile inventory is only available.
The sooner you participate in the Verizon Media API, the sooner the system can begin to build a performance history for your ad, so that your ad can earn better ranking and start getting you the clicks it deserves. As traffic ramps, your ad is then in the best position for cost-effective delivery and performance.
Who Should Read This Document¶
This documentation is intended for programmers who are developing apps to access Verizon Media content and search infrastructure. A prerequisite for working with the Verizon Media API is an understanding of HTTP, XML, JSON, and a cursory knowledge of query languages.
Verizon Media v3 API Roadmap¶
The roadmap for taking advantage of the Verizon Media v3 API is straightforward and easy to navigate.
Follow These Paths If You’re New to Verizon Media¶
- Apply for Access, if you haven’t already, so you can get your API key, copy the PHP example code and build and launch your code.
- Establish Authentication using the OAuth 2.0 protocol as your Verizon Media authorization model.
- Set up your Sandbox environment for Testing the creation and management of your advertising campaigns.
- Understand the set of Verizon Media RESTful Objects that you can use to create, manage and retrieve advertiser data for your ads, ad groups and campaigns programmatically. Learn about the data model for the API, which is based on calling the same RESTful object with a different HTTP method.
- Check out the What’s New section and Product Bulletins to keep up to date with the latest features, product enhancements, and API changes.
- Tap into these resources dedicated to working with Verizon Media and API:
If You Already Have an Verizon Media Account & Need to Migrate From v1 to v2 and to v3¶
Explore these topics that describe using the new Verizon Media v3 of the API.
|Using the v3 API||Topic|
|Versioning||Why versioning is important for enabling smoother transitions to support v1 functionalities.|
|API v1 Deprecation & v2 Changes||Details of v1 deprecation and what you need to know to migrate from v1 to v2 and integrate your app.|
|FAQs||Frequently asked questions about issues when working with the v2 and v3 API.|
v3 Data Model¶
The v3 API data model, shown in the diagram, is similar to the v2 data model, with objects created on the advertiser account level for shared sitelinks and shared sets:
The v2 API includes the following objects, described in the table below:
|Shared Sitelinks||Provides methods for creating, updating and retrieving shared sitelinks. Once created, you can share and link these objects to any campaign or adgroup, using the shared sitelinks endpoint.|
|Shared Set Libraries||Provides an overview of the new library of shared sets you can use at the advertiser account level.|
|Create Shared Sets||How to create shared sets.|
|Populate Shared Sets||How to populate shared sets with negative keywords.|
|Associate Shared Sets with Campaigns||How to associate shared sets with campaigns.|
v1 API Support¶
The v1 API will be supported for 90 days beyond the June 1, 2016 deprecation date. After that date, starting on September 1, 2016, the v1 API will be available for one year. After that time, it will be relegated to End of Life (EOL) status. In addition, please note the following: New features will not be added to v1. Non-critical bugs will not be fixed outside of the 90-day window. Any significant, revenue-impacting bugs will continue to be addressed.