Pretargeting configuration samples

POST https://realtimebidding.googleapis.com/v1/bidders/12345678/pretargetingConfigs?alt=json
Authorization: Bearer <INSERT_ACCESS_TOKEN_HERE>
Content-Type: application/json
 
{
  "displayName": "TEST_PRETARGETING_CONFIG_fd9674ca-4a2d-425f-b412-a55a62aad354",
  "interstitialTargeting": "ONLY_NON_INTERSTITIAL_REQUESTS",
  "includedCreativeDimensions": [
    {
      "height": 300,
      "width": 250
    }
  ],
  "minimumViewabilityDecile": 5
}

{
  "name": "bidders/12345678/pretargetingConfigs/560983",
  "displayName": "TEST_PRETARGETING_CONFIG_fd9674ca-4a2d-425f-b412-a55a62aad354",
  "billingId": "112233445566",
  "state": "ACTIVE",
  "interstitialTargeting": "ONLY_NON_INTERSTITIAL_REQUESTS",
  "includedCreativeDimensions": [
    {
      "width": "250",
      "height": "300"
    }
  ],
  "minimumViewabilityDecile": 5
}

 /* Copyright 2020 Google LLC 
 * 
 * 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. 
 */ 
 using 
  
 Google.Apis.RealTimeBidding.v1 
 ; 
 using 
  
 Google.Apis.RealTimeBidding.v1.Data 
 ; 
 using 
  
 Mono.Options 
 ; 
 using 
  
 System 
 ; 
 using 
  
 System.Collections.Generic 
 ; 
 namespace 
  
 Google.Apis.RealTimeBidding.Examples.v1.Bidders.PretargetingConfigs 
 { 
  
 /// <summary> 
  
 /// Creates a pretargeting configuration for the given bidder account ID. 
  
 /// </summary> 
  
 public 
  
 class 
  
 CreatePretargetingConfigs 
  
 : 
  
 ExampleBase 
  
 { 
  
 private 
  
 RealTimeBiddingService 
  
 rtbService 
 ; 
  
 /// <summary> 
  
 /// Constructor. 
  
 /// </summary> 
  
 public 
  
 CreatePretargetingConfigs 
 () 
  
 { 
  
 rtbService 
  
 = 
  
 Utilities 
 . 
 GetRealTimeBiddingService 
 (); 
  
 } 
  
 /// <summary> 
  
 /// Returns a description about the code example. 
  
 /// </summary> 
  
 public 
  
 override 
  
 string 
  
 Description 
  
 { 
  
 get 
  
 = 
>  
 "This code example creates a pretargeting configuration for the given " 
  
 + 
  
 "bidder account ID." 
 ; 
  
 } 
  
 /// <summary> 
  
 /// Parse specified arguments. 
  
 /// </summary> 
  
 protected 
  
 override 
  
 Dictionary<string 
 , 
  
 object 
>  
 ParseArguments 
 ( 
 List<string> 
  
 exampleArgs 
 ) 
  
 { 
  
 string 
 [] 
  
 requiredOptions 
  
 = 
  
 new 
  
 string 
 [] 
  
 { 
 "account_id" 
 }; 
  
 bool 
  
 showHelp 
  
 = 
  
 false 
 ; 
  
 string 
  
 accountId 
  
 = 
  
 null 
 ; 
  
 string 
  
 displayName 
  
 = 
  
 null 
 ; 
  
 IList<string> 
  
 includedFormats 
  
 = 
  
 new 
  
 List<string> 
 (); 
  
 IList<long 
 ? 
>  
 includedGeoIds 
  
 = 
  
 new 
  
 List<long 
 ? 
> (); 
  
 IList<long 
 ? 
>  
 excludedGeoIds 
  
 = 
  
 new 
  
 List<long 
 ? 
> (); 
  
 IList<long 
 ? 
>  
 includedUserListIds 
  
 = 
  
 new 
  
 List<long 
 ? 
> (); 
  
 IList<long 
 ? 
>  
 excludedUserListIds 
  
 = 
  
 new 
  
 List<long 
 ? 
> (); 
  
 string 
  
 interstitialTargeting 
  
 = 
  
 null 
 ; 
  
 IList<string> 
  
 allowedUserTargetingModes 
  
 = 
  
 new 
  
 List<string> 
 (); 
  
 IList<long 
 ? 
>  
 excludedContentLabelIds 
  
 = 
  
 new 
  
 List<long 
 ? 
> (); 
  
 IList<string> 
  
 includedUserIdTypes 
  
 = 
  
 new 
  
 List<string> 
 (); 
  
 IList<string> 
  
 includedLanguageCodes 
  
 = 
  
 new 
  
 List<string> 
 (); 
  
 IList<long 
 ? 
>  
 includedMobileOsIds 
  
 = 
  
 new 
  
 List<long 
 ? 
> (); 
  
 IList<long 
 ? 
>  
 includedVerticalIds 
  
 = 
  
 new 
  
 List<long 
 ? 
> (); 
  
 IList<long 
 ? 
>  
 excludedVerticalIds 
  
 = 
  
 new 
  
 List<long 
 ? 
> (); 
  
 IList<string> 
  
 includedPlatforms 
  
 = 
  
 new 
  
 List<string> 
 (); 
  
 long? 
  
 includedCreativeDimensionHeight 
  
 = 
  
 null 
 ; 
  
 long? 
  
 includedCreativeDimensionWidth 
  
 = 
  
 null 
 ; 
  
 IList<string> 
  
 includedEnvironments 
  
 = 
  
 new 
  
 List<string> 
 (); 
  
 string 
  
 webTargetingMode 
  
 = 
  
 null 
 ; 
  
 IList<string> 
  
 webTargetingUrls 
  
 = 
  
 new 
  
 List<string> 
 (); 
  
 string 
  
 mobileAppTargetingMode 
  
 = 
  
 null 
 ; 
  
 IList<string> 
  
 mobileAppTargetingAppIds 
  
 = 
  
 new 
  
 List<string> 
 (); 
  
 IList<long 
 ? 
>  
 includedMobileAppTargetingCategoryIds 
  
 = 
  
 new 
  
 List<long 
 ? 
> (); 
  
 IList<long 
 ? 
>  
 excludedMobileAppTargetingCategoryIds 
  
 = 
  
 new 
  
 List<long 
 ? 
> (); 
  
 string 
  
 publisherTargetingMode 
  
 = 
  
 null 
 ; 
  
 IList<string> 
  
 publisherIds 
  
 = 
  
 new 
  
 List<string> 
 (); 
  
 int? 
  
 minimumViewabilityDecile 
  
 = 
  
 null 
 ; 
  
 OptionSet 
  
 options 
  
 = 
  
 new 
  
 OptionSet 
  
 { 
  
 "Creates a pretargeting configuration for the given bidder account ID." 
 , 
  
 { 
  
 "h|help" 
 , 
  
 "Show help message and exit." 
 , 
  
 h 
  
 = 
>  
 showHelp 
  
 = 
  
 h 
  
 != 
  
 null 
  
 }, 
  
 { 
  
 "a|account_id=" 
 , 
  
 ( 
 "[Required] The resource ID of the bidders resource under which the " 
  
 + 
  
 "pretargeting configuration is to be created." 
 ), 
  
 a 
  
 = 
>  
 accountId 
  
 = 
  
 a 
  
 }, 
  
 { 
  
 "display_name=" 
 , 
  
 "The display name to associate with the new configuration. Must be unique " 
  
 + 
  
 "among all of a bidder's pretargeting configurations." 
 , 
  
 display_name 
  
 = 
>  
 displayName 
  
 = 
  
 display_name 
  
 }, 
  
 { 
  
 "included_formats=" 
 , 
  
 ( 
 "Creative formats included by this configuration. An unset value will not " 
  
 + 
  
 "filter any bid requests based on the format. Specify this argument for " 
  
 + 
  
 "each value you intend to include.Valid values include: HTML, NATIVE, and " 
  
 + 
  
 "VAST." 
 ), 
  
 included_formats 
  
 = 
>  
 includedFormats 
 . 
 Add 
 ( 
 included_formats 
 ) 
  
 }, 
  
 { 
  
 "included_geo_ids=" 
 , 
  
 ( 
 "The geo IDs to include in targeting for this configuration. Specify this " 
  
 + 
  
 "argument for each value you intend to include. Valid geo IDs can be found " 
  
 + 
  
 "in: https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv " 
 ), 
  
 ( 
 long 
  
 included_geo_ids 
 ) 
  
 = 
>  
 includedGeoIds 
 . 
 Add 
 ( 
 included_geo_ids 
 ) 
  
 }, 
  
 { 
  
 "excluded_geo_ids=" 
 , 
  
 ( 
 "The geo IDs to exclude in targeting for this configuration. Specify this " 
  
 + 
  
 "argument for each value you intend to include. Valid geo IDs can be found " 
  
 + 
  
 "in: https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv " 
 ), 
  
 ( 
 long 
  
 excluded_geo_ids 
 ) 
  
 = 
>  
 excludedGeoIds 
 . 
 Add 
 ( 
 excluded_geo_ids 
 ) 
  
 }, 
  
 { 
  
 "included_user_list_ids=" 
 , 
  
 ( 
 "The user list IDs to include in targeting for this configuration. Specify " 
  
 + 
  
 "this argument for each value you intend to include. Valid user list IDs " 
  
 + 
  
 "would include any found under the buyers.userLists resource for a given " 
  
 + 
  
 "bidder account, or any buyer accounts under it. " 
 ), 
  
 ( 
 long 
  
 included_user_list_ids 
 ) 
  
 = 
>  
 includedUserListIds 
 . 
 Add 
 ( 
  
 included_user_list_ids 
 ) 
  
 }, 
  
 { 
  
 "excluded_user_list_ids=" 
 , 
  
 ( 
 "The user list IDs to exclude in targeting for this configuration. Specify " 
  
 + 
  
 "this argument for each value you intend to include. Valid user list IDs " 
  
 + 
  
 "would include any found under the buyers.userLists resource for a given " 
  
 + 
  
 "bidder account, or any buyer accounts under it. " 
 ), 
  
 ( 
 long 
  
 excluded_user_list_ids 
 ) 
  
 = 
>  
 excludedUserListIds 
 . 
 Add 
 ( 
  
 excluded_user_list_ids 
 ) 
  
 }, 
  
 { 
  
 "interstitial_targeting=" 
 , 
  
 ( 
 "The interstitial targeting specified for this configuration. By default, " 
  
 + 
  
 "this will be set to ONLY_NON_INTERSTITIAL_REQUESTS. Valid values include: " 
  
 + 
  
 "ONLY_INTERSTITIAL_REQUESTS and ONLY_NON_INTERSTITIAL_REQUESTS." 
 ), 
  
 interstitial_targeting 
  
 = 
>  
 interstitialTargeting 
  
 = 
  
 interstitial_targeting 
  
 }, 
  
 { 
  
 "allowed_user_targeting_modes=" 
 , 
  
 ( 
 "The targeting modes to include in targeting for this configuration. " 
  
 + 
  
 "Specify this argument for each value you intend to include. Valid " 
  
 + 
  
 "targeting modes include: REMARKETING_ADS and INTEREST_BASED_TARGETING." 
 ), 
  
 allowed_user_targeting_modes 
  
 = 
>  
 allowedUserTargetingModes 
 . 
 Add 
 ( 
  
 allowed_user_targeting_modes 
 ) 
  
 }, 
  
 { 
  
 "excluded_content_label_ids=" 
 , 
  
 ( 
 "The sensitive content category IDs excluded in targeting for this " 
  
 + 
  
 "configuration. Specify this argument for each value you intend to  " 
  
 + 
  
 "include. Valid sensitive content category IDs can be found in: " 
  
 + 
  
 "https://storage.googleapis.com/adx-rtb-dictionaries/content-labels.txt" 
 ), 
  
 ( 
 long 
  
 excluded_content_label_ids 
 ) 
  
 = 
>  
 excludedContentLabelIds 
 . 
 Add 
 ( 
  
 excluded_content_label_ids 
 ) 
  
 }, 
  
 { 
  
 "included_user_id_types=" 
 , 
  
 ( 
 "The user identifier types included in targeting for this configuration. " 
  
 + 
  
 "Specify this argument for each value you intend to include. Valid values " 
  
 + 
  
 "include: HOSTED_MATCH_DATA, GOOGLE_COOKIE, and DEVICE_ID." 
 ), 
  
 included_user_id_types 
  
 = 
>  
 includedUserIdTypes 
 . 
 Add 
 ( 
 included_user_id_types 
 ) 
  
 }, 
  
 { 
  
 "included_language_codes=" 
 , 
  
 ( 
 "The languages represented by languages codes that are included in " 
  
 + 
  
 "targeting for this configuration. Specify this argument for each value " 
  
 + 
  
 "you intend to include. Valid language codes can be found in: " 
  
 + 
  
 "https://developers.google.com/adwords/api/docs/appendix/languagecodes." 
 ), 
  
 included_language_codes 
  
 = 
>  
 includedLanguageCodes 
 . 
 Add 
 ( 
 included_language_codes 
 ) 
  
 }, 
  
 { 
  
 "included_mobile_os_ids=" 
 , 
  
 ( 
 "The mobile OS IDs to include in targeting for this configuration. Specify " 
  
 + 
  
 "this argument for each value you intend to include. Valid mobile OS IDs " 
  
 + 
  
 "can be found in: " 
  
 + 
  
 "https://storage.googleapis.com/adx-rtb-dictionaries/mobile-os.csv" 
 ), 
  
 ( 
 long 
  
 included_mobile_os_ids 
 ) 
  
 = 
>  
 includedMobileOsIds 
 . 
 Add 
 ( 
  
 included_mobile_os_ids 
 ) 
  
 }, 
  
 { 
  
 "included_vertical_ids=" 
 , 
  
 ( 
 "The vertical IDs to include in targeting for this configuration. Specify " 
  
 + 
  
 "this argument for each value you intend to include. Valid vertical IDs " 
  
 + 
  
 "can be found in: https://developers.google.com/authorized-buyers/rtb/" 
  
 + 
  
 "downloads/publisher-verticals" 
 ), 
  
 ( 
 long 
  
 included_vertical_ids 
 ) 
  
 = 
>  
 includedVerticalIds 
 . 
 Add 
 ( 
 included_vertical_ids 
 ) 
  
 }, 
  
 { 
  
 "excluded_vertical_ids=" 
 , 
  
 ( 
 "The vertical IDs to exclude in targeting for this configuration. Specify " 
  
 + 
  
 "this argument for each value you intend to include. Valid vertical IDs " 
  
 + 
  
 "can be found in: https://developers.google.com/authorized-buyers/rtb/" 
  
 + 
  
 "downloads/publisher-verticals" 
 ), 
  
 ( 
 long 
  
 excluded_vertical_ids 
 ) 
  
 = 
>  
 excludedVerticalIds 
 . 
 Add 
 ( 
 excluded_vertical_ids 
 ) 
  
 }, 
  
 { 
  
 "included_platforms=" 
 , 
  
 ( 
 "The platforms to include in targeting for this configuration. Specify " 
  
 + 
  
 "this argument for each value you intend to include. Valid values include: " 
  
 + 
  
 "PERSONAL_COMPUTER, PHONE, TABLET, and CONNECTED_TV." 
 ), 
  
 included_platforms 
  
 = 
>  
 includedPlatforms 
 . 
 Add 
 ( 
 included_platforms 
 ) 
  
 }, 
  
 { 
  
 "included_creative_dimension_height=" 
 , 
  
 ( 
 "A creative dimension's height to be included in targeting for this " 
  
 + 
  
 "configuration. By default, this example will set the targeted height to " 
  
 + 
  
 "300. Note that while only a single set of dimensions are specified in " 
  
 + 
  
 "this sample, pretargeting configurations can target multiple creative " 
  
 + 
  
 "dimensions." 
 ), 
  
 ( 
 long 
  
 included_creative_dimension_height 
 ) 
  
 = 
>  
 includedCreativeDimensionHeight 
  
 = 
  
 ( 
  
 included_creative_dimension_height 
 ) 
  
 }, 
  
 { 
  
 "included_creative_dimension_width=" 
 , 
  
 ( 
 "A creative dimension's height to be included in targeting for this " 
  
 + 
  
 "configuration. By default, this example will set the targeted height to " 
  
 + 
  
 "300. Note that while only a single set of dimensions are specified in " 
  
 + 
  
 "this sample, pretargeting configurations can target multiple creative " 
  
 + 
  
 "dimensions." 
 ), 
  
 ( 
 long 
  
 included_creative_dimension_width 
 ) 
  
 = 
>  
 includedCreativeDimensionWidth 
  
 = 
  
 ( 
  
 included_creative_dimension_width 
 ) 
  
 }, 
  
 { 
  
 "included_environments=" 
 , 
  
 ( 
 "The environments to include in targeting for this configuration. Specify " 
  
 + 
  
 "this argument for each value you intend to include. Valid values include: " 
  
 + 
  
 "APP, and WEB." 
 ), 
  
 included_environments 
  
 = 
>  
 includedEnvironments 
 . 
 Add 
 ( 
 included_environments 
 ) 
  
 }, 
  
 { 
  
 "web_targeting_mode=" 
 , 
  
 ( 
 "The targeting mode for this configuration's web targeting. Valid values " 
  
 + 
  
 "include: INCLUSIVE, and EXCLUSIVE." 
 ), 
  
 web_targeting_mode 
  
 = 
>  
 webTargetingMode 
  
 = 
  
 web_targeting_mode 
  
 }, 
  
 { 
  
 "web_targeting_urls=" 
 , 
  
 ( 
 "The URLs specified for this configuration's web targeting, which allows " 
  
 + 
  
 "one to target a subset of site inventory. Specify this argument for each " 
  
 + 
  
 "value you intend to include. Values specified must be valid URLs." 
 ), 
  
 web_targeting_urls 
  
 = 
>  
 webTargetingUrls 
 . 
 Add 
 ( 
 web_targeting_urls 
 ) 
  
 }, 
  
 { 
  
 "mobile_app_targeting_mode=" 
 , 
  
 ( 
 "The targeting mode for this configuration's mobile app targeting. Valid " 
  
 + 
  
 "values include: INCLUSIVE, and EXCLUSIVE." 
 ), 
  
 mobile_app_targeting_mode 
  
 = 
>  
 mobileAppTargetingMode 
  
 = 
  
 mobile_app_targeting_mode 
  
 }, 
  
 { 
  
 "mobile_app_targeting_app_ids=" 
 , 
  
 ( 
 "The mobile app IDs specified for this configuration's mobile app " 
  
 + 
  
 "targeting, which allows one to target a subset of mobile app inventory. " 
  
 + 
  
 "Specify this argument for each value you intend to include. Values " 
  
 + 
  
 "specified must be valid URLs." 
 ), 
  
 mobile_app_targeting_app_ids 
  
 = 
>  
 mobileAppTargetingAppIds 
 . 
 Add 
 ( 
  
 mobile_app_targeting_app_ids 
 ) 
  
 }, 
  
 { 
  
 "included_mobile_app_targeting_category_ids=" 
 , 
  
 ( 
 "The mobile app category IDs to include in targeting for this " 
  
 + 
  
 "configuration. Specify this argument for each value you intend to " 
  
 + 
  
 "include. Valid category IDs can be found in: " 
  
 + 
  
 "https://developers.google.com/adwords/api/docs/appendix/" 
  
 + 
  
 "mobileappcategories.csv" 
 ), 
  
 ( 
 long 
  
 included_mobile_app_targeting_category_ids 
 ) 
  
 = 
>  
 includedMobileAppTargetingCategoryIds 
 . 
 Add 
 ( 
  
 included_mobile_app_targeting_category_ids 
 ) 
  
 }, 
  
 { 
  
 "excluded_mobile_app_targeting_category_ids=" 
 , 
  
 ( 
 "The mobile app category IDs to exclude in targeting for this " 
  
 + 
  
 "configuration. Specify this argument for each value you intend to " 
  
 + 
  
 "include. Valid category IDs can be found in: " 
  
 + 
  
 "https://developers.google.com/adwords/api/docs/appendix/" 
  
 + 
  
 "mobileappcategories.csv" 
 ), 
  
 ( 
 long 
  
 excluded_mobile_app_targeting_category_ids 
 ) 
  
 = 
>  
 excludedMobileAppTargetingCategoryIds 
 . 
 Add 
 ( 
  
 excluded_mobile_app_targeting_category_ids 
 ) 
  
 }, 
  
 { 
  
 "publisher_targeting_mode=" 
 , 
  
 ( 
 "The targeting mode for this configuration's publisher targeting. Valid " 
  
 + 
  
 "values include: INCLUSIVE, and EXCLUSIVE." 
 ), 
  
 publisher_targeting_mode 
  
 = 
>  
 publisherTargetingMode 
  
 = 
  
 publisher_targeting_mode 
  
 }, 
  
 { 
  
 "publisher_ids=" 
 , 
  
 ( 
 "The publisher IDs specified for this configuration's publisher targeting, " 
  
 + 
  
 "which allows one to target a subset of publisher inventory. Specify this " 
  
 + 
  
 "argument for each value you intend to include. Valid publisher IDs can be " 
  
 + 
  
 "found in Real-time Bidding bid requests, or alternatively in " 
  
 + 
  
 "ads.txt / app-ads.txt. For more information, see: " 
  
 + 
  
 "https://iabtechlab.com/ads-txt/" 
 ), 
  
 publisher_ids 
  
 = 
>  
 publisherIds 
 . 
 Add 
 ( 
 publisher_ids 
 ) 
  
 }, 
  
 { 
  
 "minimum_viewability_decile=" 
 , 
  
 ( 
 "The targeted minimum viewability decile, ranging from 0 - 10. A value of " 
  
 + 
  
 "'5' means that the configuration will only match adslots for which we " 
  
 + 
  
 "predict at least 50% viewability. Values > 10 will be rounded down to 10. " 
  
 + 
  
 "An unset value, or a value of '0', indicates that bid requests should be " 
  
 + 
  
 "sent regardless of viewability." 
 ), 
  
 ( 
 int 
  
 minimum_viewability_decile 
 ) 
  
 = 
>  
 minimumViewabilityDecile 
  
 = 
  
 ( 
  
 minimum_viewability_decile 
 ) 
  
 }, 
  
 }; 
  
 List<string> 
  
 extras 
  
 = 
  
 options 
 . 
 Parse 
 ( 
 exampleArgs 
 ); 
  
 var 
  
 parsedArgs 
  
 = 
  
 new 
  
 Dictionary<string 
 , 
  
 object 
> (); 
  
 // Show help message. 
  
 if 
 ( 
 showHelp 
  
 == 
  
 true 
 ) 
  
 { 
  
 options 
 . 
 WriteOptionDescriptions 
 ( 
 Console 
 . 
 Out 
 ); 
  
 Environment 
 . 
 Exit 
 ( 
 0 
 ); 
  
 } 
  
 // Set arguments. 
  
 parsedArgs 
 [ 
 "account_id" 
 ] 
  
 = 
  
 accountId 
 ; 
  
 parsedArgs 
 [ 
 "display_name" 
 ] 
  
 = 
  
 displayName 
  
 ?? 
  
 String 
 . 
 Format 
 ( 
  
 "TEST_PRETARGETING_CONFIG_{0}" 
 , 
  
 System 
 . 
 Guid 
 . 
 NewGuid 
 ()); 
  
 parsedArgs 
 [ 
 "interstitial_targeting" 
 ] 
  
 = 
  
 interstitialTargeting 
  
 ?? 
  
 ( 
  
 "ONLY_NON_INTERSTITIAL_REQUESTS" 
 ); 
  
 parsedArgs 
 [ 
 "included_creative_dimension_height" 
 ] 
  
 = 
  
 includedCreativeDimensionHeight 
  
 ?? 
  
 ( 
  
 300L 
 ); 
  
 parsedArgs 
 [ 
 "included_creative_dimension_width" 
 ] 
  
 = 
  
 includedCreativeDimensionWidth 
  
 ?? 
  
 ( 
  
 250L 
 ); 
  
 parsedArgs 
 [ 
 "minimum_viewability_decile" 
 ] 
  
 = 
  
 minimumViewabilityDecile 
  
 ?? 
  
 5 
 ; 
  
 parsedArgs 
 [ 
 "included_formats" 
 ] 
  
 = 
  
 includedFormats 
 ; 
  
 parsedArgs 
 [ 
 "included_geo_ids" 
 ] 
  
 = 
  
 includedGeoIds 
 ; 
  
 parsedArgs 
 [ 
 "excluded_geo_ids" 
 ] 
  
 = 
  
 excludedGeoIds 
 ; 
  
 parsedArgs 
 [ 
 "included_user_list_ids" 
 ] 
  
 = 
  
 includedUserListIds 
 ; 
  
 parsedArgs 
 [ 
 "excluded_user_list_ids" 
 ] 
  
 = 
  
 excludedUserListIds 
 ; 
  
 parsedArgs 
 [ 
 "allowed_user_targeting_modes" 
 ] 
  
 = 
  
 allowedUserTargetingModes 
 ; 
  
 parsedArgs 
 [ 
 "excluded_content_label_ids" 
 ] 
  
 = 
  
 excludedContentLabelIds 
 ; 
  
 parsedArgs 
 [ 
 "included_user_id_types" 
 ] 
  
 = 
  
 includedUserIdTypes 
 ; 
  
 parsedArgs 
 [ 
 "included_language_codes" 
 ] 
  
 = 
  
 includedLanguageCodes 
 ; 
  
 parsedArgs 
 [ 
 "included_mobile_os_ids" 
 ] 
  
 = 
  
 includedMobileOsIds 
 ; 
  
 parsedArgs 
 [ 
 "included_vertical_ids" 
 ] 
  
 = 
  
 includedVerticalIds 
 ; 
  
 parsedArgs 
 [ 
 "excluded_vertical_ids" 
 ] 
  
 = 
  
 excludedVerticalIds 
 ; 
  
 parsedArgs 
 [ 
 "included_platforms" 
 ] 
  
 = 
  
 includedPlatforms 
 ; 
  
 parsedArgs 
 [ 
 "included_environments" 
 ] 
  
 = 
  
 includedEnvironments 
 ; 
  
 parsedArgs 
 [ 
 "web_targeting_mode" 
 ] 
  
 = 
  
 webTargetingMode 
 ; 
  
 parsedArgs 
 [ 
 "web_targeting_urls" 
 ] 
  
 = 
  
 webTargetingUrls 
 ; 
  
 parsedArgs 
 [ 
 "mobile_app_targeting_mode" 
 ] 
  
 = 
  
 mobileAppTargetingMode 
 ; 
  
 parsedArgs 
 [ 
 "mobile_app_targeting_app_ids" 
 ] 
  
 = 
  
 mobileAppTargetingAppIds 
 ; 
  
 parsedArgs 
 [ 
 "included_mobile_app_targeting_category_ids" 
 ] 
  
 = 
  
 ( 
  
 includedMobileAppTargetingCategoryIds 
 ); 
  
 parsedArgs 
 [ 
 "excluded_mobile_app_targeting_category_ids" 
 ] 
  
 = 
  
 ( 
  
 excludedMobileAppTargetingCategoryIds 
 ); 
  
 parsedArgs 
 [ 
 "publisher_targeting_mode" 
 ] 
  
 = 
  
 publisherTargetingMode 
 ; 
  
 parsedArgs 
 [ 
 "publisher_ids" 
 ] 
  
 = 
  
 publisherIds 
 ; 
  
 // Validate that options were set correctly. 
  
 Utilities 
 . 
 ValidateOptions 
 ( 
 options 
 , 
  
 parsedArgs 
 , 
  
 requiredOptions 
 , 
  
 extras 
 ); 
  
 return 
  
 parsedArgs 
 ; 
  
 } 
  
 /// <summary> 
  
 /// Run the example. 
  
 /// </summary> 
  
 /// <param name="parsedArgs">Parsed arguments for the example.</param> 
  
 protected 
  
 override 
  
 void 
  
 Run 
 ( 
 Dictionary<string 
 , 
  
 object 
>  
 parsedArgs 
 ) 
  
 { 
  
 string 
  
 accountId 
  
 = 
  
 ( 
 string 
 ) 
  
 parsedArgs 
 [ 
 "account_id" 
 ]; 
  
 string 
  
 parent 
  
 = 
  
 $"bidders/{accountId}" 
 ; 
  
 NumericTargetingDimension 
  
 geoTargeting 
  
 = 
  
 new 
  
 NumericTargetingDimension 
 (); 
  
 geoTargeting 
 . 
 IncludedIds 
  
 = 
  
 ( 
 IList<long 
 ? 
> ) 
  
 parsedArgs 
 [ 
 "included_geo_ids" 
 ]; 
  
 geoTargeting 
 . 
 ExcludedIds 
  
 = 
  
 ( 
 IList<long 
 ? 
> ) 
  
 parsedArgs 
 [ 
 "excluded_geo_ids" 
 ]; 
  
 NumericTargetingDimension 
  
 userListTargeting 
  
 = 
  
 new 
  
 NumericTargetingDimension 
 (); 
  
 userListTargeting 
 . 
 IncludedIds 
  
 = 
  
 ( 
 IList<long 
 ? 
> ) 
  
 parsedArgs 
 [ 
 "included_user_list_ids" 
 ]; 
  
 userListTargeting 
 . 
 ExcludedIds 
  
 = 
  
 ( 
 IList<long 
 ? 
> ) 
  
 parsedArgs 
 [ 
 "excluded_user_list_ids" 
 ]; 
  
 NumericTargetingDimension 
  
 verticalTargeting 
  
 = 
  
 new 
  
 NumericTargetingDimension 
 (); 
  
 verticalTargeting 
 . 
 IncludedIds 
  
 = 
  
 ( 
 IList<long 
 ? 
> ) 
  
 parsedArgs 
 [ 
 "included_vertical_ids" 
 ]; 
  
 verticalTargeting 
 . 
 ExcludedIds 
  
 = 
  
 ( 
 IList<long 
 ? 
> ) 
  
 parsedArgs 
 [ 
 "excluded_vertical_ids" 
 ]; 
  
 CreativeDimensions 
  
 dimensions 
  
 = 
  
 new 
  
 CreativeDimensions 
 (); 
  
 dimensions 
 . 
 Height 
  
 = 
  
 ( 
 long? 
 ) 
  
 parsedArgs 
 [ 
 "included_creative_dimension_height" 
 ]; 
  
 dimensions 
 . 
 Width 
  
 = 
  
 ( 
 long? 
 ) 
  
 parsedArgs 
 [ 
 "included_creative_dimension_width" 
 ]; 
  
 StringTargetingDimension 
  
 webTargeting 
  
 = 
  
 new 
  
 StringTargetingDimension 
 (); 
  
 webTargeting 
 . 
 TargetingMode 
  
 = 
  
 ( 
 string 
 ) 
  
 parsedArgs 
 [ 
 "web_targeting_mode" 
 ]; 
  
 webTargeting 
 . 
 Values 
  
 = 
  
 ( 
 IList<string> 
 ) 
  
 parsedArgs 
 [ 
 "web_targeting_urls" 
 ]; 
  
 StringTargetingDimension 
  
 mobileAppTargeting 
  
 = 
  
 new 
  
 StringTargetingDimension 
 (); 
  
 mobileAppTargeting 
 . 
 TargetingMode 
  
 = 
  
 ( 
 string 
 ) 
  
 parsedArgs 
 [ 
 "mobile_app_targeting_mode" 
 ]; 
  
 mobileAppTargeting 
 . 
 Values 
  
 = 
  
 ( 
 IList<string> 
 ) 
  
 parsedArgs 
 [ 
 "mobile_app_targeting_app_ids" 
 ]; 
  
 NumericTargetingDimension 
  
 mobileAppCategoryTargeting 
  
 = 
  
 new 
  
 NumericTargetingDimension 
 (); 
  
 mobileAppCategoryTargeting 
 . 
 IncludedIds 
  
 = 
  
 ( 
 IList<long 
 ? 
> ) 
  
 parsedArgs 
 [ 
  
 "included_mobile_app_targeting_category_ids" 
 ]; 
  
 mobileAppCategoryTargeting 
 . 
 ExcludedIds 
  
 = 
  
 ( 
 IList<long 
 ? 
> ) 
  
 parsedArgs 
 [ 
  
 "excluded_mobile_app_targeting_category_ids" 
 ]; 
  
 AppTargeting 
  
 appTargeting 
  
 = 
  
 new 
  
 AppTargeting 
 (); 
  
 appTargeting 
 . 
 MobileAppTargeting 
  
 = 
  
 mobileAppTargeting 
 ; 
  
 appTargeting 
 . 
 MobileAppCategoryTargeting 
  
 = 
  
 mobileAppCategoryTargeting 
 ; 
  
 StringTargetingDimension 
  
 publisherTargeting 
  
 = 
  
 new 
  
 StringTargetingDimension 
 (); 
  
 publisherTargeting 
 . 
 TargetingMode 
  
 = 
  
 ( 
 string 
 ) 
  
 parsedArgs 
 [ 
 "publisher_targeting_mode" 
 ]; 
  
 publisherTargeting 
 . 
 Values 
  
 = 
  
 ( 
 IList<string> 
 ) 
  
 parsedArgs 
 [ 
 "publisher_ids" 
 ]; 
  
 PretargetingConfig 
  
 newConfig 
  
 = 
  
 new 
  
 PretargetingConfig 
 (); 
  
 newConfig 
 . 
 DisplayName 
  
 = 
  
 ( 
 string 
 ) 
  
 parsedArgs 
 [ 
 "display_name" 
 ]; 
  
 newConfig 
 . 
 IncludedFormats 
  
 = 
  
 ( 
 IList<string> 
 ) 
  
 parsedArgs 
 [ 
 "included_formats" 
 ]; 
  
 newConfig 
 . 
 GeoTargeting 
  
 = 
  
 geoTargeting 
 ; 
  
 newConfig 
 . 
 UserListTargeting 
  
 = 
  
 userListTargeting 
 ; 
  
 newConfig 
 . 
 InterstitialTargeting 
  
 = 
  
 ( 
 string 
 ) 
  
 parsedArgs 
 [ 
 "interstitial_targeting" 
 ]; 
  
 newConfig 
 . 
 AllowedUserTargetingModes 
  
 = 
  
 ( 
 IList<string> 
 ) 
  
 parsedArgs 
 [ 
  
 "allowed_user_targeting_modes" 
 ]; 
  
 newConfig 
 . 
 ExcludedContentLabelIds 
  
 = 
  
 ( 
 IList<long 
 ? 
> ) 
  
 parsedArgs 
 [ 
  
 "excluded_content_label_ids" 
 ]; 
  
 newConfig 
 . 
 IncludedUserIdTypes 
  
 = 
  
 ( 
 IList<string> 
 ) 
  
 parsedArgs 
 [ 
 "included_user_id_types" 
 ]; 
  
 newConfig 
 . 
 IncludedLanguages 
  
 = 
  
 ( 
 IList<string> 
 ) 
  
 parsedArgs 
 [ 
 "included_language_codes" 
 ]; 
  
 newConfig 
 . 
 IncludedMobileOperatingSystemIds 
  
 = 
  
 ( 
 IList<long 
 ? 
> ) 
  
 parsedArgs 
 [ 
  
 "included_mobile_os_ids" 
 ]; 
  
 newConfig 
 . 
 VerticalTargeting 
  
 = 
  
 verticalTargeting 
 ; 
  
 newConfig 
 . 
 IncludedPlatforms 
  
 = 
  
 ( 
 IList<string> 
 ) 
  
 parsedArgs 
 [ 
 "included_platforms" 
 ]; 
  
 newConfig 
 . 
 IncludedCreativeDimensions 
  
 = 
  
 new 
  
 List<CreativeDimensions> 
  
 { 
 dimensions 
 }; 
  
 newConfig 
 . 
 IncludedEnvironments 
  
 = 
  
 ( 
 IList<string> 
 ) 
  
 parsedArgs 
 [ 
 "included_environments" 
 ]; 
  
 newConfig 
 . 
 WebTargeting 
  
 = 
  
 webTargeting 
 ; 
  
 newConfig 
 . 
 AppTargeting 
  
 = 
  
 appTargeting 
 ; 
  
 newConfig 
 . 
 PublisherTargeting 
  
 = 
  
 publisherTargeting 
 ; 
  
 newConfig 
 . 
 MinimumViewabilityDecile 
  
 = 
  
 ( 
 int? 
 ) 
  
 parsedArgs 
 [ 
 "minimum_viewability_decile" 
 ]; 
  
 BiddersResource 
 . 
 PretargetingConfigsResource 
 . 
 CreateRequest 
  
 request 
  
 = 
  
 rtbService 
 . 
 Bidders 
 . 
 PretargetingConfigs 
 . 
 Create 
 ( 
 newConfig 
 , 
  
 parent 
 ); 
  
 PretargetingConfig 
  
 response 
  
 = 
  
 null 
 ; 
  
 Console 
 . 
 WriteLine 
 ( 
 "Creating pretargeting configuration for bidder: {0}" 
 , 
  
 parent 
 ); 
  
 try 
  
 { 
  
 response 
  
 = 
  
 request 
 . 
 Execute 
 (); 
  
 } 
  
 catch 
  
 ( 
 System 
 . 
 Exception 
  
 exception 
 ) 
  
 { 
  
 throw 
  
 new 
  
 ApplicationException 
 ( 
  
 $"Real-time Bidding API returned error response:\n{exception.Message}" 
 ); 
  
 } 
  
 Utilities 
 . 
 PrintPretargetingConfiguration 
 ( 
 response 
 ); 
  
 } 
  
 } 
 } 

 /* 
 * Copyright 2020 Google LLC 
 * 
 * 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 
 * 
 *    https://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. 
 */ 
 package 
  
 com.google.api.services.samples.authorizedbuyers.realtimebidding.v1.bidders.pretargetingconfigs 
 ; 
 import 
  
 com.google.api.services.realtimebidding.v1.RealTimeBidding 
 ; 
 import 
  
 com.google.api.services.realtimebidding.v1.model.AppTargeting 
 ; 
 import 
  
 com.google.api.services.realtimebidding.v1.model.CreativeDimensions 
 ; 
 import 
  
 com.google.api.services.realtimebidding.v1.model.NumericTargetingDimension 
 ; 
 import 
  
 com.google.api.services.realtimebidding.v1.model.PretargetingConfig 
 ; 
 import 
  
 com.google.api.services.realtimebidding.v1.model.StringTargetingDimension 
 ; 
 import 
  
 com.google.api.services.samples.authorizedbuyers.realtimebidding.Utils 
 ; 
 import 
  
 java.io.IOException 
 ; 
 import 
  
 java.security.GeneralSecurityException 
 ; 
 import 
  
 java.util.Collections 
 ; 
 import 
  
 java.util.UUID 
 ; 
 import 
  
 net.sourceforge.argparse4j.ArgumentParsers 
 ; 
 import 
  
 net.sourceforge.argparse4j.inf.ArgumentParser 
 ; 
 import 
  
 net.sourceforge.argparse4j.inf.ArgumentParserException 
 ; 
 import 
  
 net.sourceforge.argparse4j.inf.Namespace 
 ; 
 /** Creates a pretargeting configuration for the given bidder account ID. */ 
 public 
  
 class 
 CreatePretargetingConfigs 
  
 { 
  
 public 
  
 static 
  
 void 
  
 execute 
 ( 
 RealTimeBidding 
  
 client 
 , 
  
 Namespace 
  
 parsedArgs 
 ) 
  
 throws 
  
 IOException 
  
 { 
  
 Long 
  
 accountId 
  
 = 
  
 parsedArgs 
 . 
 getLong 
 ( 
 "account_id" 
 ); 
  
 String 
  
 parentBidderName 
  
 = 
  
 String 
 . 
 format 
 ( 
 "bidders/%s" 
 , 
  
 accountId 
 ); 
  
 NumericTargetingDimension 
  
 geoTargeting 
  
 = 
  
 new 
  
 NumericTargetingDimension 
 (); 
  
 geoTargeting 
 . 
 setIncludedIds 
 ( 
 parsedArgs 
 . 
< Long>getList 
 ( 
 "included_geo_ids" 
 )); 
  
 geoTargeting 
 . 
 setExcludedIds 
 ( 
 parsedArgs 
 . 
< Long>getList 
 ( 
 "excluded_geo_ids" 
 )); 
  
 NumericTargetingDimension 
  
 userListTargeting 
  
 = 
  
 new 
  
 NumericTargetingDimension 
 (); 
  
 userListTargeting 
 . 
 setIncludedIds 
 ( 
 parsedArgs 
 . 
< Long>getList 
 ( 
 "included_user_list_ids" 
 )); 
  
 userListTargeting 
 . 
 setExcludedIds 
 ( 
 parsedArgs 
 . 
< Long>getList 
 ( 
 "excluded_user_list_ids" 
 )); 
  
 NumericTargetingDimension 
  
 verticalTargeting 
  
 = 
  
 new 
  
 NumericTargetingDimension 
 (); 
  
 verticalTargeting 
 . 
 setIncludedIds 
 ( 
 parsedArgs 
 . 
< Long>getList 
 ( 
 "included_vertical_ids" 
 )); 
  
 verticalTargeting 
 . 
 setExcludedIds 
 ( 
 parsedArgs 
 . 
< Long>getList 
 ( 
 "excluded_vertical_ids" 
 )); 
  
 CreativeDimensions 
  
 dimensions 
  
 = 
  
 new 
  
 CreativeDimensions 
 (); 
  
 dimensions 
 . 
 setHeight 
 ( 
 parsedArgs 
 . 
 getLong 
 ( 
 "included_creative_dimension_height" 
 )); 
  
 dimensions 
 . 
 setWidth 
 ( 
 parsedArgs 
 . 
 getLong 
 ( 
 "included_creative_dimension_width" 
 )); 
  
 StringTargetingDimension 
  
 webTargeting 
  
 = 
  
 new 
  
 StringTargetingDimension 
 (); 
  
 webTargeting 
 . 
 setTargetingMode 
 ( 
 parsedArgs 
 . 
 getString 
 ( 
 "web_targeting_mode" 
 )); 
  
 webTargeting 
 . 
 setValues 
 ( 
 parsedArgs 
 . 
< String>getList 
 ( 
 "web_targeting_urls" 
 )); 
  
 StringTargetingDimension 
  
 mobileAppTargeting 
  
 = 
  
 new 
  
 StringTargetingDimension 
 (); 
  
 mobileAppTargeting 
 . 
 setTargetingMode 
 ( 
 parsedArgs 
 . 
 getString 
 ( 
 "mobile_app_targeting_mode" 
 )); 
  
 mobileAppTargeting 
 . 
 setValues 
 ( 
 parsedArgs 
 . 
< String>getList 
 ( 
 "mobile_app_targeting_app_ids" 
 )); 
  
 NumericTargetingDimension 
  
 mobileAppCategoryTargeting 
  
 = 
  
 new 
  
 NumericTargetingDimension 
 (); 
  
 mobileAppCategoryTargeting 
 . 
 setIncludedIds 
 ( 
  
 parsedArgs 
 . 
< Long>getList 
 ( 
 "included_mobile_app_targeting_category_ids" 
 )); 
  
 mobileAppCategoryTargeting 
 . 
 setExcludedIds 
 ( 
  
 parsedArgs 
 . 
< Long>getList 
 ( 
 "excluded_mobile_app_targeting_category_ids" 
 )); 
  
 AppTargeting 
  
 appTargeting 
  
 = 
  
 new 
  
 AppTargeting 
 (); 
  
 appTargeting 
 . 
 setMobileAppTargeting 
 ( 
 mobileAppTargeting 
 ); 
  
 appTargeting 
 . 
 setMobileAppCategoryTargeting 
 ( 
 mobileAppCategoryTargeting 
 ); 
  
 StringTargetingDimension 
  
 publisherTargeting 
  
 = 
  
 new 
  
 StringTargetingDimension 
 (); 
  
 publisherTargeting 
 . 
 setTargetingMode 
 ( 
 parsedArgs 
 . 
 getString 
 ( 
 "publisher_targeting_mode" 
 )); 
  
 publisherTargeting 
 . 
 setValues 
 ( 
 parsedArgs 
 . 
< String>getList 
 ( 
 "publisher_ids" 
 )); 
  
 PretargetingConfig 
  
 newPretargetingConfig 
  
 = 
  
 new 
  
 PretargetingConfig 
 (); 
  
 newPretargetingConfig 
 . 
 setDisplayName 
 ( 
 parsedArgs 
 . 
 getString 
 ( 
 "display_name" 
 )); 
  
 newPretargetingConfig 
 . 
 setIncludedFormats 
 ( 
 parsedArgs 
 . 
< String>getList 
 ( 
 "included_formats" 
 )); 
  
 newPretargetingConfig 
 . 
 setGeoTargeting 
 ( 
 geoTargeting 
 ); 
  
 newPretargetingConfig 
 . 
 setUserListTargeting 
 ( 
 userListTargeting 
 ); 
  
 newPretargetingConfig 
 . 
 setInterstitialTargeting 
 ( 
 parsedArgs 
 . 
 getString 
 ( 
 "interstitial_targeting" 
 )); 
  
 newPretargetingConfig 
 . 
 setAllowedUserTargetingModes 
 ( 
  
 parsedArgs 
 . 
< String>getList 
 ( 
 "allowed_user_targeting_modes" 
 )); 
  
 newPretargetingConfig 
 . 
 setExcludedContentLabelIds 
 ( 
  
 parsedArgs 
 . 
< Long>getList 
 ( 
 "excluded_content_label_ids" 
 )); 
  
 newPretargetingConfig 
 . 
 setIncludedUserIdTypes 
 ( 
  
 parsedArgs 
 . 
< String>getList 
 ( 
 "included_user_id_types" 
 )); 
  
 newPretargetingConfig 
 . 
 setIncludedLanguages 
 ( 
 parsedArgs 
 . 
< String>getList 
 ( 
 "included_languages" 
 )); 
  
 newPretargetingConfig 
 . 
 setIncludedMobileOperatingSystemIds 
 ( 
  
 parsedArgs 
 . 
< Long>getList 
 ( 
 "included_mobile_os_ids" 
 )); 
  
 newPretargetingConfig 
 . 
 setVerticalTargeting 
 ( 
 verticalTargeting 
 ); 
  
 newPretargetingConfig 
 . 
 setIncludedPlatforms 
 ( 
 parsedArgs 
 . 
< String>getList 
 ( 
 "included_platforms" 
 )); 
  
 newPretargetingConfig 
 . 
 setIncludedCreativeDimensions 
 ( 
 Collections 
 . 
 singletonList 
 ( 
 dimensions 
 )); 
  
 newPretargetingConfig 
 . 
 setIncludedEnvironments 
 ( 
  
 parsedArgs 
 . 
< String>getList 
 ( 
 "included_environments" 
 )); 
  
 newPretargetingConfig 
 . 
 setWebTargeting 
 ( 
 webTargeting 
 ); 
  
 newPretargetingConfig 
 . 
 setAppTargeting 
 ( 
 appTargeting 
 ); 
  
 newPretargetingConfig 
 . 
 setPublisherTargeting 
 ( 
 publisherTargeting 
 ); 
  
 newPretargetingConfig 
 . 
 setMinimumViewabilityDecile 
 ( 
  
 parsedArgs 
 . 
 getInt 
 ( 
 "minimum_viewability_decile" 
 )); 
  
 PretargetingConfig 
  
 pretargetingConfig 
  
 = 
  
 client 
  
 . 
 bidders 
 () 
  
 . 
 pretargetingConfigs 
 () 
  
 . 
 create 
 ( 
 parentBidderName 
 , 
  
 newPretargetingConfig 
 ) 
  
 . 
 execute 
 (); 
  
 System 
 . 
 out 
 . 
 printf 
 ( 
  
 "Created pretargeting configuration for bidder Account ID '%s':\n" 
 , 
  
 accountId 
 ); 
  
 Utils 
 . 
 printPretargetingConfig 
 ( 
 pretargetingConfig 
 ); 
  
 } 
  
 public 
  
 static 
  
 void 
  
 main 
 ( 
 String 
 [] 
  
 args 
 ) 
  
 { 
  
 ArgumentParser 
  
 parser 
  
 = 
  
 ArgumentParsers 
 . 
 newFor 
 ( 
 "CreatePretargetingConfigs" 
 ) 
  
 . 
 build 
 () 
  
 . 
 defaultHelp 
 ( 
 true 
 ) 
  
 . 
 description 
 (( 
 "Creates a pretargeting configuration for the given bidder account ID." 
 )); 
  
 parser 
  
 . 
 addArgument 
 ( 
 "-a" 
 , 
  
 "--account_id" 
 ) 
  
 . 
 help 
 ( 
  
 "The resource ID of the bidders resource under which the pretargeting " 
  
 + 
  
 "configuration is to be created." 
 ) 
  
 . 
 required 
 ( 
 true 
 ) 
  
 . 
 type 
 ( 
 Long 
 . 
 class 
 ); 
  
 parser 
  
 . 
 addArgument 
 ( 
 "-d" 
 , 
  
 "--display_name" 
 ) 
  
 . 
 help 
 ( 
  
 "The display name to associate with the new configuration. Must be unique among " 
  
 + 
  
 "all of a bidder's pretargeting configurations." 
 ) 
  
 . 
 setDefault 
 ( 
 String 
 . 
 format 
 ( 
 "TEST_PRETARGETING_CONFIG_%s" 
 , 
  
 UUID 
 . 
 randomUUID 
 ())); 
  
 parser 
  
 . 
 addArgument 
 ( 
 "--included_formats" 
 ) 
  
 . 
 help 
 ( 
  
 "Creative formats included by this configuration. Specify each ID separated by a space." 
  
 + 
  
 " An unset value will not filter any bid requests based on the format. Valid" 
  
 + 
  
 " values include: HTML, NATIVE, and VAST." 
 ) 
  
 . 
 type 
 ( 
 String 
 . 
 class 
 ) 
  
 . 
 nargs 
 ( 
 "*" 
 ); 
  
 parser 
  
 . 
 addArgument 
 ( 
 "--included_geo_ids" 
 ) 
  
 . 
 help 
 ( 
  
 "The geo IDs to include in targeting for this configuration. Specify each ID " 
  
 + 
  
 "separated by a space. Valid geo IDs can be found in:" 
  
 + 
  
 "https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv" 
 ) 
  
 . 
 type 
 ( 
 Long 
 . 
 class 
 ) 
  
 . 
 nargs 
 ( 
 "*" 
 ); 
  
 parser 
  
 . 
 addArgument 
 ( 
 "--excluded_geo_ids" 
 ) 
  
 . 
 help 
 ( 
  
 "The geo IDs to exclude in targeting for this configuration. Specify each ID " 
  
 + 
  
 "separated by a space. Valid geo IDs can be found in:" 
  
 + 
  
 "https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv" 
 ) 
  
 . 
 type 
 ( 
 Long 
 . 
 class 
 ) 
  
 . 
 nargs 
 ( 
 "*" 
 ); 
  
 parser 
  
 . 
 addArgument 
 ( 
 "--included_user_list_ids" 
 ) 
  
 . 
 help 
 ( 
  
 "The user list IDs to include in targeting for this configuration. Specify each ID" 
  
 + 
  
 " separated by a space. Valid user list IDs would include any found under the" 
  
 + 
  
 " buyers.userLists resource for a given bidder account, or any buyer accounts" 
  
 + 
  
 " under it." 
 ) 
  
 . 
 type 
 ( 
 Long 
 . 
 class 
 ) 
  
 . 
 nargs 
 ( 
 "*" 
 ); 
  
 parser 
  
 . 
 addArgument 
 ( 
 "--excluded_user_list_ids" 
 ) 
  
 . 
 help 
 ( 
  
 "The user list IDs to exclude in targeting for this configuration. Specify each ID" 
  
 + 
  
 " separated by a space. Valid user list IDs would include any found under the" 
  
 + 
  
 " buyers.userLists resource for a given bidder account, or any buyer accounts" 
  
 + 
  
 " under it." 
 ) 
  
 . 
 type 
 ( 
 Long 
 . 
 class 
 ) 
  
 . 
 nargs 
 ( 
 "*" 
 ); 
  
 parser 
  
 . 
 addArgument 
 ( 
 "--interstitial_targeting" 
 ) 
  
 . 
 help 
 ( 
  
 "The interstitial targeting specified for this configuration. By default, this " 
  
 + 
  
 "will be set to ONLY_NON_INTERSTITIAL_REQUESTS. Valid values include: " 
  
 + 
  
 "ONLY_INTERSTITIAL_REQUESTS and ONLY_NON_INTERSTITIAL_REQUESTS." 
 ) 
  
 . 
 setDefault 
 ( 
 "ONLY_NON_INTERSTITIAL_REQUESTS" 
 ); 
  
 parser 
  
 . 
 addArgument 
 ( 
 "--allowed_user_targeting_modes" 
 ) 
  
 . 
 help 
 ( 
  
 "The targeting modes to include in targeting for this configuration. Specify each " 
  
 + 
  
 "value separated by a space. Valid targeting modes include: REMARKETING_ADS and " 
  
 + 
  
 "INTEREST_BASED_TARGETING." 
 ) 
  
 . 
 type 
 ( 
 String 
 . 
 class 
 ) 
  
 . 
 nargs 
 ( 
 "*" 
 ); 
  
 parser 
  
 . 
 addArgument 
 ( 
 "--excluded_content_label_ids" 
 ) 
  
 . 
 help 
 ( 
  
 "The sensitive content category IDs excluded in targeting for this configuration." 
  
 + 
  
 " Specify each value separated by a space. Valid sensitive content category IDs" 
  
 + 
  
 " can be found in:" 
  
 + 
  
 " https://storage.googleapis.com/adx-rtb-dictionaries/content-labels.txt" 
 ) 
  
 . 
 type 
 ( 
 Long 
 . 
 class 
 ) 
  
 . 
 nargs 
 ( 
 "*" 
 ); 
  
 parser 
  
 . 
 addArgument 
 ( 
 "--included_user_id_types" 
 ) 
  
 . 
 help 
 ( 
  
 "The user identifier types included in targeting for this configuration. Specify " 
  
 + 
  
 "each value separated by a space. Valid values include: HOSTED_MATCH_DATA, " 
  
 + 
  
 "GOOGLE_COOKIE, and DEVICE_ID." 
 ) 
  
 . 
 type 
 ( 
 String 
 . 
 class 
 ) 
  
 . 
 nargs 
 ( 
 "*" 
 ); 
  
 parser 
  
 . 
 addArgument 
 ( 
 "--included_language_codes" 
 ) 
  
 . 
 help 
 ( 
  
 "The languages represented by languages codes that are included in targeting for this" 
  
 + 
  
 " configuration. Specify each code separated by a space. Valid language codes can" 
  
 + 
  
 " be found in: " 
  
 + 
  
 "https://developers.google.com/adwords/api/docs/appendix/languagecodes." 
 ) 
  
 . 
 type 
 ( 
 String 
 . 
 class 
 ) 
  
 . 
 nargs 
 ( 
 "*" 
 ); 
  
 parser 
  
 . 
 addArgument 
 ( 
 "--included_mobile_os_ids" 
 ) 
  
 . 
 help 
 ( 
  
 "The mobile OS IDs to include in targeting for this configuration. Specify each " 
  
 + 
  
 "value separated by a space. Valid mobile OS IDs can be found in: " 
  
 + 
  
 "https://storage.googleapis.com/adx-rtb-dictionaries/mobile-os.csv" 
 ) 
  
 . 
 type 
 ( 
 Long 
 . 
 class 
 ) 
  
 . 
 nargs 
 ( 
 "*" 
 ); 
  
 parser 
  
 . 
 addArgument 
 ( 
 "--included_vertical_ids" 
 ) 
  
 . 
 help 
 ( 
  
 "The vertical IDs to include in targeting for this configuration. Specify each ID" 
  
 + 
  
 " separated by a space. Valid vertical IDs can be found in: " 
  
 + 
  
 "https://developers.google.com/authorized-buyers/rtb/downloads/publisher-verticals" 
 ) 
  
 . 
 type 
 ( 
 Long 
 . 
 class 
 ) 
  
 . 
 nargs 
 ( 
 "*" 
 ); 
  
 parser 
  
 . 
 addArgument 
 ( 
 "--excluded_vertical_ids" 
 ) 
  
 . 
 help 
 ( 
  
 "The vertical IDs to exclude in targeting for this configuration. Specify each ID" 
  
 + 
  
 " separated by a space. Valid vertical IDs can be found in: " 
  
 + 
  
 "https://developers.google.com/authorized-buyers/rtb/downloads/publisher-verticals" 
 ) 
  
 . 
 type 
 ( 
 Long 
 . 
 class 
 ) 
  
 . 
 nargs 
 ( 
 "*" 
 ); 
  
 parser 
  
 . 
 addArgument 
 ( 
 "--included_platforms" 
 ) 
  
 . 
 help 
 ( 
  
 "The platforms to include in targeting for this configuration. Specify each value" 
  
 + 
  
 " separated by a space. Valid values include: PERSONAL_COMPUTER, PHONE, TABLET," 
  
 + 
  
 " and CONNECTED_TV." 
 ) 
  
 . 
 type 
 ( 
 String 
 . 
 class 
 ) 
  
 . 
 nargs 
 ( 
 "*" 
 ); 
  
 parser 
  
 . 
 addArgument 
 ( 
 "--included_creative_dimension_height" 
 ) 
  
 . 
 help 
 ( 
  
 "A creative dimension's height to be included in targeting for this configuration. By" 
  
 + 
  
 " default, this example will set the targeted height to 300. Note that while only" 
  
 + 
  
 " a single set of dimensions are specified in this sample, pretargeting" 
  
 + 
  
 " configurations can target multiple creative dimensions." 
 ) 
  
 . 
 type 
 ( 
 Long 
 . 
 class 
 ) 
  
 . 
 setDefault 
 ( 
 300L 
 ); 
  
 parser 
  
 . 
 addArgument 
 ( 
 "--included_creative_dimension_width" 
 ) 
  
 . 
 help 
 ( 
  
 "A creative dimension's width to be included in targeting for this configuration. By" 
  
 + 
  
 " default, this example will set the targeted width to 250. Note that while only" 
  
 + 
  
 " a single set of dimensions are specified in this sample, pretargeting" 
  
 + 
  
 " configurations can target multiple creative dimensions." 
 ) 
  
 . 
 type 
 ( 
 Long 
 . 
 class 
 ) 
  
 . 
 setDefault 
 ( 
 250L 
 ); 
  
 parser 
  
 . 
 addArgument 
 ( 
 "--included_environments" 
 ) 
  
 . 
 help 
 ( 
  
 "The environments to include in targeting for this configuration. Specify each " 
  
 + 
  
 "value separated by a space. Valid values include: APP, and WEB." 
 ) 
  
 . 
 type 
 ( 
 String 
 . 
 class 
 ) 
  
 . 
 nargs 
 ( 
 "*" 
 ); 
  
 parser 
  
 . 
 addArgument 
 ( 
 "--web_targeting_mode" 
 ) 
  
 . 
 help 
 ( 
  
 "The targeting mode for this configuration's web targeting. Valid values include: " 
  
 + 
  
 "INCLUSIVE, and EXCLUSIVE." 
 ) 
  
 . 
 type 
 ( 
 String 
 . 
 class 
 ); 
  
 parser 
  
 . 
 addArgument 
 ( 
 "--web_targeting_urls" 
 ) 
  
 . 
 help 
 ( 
  
 "The URLs specified for this configuration's web targeting, which allows one to target" 
  
 + 
  
 " a subset of site inventory. Specify each value separated by a space. Values" 
  
 + 
  
 " specified must be valid URLs." 
 ) 
  
 . 
 type 
 ( 
 String 
 . 
 class 
 ) 
  
 . 
 nargs 
 ( 
 "*" 
 ); 
  
 parser 
  
 . 
 addArgument 
 ( 
 "--mobile_app_targeting_mode" 
 ) 
  
 . 
 help 
 ( 
  
 "The targeting mode for the configuration's mobile app targeting. Valid values " 
  
 + 
  
 "include: INCLUSIVE, and EXCLUSIVE." 
 ) 
  
 . 
 type 
 ( 
 String 
 . 
 class 
 ); 
  
 parser 
  
 . 
 addArgument 
 ( 
 "--mobile_app_targeting_app_ids" 
 ) 
  
 . 
 help 
 ( 
  
 "The mobile app IDs specified for this configuration's mobile app targeting, which" 
  
 + 
  
 " allows one to target a subset of mobile app inventory. Specify each value" 
  
 + 
  
 " separated by a space. Values specified must be valid mobile App IDs, as found" 
  
 + 
  
 " on their respective app stores." 
 ) 
  
 . 
 type 
 ( 
 String 
 . 
 class 
 ) 
  
 . 
 nargs 
 ( 
 "*" 
 ); 
  
 parser 
  
 . 
 addArgument 
 ( 
 "--included_mobile_app_targeting_category_ids" 
 ) 
  
 . 
 help 
 ( 
  
 "The mobile app category IDs to include in targeting for this configuration. " 
  
 + 
  
 "Specify each ID separated by a space. Valid category IDs can be found in: " 
  
 + 
  
 "https://developers.google.com/adwords/api/docs/appendix/mobileappcategories.csv" 
 ) 
  
 . 
 type 
 ( 
 Long 
 . 
 class 
 ) 
  
 . 
 nargs 
 ( 
 "*" 
 ); 
  
 parser 
  
 . 
 addArgument 
 ( 
 "--excluded_mobile_app_targeting_category_ids" 
 ) 
  
 . 
 help 
 ( 
  
 "The mobile app category IDs to exclude in targeting for this configuration. " 
  
 + 
  
 "Specify each ID separated by a space. Valid category IDs can be found in: " 
  
 + 
  
 "https://developers.google.com/adwords/api/docs/appendix/mobileappcategories.csv" 
 ) 
  
 . 
 type 
 ( 
 Long 
 . 
 class 
 ) 
  
 . 
 nargs 
 ( 
 "*" 
 ); 
  
 parser 
  
 . 
 addArgument 
 ( 
 "--publisher_targeting_mode" 
 ) 
  
 . 
 help 
 ( 
  
 "The targeting mode for the configuration's publisher targeting. Valid values " 
  
 + 
  
 "include: INCLUSIVE, and EXCLUSIVE." 
 ) 
  
 . 
 type 
 ( 
 String 
 . 
 class 
 ); 
  
 parser 
  
 . 
 addArgument 
 ( 
 "--publisher_ids" 
 ) 
  
 . 
 help 
 ( 
  
 "The publisher IDs specified for this configuration's publisher targeting, which allows" 
  
 + 
  
 " one to target a subset of publisher inventory. Specify each ID separated by a" 
  
 + 
  
 " space. Valid publisher IDs can be found in Real-time Bidding bid requests, or" 
  
 + 
  
 " alternatively in ads.txt / app-ads.txt. For more information, see: " 
  
 + 
  
 "https://iabtechlab.com/ads-txt/" 
 ) 
  
 . 
 type 
 ( 
 String 
 . 
 class 
 ) 
  
 . 
 nargs 
 ( 
 "*" 
 ); 
  
 parser 
  
 . 
 addArgument 
 ( 
 "--minimum_viewability_decile" 
 ) 
  
 . 
 help 
 ( 
  
 "The targeted minimum viewability decile, ranging from 0 - 10. A value of '5' means" 
  
 + 
  
 " that the configuration will only match adslots for which we predict at least" 
  
 + 
  
 " 50% viewability. Values > 10 will be rounded down to 10. An unset value, or a" 
  
 + 
  
 " value of '0', indicates that bid requests should be sent regardless of" 
  
 + 
  
 " viewability." 
 ) 
  
 . 
 type 
 ( 
 String 
 . 
 class 
 ) 
  
 . 
 setDefault 
 ( 
 5 
 ); 
  
 Namespace 
  
 parsedArgs 
  
 = 
  
 null 
 ; 
  
 try 
  
 { 
  
 parsedArgs 
  
 = 
  
 parser 
 . 
 parseArgs 
 ( 
 args 
 ); 
  
 } 
  
 catch 
  
 ( 
 ArgumentParserException 
  
 ex 
 ) 
  
 { 
  
 parser 
 . 
 handleError 
 ( 
 ex 
 ); 
  
 System 
 . 
 exit 
 ( 
 1 
 ); 
  
 } 
  
 RealTimeBidding 
  
 client 
  
 = 
  
 null 
 ; 
  
 try 
  
 { 
  
 client 
  
 = 
  
 Utils 
 . 
 getRealTimeBiddingClient 
 (); 
  
 } 
  
 catch 
  
 ( 
 IOException 
  
 ex 
 ) 
  
 { 
  
 System 
 . 
 out 
 . 
 printf 
 ( 
 "Unable to create RealTimeBidding API service:\n%s" 
 , 
  
 ex 
 ); 
  
 System 
 . 
 out 
 . 
 println 
 ( 
 "Did you specify a valid path to a service account key file?" 
 ); 
  
 System 
 . 
 exit 
 ( 
 1 
 ); 
  
 } 
  
 catch 
  
 ( 
 GeneralSecurityException 
  
 ex 
 ) 
  
 { 
  
 System 
 . 
 out 
 . 
 printf 
 ( 
 "Unable to establish secure HttpTransport:\n%s" 
 , 
  
 ex 
 ); 
  
 System 
 . 
 exit 
 ( 
 1 
 ); 
  
 } 
  
 try 
  
 { 
  
 execute 
 ( 
 client 
 , 
  
 parsedArgs 
 ); 
  
 } 
  
 catch 
  
 ( 
 IOException 
  
 ex 
 ) 
  
 { 
  
 System 
 . 
 out 
 . 
 printf 
 ( 
 "RealTimeBidding API returned error response:\n%s" 
 , 
  
 ex 
 ); 
  
 System 
 . 
 exit 
 ( 
 1 
 ); 
  
 } 
  
 } 
 } 

