Antes de empezar
Editar el tipo de matriz de datos
Puede editar datos en Affise a través de muchos métodos de la API, sin embargo, algunos de ellos requieren conocimientos específicos para trabajar correctamente con los datos. Uno de estos casos es la edición de datos de tipo array.
Las peculiaridades del tipo array son:
es necesario mantener (repetir) la configuración de toda la matriz, que desea guardar, en la solicitud de edición
es necesario añadir nuevos ajustes a la matriz correspondiente, si es necesario, teniendo en cuenta el punto anterior.
es necesario eliminar los ajustes de toda la matriz, que no desea guardar, en la solicitud de edición. En el caso de otros tipos de datos (cadena o entero), los datos no se borrarán, si no los repite en la petición API de edición.
En este artículo, verá varios ejemplos de edición de datos de tipo array.
Editar un grupo de destino
Supongamos que tiene tres grupos de destinatarios en la oferta con la siguiente configuración:
Grupo de segmentación general:
Países: Francia, España, Países Bajos.
El antifraude a nivel de clics está activado.
Dispositivos: móvil.
Grupo objetivo general.
Países: Francia.
El antifraude a nivel de clics está activado.
Valores sub1 permitidos: 123,323.
Grupo de segmentación personal para el afiliado nº 2.
Países: España, Italia.
El antifraude a nivel de clics está activado.
Los parámetros para esta configuración son:
🔎 Cada grupo de segmentación es una matriz de datos independiente.
Supongamos que desea cambiar los países en todos los grupos de segmentación generales, añadir cuentas sub1 permitidas al primer grupo de segmentación general y eliminar el grupo de segmentación personal. Los demás ajustes deben permanecer.
Los parámetros para la solicitud API son
La solicitud cURL para el ejemplo es:
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'
La solicitud cambia lo siguiente:
No hay grupo de segmentación personal (se elimina).
Los países de ambos grupos generales difieren de los iniciales.
Los valores sub1 permitidos se añaden al primer grupo de segmentación general.
Todos los ajustes que queríamos mantener se guardan en la oferta.
Editar un pago
Supongamos que tiene dos pagos en la oferta con la siguiente configuración:
Pago general.
Países: Noruega, Suecia y Dinamarca están excluidos.
Tipo de pago: fijo.
Divisa: EUR.
Ingresos: 10.
Pago: 5.
Valor del objetivo: inst.
Pago general.
Países: Polonia.
Sub1: 456, sub2: 678.
Tipo de pago: porcentaje.
Divisa: EUR.
Ingresos: 10.
Pago: 5.
Valor del objetivo: comprador.
Los parámetros para estos ajustes son:
🔎 Cada pago es una matriz de datos independiente.
Supongamos que desea incluir países en el primer pago, agregar valores sub1 y sub2 allí, cambiar la moneda, los ingresos y los pagos en el segundo pago y eliminar valores sub1 y sub2 allí.
Los parámetros para la solicitud API son:
La solicitud cURL para el ejemplo es:
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][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][income]=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'
La solicitud modifica lo siguiente
se incluyen los países de los primeros pagos.
los valores sub1 y sub2 se añadieron al primer pago y se eliminaron del segundo pago.
la divisa, los ingresos y los pagos se han modificado en el segundo pago.
Editar una conversión
Utilice este método para editar el estado de la conversión, los ingresos, el pago y la divisa. Aquí puede encontrar un ejemplo detallado.
🔎 Al editar una conversión, no deben permanecer/repetirse ciertos datos en la solicitud API.
El método: POST /3.0/admin/conversion/edit
Editar el postback de un afiliado
Utilice este método para editar el enlace de postback del afiliado: la URL, los parámetros, las macros.
🔎 En la solicitud API, debe utilizar el ID del postback. Puedes encontrarlo en la página de edición del afiliado en el panel de administración, o a través del método API para la lista de postbacks de afiliados.
El método: POST /3.0/afiliado/postback/{ID}
La petición cURL para cambiar un enlace 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=allEditar un afiliado
Utilice este método para editar el perfil del afiliado en Affise. Este método no concierne a los postbacks ni a los píxeles, sino a la información del perfil, los sistemas de pago y otros datos no relacionados con la integración.
El método: POST /3.0/admin/partner/{ID}
La solicitud cURL para cambiar la información de perfil y añadir etiquetas, porcentaje de referencia y un sistema de pago.
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' \ --datos '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'
Ningún dato editado aquí pertenece al tipo array. Sin embargo, los datos añadidos pertenecen al tipo array (etiquetas, el sistema de pago).
Póngase en contacto con el equipo de atención al cliente de Affise en relación con todas las preguntas planteadas a través del correo electrónico: [email protected].