Nous mettons à jour notre documentation continuellement, mais certaines publications peuvent ne pas encore être disponibles dans votre langue. Pour accéder aux informations les plus récentes, utilisez la version en anglais.

Configurer App Samurai

App Samurai est un réseau publicitaire intégré avec Adjust. Notre intégration permet à App Samurai de recevoir les données d'événement in-app et d'attribution via des callbacks automatisés.

Dans cet article, découvrez comment configurer la mesure avec App Samurai pour votre application. Cela inclut l'activation de l'intégration, de créer un lien de campagne et de choisir les données que Adjust peut partager avec App Samurai.

Avant de commencer

Prérequis

iOS | Android | Windows | Unity | React Native | Flutter | Adobe Air | Cordova | Marmalade | Xamarin | Cocos2d-x | Titanium | Corona

Sélectionner App Samurai et votre application dans Campaign Lab

  1. Sous Campaign Lab, sélectionnez Partenaires.
  2. Sélectionnez Nouveau partenaire > App Samurai. Sélectionnez Suivant pour passer à l'écran suivant.
  3. Dans l'écran Sélection d'app, choisissez l'application pour laquelle vous souhaitez créer le lien, puis activez l'intégration pour partager des données avec App Samurai.
  4. Sélectionnez Suivant.

Activer le partage des données

Activez le partage des données pour activer l'intégration avec App Samurai. Pour activer le partage des données :

  1. Activez Enabled

Lorsque vous avez activé le partage des données avec App Samurai, Adjust envoie automatiquement à App Samurai les données suivantes par défaut :

  • installation
  • réinstallation
  • réattribution

Configurez vos options de partage de données

Si vous utilisez une application multiplateforme dont le partage des données est activé pour plusieurs plateformes, vous pouvez :

  1. Séparer les options de partage des données au niveau de chaque plateforme en sélectionnant Utiliser les paramètres spécifiques à la plateforme.
  2. Définir les mêmes paramètres de partage des données pour plusieurs plateformes en sélectionnant Utiliser les paramètres globaux.

Maintenant, sous Quelles sont les données partagées par défaut ?, vérifiez les activités partagées par défaut par Adjust avec App Samurai.

  • installation
  • réinstallation
  • réattribution

Envoyer des données supplémentaires

Choisissez la quantité et le type de données que vous souhaitez partager avec App Samurai à travers les callbacks. App Samurai peut utiliser ces informations afin d'optimiser les performances.

  1. Sous Quelles sources de données souhaitez-vous partager ?, choisissez la source d'attribution des données que vous souhaitez partager avec App Samurai :
  • Données issues de toutes les sources d'attribution
  • Uniquement les données attribuées à App Samurai