< ?php 
 /** 
 * Copyright 2020 Google LLC 
 * 
 * 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 
 * 
 *    https://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. 
 */ 
 namespace Google\Ads\AuthorizedBuyers\RealTimeBidding\Examples\V1\Bidders_PretargetingConfigs; 
 use Google\Ads\AuthorizedBuyers\RealTimeBidding\ExampleUtil\BaseExample; 
 use Google\Ads\AuthorizedBuyers\RealTimeBidding\ExampleUtil\Config; 
 use Google_Service_RealTimeBidding_PretargetingConfig; 
 use Google_Service_RealTimeBidding_AppTargeting; 
 use Google_Service_RealTimeBidding_CreativeDimensions; 
 use Google_Service_RealTimeBidding_NumericTargetingDimension; 
 use Google_Service_RealTimeBidding_StringTargetingDimension; 
 /** 
 * Creates a pretargeting configuration for the given bidder account ID. 
 */ 
 class CreatePretargetingConfigs extends BaseExample 
 { 
 public function __construct($client) 
 { 
 $this->service = Config::getGoogleServiceRealTimeBidding($client); 
 } 
 /** 
 * @see BaseExample::getInputParameters() 
 */ 
 protected function getInputParameters() 
 { 
 return [ 
 [ 
 'name' => 'account_id', 
 'display' => 'Account ID', 
 'description' = 
> 'The resource ID of the bidders resource under which the pretargeting ' . 
 'configuration is to be created.', 
 'required' => true 
 ], 
 [ 
 'name' => 'display_name', 
 'display' => 'Display name', 
 'description' = 
> 'The display name to associate with the new configuration. Must be unique ' . 
 'among all of a bidder\'s pretargeting configurations.', 
 'required' => false, 
 'default' => 'TEST_PRETARGETING_CONFIG_' . uniqid() 
 ], 
 [ 
 'name' => 'included_formats', 
 'display' => 'Included formats', 
 'description' = 
> 'Creative formats included by this configuration. Specify each value ' . 
 'separated by a comma. An unset value will not filter any bid requests ' . 
 'based on the format. Valid values include: HTML, NATIVE, and VAST.', 
 'required' => false, 
 'is_array' => true, 
 'default' => [] 
 ], 
 [ 
 'name' => 'included_geo_ids', 
 'display' => 'Included geo IDs', 
 'description' = 
> 'The geo IDs to include in targeting for this configuration. Specify each ' . 
 'ID separated by a comma. Valid geo IDs can be found in: ' . 
 'https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv', 
 'required' => false, 
 'is_array' => true, 
 'default' => [] 
 ], 
 [ 
 'name' => 'excluded_geo_ids', 
 'display' => 'Excluded geo IDs', 
 'description' = 
> 'The geo IDs to exclude in targeting for this configuration. Specify each ' . 
 'ID separated by a comma. Valid geo IDs can be found in: ' . 
 'https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv', 
 'required' => false, 
 'is_array' => true, 
 'default' => [] 
 ], 
 [ 
 'name' => 'included_user_list_ids', 
 'display' => 'Included user list IDs', 
 'description' = 
> 'The user list IDs to include in targeting for this configuration. Specify ' . 
 'each ID separated by a comma. Valid user list IDs would include any found ' . 
 'under the buyers.userLists resource for a given bidder account, or any ' . 
 'buyer accounts under it.', 
 'required' => false, 
 'is_array' => true, 
 'default' => [] 
 ], 
 [ 
 'name' => 'excluded_user_list_ids', 
 'display' => 'Excluded user list IDs', 
 'description' = 
> 'The user list IDs to exclude in targeting for this configuration. Specify ' . 
 'each ID separated by a comma. Valid user list IDs would include any found ' . 
 'under the buyers.userLists resource for a given bidder account, or any ' . 
 'buyer accounts under it.', 
 'required' => false, 
 'is_array' => true, 
 'default' => [] 
 ], 
 [ 
 'name' => 'interstitial_targeting', 
 'display' => 'Interstitial targeting', 
 'description' = 
> 'The interstitial targeting specified for this configuration. By default, ' . 
 'this will be set to ONLY_NON_INTERSTITIAL_REQUESTS. Valid values include: ' . 
 'ONLY_INTERSTITIAL_REQUESTS and ONLY_NON_INTERSTITIAL_REQUESTS.', 
 'required' => false, 
 'default' => 'ONLY_NON_INTERSTITIAL_REQUESTS' 
 ], 
 [ 
 'name' => 'allowed_user_targeting_modes', 
 'display' => 'Allowed user targeting modes', 
 'description' = 
> 'The targeting modes to include in targeting for this configuration. ' . 
 'Specify each value separated by a comma. Valid targeting modes include: ' . 
 'REMARKETING_ADS and INTEREST_BASED_TARGETING.', 
 'required' => false, 
 'is_array' => true, 
 'default' => [] 
 ], 
 [ 
 'name' => 'excluded_content_label_ids', 
 'display' => 'Excluded content label IDs', 
 'description' = 
> 'The sensitive content category IDs excluded in targeting for this ' . 
 'configuration. Specify each value separated by a comma. Valid sensitive ' . 
 'content category IDs can be found in: ' . 
 'https://storage.googleapis.com/adx-rtb-dictionaries/content-labels.txt', 
 'required' => false, 
 'is_array' => true, 
 'default' => [] 
 ], 
 [ 
 'name' => 'included_user_id_types', 
 'display' => 'Included user ID types', 
 'description' = 
> 'The user identifier types included in targeting for this configuration. ' . 
 'Specify each value separated by a comma. Valid values include: ' . 
 'HOSTED_MATCH_DATA, GOOGLE_COOKIE, and DEVICE_ID.', 
 'required' => false, 
 'is_array' => true, 
 'default' => [] 
 ], 
 [ 
 'name' => 'included_language_codes', 
 'display' => 'Included language codes', 
 'description' = 
> 'The languages represented by languages codes that are included in ' . 
 'targeting for this configuration. Specify each code separated by a comma. ' . 
 'Valid language codes can be found in: ' . 
 'https://developers.google.com/adwords/api/docs/appendix/languagecodes.', 
 'required' => false, 
 'is_array' => true, 
 'default' => [] 
 ], 
 [ 
 'name' => 'included_mobile_os_ids', 
 'display' => 'Included mobile OS IDs', 
 'description' = 
> 'The mobile OS IDs to include in targeting for this configuration. Specify ' . 
 'each value separated by a comma. Valid mobile OS IDs can be found in: ' . 
 'https://storage.googleapis.com/adx-rtb-dictionaries/mobile-os.csv', 
 'required' => false, 
 'is_array' => true, 
 'default' => [] 
 ], 
 [ 
 'name' => 'included_vertical_ids', 
 'display' => 'Included vertical IDs', 
 'description' = 
> 'The vertical IDs to include in targeting for this configuration. Specify ' . 
 'each ID separated by a comma. Valid vertical IDs can be found in: ' . 
 'https://developers.google.com/authorized-buyers/rtb/downloads/' . 
 'publisher-verticals', 
 'required' => false, 
 'is_array' => true, 
 'default' => [] 
 ], 
 [ 
 'name' => 'excluded_vertical_ids', 
 'display' => 'Excluded vertical IDs', 
 'description' = 
> 'The vertical IDs to exclude in targeting for this configuration. Specify ' . 
 'each ID separated by a comma. Valid vertical IDs can be found in: ' . 
 'https://developers.google.com/authorized-buyers/rtb/downloads/' . 
 'publisher-verticals', 
 'required' => false, 
 'is_array' => true, 
 'default' => [] 
 ], 
 [ 
 'name' => 'included_platforms', 
 'display' => 'Included platforms', 
 'description' = 
> 'The platforms to include in targeting for this configuration. Specify each ' . 
 'value separated by a comma. Valid values include: PERSONAL_COMPUTER, ' . 
 'PHONE, TABLET, and CONNECTED_TV.', 
 'required' => false, 
 'is_array' => true, 
 'default' => [] 
 ], 
 [ 
 'name' => 'included_creative_dimension_height', 
 'display' => 'Included creative dimension height', 
 'description' = 
> 'A creative dimension\'s height to be included in targeting for this ' . 
 'configuration. By default, this example will set the targeted height to ' . 
 '300. Note that while only a single set of dimensions are specified in this ' . 
 'sample, pretargeting configurations can target multiple creative dimensions.', 
 'required' => false, 
 'default' => 300 
 ], 
 [ 
 'name' => 'included_creative_dimension_width', 
 'display' => 'Included creative dimension width', 
 'description' = 
> 'A creative dimension\'s width to be included in targeting for this ' . 
 'configuration. By default, this example will set the targeted height to ' . 
 '250. Note that while only a single set of dimensions are specified in this ' . 
 'sample, pretargeting configurations can target multiple creative dimensions.', 
 'required' => false, 
 'default' => 250 
 ], 
 [ 
 'name' => 'included_environments', 
 'display' => 'Included environments', 
 'description' = 
> 'The environments to include in targeting for this configuration. Specify ' . 
 'each value separated by a comma. Valid values include: APP, and WEB.', 
 'required' => false, 
 'is_array' => true, 
 'default' => [] 
 ], 
 [ 
 'name' => 'web_targeting_mode', 
 'display' => 'Web targeting mode', 
 'description' = 
> 'The targeting mode for this configuration\'s web targeting. Valid values ' . 
 'include: INCLUSIVE, and EXCLUSIVE.', 
 'required' => false, 
 'default' => null 
 ], 
 [ 
 'name' => 'web_targeting_urls', 
 'display' => 'Web targeting URLs', 
 'description' = 
> 'The URLs specified for this configuration\'s web targeting, which allows ' . 
 'one to target a subset of site inventory. Specify each value separated by ' . 
 'a comma. Values specified must be valid URLs.', 
 'required' => false, 
 'is_array' => true, 
 'default' => [] 
 ], 
 [ 
 'name' => 'mobile_app_targeting_mode', 
 'display' => 'Mobile app targeting mode', 
 'description' = 
> 'The targeting mode for this configuration\'s mobile app targeting. Valid ' . 
 'values include: INCLUSIVE, and EXCLUSIVE.', 
 'required' => false, 
 'default' => null 
 ], 
 [ 
 'name' => 'mobile_app_targeting_app_ids', 
 'display' => 'Mobile app targeting app IDs', 
 'description' = 
> 'The mobile app IDs specified for this configuration\'s mobile app ' . 
 'targeting, which allows one to target a subset of mobile app inventory. ' . 
 'Specify each value separated by a comma. Values specified must be valid ' . 
 'mobile App IDs, as found on their respective app stores.', 
 'required' => false, 
 'is_array' => true, 
 'default' => [] 
 ], 
 [ 
 'name' => 'included_mobile_app_targeting_category_ids', 
 'display' => 'Included mobile app targeting category IDs', 
 'description' = 
> 'The mobile app category IDs to include in targeting for this ' . 
 'configuration. Specify each ID separated by a comma. Valid category IDs ' . 
 'can be found in: https://developers.google.com/adwords/api/docs/appendix/' . 
 'mobileappcategories.csv', 
 'required' => false, 
 'is_array' => true, 
 'default' => [] 
 ], 
 [ 
 'name' => 'excluded_mobile_app_targeting_category_ids', 
 'display' => 'Excluded mobile app targeting category IDs', 
 'description' = 
> 'The mobile app category IDs to exclude in targeting for this ' . 
 'configuration. Specify each ID separated by a comma. Valid category IDs ' . 
 'can be found in: https://developers.google.com/adwords/api/docs/appendix/' . 
 'mobileappcategories.csv', 
 'required' => false, 
 'is_array' => true, 
 'default' => [] 
 ], 
 [ 
 'name' => 'publisher_targeting_mode', 
 'display' => 'Publisher targeting mode', 
 'description' = 
> 'The targeting mode for this configuration\'s publisher targeting. Valid ' . 
 'values include: INCLUSIVE, and EXCLUSIVE.', 
 'required' => false, 
 'default' => null 
 ], 
 [ 
 'name' => 'publisher_ids', 
 'display' => 'Publisher IDs', 
 'description' = 
> 'The publisher IDs specified for this configuration\'s publisher targeting, ' . 
 'which allows one to target a subset of publisher inventory. Specify each ' . 
 'ID separated by a comma. Valid publisher IDs can be found in Real-time ' . 
 'Bidding bid requests, or alternatively in ads.txt / app-ads.txt. For more ' . 
 'information, see: https://iabtechlab.com/ads-txt/', 
 'required' => false, 
 'is_array' => true, 
 'default' => [] 
 ], 
 [ 
 'name' => 'minimum_viewability_decile', 
 'display' => 'Minimum viewability decile', 
 'description' = 
> 'The targeted minimum viewability decile, ranging from 0 - 10. A value of ' . 
 '"5" means that the configuration will only match adslots for which we ' . 
 'predict at least 50% viewability. Values > 10 will be rounded down to 10. ' . 
 'An unset value, or a value of "0", indicates that bid requests should be ' . 
 'sent regardless of viewability.', 
 'required' => false, 
 'default' => null 
 ], 
 ]; 
 } 
 /** 
 * @see BaseExample::run() 
 */ 
 public function run() 
 { 
 $values = $this->formValues; 
 $parentName = "bidders/$values[account_id]"; 
 $geoTargeting = new Google_Service_RealTimeBidding_NumericTargetingDimension(); 
 $geoTargeting->includedIds = $values['included_geo_ids']; 
 $geoTargeting->excludedIds = $values['excluded_geo_ids']; 
 $userListTargeting = new Google_Service_RealTimeBidding_NumericTargetingDimension(); 
 $userListTargeting->includedIds = $values['included_user_list_ids']; 
 $userListTargeting->excludedIds = $values['excluded_user_list_ids']; 
 $verticalTargeting = new Google_Service_RealTimeBidding_NumericTargetingDimension(); 
 $verticalTargeting->includedIds = $values['included_vertical_ids']; 
 $verticalTargeting->excludedIds = $values['excluded_vertical_ids']; 
 $includedCreativeDimensions = new Google_Service_RealTimeBidding_CreativeDimensions(); 
 $includedCreativeDimensions->height = $values['included_creative_dimension_height']; 
 $includedCreativeDimensions->width = $values['included_creative_dimension_width']; 
 $webTargeting = new Google_Service_RealTimeBidding_StringTargetingDimension(); 
 $webTargeting->targetingMode = $values['web_targeting_mode']; 
 $webTargeting->values = $values['web_targeting_urls']; 
 $mobileAppTargeting = new Google_Service_RealTimeBidding_StringTargetingDimension(); 
 $mobileAppTargeting->targetingMode = $values['mobile_app_targeting_mode']; 
 $mobileAppTargeting->values = $values['mobile_app_targeting_app_ids']; 
 $mobileAppCategoryTargeting = new Google_Service_RealTimeBidding_NumericTargetingDimension(); 
 $mobileAppCategoryTargeting->includedIds = $values['included_mobile_app_targeting_category_ids']; 
 $mobileAppCategoryTargeting->excludedIds = $values['excluded_mobile_app_targeting_category_ids']; 
 $appTargeting = new Google_Service_RealTimeBidding_AppTargeting(); 
 $appTargeting->mobileAppTargeting = $mobileAppTargeting; 
 $appTargeting->mobileAppCategoryTargeting = $mobileAppCategoryTargeting; 
 $publisherTargeting = new Google_Service_RealTimeBidding_StringTargetingDimension(); 
 $publisherTargeting->targetingMode = $values['publisher_targeting_mode']; 
 $publisherTargeting->values = $values['publisher_ids']; 
 $newPretargetingConfig = new Google_Service_RealTimeBidding_PretargetingConfig(); 
 $newPretargetingConfig->displayName = $values['display_name']; 
 $newPretargetingConfig->includedFormats = $values['included_formats']; 
 $newPretargetingConfig->geoTargeting = $geoTargeting; 
 $newPretargetingConfig->userListTargeting = $userListTargeting; 
 $newPretargetingConfig->interstitialTargeting = $values['interstitial_targeting']; 
 $newPretargetingConfig->allowedUserTargetingModes = $values['allowed_user_targeting_modes']; 
 $newPretargetingConfig->excludedContentLabelIds = $values['excluded_content_label_ids']; 
 $newPretargetingConfig->includedUserIdTypes = $values['included_user_id_types']; 
 $newPretargetingConfig->includedLanguages = $values['included_languages']; 
 $newPretargetingConfig->includedMobileOperatingSystemIds = $values['included_mobile_os_ids']; 
 $newPretargetingConfig->verticalTargeting = $verticalTargeting; 
 $newPretargetingConfig->includedPlatforms = $values['included_platforms']; 
 $newPretargetingConfig->includedCreativeDimensions = [$includedCreativeDimensions]; 
 $newPretargetingConfig->includedEnvironments = $values['included_environments']; 
 $newPretargetingConfig->webTargeting = $webTargeting; 
 $newPretargetingConfig->appTargeting = $appTargeting; 
 $newPretargetingConfig->publisherTargeting = $publisherTargeting; 
 $newPretargetingConfig->minimumViewabilityDecile = $values['minimum_viewability_decile']; 
 print "<h2>Creating pretargeting configuration for '$parentName':</h2>"; 
 $result = $this->service->bidders_pretargetingConfigs->create($parentName, $newPretargetingConfig); 
 $this->printResult($result); 
 } 
 /** 
 * @see BaseExample::getName() 
 */ 
 public function getName() 
 { 
 return 'Create Pretargeting Configuration'; 
 } 
 } 

 #!/usr/bin/python 
 # 
 # Copyright 2020 Google Inc. 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. 
 """This example creates a pretargeting config for the given bidder account ID. 
 """ 
 import 
  
 argparse 
 import 
  
 os 
 import 
  
 pprint 
 import 
  
 sys 
 import 
  
 uuid 
 sys 
 . 
 path 
 . 
 insert 
 ( 
 0 
 , 
 os 
 . 
 path 
 . 
 abspath 
 ( 
 '../../..' 
 )) 
 from 
  
 googleapiclient.errors 
  
 import 
 HttpError 
 import 
  
 util 
 _BIDDER_NAME_TEMPLATE 
 = 
 'bidders/ 
 %s 
 ' 
 DEFAULT_BIDDER_RESOURCE_ID 
 = 
 'ENTER_BIDDER_RESOURCE_ID_HERE' 
 def 
  
 main 
 ( 
 realtimebidding 
 , 
 args 
 ): 
 account_id 
 = 
 args 
 . 
 account_id 
 body 
 = 
 { 
 'displayName' 
 : 
 args 
 . 
 display_name 
 , 
 'includedFormats' 
 : 
 args 
 . 
 included_formats 
 , 
 'geoTargeting' 
 : 
 { 
 'includedIds' 
 : 
 args 
 . 
 included_geo_ids 
 , 
 'excludedIds' 
 : 
 args 
 . 
 excluded_geo_ids 
 }, 
 'userListTargeting' 
 : 
 { 
 'includedIds' 
 : 
 args 
 . 
 included_user_list_ids 
 , 
 'excludedIds' 
 : 
 args 
 . 
 excluded_user_list_ids 
 }, 
 'interstitialTargeting' 
 : 
 args 
 . 
 interstitial_targeting 
 , 
 'allowedUserTargetingModes' 
 : 
 args 
 . 
 allowed_user_targeting_modes 
 , 
 'excludedContentLabelIds' 
 : 
 args 
 . 
 excluded_content_label_ids 
 , 
 'includedUserIdTypes' 
 : 
 args 
 . 
 included_user_id_types 
 , 
 'includedLanguages' 
 : 
 args 
 . 
 included_language_codes 
 , 
 'includedMobileOperatingSystemIds' 
 : 
 args 
 . 
 included_mobile_os_ids 
 , 
 'verticalTargeting' 
 : 
 { 
 'includedIds' 
 : 
 args 
 . 
 included_vertical_ids 
 , 
 'excludedIds' 
 : 
 args 
 . 
 excluded_vertical_ids 
 }, 
 'includedPlatforms' 
 : 
 args 
 . 
 included_platforms 
 , 
 'includedCreativeDimensions' 
 : 
 [{ 
 'height' 
 : 
 args 
 . 
 included_creative_dimension_height 
 , 
 'width' 
 : 
 args 
 . 
 included_creative_dimension_width 
 }], 
 'includedEnvironments' 
 : 
 args 
 . 
 included_environments 
 , 
 'webTargeting' 
 : 
 { 
 'targetingMode' 
 : 
 args 
 . 
 web_targeting_mode 
 , 
 'values' 
 : 
 args 
 . 
 web_targeting_urls 
 }, 
 'appTargeting' 
 : 
 { 
 'mobileAppTargeting' 
 : 
 { 
 'targetingMode' 
 : 
 args 
 . 
 mobile_app_targeting_mode 
 , 
 'values' 
 : 
 args 
 . 
 mobile_app_targeting_app_ids 
 }, 
 'mobileAppCategoryTargeting' 
 : 
 { 
 'includedIds' 
 : 
 args 
 . 
 included_mobile_app_targeting_category_ids 
 , 
 'excludedIds' 
 : 
 args 
 . 
 excluded_mobile_app_targeting_category_ids 
 } 
 }, 
 'publisherTargeting' 
 : 
 { 
 'targetingMode' 
 : 
 args 
 . 
 publisher_targeting_mode 
 , 
 'values' 
 : 
 args 
 . 
 publisher_ids 
 }, 
 'minimumViewabilityDecile' 
 : 
 args 
 . 
 minimum_viewability_decile 
 } 
 print 
 ( 
 'Creating a pretargeting configuration for account ID: ' 
 f 
 '" 
 { 
 account_id 
 } 
 ".' 
 ) 
 try 
 : 
 response 
 = 
 realtimebidding 
 . 
 bidders 
 () 
 . 
 pretargetingConfigs 
 () 
 . 
 create 
 ( 
 parent 
 = 
 _BIDDER_NAME_TEMPLATE 
 % 
 account_id 
 , 
 body 
 = 
 body 
 ) 
 . 
 execute 
 () 
 except 
 HttpError 
 as 
 e 
 : 
 print 
 ( 
 e 
 ) 
 sys 
 . 
 exit 
 ( 
 1 
 ) 
 pprint 
 . 
 pprint 
 ( 
 response 
 ) 
 if 
 __name__ 
 == 
 '__main__' 
 : 
 try 
 : 
 service 
 = 
 util 
 . 
 GetService 
 ( 
 version 
 = 
 'v1' 
 ) 
 except 
 IOError 
 as 
 ex 
 : 
 print 
 ( 
 f 
 'Unable to create realtimebidding service - 
 { 
 ex 
 } 
 ' 
 ) 
 print 
 ( 
 'Did you specify the key file in util.py?' 
 ) 
 sys 
 . 
 exit 
 ( 
 1 
 ) 
 parser 
 = 
 argparse 
 . 
 ArgumentParser 
 ( 
 description 
 = 
 ( 
 'Creates a pretargeting configuration for the given bidder ' 
 'account.' 
 )) 
 # Required fields. 
 parser 
 . 
 add_argument 
 ( 
 '-a' 
 , 
 '--account_id' 
 , 
 default 
 = 
 DEFAULT_BIDDER_RESOURCE_ID 
 , 
 help 
 = 
 ( 
 'The resource ID of the bidders resource under which the ' 
 'pretargeting configuration is to be created.' 
 )) 
 # Optional fields. 
 parser 
 . 
 add_argument 
 ( 
 '-d' 
 , 
 '--display_name' 
 , 
 default 
 = 
 f 
 'TEST_PRETARGETING_CONFIG_ 
 { 
 uuid 
 . 
 uuid4 
 () 
 } 
 ' 
 , 
 help 
 = 
 ( 
 'The display name to associate with the new configuration. Must ' 
 'be unique among all of a bidder 
 \' 
 s pretargeting configurations.' 
 )) 
 parser 
 . 
 add_argument 
 ( 
 '--included_formats' 
 , 
 nargs 
 = 
 '*' 
 , 
 default 
 = 
 [], 
 help 
 = 
 ( 
 'Creative formats included by this configuration. An unset value ' 
 'will not filter any bid requests based on the format. Valid ' 
 'values include: HTML, NATIVE, and VAST.' 
 )) 
 parser 
 . 
 add_argument 
 ( 
 '--included_geo_ids' 
 , 
 nargs 
 = 
 '*' 
 , 
 default 
 = 
 [], 
 help 
 = 
 ( 
 'The geo IDs to include in targeting for this configuration. ' 
 'Specify each ID separated by a space. Valid geo IDs can be found ' 
 'in: https://storage.googleapis.com/adx-rtb-dictionaries/' 
 'geo-table.csv' 
 )) 
 parser 
 . 
 add_argument 
 ( 
 '--excluded_geo_ids' 
 , 
 nargs 
 = 
 '*' 
 , 
 default 
 = 
 [], 
 help 
 = 
 ( 
 'The geo IDs to exclude in targeting for this configuration. ' 
 'Specify each ID separated by a space. Valid geo IDs can be found ' 
 'in: https://storage.googleapis.com/adx-rtb-dictionaries/' 
 'geo-table.csv' 
 )) 
 parser 
 . 
 add_argument 
 ( 
 '--included_user_list_ids' 
 , 
 nargs 
 = 
 '*' 
 , 
 default 
 = 
 [], 
 help 
 = 
 ( 
 'The user list IDs to include in targeting for this ' 
 'configuration. Specify each ID separated by a space. Valid user ' 
 'list IDs would include any found under the buyers.userLists ' 
 'resource for a given bidder account, or any buyer accounts under ' 
 'it.' 
 )) 
 parser 
 . 
 add_argument 
 ( 
 '--excluded_user_list_ids' 
 , 
 nargs 
 = 
 '*' 
 , 
 default 
 = 
 [], 
 help 
 = 
 ( 
 'The user list IDs to exclude in targeting for this ' 
 'configuration. Specify each ID separated by a space. Valid user ' 
 'list IDs would include any found under the buyers.userLists ' 
 'resource for a given bidder account, or any buyer accounts under ' 
 'it.' 
 )) 
 parser 
 . 
 add_argument 
 ( 
 '--interstitial_targeting' 
 , 
 default 
 = 
 'ONLY_NON_INTERSTITIAL_REQUESTS' 
 , 
 help 
 = 
 ( 
 'The interstitial targeting specified for this configuration. By ' 
 'default, this will be set to ONLY_NON_INTERSTITIAL_REQUESTS. ' 
 'Valid values include: ONLY_INTERSTITIAL_REQUESTS and ' 
 'ONLY_NON_INTERSTITIAL_REQUESTS.' 
 )) 
 parser 
 . 
 add_argument 
 ( 
 '--allowed_user_targeting_modes' 
 , 
 nargs 
 = 
 '*' 
 , 
 default 
 = 
 [], 
 help 
 = 
 ( 
 'The targeting modes to include in targeting for this ' 
 'configuration. Specify each value separated by a space. Valid ' 
 'targeting modes include: REMARKETING_ADS and ' 
 'INTEREST_BASED_TARGETING.' 
 )) 
 parser 
 . 
 add_argument 
 ( 
 '--excluded_content_label_ids' 
 , 
 nargs 
 = 
 '*' 
 , 
 default 
 = 
 [], 
 help 
 = 
 ( 
 'The sensitive content category IDs excluded in targeting for ' 
 'this configuration. Valid sensitive content category IDs can be ' 
 'found in: https://storage.googleapis.com/adx-rtb-dictionaries/' 
 'content-labels.txt' 
 )) 
 parser 
 . 
 add_argument 
 ( 
 '--included_user_id_types' 
 , 
 nargs 
 = 
 '*' 
 , 
 default 
 = 
 [], 
 help 
 = 
 ( 
 'The user identifier types included in targeting for this ' 
 'configuration. Specify each value separated by a space. Valid ' 
 'values include: HOSTED_MATCH_DATA, GOOGLE_COOKIE, and DEVICE_ID.' 
 )) 
 parser 
 . 
 add_argument 
 ( 
 '--included_language_codes' 
 , 
 nargs 
 = 
 '*' 
 , 
 default 
 = 
 [], 
 help 
 = 
 ( 
 'The languages represented by languages codes that are included ' 
 'in targeting for this configuration. Specify each code separated ' 
 'by a space. Valid language codes can be found in: ' 
 'https://developers.google.com/adwords/api/docs/appendix/' 
 'languagecodes.' 
 )) 
 parser 
 . 
 add_argument 
 ( 
 '--included_mobile_os_ids' 
 , 
 nargs 
 = 
 '*' 
 , 
 default 
 = 
 [], 
 help 
 = 
 ( 
 'The mobile OS IDs to include in targeting for this ' 
 'configuration. Specify each value separated by a space. Valid ' 
 'mobile OS IDs can be found in: ' 
 'https://storage.googleapis.com/adx-rtb-dictionaries/mobile-os.csv' 
 )) 
 parser 
 . 
 add_argument 
 ( 
 '--included_vertical_ids' 
 , 
 nargs 
 = 
 '*' 
 , 
 default 
 = 
 [], 
 help 
 = 
 ( 
 'The vertical IDs to include in targeting for this configuration. ' 
 'Specify each ID separated by a space. Valid vertical IDs can be ' 
 'found in: ' 
 'https://developers.google.com/authorized-buyers/rtb/downloads/' 
 'publisher-verticals' 
 )) 
 parser 
 . 
 add_argument 
 ( 
 '--excluded_vertical_ids' 
 , 
 nargs 
 = 
 '*' 
 , 
 default 
 = 
 [], 
 help 
 = 
 ( 
 'The vertical IDs to exclude in targeting for this configuration. ' 
 'Specify each ID separated by a space. Valid vertical IDs can be ' 
 'found in: ' 
 'https://developers.google.com/authorized-buyers/rtb/downloads/' 
 'publisher-verticals' 
 )) 
 parser 
 . 
 add_argument 
 ( 
 '--included_platforms' 
 , 
 nargs 
 = 
 '*' 
 , 
 default 
 = 
 [], 
 help 
 = 
 ( 
 'The platforms to include in targeting for this configuration. ' 
 'Specify each value separated by a space. Valid values include: ' 
 'PERSONAL_COMPUTER, PHONE, TABLET, and CONNECTED_TV.' 
 )) 
 parser 
 . 
 add_argument 
 ( 
 '--included_creative_dimension_height' 
 , 
 default 
 = 
 300 
 , 
 help 
 = 
 ( 
 'A creative dimension\s height to be included in targeting for ' 
 'this configuration. By default, this example will set the ' 
 'targeted height to 300. Note that while only a single set of ' 
 'dimensions are specified in this sample, pretargeting ' 
 'configurations can target multiple creative dimensions.' 
 )) 
 parser 
 . 
 add_argument 
 ( 
 '--included_creative_dimension_width' 
 , 
 default 
 = 
 250 
 , 
 help 
 = 
 ( 
 'A creative dimension\s width to be included in targeting for ' 
 'this configuration. By default, this example will set the ' 
 'targeted height to 250. Note that while only a single set of ' 
 'dimensions are specified in this sample, pretargeting ' 
 'configurations can target multiple creative dimensions.' 
 )) 
 parser 
 . 
 add_argument 
 ( 
 '--included_environments' 
 , 
 nargs 
 = 
 '*' 
 , 
 default 
 = 
 [], 
 help 
 = 
 ( 
 'The environments to include in targeting for this configuration. ' 
 'Specify each value separated by a space. Valid values include: ' 
 'APP, and WEB.' 
 )) 
 parser 
 . 
 add_argument 
 ( 
 '--web_targeting_mode' 
 , 
 default 
 = 
 None 
 , 
 help 
 = 
 ( 
 'The targeting mode for this configuration 
 \' 
 s web targeting. ' 
 'Valid values include: INCLUSIVE, and EXCLUSIVE.' 
 )) 
 parser 
 . 
 add_argument 
 ( 
 '--web_targeting_urls' 
 , 
 nargs 
 = 
 '*' 
 , 
 default 
 = 
 [], 
 help 
 = 
 ( 
 'The URLs specified for this configuration 
 \' 
 s web targeting, ' 
 'which allows one to target a subset of site inventory. Specify ' 
 'each value separated by a space. Values specified must be valid ' 
 'URLs.' 
 )) 
 parser 
 . 
 add_argument 
 ( 
 '--mobile_app_targeting_mode' 
 , 
 default 
 = 
 None 
 , 
 help 
 = 
 ( 
 'The targeting mode for the configuration 
 \' 
 s mobile app ' 
 'targeting. Valid values include: INCLUSIVE, and EXCLUSIVE.' 
 )) 
 parser 
 . 
 add_argument 
 ( 
 '--mobile_app_targeting_app_ids' 
 , 
 nargs 
 = 
 '*' 
 , 
 default 
 = 
 [], 
 help 
 = 
 ( 
 'The mobile app IDs specified for this configuration 
 \' 
 s mobile ' 
 'app targeting, which allows one to target a subset of mobile app ' 
 'inventory. Specify each value separated by a space. Values ' 
 'specified must be valid mobile App IDs, as found on their ' 
 'respective app stores.' 
 )) 
 parser 
 . 
 add_argument 
 ( 
 '--included_mobile_app_targeting_category_ids' 
 , 
 nargs 
 = 
 '*' 
 , 
 default 
 = 
 [], 
 help 
 = 
 ( 
 'The mobile app category IDs to include in targeting for this ' 
 'configuration. Specify each ID separated by a space. Valid ' 
 'category IDs can be found in:' 
 'https://developers.google.com/adwords/api/docs/appendix/' 
 'mobileappcategories.csv' 
 )) 
 parser 
 . 
 add_argument 
 ( 
 '--excluded_mobile_app_targeting_category_ids' 
 , 
 nargs 
 = 
 '*' 
 , 
 default 
 = 
 [], 
 help 
 = 
 ( 
 'The mobile app category IDs to exclude in targeting for this ' 
 'configuration. Specify each ID separated by a space. Valid ' 
 'category IDs can be found in:' 
 'https://developers.google.com/adwords/api/docs/appendix/' 
 'mobileappcategories.csv' 
 )) 
 parser 
 . 
 add_argument 
 ( 
 '--publisher_targeting_mode' 
 , 
 default 
 = 
 None 
 , 
 help 
 = 
 ( 
 'The targeting mode for the configuration 
 \' 
 s publisher targeting. ' 
 'Valid values include: INCLUSIVE, and EXCLUSIVE.' 
 )) 
 parser 
 . 
 add_argument 
 ( 
 '--publisher_ids' 
 , 
 nargs 
 = 
 '*' 
 , 
 default 
 = 
 [], 
 help 
 = 
 ( 
 'The publisher IDs specified for this configuration 
 \' 
 s publisher ' 
 'targeting, which allows one to target a subset of publisher ' 
 'inventory. Specify each ID separated by a space. Valid publisher ' 
 'IDs can be found in Real-time Bidding bid requests, or ' 
 'alternatively in ads.txt / app-ads.txt. For more information, ' 
 'see: https://iabtechlab.com/ads-txt/' 
 )) 
 parser 
 . 
 add_argument 
 ( 
 '-m' 
 , 
 '--minimum_viewability_decile' 
 , 
 default 
 = 
 5 
 , 
 help 
 = 
 ( 
 'The display name to associate with the new configuration. Must ' 
 'be unique among all of a bidder 
 \' 
 s pretargeting configurations.' 
 )) 
 args 
 = 
 parser 
 . 
 parse_args 
 () 
 main 
 ( 
 service 
 , 
 args 
 ) 

 #!/usr/bin/env ruby 
 # Encoding: utf-8 
 # 
 # Copyright:: Copyright 2020 Google LLC 
 # 
 # License:: 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. 
 # 
 # Creates a pretargeting configuration for the given bidder account ID. 
 require 
  
 'optparse' 
 require 
  
 'securerandom' 
 require_relative 
  
 '../../../util' 
 def 
  
 create_pretargeting_configs 
 ( 
 realtimebidding 
 , 
  
 options 
 ) 
  
 parent 
  
 = 
  
 "bidders/ 
 #{ 
 options 
 [ 
 :account_id 
 ] 
 } 
 " 
  
 body 
  
 = 
  
 Google 
 :: 
 Apis 
 :: 
 RealtimebiddingV1 
 :: 
 PretargetingConfig 
 . 
 new 
 ( 
  
 display_name 
 : 
  
 options 
 [ 
 :display_name 
 ] 
 , 
  
 included_formats 
 : 
  
 options 
 [ 
 :included_formats 
 ] 
 , 
  
 geo_targeting 
 : 
  
 Google 
 :: 
 Apis 
 :: 
 RealtimebiddingV1 
 :: 
 NumericTargetingDimension 
 . 
 new 
 ( 
  
 included_ids 
 : 
  
 options 
 [ 
 :included_geo_ids 
 ] 
 , 
  
 excluded_ids 
 : 
  
 options 
 [ 
 :excluded_geo_ids 
 ] 
  
 ), 
  
 user_list_targeting 
 : 
  
 Google 
 :: 
 Apis 
 :: 
 RealtimebiddingV1 
 :: 
 NumericTargetingDimension 
 . 
 new 
 ( 
  
 included_ids 
 : 
  
 options 
 [ 
 :included_user_list_ids 
 ] 
 , 
  
 excluded_ids 
 : 
  
 options 
 [ 
 :excluded_user_list_ids 
 ] 
  
 ), 
  
 interstitial_targeting 
 : 
  
 options 
 [ 
 :interstitial_targeting 
 ] 
 , 
  
 allowed_user_targeting_modes 
 : 
  
 options 
 [ 
 :allowed_user_targeting_modes 
 ] 
 , 
  
 excluded_content_label_ids 
 : 
  
 options 
 [ 
 :excluded_content_label_ids 
 ] 
 , 
  
 included_user_id_types 
 : 
  
 options 
 [ 
 :included_user_id_types 
 ] 
 , 
  
 included_languages 
 : 
  
 options 
 [ 
 :included_language_codes 
 ] 
 , 
  
 included_mobile_operating_system_ids 
 : 
  
 options 
 [ 
 :included_mobile_os_ids 
 ] 
 , 
  
 vertical_targeting 
 : 
  
 Google 
 :: 
 Apis 
 :: 
 RealtimebiddingV1 
 :: 
 NumericTargetingDimension 
 . 
 new 
 ( 
  
 included_ids 
 : 
  
 options 
 [ 
 :included_vertical_ids 
 ] 
 , 
  
 excluded_ids 
 : 
  
 options 
 [ 
 :excluded_vertical_ids 
 ] 
  
 ), 
  
 included_platforms 
 : 
  
 options 
 [ 
 :included_platforms 
 ] 
 , 
  
 included_creative_dimensions 
 : 
  
 [ 
 Google 
 :: 
 Apis 
 :: 
 RealtimebiddingV1 
 :: 
 CreativeDimensions 
 . 
 new 
 ( 
  
 height 
 : 
  
 options 
 [ 
 :included_creative_dimension_height 
 ] 
 , 
  
 width 
 : 
  
 options 
 [ 
 :included_creative_dimension_width 
 ] 
  
 ) 
 ] 
 , 
  
 included_environments 
 : 
  
 options 
 [ 
 :included_environments 
 ] 
 , 
  
 web_targeting 
 : 
  
 Google 
 :: 
 Apis 
 :: 
 RealtimebiddingV1 
 :: 
 StringTargetingDimension 
 . 
 new 
 ( 
  
 targeting_mode 
 : 
  
 options 
 [ 
 :web_targeting_mode 
 ] 
 , 
  
 values 
 : 
  
 options 
 [ 
 :web_targeting_urls 
 ] 
  
 ), 
  
 app_targeting 
 : 
  
 Google 
 :: 
 Apis 
 :: 
 RealtimebiddingV1 
 :: 
 AppTargeting 
 . 
 new 
 ( 
  
 mobile_app_targeting 
 : 
  
 Google 
 :: 
 Apis 
 :: 
 RealtimebiddingV1 
 :: 
 StringTargetingDimension 
 . 
 new 
 ( 
  
 targeting_mode 
 : 
  
 options 
 [ 
 :mobile_app_targeting_mode 
 ] 
 , 
  
 values 
 : 
  
 options 
 [ 
 :mobile_app_targeting_app_ids 
 ] 
  
 ), 
  
 mobile_app_category_targeting 
 : 
  
 Google 
 :: 
 Apis 
 :: 
 RealtimebiddingV1 
 :: 
 NumericTargetingDimension 
 . 
 new 
 ( 
  
 included_ids 
 : 
  
 options 
 [ 
 :included_mobile_app_targeting_category_ids 
 ] 
 , 
  
 excluded_ids 
 : 
  
 options 
 [ 
 :excluded_mobile_app_targeting_category_ids 
 ] 
  
 ) 
  
 ), 
  
 publisher_targeting 
 : 
  
 Google 
 :: 
 Apis 
 :: 
 RealtimebiddingV1 
 :: 
 StringTargetingDimension 
 . 
 new 
 ( 
  
 targeting_mode 
 : 
  
 options 
 [ 
 :publisher_targeting_mode 
 ] 
 , 
  
 values 
 : 
  
 options 
 [ 
 :publisher_ids 
 ] 
  
 ), 
  
 minimum_viewability_decile 
 : 
  
 options 
 [ 
 :minimum_viewability_decile 
 ] 
  
 ) 
  
 puts 
  
 "Creating a pretargeting configuration for bidder account ' 
 #{ 
 parent 
 } 
 '" 
  
 pretargeting_config 
  
 = 
  
 realtimebidding 
 . 
 create_bidder_pretargeting_config 
 ( 
 parent 
 , 
  
 body 
 ) 
  
 print_pretargeting_config 
 ( 
 pretargeting_config 
 ) 
 end 
 if 
  
 __FILE__ 
  
 == 
  
 $0 
  
 begin 
  
 # Retrieve the service used to make API requests. 
  
 service 
  
 = 
  
 get_service 
 () 
  
 rescue 
  
 ArgumentError 
  
 = 
