Creative fields

When a creative is reviewed, its creativeServingDecision is populated with detected attributes and policy compliance fields that determine the kind of inventory the creative is eligible for.

Compare detected fields to publisher restrictions at bidding time

Fields in CreativeServingDecison prefixed with detected–such as detectedLanguages–describe information about your creatives that Google has detected during the creative review process. These fields can impact your creative's policy compliance, and are relevant in Real-time Bidding, where you can use them to determine which creatives are going to be filtered from the auction due to publisher restrictions.

Select and use your preferred ad category taxonomy

The ad category taxonomy configured for your Authorized Buyers account will determine how detectedCategories and the OpenRTB protocol's BidRequest.bcat field are populated. By default, all Authorized Buyers accounts are configured to use IAB Content Taxonomy 1.0, which is suitable if your bidding integration prioritizes interoperability with other exchanges, or minimizes Google-specific logic. However, IAB Content Taxonomy 1.0 doesn't perfectly align with Google, which can impact the performance of your bidding integration. Here are some examples:

• Categories blocked by publishers may not exist in IAB Content Taxonomy 1.0, which can result in increased bid filtering because creatives and bid requests aren't able to represent those categories.
• Categories aren't represented as granularly in IAB Content Taxonomy 1.0, which may cause bid requests to have broader publisher blocks than necessary. This can reduce your opportunities to bid with some creatives.

If your bidding integration prioritizes minimization of bid filtering caused by bids containing blocked categories, Google recommends that you use Google Ad Category Taxonomy, which is the combination of product, restricted, and sensitive categories. You can enable this for your account by contacting your account manager.

Tip: You can use the detectedCategoriesTaxonomy field to see which ad category taxonomy is enabled.

Note: If your account is configured to use Google Ad Category Taxonomy, detectedCategories will be populated with product and sensitive categories. In a future update, this will also include restricted categories.

Policy compliance

During review the creativeServingDecision is populated with the following:

• dealsPolicyCompliance
• networkPolicyCompliance
• platformPolicyCompliance
• chinaPolicyCompliance
• russiaPolicyCompliance

Bids that don't comply with relevant policies are filtered from the Real-Time Bidding auction.

The policy compliance, status field tells you if a creative is approved for a specific use.

You can use the following information to troubleshoot disapprovals:

• The topics field provides details of a disapproval
• PolicyTopicEntry had the following fields:
  • policyTopic describes the disapproval reason
  • helpCenterUrl links to a help center article on the violated policy
  • evidences explains how the creative violates the policy
  • missingCertificate indicates whether a certificate is needed to unblock serving for some regions.

Important: Inventory for the Authorized Buyers open auction, private auctions, and auction packages require that creatives included in bid responses meet the network policy. Open Bidding inventory requires that creatives comply with the platform policy, which is a subset of network policy. Creatives can be approved for multiple policies.

Examples

Approved

A creative with the following creativeServingDecision would not be filtered from the open auction, deals, open bidding, or from being placed in China or Russia.

{
  "chinaPolicyCompliance": {
    "status": "APPROVED"
  },
  "dealsPolicyCompliance": {
    "status": "APPROVED"
  },
  "detectedAttributes": [
    "CREATIVE_TYPE_HTML"
  ],
  "detectedLanguages": [
    "en"
  ],
  "detectedProductCategories": [
    10016,
    10019,
    10141,
    10168,
    10754,
    10885,
    12206
  ],
  "lastStatusUpdate": "2020-07-30T04:47:31.616018Z",
  "networkPolicyCompliance": {
    "status": "APPROVED"
  },
  "platformPolicyCompliance": {
    "status": "APPROVED"
  },
  "russiaPolicyCompliance": {
    "status": "APPROVED"
  }
}

Note: Detected attributes like detectedAttributes, detectedLanguages, and detectedProductCategories can still impact which bid requests a bidder can respond to with the creative.

Disapproved

In addition to detected attributes, the following creativeServingDecision indicates that the creative isn't approved to serve in deals or the open auction. The dealsPolicyCompliance and networkPolicyCompliance are set to DISAPPROVED.

