Generative AI

With Copilot asset creation via Campaign Management API, advertisers, agencies, and partners who access Microsoft Advertising via API can use generative AI capabilities to create campaigns with ease and save time.

Asset recommendations populate campaigns by leveraging generative AI to generate ad copy, recommend images, and assemble video and display banner assets based on a website URL and a text prompt (optional).

Asset generation, in addition to the text generation that occurs automatically when you use Asset recommendations in your campaign creation workflow, also includes ad copy tone refinement. This generates text based on the website URL and text prompt (optional) + text tone (optional). Net new video or image generation is not available at this time.

See market and language availability for Generative AI tools.

Asset Generation

Use the following Copilot asset recommendations calls within Microsoft Advertising’s Campaign Management API to get text, image, and video asset recommendations to expedite creation of your Performance Max campaigns, Responsive Search ads, Display ads, Native ads, and Video ads.

Service Operations

The following service operations are used with create asset recommendations:

• CreateAssetGroupRecommendation
• CreateResponsiveAdRecommendation
• CreateResponsiveSearchAdRecommendation

Image Generation

Generate new new images with a text prompt. The following service operations are used with image generation:

• CreateAssetGroupRecommendation
• CreateResponsiveAdRecommendation

Background Generation

Remove and generate a new background for image assets with the help of Copilot. The following service operations are used with background generation:

• CreateAssetGroupRecommendation
• CreateResponsiveAdRecommendation

Display Banner Generation

Generate banner assets for display ads with five editable templates. Copilot will infer your brand elements such as logo, color, and font from your landing page or brand kit. The following service operations are used with display banner generation:

• CreateResponsiveAdRecommendation

Brand Kit

Define your brand guidelines, such as fonts, colors, logo, and other images, to enable Copilot to create brand-aligned assets. The following service operations are used for brand kit:

• AddBrandKits
• DeleteBrandKits
• GetBrandKitsByAccountId
• GetBrandKitsByIds
• UpdateBrandKits

Code Samples

The following samples demonstrate building a campaign with generated assets using Bing Ads SDK:

• Java
• .NET
• Python
• PHP

Rest API Request Sample

Here is an example of REST API sample code:

Method: POST; Uri: https://campaign.api.bingads.microsoft.com/CampaignManagement/v13/ResponsiveAdRecommendation/Create  

{"FinalUrls":["https://contoso.com"],"Prompt":null,"TextTone":null}  

FinalUrls is a required parameter (it accepts multiple URLs for future extensibility, but currently we are using just one). 

Prompt is an optional parameter to set a theme for the ad, for example "Holiday sale". 

TextTone is an optional parameter and accepts values Friendly, Persuasive, Cute, Inspiring. 

The response contains a ResponsiveAd object with the text fields filled out. This is the same object as the ResponsiveAd data object. It also has an ImageSuggestions field, which has URLs for generated images. The caller can inspect these images and upload the ones that should be added to the ad by calling the AddMedia method and using the returned image Id in the ad object.

To create a recommendation for a Display Ad we need to add an AdSubType parameter to the request:

{"AdSubType":"Display","FinalUrls":["https://contoso.com"],"Prompt":null,"TextTone":null}  

Similarly, for a Video Ad we need to set AdSubType to "Video":

{"AdSubType":"Video","FinalUrls":["https://contoso.com"],"Prompt":null,"TextTone":null}  

To create a recommendation of PMax Asset Group the request is the same as for Native Ad, but the URL is different:

Method: POST; Uri: https://campaign.api.bingads.microsoft.com/CampaignManagement/v13/AssetGroupRecommendation/Create 

Asset Refinement

Use the following Copilot asset generation calls within Microsoft Advertising’s Campaign Management API to enhance your copywriting. Refine your text assets by easily adjusting your tone of voice for short headlines, long headlines, and descriptions.

Service Operations

The following service operations are used with refine asset recommendations:

• RefineAssetGroupRecommendation
• RefineResponsiveAdRecommendation
• RefineResponsiveSearchAdRecommendation

Rest API Request Sample

To refine text in a previously created recommendation a corresponding refine method can be used. For example: 

Method: POST; Uri: https://campaign.api.bingads.microsoft.com/CampaignManagement/v13/ResponsiveAdRecommendation/Refine  

{  
  "ResponsiveAd": {  
    "Descriptions": [  
      {  
        "Asset": {  
          "Text": "Description 0",  
          "Type": "TextAsset"  
        }  
      },  
      {  
        "Asset": {  
          "Text": "Description 1",  
          "Type": "TextAsset"  
        }  
      }  
    ],  
    "Headlines": [  
      {  
        "Asset": {  
          "Text": "Short headline 0",  
          "Type": "TextAsset"  
        }  
      }  
    ],  
    "FinalUrls": [ "https://www.nike.com" ],  
    "Type": "ResponsiveAd"  
  },  
  "TextRefineOperations": [  
    {  
      "TextField": "Description",  
      "TextFieldIndex": 1,  
      "TextTone": "Inspiring"  
    }  
  ]  
}  

ResponsiveAd should be the object returned from the create recommendation response, with the text fields populated. TextRefineOperations is a list of operations (specific text fields and corresponding tones) for which refined text values should be returned.