>  
 e 
  
 raise 
  
 'Unable to create service, with error message: 
 #{ 
 e 
 . 
 message 
 } 
 ' 
  
 rescue 
  
 Signet 
 :: 
 AuthorizationError 
  
 = 
>  
 e 
  
 raise 
  
 'Unable to create service, was the KEY_FILE in util.rb set? Error message: 
 #{ 
 e 
 . 
 message 
 } 
 ' 
  
 end 
  
 # Set options and default values for fields used in this example. 
  
 options 
  
 = 
  
 [ 
  
 Option 
 . 
 new 
 ( 
  
 'account_id' 
 , 
  
 'The resource ID of the bidders resource under which the pretargeting configuration is to be created, This ' 
 \ 
  
 'will be used to construct the name used as a path parameter for the pretargetingConfig.create request.' 
 , 
  
 type 
 : 
  
 Integer 
 , 
  
 short_alias 
 : 
  
 'a' 
 , 
  
 required 
 : 
  
 true 
 , 
  
 default_value 
 : 
  
 nil 
  
 ), 
  
 Option 
 . 
 new 
 ( 
  
 'display_name' 
 , 
  
 'The display name to associate with the new configuration. Must be unique among all of a bidder 
 \' 
 s ' 
 \ 
  
 'pretargeting configurations.' 
 , 
  
 short_alias 
 : 
  
 'd' 
 , 
  
 required 
 : 
  
 false 
 , 
  
 default_value 
 : 
  
 "TEST_PRETARGETING_CONFIG_ 
 #{ 
 SecureRandom 
 . 
 uuid 
 } 
 " 
  
 ), 
  
 Option 
 . 
 new 
 ( 
  
 'included_formats' 
 , 
  
 'Creative formats included by this configuration. Specify each ID separated by a comma. An unset value will ' 
 \ 
  
 'not filter any bid requests based on the format. Valid values include: HTML, NATIVE, and VAST.' 
 , 
  
 required 
 : 
  
 false 
 , 
  
 type 
 : 
  
 Array 
 , 
  
 default_value 
 : 
  
 [] 
  
 ), 
  
 Option 
 . 
 new 
 ( 
  
 'included_geo_ids' 
 , 
  
 'The geo IDs to include in targeting for this configuration. Specify each ID separated by a comma. Valid geo ' 
 \ 
  
 'IDs can be found in: https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv' 
 , 
  
 required 
 : 
  
 false 
 , 
  
 type 
 : 
  
 Array 
 , 
  
 default_value 
 : 
  
 [] 
  
 ), 
  
 Option 
 . 
 new 
 ( 
  
 'excluded_geo_ids' 
 , 
  
 'The geo IDs to exclude in targeting for this configuration. Specify each ID separated by a comma. Valid geo ' 
 \ 
  
 'IDs can be found in: https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv' 
 , 
  
 required 
 : 
  
 false 
 , 
  
 type 
 : 
  
 Array 
 , 
  
 default_value 
 : 
  
 [] 
  
 ), 
  
 Option 
 . 
 new 
 ( 
  
 'included_user_list_ids' 
 , 
  
 'The user list IDs to include in targeting for this configuration. Specify each ID separated by a comma. ' 
 \ 
  
 'Valid user list IDs would include any found under the buyers.userLists resource for a given bidder account, ' 
 \ 
  
 'or any buyer accounts under it.' 
 , 
  
 required 
 : 
  
 false 
 , 
  
 type 
 : 
  
 Array 
 , 
  
 default_value 
 : 
  
 [] 
  
 ), 
  
 Option 
 . 
 new 
 ( 
  
 'excluded_user_list_ids' 
 , 
  
 'The user list IDs to exclude in targeting for this configuration. Specify each ID separated by a comma. ' 
 \ 
  
 'Valid user list IDs would include any found under the buyers.userLists resource for a given bidder account, ' 
 \ 
  
 'or any buyer accounts under it.' 
 , 
  
 required 
 : 
  
 false 
 , 
  
 type 
 : 
  
 Array 
 , 
  
 default_value 
 : 
  
 [] 
  
 ), 
  
 Option 
 . 
 new 
 ( 
  
 'interstitial_targeting' 
 , 
  
 'The interstitial targeting specified for this configuration. By default, this will be set to ' 
 \ 
  
 'ONLY_NON_INTERSTITIAL_REQUESTS. Valid values include: ONLY_INTERSTITIAL_REQUESTS and ' 
 \ 
  
 'ONLY_NON_INTERSTITIAL_REQUESTS.' 
 , 
  
 required 
 : 
  
 false 
 , 
  
 default_value 
 : 
  
 'ONLY_NON_INTERSTITIAL_REQUESTS' 
  
 ), 
  
 Option 
 . 
 new 
 ( 
  
 'allowed_user_targeting_modes' 
 , 
  
 'The targeting modes to include in targeting for this configuration. Specify each value separated by a comma. ' 
 \ 
  
 'Valid targeting modes include: REMARKETING_ADS and INTEREST_BASED_TARGETING.' 
 , 
  
 required 
 : 
  
 false 
 , 
  
 type 
 : 
  
 Array 
 , 
  
 default_value 
 : 
  
 [] 
  
 ), 
  
 Option 
 . 
 new 
 ( 
  
 'excluded_content_label_ids' 
 , 
  
 'The sensitive content category IDs excluded in targeting for this configuration. Specify each value separated ' 
 \ 
  
 'by a comma. Valid sensitive content category IDs can be found in: ' 
 \ 
  
 'https://storage.googleapis.com/adx-rtb-dictionaries/content-labels.txt' 
 , 
  
 required 
 : 
  
 false 
 , 
  
 type 
 : 
  
 Array 
 , 
  
 default_value 
 : 
  
 [] 
  
 ), 
  
 Option 
 . 
 new 
 ( 
  
 'included_user_id_types' 
 , 
  
 'The user identifier types included in targeting for this configuration. Specify each value separated by a ' 
  
 \ 
  
 'comma. Valid values include: HOSTED_MATCH_DATA, GOOGLE_COOKIE, and DEVICE_ID.' 
 , 
  
 required 
 : 
  
 false 
 , 
  
 type 
 : 
  
 Array 
 , 
  
 default_value 
 : 
  
 [] 
  
 ), 
  
 Option 
 . 
 new 
 ( 
  
 'included_language_codes' 
 , 
  
 'The languages represented by languages codes that are included in targeting for this configuration. Specify ' 
 \ 
  
 'each code separated by a comma. Valid language codes can be found in: ' 
 \ 
  
 'https://developers.google.com/adwords/api/docs/appendix/languagecodes.' 
 , 
  
 required 
 : 
  
 false 
 , 
  
 type 
 : 
  
 Array 
 , 
  
 default_value 
 : 
  
 [] 
  
 ), 
  
 Option 
 . 
 new 
 ( 
  
 'included_mobile_os_ids' 
 , 
  
 'The mobile OS IDs to include in targeting for this configuration. Specify each value separated by a comma. ' 
 \ 
  
 'Valid mobile OS IDs can be found in: https://storage.googleapis.com/adx-rtb-dictionaries/mobile-os.csv' 
 , 
  
 required 
 : 
  
 false 
 , 
  
 type 
 : 
  
 Array 
 , 
  
 default_value 
 : 
  
 [] 
  
 ), 
  
 Option 
 . 
 new 
 ( 
  
 'included_vertical_ids' 
 , 
  
 'The vertical IDs to include in targeting for this configuration. Specify each ID separated by a comma. Valid ' 
 \ 
  
 'vertical IDs can be found in: https://developers.google.com/authorized-buyers/rtb/downloads/' 
 \ 
  
 'publisher-verticals' 
 , 
  
 required 
 : 
  
 false 
 , 
  
 type 
 : 
  
 Array 
 , 
  
 default_value 
 : 
  
 [] 
  
 ), 
  
 Option 
 . 
 new 
 ( 
  
 'excluded_vertical_ids' 
 , 
  
 'The vertical IDs to exclude in targeting for this configuration. Specify each ID separated by a comma. Valid ' 
 \ 
  
 'vertical IDs can be found in: https://developers.google.com/authorized-buyers/rtb/downloads/' 
 \ 
  
 'publisher-verticals' 
 , 
  
 required 
 : 
  
 false 
 , 
  
 type 
 : 
  
 Array 
 , 
  
 default_value 
 : 
  
 [] 
  
 ), 
  
 Option 
 . 
 new 
 ( 
  
 'included_platforms' 
 , 
  
 'The platforms to include in targeting for this configuration. Specify each value separated by a comma. Valid ' 
 \ 
  
 'values include: PERSONAL_COMPUTER, PHONE, TABLET, and CONNECTED_TV.' 
 , 
  
 required 
 : 
  
 false 
 , 
  
 type 
 : 
  
 Array 
 , 
  
 default_value 
 : 
  
 [] 
  
 ), 
  
 Option 
 . 
 new 
 ( 
  
 'included_creative_dimension_height' 
 , 
  
 'A creative dimension 
 \s 
 height to be included in targeting for this configuration. By default, this example ' 
 \ 
  
 'will set the targeted height to 300. Note that while only a single set of dimensions are specified in this ' 
 \ 
  
 'sample, pretargeting configurations can target multiple creative dimensions.' 
 , 
  
 required 
 : 
  
 false 
 , 
  
 default_value 
 : 
  
 300 
  
 ), 
  
 Option 
 . 
 new 
 ( 
  
 'included_creative_dimension_width' 
 , 
  
 'A creative dimension 
 \s 
 width to be included in targeting for this configuration. By default, this example ' 
 \ 
  
 'will set the targeted width to 250. Note that while only a single set of dimensions are specified in this ' 
 \ 
  
 'sample, pretargeting configurations can target multiple creative dimensions.' 
 , 
  
 required 
 : 
  
 false 
 , 
  
 default_value 
 : 
  
 250 
  
 ), 
  
 Option 
 . 
 new 
 ( 
  
 'included_environments' 
 , 
  
 'The environments to include in targeting for this configuration. Specify each value separated by a comma. ' 
 \ 
  
 'Valid values include: APP, and WEB.' 
 , 
  
 required 
 : 
  
 false 
 , 
  
 type 
 : 
  
 Array 
 , 
  
 default_value 
 : 
  
 [] 
  
 ), 
  
 Option 
 . 
 new 
 ( 
  
 'web_targeting_mode' 
 , 
  
 'The targeting mode for this configuration 
 \' 
 s web targeting. Valid values include: INCLUSIVE, and EXCLUSIVE.' 
 , 
  
 required 
 : 
  
 false 
 , 
  
 default_value 
 : 
  
 nil 
  
 ), 
  
 Option 
 . 
 new 
 ( 
  
 'web_targeting_urls' 
 , 
  
 'The URLs specified for this configuration 
 \' 
 s web targeting, which allows one to target a subset of site ' 
 \ 
  
 'inventory. Specify each value separated by a comma. Values specified must be valid URLs.' 
 , 
  
 required 
 : 
  
 false 
 , 
  
 type 
 : 
  
 Array 
 , 
  
 default_value 
 : 
  
 [] 
  
 ), 
  
 Option 
 . 
 new 
 ( 
  
 'mobile_app_targeting_mode' 
 , 
  
 'The targeting mode for the configuration 
 \' 
 s mobile app targeting. Valid values include: INCLUSIVE, and ' 
 \ 
  
 'EXCLUSIVE.' 
 , 
  
 required 
 : 
  
 false 
 , 
  
 default_value 
 : 
  
 nil 
  
 ), 
  
 Option 
 . 
 new 
 ( 
  
 'mobile_app_targeting_app_ids' 
 , 
  
 'The mobile app IDs specified for this configuration 
 \' 
 s mobile app targeting, which allows one to target a ' 
 \ 
  
 'subset of mobile app inventory. Specify each value separated by a comma. Values specified must be valid ' 
 \ 
  
 'mobile App IDs, as found on their respective app stores.' 
 , 
  
 required 
 : 
  
 false 
 , 
  
 type 
 : 
  
 Array 
 , 
  
 default_value 
 : 
  
 [] 
  
 ), 
  
 Option 
 . 
 new 
 ( 
  
 'included_mobile_app_targeting_category_ids' 
 , 
  
 'The mobile app category IDs to include in targeting for this configuration. Specify each ID separated by a ' 
 \ 
  
 'comma. Valid category IDs can be found in: ' 
 \ 
  
 'https://developers.google.com/adwords/api/docs/appendix/mobileappcategories.csv' 
 , 
  
 required 
 : 
  
 false 
 , 
  
 type 
 : 
  
 Array 
 , 
  
 default_value 
 : 
  
 [] 
  
 ), 
  
 Option 
 . 
 new 
 ( 
  
 'excluded_mobile_app_targeting_category_ids' 
 , 
  
 'The mobile app category IDs to exclude in targeting for this configuration. Specify each ID separated by a ' 
 \ 
  
 'comma. Valid category IDs can be found in: ' 
 \ 
  
 'https://developers.google.com/adwords/api/docs/appendix/mobileappcategories.csv' 
 , 
  
 required 
 : 
  
 false 
 , 
  
 type 
 : 
  
 Array 
 , 
  
 default_value 
 : 
  
 [] 
  
 ), 
  
 Option 
 . 
 new 
 ( 
  
 'publisher_targeting_mode' 
 , 
  
 'The targeting mode for the configuration 
 \' 
 s publisher targeting. Valid values include: INCLUSIVE, and ' 
 \ 
  
 'EXCLUSIVE.' 
 , 
  
 required 
 : 
  
 false 
 , 
  
 default_value 
 : 
  
 nil 
  
 ), 
  
 Option 
 . 
 new 
 ( 
  
 'publisher_ids' 
 , 
  
 'The publisher IDs specified for this configuration 
 \' 
 s publisher targeting, which allows one to target a ' 
 \ 
  
 'subset of publisher inventory. Specify each ID separated by a comma. Valid publisher IDs can be found in ' 
 \ 
  
 'Real-time Bidding bid requests, or alternatively in ads.txt / app-ads.txt. For more information, see: ' 
 \ 
  
 'https://iabtechlab.com/ads-txt/' 
 , 
  
 required 
 : 
  
 false 
 , 
  
 type 
 : 
  
 Array 
 , 
  
 default_value 
 : 
  
 [] 
  
 ), 
  
 Option 
 . 
 new 
 ( 
  
 'minimum_viewability_decile' 
 , 
  
 'The targeted minimum viewability decile, ranging from 0 - 10. A value of "5" means that the configuration ' 
 \ 
  
 'will only match adslots for which we predict at least 50% viewability. Values > 10 will be rounded down to ' 
 \ 
  
 '10. An unset value, or a value of "0", indicates that bid requests should be sent regardless of viewability.' 
 , 
  
 required 
 : 
  
 false 
 , 
  
 default_value 
 : 
  
 nil 
  
 ), 
  
 ] 
  
 # Parse options. 
  
 parser 
  
 = 
  
 Parser 
 . 
 new 
 ( 
 options 
 ) 
  
 opts 
  
 = 
  
 parser 
 . 
 parse 
 ( 
 ARGV 
 ) 
  
 begin 
  
 create_pretargeting_configs 
 ( 
 service 
 , 
  
 opts 
 ) 
  
 rescue 
  
 Google 
 :: 
 Apis 
 :: 
 ServerError 
  
 = 
