Guide d'Intégration Keitaro

Pour configurer le suivi des conversions serveur à serveur (S2S) pour le réseau Blockchain-Ads en utilisant Keitaro, vous configurerez Blockchain-Ads pour générer une URL de postback (où Keitaro enverra les données de conversion) puis l'intégrerez en tant que source de trafic personnalisée dans Keitaro. Cela garantit que Keitaro capture le {clickid} du trafic entrant et envoie des postbacks à Blockchain-Ads avec des ID de clic correspondants, des revenus et d'autres détails.

Étape 1 : Créer l'Événement de Conversion S2S dans Blockchain-Ads

1. Connectez-vous à votre tableau de bord Blockchain-Ads HUB.
2. Accédez à Advertising > Tracking > Create Conversion > Server to Server.
3. Suivez les instructions à l'écran pour configurer l'événement :
   
   • Nommez l'événement de conversion (par exemple, "Lead" ou "Sale").
   • Spécifiez le type d'événement (par exemple, lead, purchase) et tous les champs de revenus le cas échéant.
   • Cela générera un ID de tracker unique pour votre événement et une URL de postback au format :

GET https://server.blockchain-ads.com/www/delivery/tracker-mobile.php?clickid={clickid}&trackerid=YOUR_TRACKERID&transaction_value={transaction_value}

• {clickid} : Espace réservé pour l'ID de clic unique (Blockchain-Ads le fera correspondre au clic d'origine).
• trackerid : Votre ID d'événement fixe (ne le modifiez pas).
• {transaction_value} : Espace réservé optionnel pour le montant des revenus/paiement (omettez si vous ne suivez pas les revenus).

Copiez cette URL de postback complète—vous en aurez besoin dans Keitaro.

4. Enregistrez l'événement. Remarque : Lors de la création de campagnes dans Blockchain-Ads, définissez votre URL de destination sur votre URL de campagne Keitaro (par exemple, https://your-keitaro-domain.com/campaign123?clickid={clickid}). Blockchain-Ads ajoutera automatiquement la valeur réelle de l'ID de clic.

Étape 2 : Ajouter Blockchain-Ads comme Source de Trafic Personnalisée dans Keitaro

1. Connectez-vous à votre tableau de bord Keitaro.
2. Accédez à Traffic Sources > Create.
3. Dans le champ "From template", recherchez "Blockchain-Ads"—si aucun modèle n'existe, sélectionnez Custom ou laissez vide pour construire manuellement.
4. Remplissez les détails de base :
   
   • Name : "Blockchain-Ads".
   • Paramètre Click ID : Définissez-le sur clickid (cela indique à Keitaro de capturer la valeur ?clickid=xxx entrante du trafic Blockchain-Ads et de la stocker en interne comme ID externe pour les postbacks).
5. Dans la section du modèle de paramètres (si demandé) :
   
   • Ajoutez une ligne pour l'ID de clic :
     
     • Colonne 1 (Alias) : Laissez vide ou définissez sur "External ID" pour les rapports.
     • Colonne 2 (Parameter name) : clickid.
     • Colonne 3 (Macro) : Laissez vide (puisque Blockchain-Ads ajoute directement la valeur réelle).
   • Ajoutez d'autres paramètres si nécessaire (par exemple, pour l'ID de campagne ou les subID des macros Blockchain-Ads).
6. Dans le champ S2S Postback :
   
   • Collez l'URL de postback de l'Étape 1.
   • Remplacez les espaces réservés Blockchain-Ads par les équivalents Keitaro :
     
     • {clickid} → {external_id} (transmet l'ID de clic capturé).
   • Exemple d'URL transformée :

https://server.blockchain-ads.com/www/delivery/tracker-mobile.php?clickid={external_id}&trackerid=YOUR_TRACKERID&transaction_value={revenue}

Si vous souhaitez envoyer uniquement des statuts de conversion spécifiques (par exemple, leads approuvés), utilisez le menu déroulant "Send only statuses" pour les sélectionner (par exemple, "Lead", "Sale").

7. Cliquez sur Create pour enregistrer la source de trafic.
8. (Optionnel) Si vous avez plusieurs campagnes, cochez Update in campaigns pour l'appliquer aux campagnes existantes.

Étape 3 : Configurer une Campagne dans Keitaro et Tester

1. Accédez à Campaigns > Create (ou modifiez une campagne existante).
2. Sélectionnez Blockchain-Ads comme Traffic Source.
3. Construisez votre flux : Ajoutez des streams, des landing pages et des offres. Pour les conversions :
   
   • Si vous utilisez des offres d'affiliation, configurez les postbacks du réseau d'affiliation vers Keitaro (sous Affiliate Networks).
   • Définissez les règles de conversion (par exemple, postback S2S de l'offre, déclenchement de pixel ou événements personnalisés).
4. Générez et copiez votre URL de campagne Keitaro (elle ressemblera à https://your-domain.com/abc?clickid={external_id}—collez-la comme destination dans votre campagne Blockchain-Ads).
5. Test :
   
   • Lancez une campagne de test dans Blockchain-Ads pointant vers l'URL Keitaro.
   • Simulez un clic et une conversion (par exemple, via une offre de test).
   • Vérifiez les rapports Keitaro (Reports > Conversions) pour les clics/conversions capturés.
   • Vérifiez dans le suivi Blockchain-Ads que les postbacks arrivent (avec des ID de clic et des revenus correspondants).
   • Utilisez des outils comme Postman pour déclencher manuellement un postback de test si nécessaire.

Conseils et Dépannage

• Espaces réservés dans Keitaro : Utilisez {external_id} pour clickid, {revenue} pour les montants et {status} pour les types d'événements (par exemple, associez "lead" à un statut). Pour les valeurs non encodées, utilisez le préfixe _ (par exemple, {_external_id}).
• Revenus/Devise : Si les conversions ont des devises différentes, utilisez {revenue:USD} pour convertir.
• Erreurs : Assurez-vous d'utiliser HTTPS pour les postbacks. Si les données ne circulent pas, vérifiez l'encodage de l'URL, les blocages de pare-feu ou l'ID de tracker non correspondant. Keitaro enregistre les tentatives de postback dans Logs > Postbacks.
• Avancé : Pour plusieurs événements, créez des événements de conversion séparés dans Blockchain-Ads et ajoutez plusieurs URL de postback dans Keitaro (une par statut).

Cette configuration permet une attribution précise sans cookies. Pour plus de détails sur Keitaro, consultez leur documentation sur docs.keitaro.io