Revenus publicitaires (visionnages d'annonces)

Le partage des revenus publicitaires permet à App Samurai de recevoir des données de revenus utilisateur. App Samurai peut alors utiliser les données de revenus publicitaires pour optimiser votre ciblage utilisateur et vos campagnes.

Solution de croissance :

Cette fonctionnalité est disponible dans le package Revenus publicitaires Adjust. Pour acheter notre package Revenus publicitaires, contactez votre représentant commercial.

Pour partager des revenus publicitaires avec App Samurai, sélectionnez une ou plusieurs Sources de revenus publicitaires .

  • Si vous laissez ce champ vide, nous envoyons les données de revenus publicitaires issues de toutes les sources de médiation intégrées.

Sessions

Adjust n'envoie pas automatiquement les callbacks de session en raison de leur volume élevé. Avec le partage des sessions, App Samurai recevra l'ensemble des données de session de votre application.

Désinstallations et réinstallations

Le partage des désinstallations ou des réinstallations permet à App Samurai de recevoir les données de désinstallation et/ou de réinstallation de votre application mesurées par Adjust.

Remarque:

Pour les applications iOS, vous obtiendrez certainement une faible valeur de désinstallations et/ou de réinstallations. Pour plus d'informations, consultez Mesure des désinstallations et des réinstallations.

Revenus in-app (issus des achats in-app)

Le transfert des revenus in-app permet à App Samurai de recevoir les quantités de revenus avec vos données d'événements de revenus. Vous devez mapper les événements qui génèrent des revenus pour partager ces données.

Mapper les événements

Mappez les événements que vous souhaitez partager avec les valeurs que App Samurai peut recevoir. Les données des événements non mappés ne sont pas partagées avec App Samurai.

Mapper les événements individuels

Si vous disposez d’une application multiplateforme, vous pouvez partager divers événements par plateforme avec App Samurai. Cela vous permet de :

  • Configurer des événements individuels afin de piloter les stratégies de campagne pour chaque plateforme.
  • Personnaliser le partage des données par plateforme.

Sous Mapper les événements , procédez comme suit pour choisir les événements in-app à envoyer directement à App Samurai.

  1. Sélectionnez Mapper l'événement .

  2. Dans la liste Événement Adjust , choisissez l'événement Adjust que vous souhaitez partager avec App Samurai.

  3. Dans la section Événement partenaire , il est nécessaire de choisir l’événement App Samurai correspondant à l’événement Adjust.

    1. Pour les applications monoplateformes et les applications multiplateformes avec partage de données activé pour une seule plateforme, vous mappez les événements uniquement à cette plateforme. Pour les applications multiplateformes dont le partage des données est activé pour plusieurs plateformes, vous pouvez :

      • Choisissez l’option Utiliser le mappage spécifique à la plateforme pour mapper des événements distincts à chaque plateforme ou pour ne pas mapper d’événements à certaines plateformes.
      • Choisissez l’option Utiliser le mappage global pour mapper les mêmes événements à l’ensemble des plateformes.

    2. Dans la liste Événement partenaire, choisissez ou saisissez un nom d'événement personnalisé auquel vous souhaitez mapper l'événement Adjust.

  4. Sélectionnez Appliquer.

À partir de là, App Samurai recevra les données des événements in-app pour chacun de vos événements liés.

Mapper tous les événements

Si App Samurai prend automatiquement en charge le mappage de tous les événements, dans la section Mapper les événements , sélectionnez l’option Mapper tous les événements . Cette manipulation permet de gagner du temps lors du mappage des événements individuels.

À partir de là, App Samurai recevra les données des événements in-app pour chacun des événements associés.

Mapper les paramètres

Vous devez généralement mapper les paramètres pour partager des données personnalisées avec App Samurai.

Les paramètres de partenaire (disponibles à partir de la version 4.0 du SDK Adjust) permettent à Adjust de collecter des points de données personnalisés à partir de votre application et de les transmettre directement à App Samurai. App Samurai reçoit alors le détail des événements personnalisés pour chacun de vos événements liés.

Avant d'ajouter de nouveaux paramètres de partenaire au SDK Adjust, assurez-vous qu'aucun autre paramètre de partenaire prédéfini ne satisfait déjà vos exigences.

Pour partager les paramètres de partenaire avec App Samurai, procédez comme suit :

  1. Configurez les paramètres partenaires dans le SDK Adjust.

    • Effectuez la vérification avant de commencer pour tous les liens de la plateforme de développement du SDK.

  2. Sous Définir vos options de partage des données , sélectionnez Paramètres .

  3. Sous Mapper les paramètres , vous pouvez spécifiez la façon dont vous souhaitez envoyer les paramètres partenaires définis dans le SDK au réseau :

    1. Sélectionnez Mapper le paramètre .
    2. Dans le champ Paramètre du SDK , saisissez le nom du paramètre SDK que vous souhaitez partager avec le réseau.
    3. Dans le champ Paramètre partenaire , saisissez le paramètre réseau correspondant au paramètre du SDK.
Remarque:

Si vous configurez les paramètres partenaires dans le SDK Adjust sans configurer le partage des paramètres dans le dashboard, Adjust transfère les paramètres tels qu'ils sont nommés dans le SDK Adjust.

Configurer votre lien et vos paramètres

Vous pouvez définir les éléments suivants :

Créer votre lien et le partager avec App Samurai

Dans l'écran Vérification de la configuration , vérifiez vos choix. Vous pouvez revenir en arrière et modifier les éléments suivants :

  • L'application sélectionnée.
  • Options de partage des données
  • Les paramètres de structure de lien.
  • Destinations utilisateur
  • Paramètres d'attribution

Sélectionnez Créer un lien pour créer votre URL de clic, URL d'impression, code QR et token de lien. La création d'un lien active également le partage des données et l'intégration avec App Samurai.

Lorsque vous avez créé votre lien, partagez-le avec App Samurai pour placement en campagnes.

Liste de tous les paramètres transférés à App Samurai

App Samurai demande à Adjust d'envoyer les paramètres suivants (points de données) avec vos callbacks :

Espace réservéInformations
{android_id}ID Android (Android uniquement)
{city}Ville de l’appareil
{click_attribution_window}Paramètres de fenêtre d’attribution pour le matching de l’appareil (heures)
{country}Code pays à deux caractères de l’appareil
{currency}Code de devise ISO 4217 d'origine envoyé depuis le SDK Adjust
{device_name}Numéro de modèle d’appareil
{device_type}Type d’appareil
{event_name}Nom d’événement, tel que défini dans le Dashboard
{idfa||gps_adid}L’IDFA, ou le GPS ADID si l’IDFA est vide
{ip_address}Adresse IP de l’appareil
{is_reattributed}1 si l’utilisateur a été réattribué au moins une fois depuis une source précédente. 0 si l’utilisateur n’a jamais été réattribué.
{isp}Fournisseur de service Internet de l’appareil
{language}Code de langue à deux caractères de l’appareil
{match_type}Méthode d’attribution
{mcc}Code pays mobile : code à trois chiffres identifiant le pays d’un appareil. Utilisez-le avec le code réseau mobile pour identifier l’opérateur d’un appareil.
{mnc}Code réseau mobile : code à deux chiffres. Utilisez-le avec le code pays mobile pour identifier l’opérateur d’un appareil.
{os_version}Numéro de version du système d’exploitation
{partner_parameters}Paramètres de partenaire personnalisés collectés par le SDK Adjust ou la requête S2S, puis transmis à des fournisseurs tiers via des postbacks
{revenue_float}Revenus, tels qu'envoyés depuis le SDK Adjust, en unités de devise entières
{sdk_version}Version du SDK Adjust (par application)
{tracking_limited}1 si le tracking est limité, 0 dans le cas contraire
{user_agent}Agent utilisateur brut entrant
{app_version_short}Numéro de version d’application (Android), release-version-number pour le bundle (iOS)
{connection_type}Type de connexion à Internet
{created_at}Horodatage de l’activité
{install_begin_time}Horodatage du début du téléchargement de l’app (Android et Google Play Store uniquement)
{install_finish_time}Horodatage de fin de téléchargement de l’application
{installed_at}Horodatage de l’installation (c.-à-d. première ouverture de l’app)
{reattributed_at}Horodatage de réattribution
{referral_time}Horodatage d’arrivée de l’utilisateur sur la page Play Store (Android et Google Play Store uniquement)
{reinstalled_at}Horodatage de réinstallation
{uninstalled_at}Horodatage de désinstallation (estimation basée sur la dernière heure de session)
{ad_impressions_count}Nombre d'annonces publicitaires mobiles adressées aux utilisateurs finaux
{ad_revenue_network}Ad Network ayant affiché la publicité
{ad_revenue_unit}Annonce qui a généré la recette
{ad_revenue_placement}Placement utilisateur, tel que défini sur la plateforme
{ad_mediation_platform}Nom de la plateforme de médiation