>  
 e 
  
 raise 
  
 "The following server error occured: 
 \n 
 #{ 
 e 
 . 
 message 
 } 
 " 
  
 rescue 
  
 Google 
 :: 
 Apis 
 :: 
 ClientError 
  
 = 
>  
 e 
  
 raise 
  
 "Invalid client request: 
 \n 
 #{ 
 e 
 . 
 message 
 } 
 " 
  
 rescue 
  
 Google 
 :: 
 Apis 
 :: 
 AuthorizationError 
  
 = 
>  
 e 
  
 raise 
  
 "Authorization error occured: 
 \n 
 #{ 
 e 
 . 
 message 
 } 
 " 
  
 end 
 end 

GET https://realtimebidding.googleapis.com/v1/bidders/12345678/pretargetingConfigs/560983?alt=json
Authorization: Bearer <INSERT_ACCESS_TOKEN_HERE>
Content-Type: application/json

{
  "name": "bidders/12345678/pretargetingConfigs/560983",
  "displayName": "TEST_PRETARGETING_CONFIG_bea55522-1373-4cfe-baf3-bac5e594c76e",
  "billingId": "112233445566",
  "state": "ACTIVE",
  "interstitialTargeting": "ONLY_NON_INTERSTITIAL_REQUESTS",
  "includedCreativeDimensions": [
    {
      "width": "250",
      "height": "300"
    }
  ],
  "minimumViewabilityDecile": 5
}

 /* Copyright 2020 Google LLC 
 * 
 * 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. 
 */ 
 using 
  
 Google.Apis.RealTimeBidding.v1 
 ; 
 using 
  
 Google.Apis.RealTimeBidding.v1.Data 
 ; 
 using 
  
 Mono.Options 
 ; 
 using 
  
 System 
 ; 
 using 
  
 System.Collections.Generic 
 ; 
 namespace 
  
 Google.Apis.RealTimeBidding.Examples.v1.Bidders.PretargetingConfigs 
 { 
  
 /// <summary> 
  
 /// Gets a single pretargeting configuration with a specified name. 
  
 /// </summary> 
  
 public 
  
 class 
  
 GetPretargetingConfigs 
  
 : 
  
 ExampleBase 
  
 { 
  
 private 
  
 RealTimeBiddingService 
  
 rtbService 
 ; 
  
 /// <summary> 
  
 /// Constructor. 
  
 /// </summary> 
  
 public 
  
 GetPretargetingConfigs 
 () 
  
 { 
  
 rtbService 
  
 = 
  
 Utilities 
 . 
 GetRealTimeBiddingService 
 (); 
  
 } 
  
 /// <summary> 
  
 /// Returns a description about the code example. 
  
 /// </summary> 
  
 public 
  
 override 
  
 string 
  
 Description 
  
 { 
  
 get 
  
 = 
>  
 "This code example gets a specified pretargeting configuration" 
 ; 
  
 } 
  
 /// <summary> 
  
 /// Parse specified arguments. 
  
 /// </summary> 
  
 protected 
  
 override 
  
 Dictionary<string 
 , 
  
 object 
>  
 ParseArguments 
 ( 
 List<string> 
  
 exampleArgs 
 ) 
  
 { 
  
 string 
 [] 
  
 requiredOptions 
  
 = 
  
 new 
  
 string 
 [] 
  
 { 
 "account_id" 
 , 
  
 "pretargeting_config_id" 
 }; 
  
 bool 
  
 showHelp 
  
 = 
  
 false 
 ; 
  
 string 
  
 accountId 
  
 = 
  
 null 
 ; 
  
 long? 
  
 pretargetingConfigId 
  
 = 
  
 null 
 ; 
  
 OptionSet 
  
 options 
  
 = 
  
 new 
  
 OptionSet 
  
 { 
  
 "Gets a specified pretargeting configuration." 
 , 
  
 { 
  
 "h|help" 
 , 
  
 "Show help message and exit." 
 , 
  
 h 
  
 = 
>  
 showHelp 
  
 = 
  
 h 
  
 != 
  
 null 
  
 }, 
  
 { 
  
 "a|account_id=" 
 , 
  
 ( 
 "[Required] The resource ID of the bidders resource under which the " 
  
 + 
  
 "pretargeting configuration was created." 
 ), 
  
 a 
  
 = 
>  
 accountId 
  
 = 
  
 a 
  
 }, 
  
 { 
  
 "p|pretargeting_config_id=" 
 , 
  
 ( 
 "[Required] The resource ID of the pretargeting configuration that is " 
  
 + 
  
 "being retrieved." 
 ), 
  
 ( 
 long 
  
 p 
 ) 
  
 = 
>  
 pretargetingConfigId 
  
 = 
  
 p 
  
 }, 
  
 }; 
  
 List<string> 
  
 extras 
  
 = 
  
 options 
 . 
 Parse 
 ( 
 exampleArgs 
 ); 
  
 var 
  
 parsedArgs 
  
 = 
  
 new 
  
 Dictionary<string 
 , 
  
 object 
> (); 
  
 // Show help message. 
  
 if 
 ( 
 showHelp 
  
 == 
  
 true 
 ) 
  
 { 
  
 options 
 . 
 WriteOptionDescriptions 
 ( 
 Console 
 . 
 Out 
 ); 
  
 Environment 
 . 
 Exit 
 ( 
 0 
 ); 
  
 } 
  
 // Set arguments. 
  
 parsedArgs 
 [ 
 "account_id" 
 ] 
  
 = 
  
 accountId 
 ; 
  
 parsedArgs 
 [ 
 "pretargeting_config_id" 
 ] 
  
 = 
  
 pretargetingConfigId 
 ; 
  
 // Validate that options were set correctly. 
  
 Utilities 
 . 
 ValidateOptions 
 ( 
 options 
 , 
  
 parsedArgs 
 , 
  
 requiredOptions 
 , 
  
 extras 
 ); 
  
 return 
  
 parsedArgs 
 ; 
  
 } 
  
 /// <summary> 
  
 /// Run the example. 
  
 /// </summary> 
  
 /// <param name="parsedArgs">Parsed arguments for the example.</param> 
  
 protected 
  
 override 
  
 void 
  
 Run 
 ( 
 Dictionary<string 
 , 
  
 object 
>  
 parsedArgs 
 ) 
  
 { 
  
 string 
  
 accountId 
  
 = 
  
 ( 
 string 
 ) 
  
 parsedArgs 
 [ 
 "account_id" 
 ]; 
  
 long? 
  
 pretargetingConfigId 
  
 = 
  
 ( 
 long? 
 ) 
  
 parsedArgs 
 [ 
 "pretargeting_config_id" 
 ]; 
  
 string 
  
 name 
  
 = 
  
 $"bidders/{accountId}/pretargetingConfigs/{pretargetingConfigId}" 
 ; 
  
 BiddersResource 
 . 
 PretargetingConfigsResource 
 . 
 GetRequest 
  
 request 
  
 = 
  
 rtbService 
 . 
 Bidders 
 . 
 PretargetingConfigs 
 . 
 Get 
 ( 
 name 
 ); 
  
 PretargetingConfig 
  
 response 
  
 = 
  
 null 
 ; 
  
 Console 
 . 
 WriteLine 
 ( 
 "Retrieving pretargeting configuration with name: '{0}'" 
 , 
  
 name 
 ); 
  
 try 
  
 { 
  
 response 
  
 = 
  
 request 
 . 
 Execute 
 (); 
  
 } 
  
 catch 
  
 ( 
 System 
 . 
 Exception 
  
 exception 
 ) 
  
 { 
  
 throw 
  
 new 
  
 ApplicationException 
 ( 
  
 $"Real-time Bidding API returned error response:\n{exception.Message}" 
 ); 
  
 } 
  
 Utilities 
 . 
 PrintPretargetingConfiguration 
 ( 
 response 
 ); 
  
 } 
  
 } 
 }