SSL implementation guide
All publisher inventory accessible via Ad Exchange has a secure connection (SSL) and requires SSL-compliant creatives.
This guide will help prepare you for SSL inventory on the Ad Exchange.
First steps for all buyers
- Your own certification: If you have not yet heard from the Google third-party ad serving (3PAS) certification team or have specific questions about the parameters of testing or the overall process, please contact firstname.lastname@example.org.
- Your vendors' certification: Ensure that the vendors you use on Ad Exchange are certified for SSL. Google certifies both display and VAST vendors. See the updated Ad Exchange vendors list for details.
Prepare your bidder
Get your bidder ready to properly interpret and respond to SSL inventory bid requests. Make sure your bidder platform understands the following:
- Interpret SSL bid requests
excluded_attributefield, the value 48 represents the
RichMediaAdsVendor: RichMediaCapabilityNonSSLcreative attribute. In the bid request, this appears as:
repeated int32 excluded_attribute = 48
- If 48 is present in the
excluded_attributefield, SSL-compliant ads are required.
- If 48 is not present in the
excluded_attributefield, both SSL-compliant and non-SSL-compliant ads can be returned.
This field will appear in bid requests for both display and in-stream video ads.
- If 48 is present in the
- Respond with an SSL-compliant creative
To bid with an SSL-compliant creative, declare attribute 47,
RichMediaCapabilityType: RichMediaCapabilitySSL, in the
attributefield of the bid response. In the bid response, this appears as:
repeated int32 attribute = 47
Please note the following:
- You should use a separate
buyer_creative_idfor SSL and non-SSL versions of creatives.
While, attribute 47
RichMediaCapabilityType: RichMediaCapabilitySSLcan be used as a part of a unique identifier for a creative, using a separate
buyer_creative_idfor separate versions is highly recommended.
To easily distinguish between creatives, you should also consider including the SSL status of the creative in your naming convention.
- Serving an SSL ad to a non-SSL request is acceptable and runs in the auction as normal.
If either the ad or the tracking calls do not use https, the bid will be dropped from the auction and the snippet disapproved. Until you confirm that all vendors you work with are SSL-compliant, refrain from dynamic insertion of third-party tracking URLs.
Using https is not, in itself, sufficient. The landing page certificate must be valid and up-to-date. To view this information, click the lock icon in the Chrome browser. Learn more
Enable SSL inventory with RTB pretargeting
PretargetingConfig where you’d like to receive SSL inventory, ensure that you do not target
RichMediaCapabilityNonSSL. By not targeting
RichMediaCapabilityNonSSL, you will receive all non-SSL and SSL inventory that matches your other pretargeting selections. Targeting
RichMediaCapabilitySSL will also get you both types of inventory, but is unnecessary.
- As with most changes to third-party ads in the UI, checking the SSL compliant checkbox for existing ads and saving will cause the ads to require another review. This will stop all pre-targeted traffic from serving in the creative until it’s approved. Please reach out to your support team to identify the best way to enable SSL bid requests for your account without interrupting delivery.
- Ad groups which contain both SSL and non-SSL live pretargeting creatives will not be eligible for SSL-required inventory.
- Before declaring SSL compliance for all of your RTB creatives, we highly recommend initially testing in small batches.
This section only applies to buyers utilizing third-party ad serving via the Ad Exchange UI. Creatives hosted via the UI automatically support SSL without user intervention.
- Understand how to make your ads work over SSL
For SSL inventory, all calls within a creative snippet must be SSL-enabled. Make sure you understand how to guarantee this for each ad server, pixel tracker, verifier, and other vendors.
%%SCHEME%%macro will insert
https:in your tags at delivery, depending on the inventory type. For more information, see the list of supported macros.
- Update existing ads
By default, existing ads will not run on SSL inventory.
The process for making a creative SSL compliant includes two steps on the part of the buyer:
- Modify the snippet contents to include/support the HTTPS scheme.
- Toggle the SSL compliance checkbox within the Ad Exchange UI.
Once this is done, the changes will trigger a new review, temporarily marking the creatives “Pending” and halting all delivery until reviewed and approved.
These ads will stop serving while in review. If uninterrupted ad serving is required, create a new, SSL-enabled copy of the ad, and disable the old copy only after the new SSL-enabled ad begins trafficking.
- Ad groups which have both SSL and non-SSL creatives will not be eligible for SSL-required inventory. If you need to have both types of creatives, you should split them into separate ad groups.
Before using this workflow, notify your Ad Exchange support team so they can help ensure a smooth transition.
Buyers must agree in writing to the following to allow us to approve your creatives in bulk:
- Ads are "copies" of only ads that are currently approved (disapproved ads will not be reviewed).
- Ads do not introduce changes to actual creatives rendered.
- Ads are not part of new, not-currently-running advertiser campaigns (only ads in existing campaigns will be reviewed). Note that this means that while the SSL transition is happening, no new ads may be added under the specified campaign IDs.
Define a process to make changes to relevant existing ads. The best way to make bulk changes is through the SOAP API. For best results, follow these instructions:
- Download existing ads.
- Make any necessary SSL changes to the HTML tag.
- Upload as new creatives (since changing existing ads causes these ads to halt serving until review is complete).
- Pass the list of new campaigns, ad groups, and creatives to your support team for bulk setting of the SSL flag and bulk approval.
- Note that we do not support checking the SSL compliance checkbox initially, which is why you should work with your support team to check them in bulk.
Once the new SSL-ready ads are approved, you may want to delete or pause the existing campaigns/ads. Ads with the “SSL compliant” checkbox enabled are able to serve on both SSL and non-SSL inventory.
Be aware there are some limits throughout this process:
- Campaigns per account: 10,000
- Ad groups per campaign: 20,000
- Placements + audiences lists + topics per account (including both inclusions and exclusions): 5,000,000
- Ads per ad group: 2,000 active