API d'événements serveur à serveur pour PBA (Web-S2S)

La mise en œuvre de l'API nécessite les informations d'identification suivantes, disponibles dans le tableau de bord :

• ID de bundle (ou ID du bundle de marques)
• Clé dev web

Pour obtenir les informations d'identification : 

1. Dans AppsFlyer, dans le menu supérieur, sélectionnez Mes applications > Voir les bundles de marques.
   La liste des bundles s'affiche.
2. Copiez et enregistrez les données appropriées :
   • ID de bundle de marques
   • Clé dev web

Principes de base de l'API Web S2S

 Exemple Curl setCuId

curl --location --request POST 'https://webs2s.appsflyer.com/v1/bundleId/setcuid' \
--header 'Accept-Encoding: application/json' \
--header 'Content-Type: application/json' \
--data-raw '{
	"customerUserId": "1234567890abcdef",
	"afUserId":"9999999-f848-4963-a091-568f0bf9a361",
        "webDevKey" : "99999999-9999-9999-9999-999999999999"}

Les paramètres de la charge utile sont divisés en identifiants d'utilisateurs et en paramètres d'événements. 

• ID utilisateur : Vous devez envoyer au moins un paramètre d'identification de l'utilisateur.
• Événement : Envoyer les paramètres obligatoires et les paramètres optionnels si nécessaire.

Paramètres d'identification de l'utilisateur (envoyer au moins un paramètre)

Paramètres d'événement

curl --location --request POST 'https://webs2s.appsflyer.com/v1/bundleId/event' \
--header 'Accept-Encoding: application/json' \
--header 'Content-Type: application/json' \
--data-raw '{
	"customerUserId": "1234567890abcdef",
	"afUserId":"9999999-f848-4963-a091-568f0bf9a361",
    "webDevKey" : "99999999-9999-9999-9999-999999999999",
    "ip" : "192.0.2.1",
	"eventType":"EVENT",
	"timestamp" : 1234567890123,
	"eventName":"my_web_event",
	"eventRevenueCurrency" : "EUR",
	"eventRevenue" : 1234.56,
	
		"eventValue": {
		"purchase":{
		 "shoes": "color",
		 "quantity" : "3",
		 "Revenue" : "1234.56",
		 "Currency" : "ZAR"
		}
	}

}'

''' using the requests python package, install using pip install requests  '''
import requests
url = "https://webs2s.appsflyer.com/v1/bundleId/event"
payload = {
    "customerUserId": "1234567890abcdef",
    "afUserId": "9999999-f848-4963-a091-568f0bf9a361",
    "webDevKey": "99999999-9999-9999-9999-999999999999",
    "ip": "192.0.2.1",
    "eventType": "EVENT",
    "timestamp": 1234567890123,
    "eventName": "my_web_event",
    "eventRevenenuCurrency": "EUR",
    "eventRevenue": 1234.56,
    "eventValue":
        {
            "purchase":
            {
                "shoes": "color",
                "quantity": "3",
                "Revenue": "1234.56",
                "Currency": "ZAR"
            }
        }
    }
headers = {
    'Accept-Encoding': 'application/json',
    'Content-Type': 'application/json'
}
response = requests.request("POST", url, headers=headers, json=payload)
print(response.text.encode('utf8'))

À des fins de test, envoyez plusieurs événements comme suit :

1. Envoyer un événement.
2. Assurez-vous que vous obtenez un code de retour 200 OK. Si ce n'est pas le cas, prenez des mesures correctives à l'aide des codes de retour et des messages d'erreur.
3. Attendez plusieurs heures après minuit UTC pour voir l'événement reporté dans les données brutes du PBA. Vous devez attendre, car les données PBA sont traitées une fois par jour. 

 Pour obtenir la clé de dev Web :

1. Dans AppsFlyer, allez dans la section Mes applications.
2. Cliquez sur Voir le bundle de marques.

   

3. Copiez la  clé de développement web requise. 

• Le afUserId est un identifiant unique, défini par le SDK Web lorsqu'un utilisateur visite votre site pour la première fois.
• Si vous avez besoin de afUserId, utilisez l'une des méthodes suivantes.

Obtenir afUserId à partir de l'en-tête du cookie HTTP

• afUserId est envoyé par le navigateur des visiteurs lorsqu'ils visitent votre site.
•  L'extraire de l'en-tête du cookie HTTP si nécessaire.

Affichage de afUserId dans le navigateur du visiteur

•  Afficher afUserId dans le navigateur du visiteur, à des fins de dépannage et de débogage.
• Pour qu'il soit disponible, le visiteur doit d'abord avoir consulté au moins une fois une page contenant le SDK Web. 
• Le cookie contenant afUserId est un cookie first party lié à votre domaine.
• La procédure qui suit a été préparée à l'aide de Chrome 81. Il peut y avoir des différences entre les navigateurs et les systèmes d'exploitation.

Pour obtenir l'afUserId du navigateur du visiteur :

1. Dans votre navigateur, allez sur votre site web.
2. Cliquez avec le bouton droit de la souris et sélectionnez Inspecter
   La fenêtre d'inspection des éléments du navigateur s'ouvre.

   

3. Aller à la (A) Application (A).
4. Dans le menu latéral, (B) développez Cookies.
5. Sélectionnez votre site web. S’il ne s'affiche pas, actualisez le navigateur.
6. Dans le filtre (C) entrez afUserId
   La valeur de afUserID s'affiche. 

• Symptôme : les codes de retour HTTP ne sont pas renvoyés
  Solution : liste des serveurs autorisés AppsFlyer