Configurer Toss
Toss est un réseau publicitaire intégré avec Adjust. Notre intégration permet à Toss 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 Toss 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 Toss.
Avant de commencer
Prérequis
- Autorisations Administrateur, Éditeur ou Éditeur personnalisé dans Adjust.
- Adjust SDK v4.0.0+ pour mapper les paramètres du SDK avec les paramètres Toss. Suivez les guides ci-dessous pour utiliser cette fonctionnalité :
iOS | Android | Windows | Unity | React Native | Flutter | Adobe Air | Cordova | Marmalade | Xamarin | Cocos2d-x | Titanium | Corona
Identifiants
CVR ID
- Si vous avez besoin d'aide pour trouver vos identifiants, contactez votre représentant Toss.
Sélectionner Toss et votre application dans Campaign Lab
- Sous Campaign Lab, sélectionnez Partenaires.
- Sélectionnez Nouveau partenaire > Toss. Sélectionnez Suivant pour passer à l'écran suivant.
- 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 Toss.
- Sélectionnez Suivant.
Activer le partage des données
Activez le partage des données pour activer l'intégration avec Toss. Pour activer le partage des données :
- Indiquez vos CVR ID.
Lorsque vous avez activé le partage des données avec Toss, Adjust envoie automatiquement à Toss les données suivantes par défaut :
- install
- session
- reattribution
- event
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 :
- 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.
- 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 Toss.
- install
- session
- reattribution
- event
Envoyer des données supplémentaires
Choisissez la quantité et le type de données que vous souhaitez partager avec Toss à travers les callbacks. Toss peut utiliser ces informations afin d'optimiser les performances.
- Sous Quelles sources de données souhaitez-vous partager ?, choisissez la source d'attribution des données que vous souhaitez partager avec Toss :
- Données issues de toutes les sources d'attribution
- Uniquement les données attribuées à Toss
Sessions
Adjust n'envoie pas automatiquement les callbacks de session en raison de leur volume élevé. Avec le partage des sessions, Toss recevra l'ensemble des données de session de votre application.
Revenus in-app (issus des achats in-app)
Le transfert des revenus in-app permet à Toss 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 Toss peut recevoir. Les données des événements non mappés ne sont pas partagées avec Toss.
Mapper les événements individuels
Si vous disposez d’une application multiplateforme, vous pouvez partager divers événements par plateforme avec Toss. 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 à Toss.
Sélectionnez Mapper l'événement .
Dans la liste Événement Adjust , choisissez l'événement Adjust que vous souhaitez partager avec Toss.
Dans la section Événement partenaire , il est nécessaire de choisir l’événement Toss correspondant à l’événement Adjust.
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.
Dans la liste Événement partenaire, choisissez ou saisissez un nom d'événement personnalisé auquel vous souhaitez mapper l'événement Adjust.
Sélectionnez Appliquer.
À partir de là, Toss recevra les données des événements in-app pour chacun de vos événements liés.
Mapper tous les événements
Si Toss 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à, Toss 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 Toss.
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 à Toss. Toss 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 Toss, procédez comme suit :
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.
Sous Définir vos options de partage des données , sélectionnez Paramètres .
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 :
- Sélectionnez Mapper le paramètre .
- Dans le champ Paramètre du SDK , saisissez le nom du paramètre SDK que vous souhaitez partager avec le réseau.
- Dans le champ Paramètre partenaire , saisissez le paramètre réseau correspondant au paramètre du SDK.
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 Toss
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 Toss.
Lorsque vous avez créé votre lien, partagez-le avec Toss pour placement en campagnes.
Liste de tous les paramètres transférés à Toss
Toss demande à Adjust d'envoyer les paramètres suivants (points de données) avec vos callbacks :
| Placeholder | Information |
{adid} | Adjust device ID (all platforms) |
{android_id_md5} | Lowercase Android ID hex MD5 hash |
{android_id} | Android ID (Android only) |
{city} | Device city |
{click_attribution_window} | Attribution window settings for device matching (hours) |
{country_subdivision} | Device subdivision of country, e.g., state |
{country} | Device two-character country code |
{currency} | Original ISO 4217 currency code sent from Adjust SDK |
{deeplink} | Deeplink URL appended to click URL |
{device_name} | Device model number |
{device_type} | Device type |
{environment} | Current Adjust SDK environment setting |
{event_name} | Event name, as set in the Dashboard |
{fire_adid} | Fire OS advertising identifier |
{gps_adid} | Google Play Store advertising ID |
{idfa} | ID for advertisers (iOS only) |
{idfv} | Uppercase iOS ID for vendors |
{impression_attribution_window} | Attribution window settings for impression matching (hours) |
{ip_address} | Device IP address |
{is_reattributed} | 1 if user was reattributed at least once from an earlier source. 0 if user has never been reattributed |
{isp} | Device internet service provider |
{label} | Value of the Adjust "label" parameter sent on click |
{language} | Device two-character language code |
{last_time_spent} | Length of user's last session, in seconds |
{lifetime_session_count} | Number of sessions recorded across entire user lifetime |
{mac_md5} | Uppercase MAC MD5 hash |
{mac_sha1} | Uppercase MAC SHA-1 hash |
{match_type} | Attribution method |
{mcc} | Mobile country code: three-digit code identifying a device's country. Use with the mobile network code to identify a device's carrier. |
{mnc} | Mobile network code: two-digit code. Use with the mobile country code to identify a device's carrier. |
{nonce} | Random lowercase alphanumeric string (unique per callback) |
{os_name} | Device operating system |
{os_version} | Operating system version number |
{partner_parameters} | Custom partner parameters collected by the Adjust SDK or S2S request and transmitted to third party providers via postbacks |
{postal_code} | Device postal code of IP address |
{random_user_id} | Random user ID (per device) |
{random} | Random number (unique per callback) |
{reftag} | Random device reference tag |
{region} | Device region code |
{reporting_currency} | Dashboard reporting ISO 4217 currency code |
{reporting_revenue} | Revenue, as reported in the Adjust Dashboard, in whole currency units |
{revenue} | Revenue, as sent from Adjust SDK in cents |
{sdk_version} | Adjust SDK version (per app) |
{session_count} | Number of sessions recorded by current Adjust SDK |
{timezone} | Device time zone |
{tracking_enabled} | 1 if tracking is enabled, 0 if not |
{tracking_limited} | 1 if tracking is limited, 0 if not |
{user_agent} | Incoming raw user agent |
{win_adid} | Windows advertising identifier |
{win_hwid} | Windows Store hardware ID |
{win_naid} | Windows Store network adapter ID |
{win_udid} | Windows Phone unique device ID |
{activity_kind} | Type of user activity |
{app_id} | Store App ID or Google Play Store |
{app_name} | Name of the app |
{app_version_raw} | App version number (Android), build-version-number for the bundle (iOS) |
{app_version_short} | App version number (Android), release-version-number for the bundle (iOS) |
{app_version} | App version number (Android), build-version-number for the bundle (iOS) |
{campaign_name} | Campaign name, as taken from the tracker |
{click_time} | Attributed click timestamp |
{connection_type} | Internet connection type |
{conversion_duration} | Time between click and install or reattribution in seconds |
{cpu_type} | CPU type |
{creative_name} | Creative name, as taken from the tracker |
{device_manufacturer} | Device manufacturer name |
{engagement_time} | Engagement timestamp |
{first_tracker_name} | Name of a user's first attribution source |
{hardware_name} | Hardware name |
{impression_based} | 1 if impression-based engagement, 0 if not |
{impression_time} | Attributed impression timestamp |
{install_begin_time} | App download began timestamp (Android and Google Play Store only) |
{install_finish_time} | App download completion timestamp |
{installed_at} | Install (i.e., first app open) timestamp |
{is_organic} | 1 if organic traffic, 0 if non-organic |
{last_session_time} | Last session timestamp |
{last_tracker_name} | A reattributed user's previous tracker name |
{network_name} | Network name, as taken from the tracker |
{network_type} | Network type |
{reattributed_at} | Reattribution timestamp |
{referral_time} | User landed on app Play Store page timestamp (Android and Google Play Store only) |
{reinstalled_at} | Reinstall timestamp |
{store} | Target store of click |
{tracker_name} | Current tracker name |
{oaid_md5} | OAID MD5 hash |
{oaid} | OAID device ID |
{is_s2s} | 1 if server to server engagement, 0 if not |
{is_s2s_engagement_based} | 1 if attributed to a server to server engagement, 0 if not |
{proxy_ip_address} | IP address of user's proxy |
{third_party_tracking_disabled} | 1 if third party sharing is disabled, 0 if not |