Avant de commencer
Modifier le type de tableau des données
Vous pouvez modifier des données sur Affise via de nombreuses méthodes API, mais certaines d'entre elles requièrent des connaissances spécifiques pour travailler correctement avec les données. L'un de ces cas est l'édition de données de type tableau.
Les particularités du type tableau sont les suivantes :
vous devez conserver (répéter) les paramètres de l'ensemble du tableau, que vous souhaitez enregistrer, dans la demande d'édition
vous devez ajouter de nouveaux paramètres au tableau concerné, si nécessaire, en tenant compte du point précédent.
vous devez supprimer les paramètres de l'ensemble du tableau, que vous ne souhaitez pas sauvegarder, dans la demande d'édition. Dans le cas d'autres types de données (chaînes ou entiers), les données ne seront pas supprimées si vous ne les répétez pas dans la demande d'édition de l'API.
Dans cet article, vous verrez plusieurs exemples de modification de données de type tableau.
Modifier un groupe de ciblage
Supposons que vous ayez trois groupes de ciblage dans l'offre avec les paramètres suivants :
Groupe de ciblage général :
Pays : France, Espagne, Pays-Bas.
L'anti-fraude au niveau du clic est activé.
Appareils : mobiles.
Groupe cible général.
Pays : France : France.
L'anti-fraude au clic est activée.
Valeurs sub1 autorisées : 123,323.
Groupe de ciblage personnel pour l'affilié #2.
Pays : Espagne, Italie.
L'anti-fraude au niveau des clics est activé.
Les paramètres de ces réglages sont :
🔎 Chaque groupe de ciblage est un tableau de données distinct.
Supposons que vous souhaitiez modifier les pays dans tous les groupes de ciblage généraux, ajouter des comptes sub1 autorisés au premier groupe de ciblage général et supprimer le groupe de ciblage personnel. Les autres paramètres doivent être conservés.
Les paramètres de la requête API sont les suivants
La requête cURL de l'exemple est la suivante :
curl --request POST \N- --url https://api-rocketcompany.affise.com/3.0/admin/offer/1441540 \N- --header 'api-key : 4sdf87fsdfd8723lkjhrn324' \N- --header 'content-type : application/x-www-form-urlencoded' \N- --cookie PHPSESSID=7u7eu0hds2parivvhl6nbicgj9 \N- --data 'targeting[0][country][allow][0]=DE' \N- --data 'targeting[0][country][allow][1]=BE' \N- --data 'targeting[0][country][allow][2]=AT' \N- --data 'targeting[0][device_type][0]=mobile' \N- --data 'targeting[0][block_proxy]=1' \N- --data 'targeting[0][sub][allow][1][0]=123' \N- --data 'targeting[0][sub][allow][1][1]=321' \N- --data 'targeting[1][country][allow][0]=DE' \N- --data 'targeting[1][block_proxy]=1' \N- --data 'targeting[1][sub][allow][1][0]=123' \N- --data 'targeting[1][sub][allow][1][1]=321' \N- --data 'targeting[1][sub][allow][1][1][1]=321' \N-
La requête modifie les éléments suivants :
Il n'y a pas de groupe de ciblage personnel (il est supprimé).
Les pays des deux groupes généraux diffèrent des groupes initiaux.
Les valeurs sub1 autorisées sont ajoutées au premier groupe de ciblage général.
Tous les paramètres que nous voulions conserver sont sauvegardés dans l'offre.
Modifier un paiement
Supposons que vous ayez deux paiements dans l'offre avec les paramètres suivants :
Paiement général.
Pays : La Norvège, la Suède et le Danemark sont exclus.
Type de paiement : fixe.
Devise : EUR.
Revenu : 10.
Paiement : 5.
Valeur de l'objectif : inst.
Paiement général.
Pays : Pologne.
Sub1 : 456, sub2 : 678.
Type de paiement : pourcentage.
Devise : EUR : EUR.
Recettes : 10.
Paiement : 5.
Valeur de l'objectif : acheteur.
Les paramètres de ces réglages sont :
🔎 Chaque paiement est un tableau de données distinct.
Supposons que vous souhaitiez inclure des pays dans le premier paiement, ajouter des valeurs sub1 et sub2 à cet endroit, modifier la devise, le revenu et les paiements dans le deuxième paiement, et supprimer les valeurs sub1 et sub2 à cet endroit.
Les paramètres de la requête API sont les suivants :
La requête cURL de l'exemple est la suivante :
curl --request POST \N- --url https://api-rocketcompany.affise.com/3.0/admin/offer/1441540 \N- --header 'api-key : 4sdf87fsdfd8723lkjhrn324' \N- --header 'content-type : application/x-www-form-urlencoded' \N- --cookie PHPSESSID=7u7eu0hds2parivvhl6nbicgj9 \N- --data 'payments[0][countries][0]=DK' \N- --data 'payments[0][countries][1]=NO' \N- --data 'payments[0][countries][2]=SE' \N- --data 'payments[0][country_exclude]=0' \N- --data 'payments[0][type]=fixed' \N- --data 'payments[0][currency]=EUR' \N- --data 'payments[0][total]=10' \N- --data 'payments[0][revenue]=5' \N- --data 'payments[0][goal]=inst' \N- --data 'payments[0][sub1]=456' \N- --data 'payments[0][sub2]=678' \N- --data 'payments[1][countries][0]=PL' \N- --data 'payments[1][type]=percent' \N- --data 'payments[1][currency]=USD' \N- --data 'payments[1][total]=8' \N- --data 'payments[1][revenue]=4' \N- --data 'payments[1][goal]=purch' \N- --data 'payments[1][sub1]=0' \N- --data 'payments[1][sub2]=0'
La requête modifie les éléments suivants :
les pays des premiers paiements sont inclus.
Les valeurs sub1 et sub2 ont été ajoutées au premier paiement et supprimées du second.
la devise, les revenus et les paiements ont été modifiés dans le deuxième paiement.
Modifier une conversion
Utilisez cette méthode pour modifier le statut de la conversion, le revenu, le paiement et la devise. Vous trouverez ici un exemple détaillé.
Lors de la modification d'une conversion, certaines données ne doivent pas être conservées/répétées dans la demande API.
La méthode: POST /3.0/admin/conversion/edit
Modifier le postback d'un affilié
Utilisez cette méthode pour modifier le lien postback de l'affilié : l'URL, les paramètres, les macros.
🔎 Dans la requête API, vous devez utiliser l'ID du postback. Vous pouvez le trouver sur la page d'édition de l'affilié dans le panneau d'administration, ou via la méthode API pour la liste des postbacks d'affiliés.
La méthode: POST /3.0/partner/postback/{ID}
La requête cURL pour changer un lien de postback :
curl --request POST \N- --url https://api-rocketcompany.affise.com/3.0/partner/postback/1496 \N- --header 'api-key : 4sdf87fsdfd8723lkjhrn324' \N- --header 'content-type : application/x-www-form-urlencoded' \N- --cookie PHPSESSID=7u7eu0hds2parivvhl6nbicgj9 \N- --data 'url=https://new.postback.com?sub1={sub1}' \N- --data status=confirmed \N- --data integration_method=allModifier un affilié
Utilisez cette méthode pour modifier le profil de l'affilié sur Affise. Cette méthode ne concerte pas les postbacks ou les pixels, elle concerne les informations du profil, les systèmes de paiement, et d'autres données non liées à l'intégration.
La méthode: POST /3.0/admin/partner/{ID}
La requête cURL pour modifier les informations de profil et ajouter des balises, un pourcentage de référence et un système de paiement.
curl --request POST \N- --url https://api-rocketcompany.affise.com/3.0/admin/partner/2 \N- --header 'api-key : 4sdf87fsdfd8723lkjhrn324' \N- --header 'content-type : application/x-www-form-urlencoded' \N- --cookie PHPSESSID=7u7eu0hds2parivvhl6nbicgj9 \N- --data country=ES \N- --data 'contact_person=John Snow' \N- --data 'tags[0]=new_aff' \N- --data 'tags[1]=gambling' \N- --data ref_percent=10 \N- --data 'payment_systems[0][system_id]=35' \N- --data 'payment_systems[0][currency]=USD' \N- --data 'payment_systems[0][fields][1]=12333321'
Aucune donnée modifiée n'appartient ici au type tableau. Cependant, les données ajoutées appartiennent au type de tableau (tags, système de paiement).
Veuillez contacter l'équipe d'assistance à la clientèle d'Affise pour toutes les questions soulevées par le biais de l'e-mail : [email protected].