Skip to content

Latest commit

 

History

History
468 lines (358 loc) · 9.64 KB

README.md

File metadata and controls

468 lines (358 loc) · 9.64 KB
Raw

FastLane Integration Guide

##Overview

FastLane is called via a simple Javascript file included in the <HEAD> tag on the page to execute Rubicon Project Marketplace Auctions asynchronously prior to calling the primary Ad Server. The Ad Server can then be accurately informed of available demand from the Marketplace and therefore make better yield optimization decisions about which line item to render for any/all ad slots on any given page. ##Code Samples (standard)

Code Samples (advanced)

##Custom Use Cases

<tr>
  
  <td>
    
    <div>
      
      <div>
        
        <p>
           Use Case 
        </p>
         
      </div>
       
    </div>
     
  </td>
  
  <td>
    
    <div>
      
      <div>
        
        <p>
           Proposed Solution 
        </p>
         
      </div>
       
    </div>
     
  </td>
   
</tr>

<tr>
  
  <td>
    
    <div>
      
      <div>
        
        <p>
           All ad units fall under 1 site and 1 zone, with varying sizes 
        </p>
         
      </div>
       
    </div>
     
  </td>
  
  <td>
    
    <div>
      
      <div>
        
        <ul>
          
          <li>
             Only 1 ad slot mapping needed in the Rubicon backend config 
          </li>
          
          <li>
             It should be set up as "catchAll" 
          </li>
           
        </ul>
         
      </div>
       
    </div>
     
  </td>
   
</tr>

<tr>
  
  <td>
    
    <div>
      
      <div>
        
        <p>
           Needs to differentiate desktop vs. mobile 
        </p>
         
      </div>
       
    </div>
     
  </td>
  
  <td>
    
    <div>
      
      <div>
        
        <ul>
          
          <li>
             Set page context to "mobile" via rubicontag.addContext()o n the web page 
          </li>
          
          <li>
            Set up mobile specific slots in the backend config 
          </li>
           
        </ul>
         
      </div>
       
    </div>
     
  </td>
   
</tr>

<tr>
  
  <td>
    
    <div>
      
      <div>
        
        <p>
           Needs a way to match URLs/domains 
        </p>
         
      </div>
       
    </div>
     
  </td>
  
  <td>
    
    <div>
      
      <div>
        
        <ul>
           <li>Utilize urlPattern set up in the backend config</li>
        </ul>
         
      </div>
       
    </div>
     
  </td>
   
</tr>

<tr>
  
  <td>
    
    <div>
      
      <div>
        
        <p>
           Custom rules to map ad slot names 
        </p>
         
      </div>
       
    </div>
     
  </td>
  
  <td>
    
    <div>
      
      <div>
        
        <ul>
           <li>Create RegEx rules for the ad slot mapping creation</li>
        </ul>
         
      </div>
       
    </div>
     
  </td>
   
</tr>

##Custom Web Page Setup

Use Case

Proposed Solution

Infinite Scroll/Dynamic Page Slot Definition

  • Particular ad slots can be specified to be included for a Rubicon auction
  • Subsequent rubicontag.run() can be executed as the additional page slots are loaded

Need a different way to retrieve key/value pairs, apart from setTargetingForGPTSlot()

  • getAdServerTargeting() can be used to get all or individual slots 
              </li>
          <li>
            To get all of the targeting objects:&nbsp;
            
          </li>
          <li>
            To get targeting for an individual slot: window.rubicontag.getSlot('&lt;elementID&gt;').getAdServerTargeting();
          </li>
          <div title="Page 13">
            <p>
              where elementID is the same that was passed to rubicontag.defineSlot
            </p>
          </div>
        </ul>
      </div>
    </td>
  </tr>
</tbody>

##Best Practices

Category

Recommendation

Setting ATF/BTF

  • Always set the ATF or BTF in rubicontag.defineSlot().setPosition('atf')

Trafficking Creative Code

  • Ensure that there are no character formatting issues with the creative code
  • Always use a text editor to edit the code prior to trafficking it into the Ad Server

Bulk Assign Creative to Line Items

  • Create the creative once per ad size
  • Once all the line items are done, assign the creative in bulk to all the line items of that size

Troubleshooting

  • Append '?rp_loglevel=4' or '#rp_loglevel=4' to the url to turn on logging
  • Overrides the log level for that site for the entire session until browser is closed (no need to append every time)

Testing

  • Append '?rp_cpm_override=' or '#rp_cpm_override=' to the url to override the price of a request
  • Forces ads to render when they wouldn't otherwise

Please submit any issues or example requests through the Github issues page for this repository.