Merge pull request #212 from BingAds/v13.0.25

v13.0.25

Author: xinyuwen2

src/Auth/ServiceClient.php

@@ -242,7 +242,7 @@ private function RefreshServiceProxy()
 			'features' => SOAP_SINGLE_ELEMENT_ARRAYS,
 			// Disable keep_alive to avoid 'Process open FD table is full'
 			'keep_alive' => FALSE, 
-			'user_agent' => 'BingAdsSDKPHP ' . '13.0.24.1 ' . PHP_VERSION, 
+			'user_agent' => 'BingAdsSDKPHP ' . '13.0.25 ' . PHP_VERSION, 
 			'cache_wsdl' => 'WSDL_CACHE_NONE',
 
 			/** 

src/V13/Bulk/DownloadEntity.php

@@ -33,7 +33,7 @@ final class DownloadEntity
         /** Include Campaign Age Criterion, Campaign Company Name Criterion, Campaign DayTime Criterion, Campaign DeviceOS Criterion, Campaign Gender Criterion, Campaign Industry Criterion, Campaign Job Function Criterion, Campaign Location Criterion, Campaign Location Intent Criterion, Campaign Negative Location Criterion, and Campaign Radius Criterion records in the download data. */
         const CampaignTargetCriterions = 'CampaignTargetCriterions';
 
-        /** Include Ad Group Age Criterion, Ad Group Company Name Criterion, Ad Group DayTime Criterion, Ad Group DeviceOS Criterion, Ad Group Gender Criterion, Ad Group Industry Criterion, Ad Group Job Function Criterion, Ad Group Location Criterion, Ad Group Location Intent Criterion, Ad Group Negative Age Criterion, Ad Group Negative Company Name Criterion, Ad Group Negative Gender Criterion, Ad Group Negative Industry Criterion, Ad Group Negative Job Function Criterion, Ad Group Negative Location Criterion, and Ad Group Radius Criterion records in the download data. */
+        /** Include Ad Group Age Criterion, Ad Group Company Name Criterion, Ad Group DayTime Criterion, Ad Group DeviceOS Criterion, Ad Group Gender Criterion, Ad Group Industry Criterion, Ad Group Job Function Criterion, Ad Group Location Criterion, Ad Group Location Intent Criterion, Ad Group Negative Age Criterion, Ad Group Negative Company Name Criterion, Ad Group Negative Gender Criterion, Ad Group Negative Industry Criterion, Ad Group Negative Job Function Criterion, Ad Group Negative Location Criterion, Ad Group Placement Criterion, and Ad Group Radius Criterion records in the download data. */
         const AdGroupTargetCriterions = 'AdGroupTargetCriterions';
 
         /** Include Campaign Negative Site records in the download data. */
@@ -444,7 +444,7 @@ final class DownloadEntity
         /** Include Campaign level conversion goal records in the download data. */
         const CampaignConversionGoal = 'CampaignConversionGoal';
 
-        /** Reserved. */
+        /** The list of hotel listing groups that correspond directly to the identifiers specified in the request. */
         const AdGroupHotelListingGroups = 'AdGroupHotelListingGroups';
 
         /** Array of asset groups to add to the specified campaign. */
@@ -459,19 +459,19 @@ final class DownloadEntity
         /** The list of Audience Group associations. */
         const AudienceGroupAssetGroupAssociations = 'AudienceGroupAssetGroupAssociations';
 
-        /** The list of listing groups that correspond directly to the identifiers specified in the request. */
+        /** The list of asset group listing groups that correspond directly to the identifiers specified in the request. */
         const AssetGroupListingGroups = 'AssetGroupListingGroups';
 
-        /** Reserved. */
+        /** Include Logo Ad Extension records in the download. */
         const LogoAdExtensions = 'LogoAdExtensions';
 
-        /** Reserved. */
+        /** Include Account Logo Ad Extension records in the download that represents the association relationship between an account and a logo ad extension. */
         const AccountLogoAdExtensions = 'AccountLogoAdExtensions';
 
-        /** Reserved. */
+        /** Include Campaign Logo Ad Extension records in the download that represents the association relationship between an campaign and a logo ad extension. */
         const CampaignLogoAdExtensions = 'CampaignLogoAdExtensions';
 
-        /** Reserved. */
+        /** Include Ad Group Logo Ad Extension records in the download that represents the association relationship between an ad group and a logo ad extension. */
         const AdGroupLogoAdExtensions = 'AdGroupLogoAdExtensions';
 
         /** Reserved. */
