Category Archives: Usage Requirements

Submitting Hyp3rL0cal for CityGrid Usage Requirements Compliance

When I built Hyp3rL0cal I wanted it to be a working example of how developers could build local directories using CityGrid Places and Advertising API. Since I want developers to be able to take the local directory prototype and deploy for themselves, I wanted to bring it as close to compliance with CityGrid usage requirements as I could.

To do this, I submitted Hyp3rL0cal for review by our partner account management team, to receive feedback on how to bring my local directory into compliance.

For the places search results page:

For the places detail page:

  • Ads Display - You can only display ads on profile pages for businesses that are non-advertisers. For example: You can view Katana’s Places Detail API response. You’ll notice an attribute that states “false”– this means you cannot display an ad for this business’ profile page. For businesses that are non-advertisers, their attribute will state “true”.
  • Customer Message Attribution - You need to provide the proper attribution for Customer Message. 
  • Optional ‘Profile URL’ - Since you have all of the required content displayed on your own profile page, you don’t need to display the ‘Profile URL’ which re-directs to Citysearch’s profile page.
  • Offer or Link – The Offer is not displaying correctly. If it may be difficult to get the full offer displayed correctly, you can choose to just display the link to view the full Offer. Our Usage Requirements give you the option to display either the entire offer or link.
  • Impression Tracker - In order for us to track impressions on your profile pages, you must implement our Places that Pay Impression Tracker. Please keep in mind that action targets must be user initiated. For example: You can fire the action target listing_profile when a user clicks on a business from the Search Results Page and is taken to the Profile page which displays all Places Detail API information. You can then set Javascript on-click events for the other action targets displayed on your Profile Page – such as listing_website, offer, listing_map and etc.
  • Footer attribution -  For all pages with CityGrid content – Under 3.8 Attribution in our Usage Requirements, the proper Footer Attribution must state the following: “Powered by CityGrid; Data from Infogroup ©[YEAR]” .
  • Search bar - Building a search bar in your directory increases user interaction and enables them open access to finding places they’re interested in.
  • Prominent Links -Make your links more prominent so that users are more apt to click on them. For instance, you can create buttons for “Menu”, “Email”, “View Website” and etc. instead of text links.Here are some examples:

I just went through all this feedback and updated the Hyp3rL0cal PHP directory, and then updated the Github repository. The only two things I did not implement was the Mapping URL and Impression Tracker.  I will make two separate posts out of this, much like I did with displaying ads on CtyGrid places detail pages.

I will work to update the Python and Ruby Hyp3rL0cal prototypes as well as the WordPress local directory when I can.  Hopefully we can some plug and play starter kits that are immediately compliant with CityGrid usage requirements, as soon as you install.

Displaying Ads on CityGrid Places Detail Pages

I’m working through the feedback I received from the CityGrid partner account management team on my Hyp3rL0cal directory project. I want to make sure its as compliant as possible, so my developers can deploy as quick as possible, and get approved for revenue sharing.

When reading through the Usage Requirements and Term and Conditions, its easy to miss some of the details. One of the details that went over my head, was displaying ads on places details. When you make a detail call against the CityGrid Places API, one of the properties you get back is “display_ad”.

The “display_ad” field tells you whether a business is an advertiser on CityGrid network or not.  If a business is an advertiser on the CityGrid network you cannot show advertisements on their places page. You are only allowed to show advertisements for business who are not already part of the CityGrid network.

So make sure and check for the “display_ad” settng, because our partner acount management team knows how to check for this, and it will be one area you could possibly fail when being approved and become billable, sharing in revenue using the CityGrid Place API.