{
  "detectedAdvertisers": [
    {
      "advertiserId": "22114433",
      "advertiserName": "Test Advertiser"
    }
  ],
  "detectedAttributes": [
    "RICH_MEDIA_CAPABILITY_TYPE_SSL"
  ],
  "lastStatusUpdate": "2020-10-16T23:20:26.140810Z",
  "dealsPolicyCompliance": {
    "status": "APPROVED"
  },
  "networkPolicyCompliance": {
    "status": "DISAPPROVED",
    "topics": [
      {
        "policyTopic": "ONLINE_PHARMACY_CERTIFICATION_REQUIRED",
        "helpCenterUrl": "https://support.google.com/authorizedbuyers/answer/6100448"
      },
      {
        "policyTopic": "DESTINATION_NOT_CRAWLABLE",
        "helpCenterUrl": "https://support.google.com/authorizedbuyers/answer/6272857",
        "evidences": [
          {
            "destinationNotWorking": {
              "httpError": 403,
              "expandedUrl": "https://www.milkywaypharma.com/content/en_earth_us/find-plan?query=QUxJRU5fRVhQT1NVUkVfUVVBUkFOVElORQ",
              "lastCheckTime": "2020-10-17T22:32:05Z"
            }
          }
        ]
      }
    ]
  },
  "platformPolicyCompliance": {
    "status": "APPROVED"
  },
  "chinaPolicyCompliance": {
    "status": "DISAPPROVED"
  },
  "russiaPolicyCompliance": {
    "status": "DISAPPROVED"
  }
}

If applicable, additional context is provided under topics. In this case, the policyTopic suggests that the creative was disapproved for the open auction for the following reasons:

• The creative's destination URL wan't crawlable
• It was detected to promote online pharmaceutical products

The helpCenterUrl links provide more details on the policies that were violated. The evidence includes the creative's destination URL that couldn't be crawled during the review.

The creative is also disapproved for use in China and Russia. Note that at this time, policy topics and evidence aren't populated for either.

Certificate required

The following creativeServingDecision includes a networkPolicyCompliance set to CERTIFICATE_REQUIRED. CERTIFICATE_REQUIRED indicates that the creative is eligible for certification, but has not been certified in any regions, which will cause it to be filtered from the auction. If the buyer were certified in at least one region, the status would change to APPROVED. To learn more about this process, see the Gambling and games policy.

Note: A bid can be filtered from the auction due to lack of certification even if the included creative is APPROVED. This can happen when your creative is certified for at least one region, but the auction is for inventory in a region the creative is not certified for.

{
  "detectedClickThroughUrls": [
    "https://testaccount.testcr.com?value=test"
  ],
  "detectedAdvertisers": [
    {
      "advertiserId": "1234567",
      "advertiserName": "TestAdvertiser",
      "brandId": "87654321",
      "brandName": "TestBrand"
    }
  ],
  "detectedProductCategories": [
    10013,
    10014,
    10015,
    10125,
    10137
  ],
  "detectedLanguages": [
    "en"
  ],
  "detectedDomains": [
    "testcr.com"
  ],
  "detectedAttributes": [
    "RICH_MEDIA_CAPABILITY_TYPE_SSL"
  ],
  "adTechnologyProviders": {
    "detectedProviderIds": [
      "2778",
      "494",
      "479"
    ],
    "detectedGvlIds": [
      "385",
      "772",
      "21"
    ]
  },
  "lastStatusUpdate": "2022-10-25T18:40:21.405Z",
  "dealsPolicyCompliance": {
    "status": "APPROVED"
  },
  "networkPolicyCompliance": {
    "status": "CERTIFICATE_REQUIRED",
    "topics": [
      {
        "policyTopic": "ONLINE_NON_CASINO_GAMES",
        "helpCenterUrl": "https://support.google.com/authorizedbuyers/answer/7450776"
      }
    ]
  },
  "platformPolicyCompliance": {
    "status": "APPROVED"
  },
  "chinaPolicyCompliance": {
    "status": "DISAPPROVED",
    "topics": [
      {
        "policyTopic": "ONLINE_NON_CASINO_GAMES",
        "helpCenterUrl": "https://support.google.com/authorizedbuyers/answer/7450776"
      },
      {
        "policyTopic": "LEGAL_CHINA",
        "helpCenterUrl": "https://support.google.com/authorizedbuyers/answer/6163678"
      }
    ]
  },
  "russiaPolicyCompliance": {
    "status": "DISAPPROVED",
    "topics": [
      {
        "policyTopic": "ONLINE_NON_CASINO_GAMES",
        "helpCenterUrl": "https://support.google.com/authorizedbuyers/answer/7450776"
      },
      {
        "policyTopic": "LEGAL_RUSSIA",
        "helpCenterUrl": "https://support.google.com/authorizedbuyers/answer/6163678"
      }
    ]
  }
}