Share via

Information on CustomerID and how to use it in the adCenter API

  • Article

We have received several support requests regarding CustomerID that is used in the adCenter API SOAP header. I was hoping to clear up some of the questions for those of you upgrading to adCenter API version 6 by our October 31 deadline.The CustomerID is only needed for a small number of adCenter API calls, specifically the targeting library calls such as CampaignManagement AddTargetsToLibrary. It is also needed if you have an editorial bypass in place, such as a trademark term. If you are not using the target libraries or don't have any editorial exclusions, you won't need it, and you can leave the value as null or an empty string, which would produce a SOAP element such as:

<h:CustomerId i:nil="true" xmlns:h="https://adcenter.microsoft.com/v6" xmlns:i="https://www.w3.org/2001/XMLSchema-instance"/>

If you are using the targeting libraries, then you will need to contact support to retrieve your CustomerID.

If you are a reseller and creating customers via the call to CustomerSignUp, then you would want to store the CustomerID that is returned by this method.

There is more information on the CustomerID and other identifiers on MSDN at:

https://msdn.microsoft.com/en-us/library/dd776532.aspx

Jeff Dillon, API Support

Comments

  • Anonymous
    January 19, 2010
    You can also find your customerID using the AdCenter Desktop, available at:go.microsoft.com/fwlinkAfter you load your customers, you can hover/mouse over the Customer name, and it will show as a tool tipJeff
  • Anonymous
    September 21, 2010
    Hello.I'm trying to get the customer id via the adcenter API, so I call CustomerSignup. But that method throws an exception "Please accept terms and conditions". The only thing I found on this issue is msdn.microsoft.com/.../bb671962%28v=MSADS.60%29.aspx, it says the header is called consentToTermsAndConditions, but it doesn't work. I've tried other names such as TermsAndConditions and so on, but it keeps throwing the same error. Here's my SOAP call:<SOAP-ENV:Envelope xmlns:SOAP-ENV="schemas.xmlsoap.org/.../"   xmlns:ns1="adcenter.microsoft.com/syncapis" xmlns:ns2="adcenter.microsoft.com/v6"><SOAP-ENV:Header><ns2:ApplicationToken></ns2:ApplicationToken><ns2:DeveloperToken></ns2:DeveloperToken><ns2:UserName></ns2:UserName><ns2:Password>***</ns2:Password><ns2:TermsAndConditions>true</ns2:AcceptTermsAndConditions></SOAP-ENV:Header><SOAP-ENV:Body><ns1:CustomerSignUp/></SOAP-ENV:Body></SOAP-ENV:Envelope>