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


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="http://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:

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

Jeff Dillon, API Support

 

 

 

Comments (2)

  1. Cnorred says:

    You can also find your customerID using the AdCenter Desktop, available at:

    go.microsoft.com/fwlink

    After you load your customers, you can hover/mouse over the Customer name, and it will show as a tool tip

    Jeff

  2. Cnorred says:

    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>

Skip to main content