Passar para o conteúdo principal
API para ofertas (administradores)
Natalya Yefimenko avatar
Escrito por Natalya Yefimenko
Atualizado há mais de 7 meses

Antes de começar

API para ofertas

A API do Affise fornece muitos métodos para trabalhar com ofertas: você pode obter informações ou adicionar/alterar/excluir. Por meio da API, você pode gerenciar suas ofertas, permitindo que os afiliados adicionem uma ou mais regras de limite. Neste artigo, você encontrará exemplos das solicitações (métodos) de API mais populares para ofertas com exemplos de cURL e exemplos da resposta.

Lista de ofertas

Use esse método para obter a lista de ofertas de acordo com suas propriedades, que você pode indicar em sua solicitação de API.

O método: GET /3.0/offers.

A solicitação para obter ofertas com o status Active (Ativo):

https://api-rocketcompany.affise.com/3.0/offers?api-key=4sdf87fsdfd8723lkjhrn324&status[]=active

Adicionar uma oferta

Use esse método para adicionar uma oferta ao painel de administração. No documento da API, você vê parâmetros gerais, bem como parâmetros do tipo de matriz para:

  • pagamentos

  • páginas de destino

  • limites

  • níveis de comissão

  • grupos de segmentação

    • URLs de rastreamento adicionais

    • Estrutura do sistema operacional

  • Criativos em HTML

  • cronograma de ofertas

Todos esses tipos de dados têm parâmetros obrigatórios:

  • um parâmetro principal para cada tipo

  • parâmetro(s) obrigatório(s) dentro de cada matriz (marcado(s) com * no documento da API)

A lista de parâmetros principais para cada tipo de dados:

  • pagamentos: para pagamentos

  • landing pages: para páginas de aterrissagem e pré-páginas de aterrissagem

  • caps: para caps

  • commission_tiers: para níveis de comissão

  • targeting: para grupos de targeting

  • schedule: para o cronograma da oferta

  • creativesHtml: para criativos em HTML

Os parâmetros obrigatórios para criar uma oferta são:

  • title

  • anunciante

  • url

  • pagamentos

Se você não souber quais valores adicionar (por exemplo, códigos ISO para países), use os métodos aqui e aqui, que ajudarão a obter a lista de valores disponíveis.

O método: POST /3.0/admin/offer

A solicitação cURL para adicionar uma oferta com as seguintes propriedades:

  • o status Active (Ativo).

  • O nível de privacidade Privado.

  • a caixa de seleção CPI selecionada.

  • a nota.

  • um grupo de segmentação geral para França, Alemanha e Itália, para Android >= 6.0.0.

  • um pagamento geral para os mesmos países, o tipo fixo de pagamento em USD.

  • uma regra de limite para 1000 conversões para o período = mês, meta = todos, afiliados = todos.

  • duas páginas de destino.

curl --request POST \ --url https://api-rocketcompany.affise.com/3.0/admin/offer \ --header 'api-key: 4sdf87fsdfd8723lkjhrn324' \ --header 'content-type: application/x-www-form-urlencoded' \ --data 'title=New Offer' \ --data advertiser=62fcd7ae7a3ccd7eacd7e4eb \ --data 'url=http://new-tracking-link.network.com?clickid={clickid}' \ --data status=active \ --data privacy=private \ --data is_cpi=1 \ --data 'notes=Esta é a mais nova oferta' \ --data 'targeting[0][country][allow][0]=FR' \ --data 'targeting[0][country][allow][1]=DE' \ --data 'targeting[0][country][allow][2]=IT' \ --data 'targeting[0][os][allow][0][name]=Android' \ --data 'targeting[0][os][allow][0][comparison]=GTE' \ --data 'targeting[0][os][allow][0][version]=6.0.0' \ --data 'payments[0][countries][0]=FR' \ --data 'payments[0][countries][1]=DE' \ --data 'payments[0][countries][2]=IT' \ --data 'payments[0][currency]=USD' \ --data 'payments[0][type]=fixed' \ --data 'caps[0][period]=month' \ --data 'caps[0][type]=conversions' \ --data 'caps[0][value]=1000' \ --data 'caps[0][goal_type]=all' \ --data 'caps[0][affiliate_type]=all' \ --data 'landings[0][title]=Dating online' \ --data 'landings[0][url]=http://new-tracking-link.network.com?clickid={clickid}&sub1=online' \ --data 'landings[0][url_preview]=http://new-tracking-link.network.com/online' \ --data 'landings[1][title]=Dating offline' \ --data 'landings[1][url]=http://new-tracking-link.network.com?clickid={clickid}&sub1=offline' \ --data 'landings[1][url_preview]=http://new-tracking-link.network.com/offline'

⚠️ Certifique-se de atender a todos os requisitos do tipo de matriz de dados, inclusive colchetes e numeração.

Adicionar uma oferta com logotipo ou criativos

Use esse método para adicionar uma oferta com um logotipo ou um anúncio. Além dos parâmetros obrigatórios mencionados anteriormente, você pode adicionar os seguintes:

  • creativeFiles

  • creativeUrls

  • creativeDownloads

  • creativesHtml

  • creativeAssets

  • creativeFileTitles

  • creativeUrlTitles

  • creativeDownloadTitles

  • logotipo