@@ -492,40 +492,40 @@ final class DownloadEntity
         /** Include Account Negative Keyword List records in the download data. */
         const AccountNegativeKeyword = 'AccountNegativeKeyword';
 
-        /** Reserved. */
+        /** Include Conversion Goal records in the download data. */
         const ConversionGoal = 'ConversionGoal';
 
-        /** Reserved. */
+        /** Include Event Goal records in the download data. */
         const EventGoal = 'EventGoal';
 
-        /** Reserved. */
+        /** Include App Install Goal records in the download data. */
         const AppInstallGoal = 'AppInstallGoal';
 
         /** Reserved. */
         const MultiStageGoal = 'MultiStageGoal';
 
-        /** Reserved. */
+        /** Include Duration Goal records in the download data. */
         const DurationGoal = 'DurationGoal';
 
-        /** Reserved. */
+        /** Include Offline Conversion Goal records in the download data. */
         const OfflineConversionGoal = 'OfflineConversionGoal';
 
-        /** Reserved. */
+        /** Include Url Goal records in the download data. */
         const UrlGoal = 'UrlGoal';
 
-        /** Reserved. */
+        /** Include In Store Transaction Goal records in the download data. */
         const InStoreTransactionGoal = 'InStoreTransactionGoal';
 
-        /** Reserved. */
+        /** Include Pages Viewed Per Visit Goal records in the download data. */
         const PagesViewedPerVisitGoal = 'PagesViewedPerVisitGoal';
 
         /** Reserved. */
         const SmartGoal = 'SmartGoal';
 
-        /** Reserved. */
+        /** Include In Store Visit Goal records in the download data. */
         const InStoreVisitGoal = 'InStoreVisitGoal';
 
-        /** Reserved. */
+        /** Include Product Goal records in the download data. */
         const ProductGoal = 'ProductGoal';
 
         /** Include SeasonalityAdjustments records in the download data. */
@@ -567,7 +567,7 @@ final class DownloadEntity
         /** Reserved. */
         const NewCustomerAcquisitionGoal = 'NewCustomerAcquisitionGoal';
 
-        /** Reserved. */
+        /** Include Conversion Value Rule records in the download data. */
         const ConversionValueRule = 'ConversionValueRule';
 
         /** Reserved. */
@@ -587,6 +587,15 @@ final class DownloadEntity
 
         /** Reserved. */
         const CampaignAccountPlacementInclusionListAssociation = 'CampaignAccountPlacementInclusionListAssociation';
+
+        /** Reserved. */
+        const Topic = 'Topic';
+
+        /** Reserved. */
+        const ContentPlacement = 'ContentPlacement';
+
+        /** Reserved. */
+        const BrandKit = 'BrandKit';
     }
 
 }

src/V13/CampaignManagement/AccountPlacementExclusionList.php

@@ -4,7 +4,7 @@
 
 {
     /**
-     * Reserved.
+     * Defines a data object for account placement exclusion list.
      * @link https:/learn.microsoft.com/advertising/campaign-management-service/accountplacementexclusionlist?view=bingads-13 AccountPlacementExclusionList Data Object
      */
     final class AccountPlacementExclusionList extends SharedList

src/V13/CampaignManagement/AccountPlacementInclusionList.php

@@ -4,7 +4,7 @@
 
 {
     /**
-     * Reserved.
+     * Defines a data object for account placement inclusion list.
      * @link https:/learn.microsoft.com/advertising/campaign-management-service/accountplacementinclusionlist?view=bingads-13 AccountPlacementInclusionList Data Object
      */
     final class AccountPlacementInclusionList extends SharedList

src/V13/CampaignManagement/AdGroupAdditionalField.php

@@ -44,6 +44,9 @@ final class AdGroupAdditionalField
 
         /** Indicates if predictive targeting is enabled for an AdGroup. */
         const UsePredictiveTargeting = 'UsePredictiveTargeting';
+
+        /** Reserved. */
+        const MaxConversionValueWithMaxCpc = 'MaxConversionValueWithMaxCpc';
     }
 
 }

src/V13/CampaignManagement/AdGroupCriterionType.php

@@ -20,7 +20,7 @@ final class AdGroupCriterionType
         /** The ad group criterion is a webpage criterion. */
         const Webpage = 'Webpage';
 
