Antes de começar

Editar o tipo de matriz de dados

Você pode editar dados no Affise por meio de muitos métodos de API; no entanto, alguns deles exigem conhecimento específico para trabalhar com os dados corretamente. Um desses casos é a edição de dados do tipo matriz.

As peculiaridades do tipo de matriz são

você precisa manter (repetir) as configurações de toda a matriz, que deseja salvar, na solicitação de edição
você precisa adicionar novas configurações à matriz relevante, se necessário, levando em conta o ponto anterior.
você precisa excluir as configurações de toda a matriz, que não deseja salvar, na solicitação de edição. No caso de outros tipos de dados (cadeia de caracteres ou número inteiro), os dados não serão excluídos se você não os repetir na solicitação de edição da API.

Neste artigo, você verá vários exemplos de edição do tipo de matriz de dados.

Editar um grupo de segmentação

Vamos supor que você tenha três grupos de segmentação na oferta com as seguintes configurações:

Grupo de segmentação geral:
- Países: França, Espanha, Holanda.
- O antifraude em nível de clique está ativado.
- Dispositivos: móveis.
Grupo de segmentação geral.
- Países: França.
- O antifraude em nível de clique está ativado.
- Valores sub1 permitidos: 123,323.
Grupo de segmentação pessoal para o afiliado nº 2.
- Países: Espanha, Itália.
- O antifraude em nível de clique está ativado.

Os parâmetros para essas configurações são:

Cada grupo de segmentação é uma matriz separada de dados.

Vamos supor que você queira alterar os países em todos os grupos de segmentação geral, adicionar contas sub1 permitidas ao primeiro grupo de segmentação geral e excluir o grupo de segmentação pessoal. Outras configurações devem permanecer.

Os parâmetros para a solicitação de API são:

A solicitação cURL para o exemplo é:

curl --request POST \ --url https://api-rocketcompany.affise.com/3.0/admin/offer/1441540 \ --header 'api-key: 4sdf87fsdfd8723lkjhrn324' \ --header 'content-type: application/x-www-form-urlencoded' \ --cookie PHPSESSID=7u7eu0hds2parivvhl6nbicgj9 \ --data 'targeting[0][country][allow][0]=DE' \ --data 'targeting[0][country][allow][1]=BE' \ --data 'targeting[0][country][allow][2]=AT' \ --data 'targeting[0][device_type][0]=mobile' \ --data 'targeting[0][block_proxy]=1' \ --data 'targeting[0][sub][allow][1][0]=123' \ --data 'targeting[0][sub][allow][1][1]=321' \ --data 'targeting[1][country][allow][0]=DE' \ --data 'targeting[1][block_proxy]=1' \ --data 'targeting[1][sub][allow][1][0]=123' \ --data 'targeting[1][sub][allow][1][1]=321'

A solicitação altera o seguinte:

Não há grupo de segmentação pessoal (ele foi excluído).
Os países em ambos os grupos gerais são diferentes dos iniciais.
Os valores sub1 permitidos são adicionados ao primeiro grupo de segmentação geral.
Todas as configurações que queríamos manter são salvas na oferta.

Editar um pagamento

Vamos supor que você tenha dois pagamentos na oferta com as seguintes configurações:

Pagamento geral.
- Países: Noruega, Suécia e Dinamarca estão excluídos.
- Tipo de pagamento: fixo.
- Moeda: EUR.
- Receita: 10.
- Pagamento: 5.
- Valor da meta: inst.
Pagamento geral.
- Países: Polônia.
- Sub1: 456, sub2: 678.
- Tipo de pagamento: porcentagem.
- Moeda: EUR.
- Receita: 10.
- Pagamento: 5.
- Valor da meta: compra.

Os parâmetros para essas configurações são:

Cada pagamento é uma matriz de dados separada.

Vamos supor que você queira incluir países no primeiro pagamento, adicionar valores sub1 e sub2, alterar a moeda, a receita e os pagamentos no segundo pagamento e excluir os valores sub1 e sub2.

