Como gerar um Source ID para um publisher usando o Wrapper PHP

Para que seu aplicativo seja monetizado pela Lomadee, é necessário que em todas as requisições à API do Buscapé o Source ID seja informado.

Hoje iremos aprender como gerar um Source ID usando o wrapper para PHP. O Source ID é um código gerado para cada Publisher, pelo qual a Lomadee poderá identificar cada um dos Publishers e monetizá-los individualmente.

Com o wrapper para PHP instanciado em nossa aplicação, vamos utilizar o método createSourceId, que requer um parâmetro em formato de array com os seguintes dados:

• siteId = ID do site selecionado pelo publisher;
• publisherId = ID do publisher;
• sourceName = Nome do código;
• campaignList = Lista de IDs das campanhas separadas por vírgula;
• token = Token utilizado para validação na requisição.

Vendo na prática, precisamos do seguinte código:

// Classe necessária para o correto uso e funcionamento do wrapper
require_once '../Apiki_Buscape_API.php';
 
// Application ID usado para testes na API do BuscaPé.
$applicationID  = '564771466d477a4458664d3d';
 
// Instancia o wrapper
$objBuscaPeApi = new Apiki_Buscape_API( $applicationID );
 
// Seta o ambiente sandbox para as requisições
$objBuscaPeApi->setSandbox();
 
// Cria o Source ID
$createSourceXML = $objBuscaPeApi->createSourceId( array(
    'siteId'        => '326598',
    'publisherId'   => '794613',
    'sourceName'    => 'Nome',
    'campaignList'  => '1,2,3',
    'token'         => '718293415263784512'
) );
 
// Obtém dos dados do XML em formato de objeto
$objCreateSource = simplexml_load_string( $createSourceXML );
 
// Obtém o Source ID criado
$sourceID = $objCreateSource->source->attributes()->id

Os parâmetros passados são meramente fictícios e estão sendo usados no ambiente de sandbox da API do Bucapé. Para que sua aplicação funcione de fato, passe os parâmetros reais e use o ambiente bws da API.

Seguem abaixo os dados em XML retornados pela API do Buscapé para a requisição feita no código acima.

http://sandbox.buscape.com/service/createSource/lomadee/564771466d477a4458664d3d/BR/?siteId=326598&publisherId=794613&sourceName=Nome&campaignList=1%2C2%2C3&token=718293415263784512

<!--?xml version="1.0" encoding="UTF-8" standalone="yes"?-->
 
<details>         564771466d477a4458664d3d
1.0.0.0
 
http://bws-apps.buscape.com/mobile/update
 
2012-04-04T16:04:12.499-03:00
17
success
<code>0</code>
success
</details>
<source id="9262544" />

É isso, pessoal! Espero que esse serviço da API do Buscapé possa ser útil para vocês em alguma parte do desenvolvimento dos seus aplicativos.