Developer Instructions: 2017 Fit My Car modal and SkyRise Tent Fit My Car

FIT MY CAR MODAL DIRECTIONS: HOW TO SETUP FOR .COM PARTNERS WITH ECOMMERCE

Thank you for using Yakima's NEW 2017 Fit My Car. Please check to ensure your NEW Fit My Car is properly set-up.

Set Up Requirements include: have ecommerce in place, have a developer to support the integration, have experience with various partner transfers from other brands.

Page setup requires two weeks to work back and forth with Yakima.

The base URL structure for all Buy Now ecommerce partners is as follows:

https://www.yakima.com/ca/whitelabel/fitmycar?partnerId=X

  • PartnerID=X references the Yakima ID for each partner and X represents the specific ID.

Step 1

If you are a new partner or already registered as a Buy Now partner, we'll need to send you back an additional check out link. Please email [email protected] with the following to get started:

  • Transfer cart URL for your domain
  • Company Logo - transparent PNG, with 186px by 121px dimensions 

Step 2

You will receive an email back within 2-4 business days with a link preconfigured with your partner ID that will link to your branded Whitelabel experience. Once received, you can place the link around any image or text you'd like to link to the new configurator.

<a href="LINK-HERE">LINK OR IMAGE HERE</a>


Step 3

Add an “AddToCart” method to your web site, which reads a collection of QueryString parameters and adds the appropriate products to the current user’s cart. The location and URL of this method doesn’t matter, as long as it accepts parameters in this format: “p1=SKU,Quantity,Price,Name”

-

  • p1 is a sequential index for the product, the first product is “p1”, the second is “p2”, etc.
  • SKU is the SKU of the product to add, ie “8002098”
  • Quantity is the number of items to add to the cart, ie “1”
  • Price is Yakima’s MSRP for the product, which is provided for your reference but can be ignored. Ie. “298.00”
  • Name is the full name of the product, which is also provided for reference and can be ignored. Ie. “Forklift”

 


Here is an example of a URL that should add two products to a user’s cart: http://www.mysite.com/cart/add_to_cart?p1=8002098,1,159.00,Forklift&p2=8000429,2,199.00,JetStreamSilver60



Below is an example (in PHP) of a method that will parse the querystring and add the products to the user’s cart. The implementation of the AddProductToCart method will depend the language and framework of your eCommerce platform. Once this method is implemented and tested, provide the URL to Yakima and we will handle the rest.

$qs = $_SERVER['QUERY_STRING'];
parse_str($qs, $products);
foreach ($products as $product) {
  $values = explode(“,”, $product);
   $sku = $values[0];
   $quantity = $values[1];
   AddProductToCart($sku, $quantity);
}

SKYRISE TENT FIT MY CAR MODAL DIRECTIONS: HOW TO SETUP FOR .COM PARTNERS WITH ECOMMERCE AND WITHOUT

If you have stock of the SkyRise Tent, please add this custom configurator to the SkyRise Page ONLY. It will inform customers is the fit is confirmed.

Set Up Requirements include: have a developer to support the integration, have experience with adding modals to your website

Step 1

Copy and paste the three lines below into the <head> section of the page that is going to host the configurator:

<link rel="stylesheet" type="text/css" href="https://www.yakima.com/js/guided/guided.css" media="all"/>
<script src="https://code.jquery.com/jquery-1.10.1.min.js"></script>
<script src="https://www.yakima.com/js/prototype/prototype.js"></script>

Step 2

Paste the five lines below just above the button or hyperlink that will open the configurator.  If you want the configurator to transfer the customer’s product selections into your cart, you will need to create an AddToCart method which accepts parameters in the format “&p1=SKU,Quantity,Price,Name&p2=SKU,Quantity,Price,Name”, and then set the “checkoutLink” variable to the path to that method.  Otherwise, leave the variable blank and the configurator will be informational only.

<script type="text/javascript">
yakimaApiUrl = 'https://www.yakima.com/api/rest/';
var checkoutLink = '';
</script>
<script type="text/javascript" src="https://www.yakima.com/js/guided/guided.js"></script>

Step 3

Simply add the class “yakima-guided” to the hyperlink or button that will open the configurator.

<a href="#" class="yakima-guided">Confirm My Fit</a>

 

email [email protected] for any specific integration questions