Conversion goal category requirements

Published Jun 06 2021 08:49 PM 1,008 Views
Microsoft

IMPORTANT: If you already use conversion goals, please read this section about required changes.  


You can categorize your conversion goals however makes sense for your business. Goal categories don't affect performance - they are here to help you segment your goals and their performance metrics.

Previously Bing Ads API did not require conversion goal categories. Depending on the goal type the default category is set to Download, None, Other, or Purchase.  

Now when you add or update the custom event, offline conversion, or URL goals you must set a goal category or the Campaign Management service will return an error. There are no changes to the default category of other goal types as shown in the table.

 

Goal type Default before Default after
EventGoal
OfflineConversionGoal
UrlGoal
None
No default; Service returns an error
DurationGoal
PagesViewedPerVisitGoal
Other Other
InStoreTransactionGoal
Purchase Purchase
AppInstallGoal
Download Download

 

For more information, see our API documentation about conversion goal categories.

 

As always please feel free to post a question in the Bing Ads API developer forum or contact support.

 

%3CLINGO-SUB%20id%3D%22lingo-sub-2420707%22%20slang%3D%22en-US%22%3EConversion%20goal%20category%20requirements%3C%2FLINGO-SUB%3E%3CLINGO-BODY%20id%3D%22lingo-body-2420707%22%20slang%3D%22en-US%22%3E%3CP%3E%3CSTRONG%3EIMPORTANT%3C%2FSTRONG%3E%3A%20If%26nbsp%3Byou%26nbsp%3Balready%26nbsp%3Buse%26nbsp%3Bconversion%26nbsp%3Bgoals%2C%26nbsp%3Bplease%26nbsp%3Bread%26nbsp%3Bthis%26nbsp%3Bsection%26nbsp%3Babout%26nbsp%3Brequired%26nbsp%3Bchanges.%26nbsp%3B%26nbsp%3B%3C%2FP%3E%0A%3CDIV%3E%3CBR%20%2F%3E%3CDIV%3E%3CSPAN%3EYou%26nbsp%3Bcan%26nbsp%3Bcategorize%26nbsp%3Byour%26nbsp%3Bconversion%26nbsp%3Bgoals%26nbsp%3Bhowever%26nbsp%3Bmakes%26nbsp%3Bsense%26nbsp%3Bfor%26nbsp%3Byour%26nbsp%3Bbusiness.%26nbsp%3BGoal%26nbsp%3Bcategories%26nbsp%3Bdon't%26nbsp%3Baffect%26nbsp%3Bperformance%26nbsp%3B-%26nbsp%3Bthey%26nbsp%3Bare%26nbsp%3Bhere%26nbsp%3Bto%26nbsp%3Bhelp%26nbsp%3Byou%26nbsp%3Bsegment%26nbsp%3Byour%26nbsp%3Bgoals%26nbsp%3Band%26nbsp%3Btheir%26nbsp%3Bperformance%26nbsp%3Bmetrics.%3C%2FSPAN%3E%3C%2FDIV%3E%3CBR%20%2F%3E%3CDIV%3E%3CSPAN%3EPreviously%26nbsp%3BBing%26nbsp%3BAds%26nbsp%3BAPI%26nbsp%3Bdid%26nbsp%3Bnot%26nbsp%3Brequire%26nbsp%3Bconversion%26nbsp%3Bgoal%26nbsp%3Bcategories.%26nbsp%3BDepending%26nbsp%3Bon%26nbsp%3Bthe%26nbsp%3Bgoal%26nbsp%3Btype%26nbsp%3Bthe%26nbsp%3Bdefault%26nbsp%3Bcategory%26nbsp%3Bis%26nbsp%3Bset%26nbsp%3Bto%26nbsp%3BDownload%2C%26nbsp%3BNone%2C%26nbsp%3BOther%2C%26nbsp%3Bor%26nbsp%3BPurchase.%26nbsp%3B%26nbsp%3B%3C%2FSPAN%3E%3C%2FDIV%3E%3CBR%20%2F%3E%3CDIV%3E%3CSPAN%3ENow%20when%20you%20%3CA%20href%3D%22https%3A%2F%2Fdocs.microsoft.com%2Fen-us%2Fadvertising%2Fcampaign-management-service%2Faddconversiongoals%3Fview%3Dbingads-13%22%20target%3D%22_blank%22%20rel%3D%22noopener%20noreferrer%22%3Eadd%3C%2FA%3E%20or%20%3CA%20href%3D%22https%3A%2F%2Fdocs.microsoft.com%2Fen-us%2Fadvertising%2Fcampaign-management-service%2Fupdateconversiongoals%3Fview%3Dbingads-13%22%20target%3D%22_blank%22%20rel%3D%22noopener%20noreferrer%22%3Eupdate%3C%2FA%3E%20the%20custom%20event%2C%20offline%20conversion%2C%20or%20URL%20goals%20you%20must%20set%20a%20%3CA%20href%3D%22https%3A%2F%2Fdocs.microsoft.com%2Fen-us%2Fadvertising%2Fcampaign-management-service%2Fconversiongoal%3Fview%3Dbingads-13%23goalcategory%22%20target%3D%22_blank%22%20rel%3D%22noopener%20noreferrer%22%3Egoal%20category%3C%2FA%3E%20or%20the%20Campaign%20Management%20service%20will%20return%20an%20error.%20There%26nbsp%3Bare%26nbsp%3Bno%26nbsp%3Bchanges%26nbsp%3Bto%26nbsp%3Bthe%26nbsp%3Bdefault%26nbsp%3Bcategory%26nbsp%3Bof%26nbsp%3Bother%26nbsp%3Bgoal%26nbsp%3Btypes%26nbsp%3Bas%26nbsp%3Bshown%26nbsp%3Bin%26nbsp%3Bthe%26nbsp%3Btable.%3C%2FSPAN%3E%3C%2FDIV%3E%0A%3C%2FDIV%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CTABLE%20style%3D%22border-style%3A%20ridge%3B%20width%3A%20100%25%3B%22%20border%3D%221%22%20width%3D%22100%25%22%3E%0A%3CTBODY%3E%0A%3CTR%3E%0A%3CTD%20width%3D%2233.333333333333336%25%22%3EGoal%20type%3C%2FTD%3E%0A%3CTD%20width%3D%2233.333333333333336%25%22%3EDefault%20before%3C%2FTD%3E%0A%3CTD%20width%3D%2233.333333333333336%25%22%3EDefault%20after%3C%2FTD%3E%0A%3C%2FTR%3E%0A%3CTR%3E%0A%3CTD%20width%3D%2233.333333333333336%25%22%3E%3CDIV%3E%0A%3CDIV%3E%3CSPAN%3EEventGoal%3C%2FSPAN%3E%3C%2FDIV%3E%0A%3CDIV%3E%3CSPAN%3EOfflineConversionGoal%3C%2FSPAN%3E%3C%2FDIV%3E%0A%3CDIV%3E%3CSPAN%3EUrlGoal%3C%2FSPAN%3E%3C%2FDIV%3E%0A%3C%2FDIV%3E%0A%3C%2FTD%3E%0A%3CTD%20width%3D%2233.333333333333336%25%22%3ENone%3C%2FTD%3E%0A%3CTD%20width%3D%2233.333333333333336%25%22%3E%3CDIV%3E%0A%3CDIV%3E%3CSPAN%3ENo%26nbsp%3Bdefault%3B%26nbsp%3BService%26nbsp%3Breturns%26nbsp%3Ban%26nbsp%3Berror%3C%2FSPAN%3E%3C%2FDIV%3E%0A%3C%2FDIV%3E%0A%3C%2FTD%3E%0A%3C%2FTR%3E%0A%3CTR%3E%0A%3CTD%20width%3D%2233.333333333333336%25%22%3E%3CDIV%3E%0A%3CDIV%3E%3CSPAN%3EDurationGoal%3C%2FSPAN%3E%3C%2FDIV%3E%0A%3CDIV%3E%3CSPAN%3EPagesViewedPerVisitGoal%3C%2FSPAN%3E%3C%2FDIV%3E%0A%3C%2FDIV%3E%0A%3C%2FTD%3E%0A%3CTD%20width%3D%2233.333333333333336%25%22%3EOther%3C%2FTD%3E%0A%3CTD%20width%3D%2233.333333333333336%25%22%3EOther%3C%2FTD%3E%0A%3C%2FTR%3E%0A%3CTR%3E%0A%3CTD%20width%3D%2233.333333333333336%25%22%3E%3CDIV%3E%0A%3CDIV%3E%3CSPAN%3EInStoreTransactionGoal%3C%2FSPAN%3E%3C%2FDIV%3E%0A%3C%2FDIV%3E%0A%3C%2FTD%3E%0A%3CTD%20width%3D%2233.333333333333336%25%22%3EPurchase%3C%2FTD%3E%0A%3CTD%20width%3D%2233.333333333333336%25%22%3EPurchase%3C%2FTD%3E%0A%3C%2FTR%3E%0A%3CTR%3E%0A%3CTD%20width%3D%2233.333333333333336%25%22%3E%3CDIV%3E%0A%3CDIV%3E%3CSPAN%3EAppInstallGoal%3C%2FSPAN%3E%3C%2FDIV%3E%0A%3C%2FDIV%3E%0A%3C%2FTD%3E%0A%3CTD%20width%3D%2233.333333333333336%25%22%3EDownload%3C%2FTD%3E%0A%3CTD%20width%3D%2233.333333333333336%25%22%3EDownload%3C%2FTD%3E%0A%3C%2FTR%3E%0A%3C%2FTBODY%3E%0A%3C%2FTABLE%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CDIV%3E%0A%3CDIV%3E%3CSPAN%3EFor%26nbsp%3Bmore%26nbsp%3Binformation%2C%26nbsp%3Bsee%26nbsp%3Bour%26nbsp%3BAPI%26nbsp%3Bdocumentation%26nbsp%3Babout%26nbsp%3B%3C%2FSPAN%3E%3CSPAN%3E%3CA%20href%3D%22https%3A%2F%2Fdocs.microsoft.com%2Fen-us%2Fadvertising%2Fcampaign-management-service%2Fconversiongoalcategory%3Fview%3Dbingads-13%22%20target%3D%22_blank%22%20rel%3D%22noopener%20noreferrer%22%3Econversion%26nbsp%3Bgoal%26nbsp%3Bcategories%3C%2FA%3E.%3C%2FSPAN%3E%3C%2FDIV%3E%0A%3C%2FDIV%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%0A%3CP%3EAs%20always%20please%20feel%20free%20to%26nbsp%3Bpost%20a%20question%20in%20the%20%3CA%20href%3D%22https%3A%2F%2Fdocs.microsoft.com%2Fen-us%2Fanswers%2Ftopics%2Fadvertising-api.html%22%20target%3D%22_blank%22%20rel%3D%22noopener%20noreferrer%22%3EBing%20Ads%20API%20developer%20forum%3C%2FA%3E%20or%26nbsp%3B%3CA%20href%3D%22https%3A%2F%2Fabout.ads.microsoft.com%2Fen-us%2Fmicrosoft-advertising-support%22%20target%3D%22_blank%22%20rel%3D%22noopener%20noreferrer%22%3Econtact%20support%3C%2FA%3E.%3C%2FP%3E%0A%3CP%3E%26nbsp%3B%3C%2FP%3E%3C%2FLINGO-BODY%3E%3CLINGO-TEASER%20id%3D%22lingo-teaser-2420707%22%20slang%3D%22en-US%22%3E%3CP%3ENow%20when%20you%20%3CA%20href%3D%22https%3A%2F%2Fdocs.microsoft.com%2Fen-us%2Fadvertising%2Fcampaign-management-service%2Faddconversiongoals%3Fview%3Dbingads-13%22%20rel%3D%22noopener%20noreferrer%22%20target%3D%22_blank%22%3Eadd%3C%2FA%3E%20or%20%3CA%20href%3D%22https%3A%2F%2Fdocs.microsoft.com%2Fen-us%2Fadvertising%2Fcampaign-management-service%2Fupdateconversiongoals%3Fview%3Dbingads-13%22%20rel%3D%22noopener%20noreferrer%22%20target%3D%22_blank%22%3Eupdate%3C%2FA%3E%20the%20custom%20event%2C%20offline%20conversion%2C%20or%20URL%20goals%20you%20must%20set%20a%20%3CA%20href%3D%22https%3A%2F%2Fdocs.microsoft.com%2Fen-us%2Fadvertising%2Fcampaign-management-service%2Fconversiongoal%3Fview%3Dbingads-13%23goalcategory%22%20rel%3D%22noopener%20noreferrer%22%20target%3D%22_blank%22%3Egoal%20category%3C%2FA%3E%20or%20the%20Campaign%20Management%20service%20will%20return%20an%20error.%3C%2FP%3E%3C%2FLINGO-TEASER%3E%3CLINGO-LABS%20id%3D%22lingo-labs-2420707%22%20slang%3D%22en-US%22%3E%3CLINGO-LABEL%3EBing%20Ads%20API%3C%2FLINGO-LABEL%3E%3CLINGO-LABEL%3EBing%20Ads%20SDK%3C%2FLINGO-LABEL%3E%3C%2FLINGO-LABS%3E
Co-Authors
Version history
Last update:
‎Jun 06 2021 08:49 PM
Updated by: