Add amp-ad type sharethrough (#3036)

* Add amp-ad type sharethrough

* Update documentation to show pkey required

3p/integration.js

@@ -66,6 +66,7 @@ import {gmossp} from '../ads/gmossp';
 import {weboramaDisplay} from '../ads/weborama';
 import {adstir} from '../ads/adstir';
 import {colombia} from '../ads/colombia';
+import {sharethrough} from '../ads/sharethrough';
 import {eplanning} from '../ads/eplanning';
 
 
@@ -118,6 +119,7 @@ register('weborama-display', weboramaDisplay);
 register('yieldbot', yieldbot);
 register('adstir', adstir);
 register('colombia', colombia);
+register('sharethrough', sharethrough);
 register('eplanning', eplanning);
 
 // For backward compat, we always allow these types without the iframe

ads/sharethrough.js

@@ -0,0 +1,28 @@
+/**
+ * Copyright 2016 The AMP HTML Authors. All Rights Reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS-IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import {writeScript, checkData, validateDataExists} from '../src/3p';
+
+/**
+ * @param {!Window} global
+ * @param {!Object} data
+ */
+export function sharethrough(global, data) {
+  checkData(data, ['pkey']);
+  validateDataExists(data, ['pkey']);
+  global.pkey = data.pkey;
+  writeScript(global, 'https://native.sharethrough.com/iframe/amp.js');
+}

ads/sharethrough.md

@@ -0,0 +1,37 @@
+<!---
+Copyright 2016 The AMP HTML Authors. All Rights Reserved.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS-IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+-->
+
+# Sharethrough
+
+## Example
+
+### Basic
+
+```html
+<amp-ad width=300 height=450
+    layout="responsive"
+    type="sharethrough"
+    data-pkey="c0fa8367">
+</amp-ad>
+```
+
+## Configuration
+
+For semantics of configuration, please [contact Sharethrough](mailto:pubsupport@sharethrough.com).
+
+Required Parameters:
+
+- ```data-pkey``` (String, non-empty) The unique identifier for your placement

builtins/amp-ad.md

@@ -88,6 +88,7 @@ resources in AMP. It requires a `type` argument that select what ad network is d
 - [PubMatic](../ads/pubmatic.md)
 - [Revcontent](../ads/revcontent.md)
 - [Rubicon Project](../ads/rubicon.md)
+- [Sharethrough](../ads/sharethrough.md)
 - [Smart AdServer](../ads/smartadserver.md)
 - [Sortable](../ads/sortable.md)
 - [TripleLift](../ads/triplelift.md)

examples/ads.amp.html

@@ -393,6 +393,13 @@ <h2>Colombia ad</h2>
       data-clmb_section="0">
   </amp-ad> 
 
+  <h2>Sharethrough</h2>
+  <amp-ad width=300 height=150
+      layout="responsive"
+      type="sharethrough"
+      data-pkey="c0fa8367">
+  </amp-ad>
+
  <h2>E-Planning 320x50</h2>
  <amp-ad width=320 height=50
       type="eplanning"