Se você deseja desenvolver um aplicativo oficial da Lomadee, deverá realizar a integração de seu aplicativo. Um dos passos dessa integração (o primeiro e, talvez, o mais importante) é a criação do SourceID para cada publisher que for utilizar seu aplicativo. Dessa forma, a API saberá qual publisher está utilizando sua aplicação e conseguirá monetizar corretamente os clicks e ações realizadas.

Para gerar um SourceID, devemos realizar uma requisição REST ao serviço CreateSource da Lomadee. Devemos informar, como parâmetros desse serviço, o ID do site do publisher (siteId), o ID do publisher (publisherId), o nome que o publisher quer para seu o source (sourceName) e o token de segurança (token).

http://sandbox.buscape.com/service/createSource/lomadee/564771466d477a4458664d3d/BR/?siteId=1234&publisherId=20444&sourceName=meuNome&token=754e2b32746751514c397a45

Como retorno da API à requisição, teremos um XML contendo um nó source, cuja propriedade ID será o sourceID gerado para o publisher.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Result xmlns="urn:buscape" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" totalResultsReturned="0" totalResultsAvailable="0" xsi:schemaLocation="http://developer.buscape.com/admin/lomadee.xsd">
   <details>
       <applicationID>564771466d477a4458664d3d</applicationID>
       <applicationVersion>1.0.0.0</applicationVersion>
       <applicationPath>http://bws-apps.buscape.com/mobile/update</applicationPath>
       <date>2012-01-31T11:18:25.865-02:00</date>
       <elapsedTime>1</elapsedTime>
 
      <status>success</status>
       <code>0</code>
       <message>success</message>
   </details>
   <source id="9262544"/>
</Result>

Também podemos obter o retorno desse serviço em JSON, o que pode facilitar nosso trabalho na hora de tratar o resultado da requisição. Devemos procurar dentro do objeto JSON a propriedade source que da mesma forma que o XML possui o atributo ID.

{"details":{"message":"success","elapsedtime":1,"status":"success","code":0,"applicationversion":"1.0.0.0","date":{"minute":21,"valid":true,"timezone":-120,"second":35,"millisecond":623,"month":1,"year":2012,"hour":11,"day":31,"xmlschematype":{"namespaceuri":"http://www.w3.org/2001/XMLSchema","prefix":"","localpart":"dateTime"},"eonandyear":{"lowestsetbit":2}},"applicationpath":"http://bws-apps.buscape.com/mobile/update","applicationid":"564771466d477a4458664d3d"},"schk":false,"source":{"id":9262544},"totalresultsavailable":0,"totalresultsreturned":0}

Com o sourceID gerado para o publisher, você agora tem que garantir que toda requisição feita pela sua aplicação à API da Lomadee informe esse ID. Dessa forma, a API identificará o publisher e poderá monetizar corretamente – tanto o publisher, quanto você, desenvolvedor.