Os parâmetros para a solicitação de API são:

A solicitação cURL para o exemplo é:

curl --request POST \ --url https://api-rocketcompany.affise.com/3.0/admin/offer/1441540 \ --header 'api-key: 4sdf87fsdfd8723lkjhrn324' \ --header 'content-type: application/x-www-form-urlencoded' \ --cookie PHPSESSID=7u7eu0hds2parivvhl6nbicgj9 \ --data 'payments[0][countries][0]=DK' \ --data 'payments[0][countries][1]=NO' \ --data 'payments[0][countries][2]=SE' \ --data 'payments[0][country_exclude]=0' \ --data 'payments[0][type]=fixed' \ --data 'payments[0][currency]=EUR' \ --data 'payments[0][total]=10' \ --data 'payments[0][revenue]=5' \ --data 'payments[0][goal]=inst' \ --data 'payments[0][sub1]=456' \ --data 'payments[0][sub2]=678' \ --data 'payments[1][countries][0]=PL' \ --data 'payments[1][type]=percent' \ --data 'payments[1][currency]=USD' \ --data 'payments[1][total]=8' \ --data 'payments[1][revenue]=4' \ --data 'payments[1][goal]=purch' \ --data 'payments[1][sub1]=0' \ --data 'payments[1][sub2]=0'

A solicitação altera o seguinte:

os países nos primeiros pagamentos são incluídos.
Os valores sub1 e sub2 foram adicionados ao primeiro pagamento e excluídos do segundo pagamento.
moeda, receita e pagamentos foram alterados no segundo pagamento.

Editar uma conversão

Use esse método para editar o status da conversão, a receita, o pagamento e a moeda. Aqui você pode encontrar um exemplo detalhado.

Ao editar uma conversão, nenhum dado específico deve ser mantido/repetido na solicitação de API.

O método: POST /3.0/admin/conversion/edit

Editar o postback de um afiliado

Use esse método para editar o link de postback do afiliado: a URL, os parâmetros, as macros.

Na solicitação da API, você precisa usar o ID do postback. Você pode encontrá-lo na página de edição do afiliado no painel de administração ou por meio do método de API para a lista de postbacks de afiliados.

O método: POST /3.0/partner/postback/{ID}

A solicitação cURL para alterar um link de postback:

curl --request POST \ --url https://api-rocketcompany.affise.com/3.0/partner/postback/1496 \ --header 'api-key: 4sdf87fsdfd8723lkjhrn324' \ --header 'content-type: application/x-www-form-urlencoded' \ --cookie PHPSESSID=7u7eu0hds2parivvhl6nbicgj9 \ --data 'url=https://new.postback.com?sub1={sub1}' \ --data status=confirmed \ --data integration_method=all

Editar um afiliado

Use esse método para editar o perfil do afiliado no Affise. Esse método não faz concertação de postbacks ou pixels, ele trata das informações do perfil, dos sistemas de pagamento e de outros dados que não são de integração.

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

A solicitação cURL para alterar as informações de perfil e adicionar tags, porcentagem de referência e um sistema de pagamento.

curl --request POST \ --url https://api-rocketcompany.affise.com/3.0/admin/partner/2 \ --header 'api-key: 4sdf87fsdfd8723lkjhrn324' \ --header 'content-type: application/x-www-form-urlencoded' \ --cookie PHPSESSID=7u7eu0hds2parivvhl6nbicgj9 \ --data country=ES \ --data 'contact_person=John Snow' \ --data 'tags[0]=new_aff' \ --data 'tags[1]=gambling' \ --data ref_percent=10 \ --data 'payment_systems[0][system_id]=35' \ --data 'payment_systems[0][currency]=USD' \ --data 'payment_systems[0][fields][1]=12333321'

Nenhum dado editado aqui pertence ao tipo de matriz. No entanto, os dados adicionados pertencem ao tipo de matriz (tags, o sistema de pagamento).

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].