-        /** Represents one or more AgeCriterion, DayTimeCriterion, DeviceCriterion, GenderCriterion, LocationCriterion, LocationIntentCriterion, ProfileCriterion, and RadiusCriterion objects that can be managed together to show ads based on your target criteria. */
+        /** Represents one or more AgeCriterion, DayTimeCriterion, DeviceCriterion, GenderCriterion, LocationCriterion, LocationIntentCriterion, PlacementCriterion, ProfileCriterion, and RadiusCriterion objects that can be managed together to show ads based on your target criteria. */
         const Targets = 'Targets';
 
         /** The ad group criterion is an age criterion. */
@@ -101,8 +101,11 @@ final class AdGroupCriterionType
         /** The ad group criterion is an impression-based remarketing list. */
         const ImpressionBasedRemarketingList = 'ImpressionBasedRemarketingList';
 
-        /** Reserved. */
+        /** The ad group criterion is a placement criterion. */
         const Placement = 'Placement';
+
+        /** Reserved. */
+        const Topic = 'Topic';
     }
 
 }

src/V13/CampaignManagement/AdRecommendationAdditionalField.php

@@ -4,7 +4,7 @@
 
 {
     /**
-     * Reserved.
+     * The ad recommendation additional field value set.
      * @link https:/learn.microsoft.com/advertising/campaign-management-service/adrecommendationadditionalfield?view=bingads-13 AdRecommendationAdditionalField Value Set
      * 
      * @used-by CreateAssetGroupRecommendationRequest
@@ -14,13 +14,13 @@
      */
     final class AdRecommendationAdditionalField
     {
-        /** Reserved. */
+        /** The meta data for the suggested image. */
         const ImageSuggestionMetadata = 'ImageSuggestionMetadata';
 
-        /** Reserved. */
+        /** The media refine results. */
         const MediaRefineResults = 'MediaRefineResults';
 
-        /** Reserved. */
+        /** Whether the brand is detected in the request prompt. */
         const PromptBrandWarning = 'PromptBrandWarning';
     }
 

src/V13/CampaignManagement/AdRecommendationCustomizedProperty.php

@@ -4,27 +4,27 @@
 
 {
     /**
-     * Reserved.
+     * The ad recommendation customized property data object.
      * @link https:/learn.microsoft.com/advertising/campaign-management-service/adrecommendationcustomizedproperty?view=bingads-13 AdRecommendationCustomizedProperty Data Object
      * 
      * @used-by AdRecommendationImageSuggestionMetadata
      */
     final class AdRecommendationCustomizedProperty
     {
         /**
-         * Reserved.
+         * The asset type name.
          * @var string
          */
         public $AssetTypeName;
 
         /**
-         * Reserved.
+         * The property name.
          * @var string
          */
         public $PropertyName;
 
         /**
-         * Reserved.
+         * The property value.
          * @var string
          */
         public $PropertyValue;

src/V13/CampaignManagement/AdRecommendationImageAssetProperty.php

@@ -4,7 +4,7 @@
 
 {
     /**
-     * Reserved.
+     * The ad recommendation image asset property data object.
      * @link https:/learn.microsoft.com/advertising/campaign-management-service/adrecommendationimageassetproperty?view=bingads-13 AdRecommendationImageAssetProperty Data Object
      * 
      * @uses AdRecommendationImageField
@@ -13,37 +13,37 @@
     final class AdRecommendationImageAssetProperty
     {
         /**
-         * Reserved.
+         * The crop height in pixels.
          * @var integer
          */
         public $CropHeight;
 
         /**
-         * Reserved.
+         * The crop width in pixels.
          * @var integer
          */
         public $CropWidth;
 
         /**
-         * Reserved.
+         * Where to crop along the x-axis in pixels.
          * @var integer
          */
         public $CropX;
 
         /**
-         * Reserved.
+         * Where to crop along the y-axis in pixels.
          * @var integer
          */
         public $CropY;
 
         /**
-         * Reserved.
+         * The image field for the ad recommendation.
          * @var AdRecommendationImageField
          */
         public $ImageField;
 
         /**
-         * Reserved.
+         * The URL of the image.
          * @var string
          */
         public $ImageUrl;

src/V13/CampaignManagement/AdRecommendationImageField.php

@@ -4,17 +4,17 @@
 
 {
     /**
-     * Reserved.
+     * The ad recommednation image field value set.
      * @link https:/learn.microsoft.com/advertising/campaign-management-service/adrecommendationimagefield?view=bingads-13 AdRecommendationImageField Value Set
      * 
      * @used-by AdRecommendationImageAssetProperty
      */
     final class AdRecommendationImageField
     {
-        /** Reserved. */
+        /** The suggested image. */
         const Image = 'Image';
 
-        /** Reserved. */
+        /** The suggested logo. */
         const Logo = 'Logo';
     }