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.

Detected attributes

Detected attributes are used to correct declared attributes and to describe other attributes that are found during review. Detected attributes can impact the creative's policy compliance and help determine whether the creative is eligible for inventory. For example, if a creative has a detectedAttributes that matches a bid request's excluded_attribute, bids placed for that inventory including that creative are filtered from the auction.

Policy compliance

During review the creativeServingDecision is populated with the following:

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.

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"
  }
}

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.

{
  "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"
      }
    ]
  }
}

Enum to ID mapping

Buyer creatives