⚠️ Se você criar uma oferta manualmente por meio da API e quiser adicionar um logotipo ou arquivos/downloads criativos, certifique-se de usar o seguinte cabeçalho content-type: multipart/form-data.

A solicitação pode ter a seguinte aparência:

Você pode ver uma demonstração de como adicionar um arquivo com um logotipo:

A solicitação cURL para a criação da oferta com logotipo e criativos:

curl --location --request POST 'https://api-rocketcompany.affise.com/3.0/admin/offer' \--header 'Content-Type: application/x-www-form-urlencoded' \--header 'Content-Type: multipart/form-data' \--header 'api-key: bf09c801ff9b95b14ac8e17d6e4904b6' \--form 'title=OFFER WITH LOGO AND CREATIVES' \--form 'advertiser=5e39279bac611cda7e5765ab' \--form 'url=https://track.gjane.com/hc/click?afclick={clickid}&afpid={pid}&afoffer={offer_id}' \--form 'logo=@/C:/Users/37525/Downloads/api.png' \--form 'creativeFiles[0]=@/C:/Users/37525/Downloads/api.png' \--form 'creativeUrls[1]=https://google.drive' \--form 'creativeDownloads=https://google.drive/download' \

Editar uma oferta

Use esse método para editar uma oferta: todas as configurações ou apenas uma parte da oferta. Recomendamos a leitura do artigo sobre a edição do tipo de matriz de dados antes de usar esse método.

O método: POST /3.0/admin/offer/{ID}

A solicitação cURL para editar um grupo de segmentação na mesma oferta, que é usada como exemplo para adicionar a oferta. No exemplo, o seguinte foi alterado:

  • França, Alemanha e Itália foram substituídas por Islândia e Irlanda.

  • a versão do sistema operacional foi alterada para 7.0.0.

  • a ferramenta de proxy antifraude foi ativada.

curl --request POST \ --url https://api-rocketcompany.affise.com/3.0/admin/offer/1441594 \ --header 'api-key: 4sdf87fsdfd8723lkjhrn324' \ --header 'content-type: application/x-www-form-urlencoded' \ --data 'targeting[0][country][allow][0]=IS' \ --data 'targeting[0][country][allow][1]=IE' \ --data 'targeting[0][block_proxy]=1' \ --data 'targeting[0][os][allow][0][name]=Android' \ --data 'targeting[0][os][allow][0][comparison]=GTE' \ --data 'targeting[0][os][allow][0][version]=7.0.0' \ --data =

⚠️ Certifique-se de atender a todos os requisitos do tipo de matriz de dados, inclusive colchetes e numeração.

Habilitar afiliados

Use esse método para permitir que seu afiliado trabalhe com a oferta. O método é relevante somente se o nível de privacidade da oferta for Pré-moderação ou Privado.

O método: POST /3.0/offer/enable-affiliate.

A solicitação cURL para habilitar o afiliado nº 2:

curl --request POST \ --url https://api-rocketcompany.affise.com/3.0/offer/enable-affiliate \ --header 'api-key: 4sdf87fsdfd8723lkjhrn324' \ --header 'content-type: application/x-www-form-urlencoded' \ --data offer_id=1441594 \ --data pid=2

Desativar afiliados

Use esse método para permitir que seu afiliado trabalhe com a oferta. O método é relevante para ofertas com todos os níveis de privacidade.

O método: POST /3.0/offer/enable-affiliate.

A solicitação cURL para a desativação do afiliado #2:

curl --request POST \ --url https://api-rocketcompany.affise.com/3.0/offer/disable-affiliate \ --header 'api-key: 4sdf87fsdfd8723lkjhrn324' \ --header 'content-type: application/x-www-form-urlencoded' \ --data offer_id=1441594 \ --data pid=2

A lista de afiliados desativados/ativados

Use esse método para obter a lista de afiliados que podem ou não trabalhar com uma determinada oferta.

O método: GET /3.1/offers/{ID}/privacy.

A solicitação:

https://api-rocketcompany.affise.com/3.1/offers/1441594/privacy?api-key=4sdf87fsdfd8723lkjhrn324

Atualizar o status das ofertas

Use esse método para alterar em massa o status das ofertas.

O método: POST /3.0/admin/offer/mass-update.

A solicitação cURL para alterar os status de três ofertas para Pausado:

curl --request POST \ --url https://api-rocketcompany.affise.com/3.0/admin/offer/mass-update \ --header 'api-: 4sdf87fsdfd8723lkjhrn324' \ --header 'content-type: application/x-www-form-urlencoded' \ --data 'offer_id[0]=1441594' \ --data 'offer_id[1]=1441528' \ --data 'offer_id[2]=1441527' \ --data status=suspended

Entre em contato com a equipe de Suporte ao Cliente da Affise sobre todas as questões levantadas por meio do e-mail: [email protected].

Respondeu à sua pergunta?