Targeting dimensions
The following targeting dimensions are supported for ads served on Apple News through Google Ad Manager. Selecting any non-supported targeting dimensions will result in your line(s) failing to deliver. This event will not trigger any email notifications to your traffic alias. Note that first and third-party audience segments are not supported.
| Keys | Values | Description |
|---|---|---|
| Age Range | Available age range values:
. |
Age Range is a pre-defined key: AN_Age.
In Canada, the minimum age for targeting is 19. If 18–20 age targeting is selected, age 18 will be excluded. |
| Apps |
|
Apps is a pre-defined key: AN_App available to a subset of publishers to run ads in the Stocks app. |
| Article ID | To target articles, use the URL consisting of the domain and the article ID as the path.
For example, https://apple.news/ Agkyw5MsBSCaJXr8T61fKmg where apple.news is the domain and Agkyw5MsBSCaJXr8T61fKmg is the path.
Article IDs are obtained by previewing an article in Apple News Publisher.
|
Article ID is free-form text used to identify an article that you want to use for targeting: AN_Article_ID. |
| Channel | Channels are unique to each publisher. | Channel is a pre-defined key: AN_Channel used to target your channels. |
| Devices | Device manufacturer > Device class > Device model.
Refer to the Ad specifications for Apple News for a list of the most current supported devices. |
Devices not listed in the most current specification document will not be supported and should not be used as a targeting value. |
| Gender | Available gender values:
|
Gender is a pre-defined key: AN_Gender. |
| Geography | Available values for the following countries: U.S., CA, UK, and AU
Apple News supports all geographic areas available in Google Ad Manager, based on user location. Available options vary by country. |
Geotargeting on Apple News is based on the zip code or postcode of the Apple Account-registered home address. Geo is not the user’s current location. |
| Inventory | Select only the Apple News Ad Unit from within the Google Ad Manager targeting module for targeting. | Only one single Google Ad Manager Ad Unit is needed for all channels/sections that you have on Apple News. |
| Issue ID | To target issues, use the URL consisting of the domain and the Issue ID as the path.
For example, https://apple.news/ IXON4qkAbRyCVtRPmyX7gzQ where apple.news is the domain and IXON4qkAbRyCVtRPmyX7gzQ is the path.
Issue IDs are obtained by previewing the issue in Apple News Publisher. |
Issue ID is free-form text corresponding to a magazine issue that you want you want to use for targeting: AN_Issue_ID. |
| Operating System | Apple News supports monetization of inventory for devices running iOS 10.3 and later and macOS 10.14 and later. In Google Ad Manager, OS targeting is available for both major and minor iOS versions. For example, iOS 13.2, 13.3, and so on. | |
| Pre-roll/Outstream Video |
Available values:
|
Enables Google Ad Manager to differentiate video types. If you have forecasting pixel enabled with Google Ad Manager, you can use these targeting options for forecasting. Pre-roll/Outstream is a pre-defined key: AN_Adtype. |
| Section | Google Ad Manager has a 40-character count limitation for values. Value input over 40 characters won’t be accepted by the system. Channel/Section names that are over the 40-character count limit will have to be updated.
Example: The_Daily_Post/Top_Stories |
Section is a pre-defined key: AN_Section. |
| Sensitive Topic Exclusions | Available values:
“Accidents_and_Disasters” “Adult_Entertainment” “Historical_Event_and_Historical_War” “Obesity_and_Child_Obesity” “Pandemics_and_Illness” “Reckless_Endangerment” “Sex_Sexuality_in_Society” “Tobacco” “Violent_Crime” “War_and_Unrest” |
Section is a pre-defined key: AN_Sensitive Topics.
To exclude sensitive topic categories using Google Ad Manager, you must select ‘is none of’ under Custom Targeting.
Using this targeting feature in ways other than those outlined above may violate Apple News Advertising Content Guidelines. |
| Key Value/Metadata | In order to target groups of articles, you must first mark up the ANF articles with the campaignData metadata property. Refer to Metadata for ANF articles for additional details.
For example an article has the following properties: "campaignData”: {"sport”:["football"], "event":["Superbowl"], "author":["John Appleseed”]}
Then, an ad that’s targeting either “sport=football", “event=Superbowl", or "author=John Appleseed" will be eligible to show in those articles. |
Publishers can target custom ANF key values in their ANF articles through Google Ad Manager. Inclusion and exclusion are available. See details on setting up Custom ANF key values below. |
Note that issue IDs are obtained by previewing the issue in Apple News Publisher. For additional details on marking up ANF articles with the campaignData metadata property to target groups of articles, refer to Metadata for ANF articles.
For pre-defined values, use the following steps to copy the targeting key values:
-
Click your account name in the upper-right corner.
-
Choose Ad Settings.
-
Click Edit for Google Ad Manager in Third-Party Ad Server.
-
Follow the onscreen instructions.
Setting up custom ANF key-value targeting in Google Ad Manager
-
Sign in to Google Ad Manager.
-
Choose Inventory from the left menu.
-
Choose Key-values.
-
Select New key-value.
-
Enter the Name (for example, “sport” or “event”).
-
Enter a Display Name.
-
Set Value Type to either:
- Dynamic: Pass targeting values dynamically into an ad tag based on information you collect.
- Pre-defined: Enter your own predefined values. The key-value remains hard-coded in the ad tag.