Accengage Upgrade

Upgrade your Accengage notification users to Airship. Mettez à jour vos utilisateurs Accengage vers Airship.

English

Bienvenue! If you are reading this document, you are ready to move your Accengage audience to the Airship service. And we are ready to help you accomplish this goal.

Much of this process is automated by Airship, but you will need to perform certain actions on your end, such as creating an Airship account, configuring your project in our dashboard, and implementing the Airship SDK. This guide will take you through those steps.

Create an Airship Account

After signing your Airship contract, create an Airship account via this signup link.

The person at your company who creates this account should be the primary day-to-day contact with the Airship team. Typically this is your marketing lead, product owner, etc.

Team Access

Your account owner may grant access to others in Settings » Team Access. Follow the steps in Manage Messaging Team Invitations.

 Important

Your web developer must have access to your project, with Full Access or Administrator permission. This is required to complete the implementation steps.

Project (Environment) Setup

 Important

In Accengage you have a unique environment for each messaging channel. In Airship, rather than an environment for each channel, you will have a project to which you may add multiple channels, e.g., app, web, SMS, etc.

You will have at least two projects for each branded website: one each for Live (production) and Test (development) environments, and additional projects for other test or staging environments.

Airship will create your projects for you. If you are moving your web notification service from Accengage to Airship, Airship will configure the Web channel with your web push details, including your default URL and default image.

We recommend reading our Platform Overview content, starting with What Is Airship?, before you get started setting with setup steps.

App Setup

Your account owner or a team member with Full Access or Administrator permissions must complete the following actions:

  1. Go to Settings » Quickstart Guide.

  2. Click Add Channel   and select the app channels (iOS and/or Android) you want your project to support. Click outside the selection box to close it.

  3. Click a channel and follow the setup steps.

  4. Set up push provider:

    In this step you will configure the push notification provider for your app: APNs for iOS, FCM for Android. Follow the instructions below for your target platform and then proceed to Step 5 to install the transitional SDK.

    iOS

    You must generate a new APNs push certificate for your app in Airship. Do not reuse the same certificate used in the Accengage platform.

    Complete the steps in the following two sections of our iOS documentation in order to create, export, and upload your Apple push certificate:

    Android

    You must reuse the same FCM project and package name in Airship as in Accengage. We also recommend using your existing server key.

  5. Install the Airship SDK.

    We provide modules in both our iOS and Android SDK to assist you while transitioning from the Accengage service to the Airship service.

  6. Send a test push notification to your app:

  7. Update calls to the Airship SDK that are a part of your integration.

    Now that you have installed our mobile SDK and configured notifications, the following features will either map automatically or with minimal effort:

    • Device ID: Device IDs will retain the same values, but will be mapped to Channel IDs in Airship.

    • Attributes: The Airship transitional SDKs provide mappings for calls used to set attributes. All attributes that exist at the user level in Accengage will migrate to Airship.

      You will, however, need to define your attributes in the Airship UI. See Add Attributes to Your Project to learn how.

    • Customer IDs can be mapped to Named Users

    The following features are available in the Airship SDK, but are not mapped directly to the Accengage SDK.

 Note

Your deep links may already work with the Airship SDK. If they don’t, our Deep Link documentation explains how to set up a deep link listener.

Post-Implementation

After you set up your App with Airship:

  1. Continue to use the Accengage UI to send notifications to your full audience for ~30 days. You will be able to use the Accengage UI to send notifications to non-upgraded users, upgraded users, and any new users who have registered via the Airship SDK since you implemented it. If you use Accengage’s In-App messaging feature, we recommend creating an in-app message encouraging users to update their app.

  2. After ~30 days, or when most or all of your active audience has updated their app, start using the Airship UI exclusively for all app messaging.

 Note

It is not possible to guarantee that every user will move from Accengage to Airship during this process, due to inactive users, outdated registrations due to new devices, users’ devices being offline for extended period of time, etc.

Web Setup

Your account owner or a team member with Full Access or Administrator permission must complete the following actions:

  1. Confirm your default URL and default image in Settings » Channels » Web Notifications and update any value that is incorrect or outdated. These fields were brought over from the Accengage system as part of the upgrade process.

  2. Update the Industry & Sub-industry for your project in Settings » Edit Project. See our Industry Types for examples.

Implementation

Before beginning the implementation process, we recommend sending a broadcast notification to your entire audience via the Accengage UI. The goal of this step is to ensure your messaging audience is up to date, because in some cases we do not receive opt-out feedback about a user until attempting to send a notification to them. If you regularly send broadcast notifications to your audience already, you can skip this step.

The steps in the Implementation sections should be handled by your web developer. Your web developer must have an Airship account with Full Access or Administrator permission for your project. See Team Access above.

Initiate Upgrade

  1. In the root of your site, remove the acc_ww.js file, leaving everything else as is. Do not remove the Accengage Service Worker yet.

  2. Remove the Accengage JavaScript snippet from every page on your website.

    Example JavaScript snippet
        <script>
        (function(l,o,a,d,i,n,g,w,e,b){
        g='AccengageWebSDKObject';w='script';l[g]=l[g]||{};l[g][n]=d;
        l[d]=l[d]||[];l[d].p={'date':1*new Date(),'window':l,'document':o,'params':a};
        e=o.createElement(w);b=o.getElementsByTagName(w)[0];e.async=1;
        e.src='https://'+n+i+'/init.js';b.parentNode.insertBefore(e,b);
        })(window,document,{},'ACC','/pushweb/assets','customer-by.accengage.net');
        </script>
        

    Note: In older Accengage integrations, we relied on a manifest.json file to store the GCM sender ID. This file is no longer required since we now use the VAPID web push protocol.

    You may safely remove <link rel="manifest" href="/manifest.json"> if you do not require it for anything else.

  3. Log in to the Airship UI, go.airship.eu.

  4. Go to Settings » Channels » Web Notifications » Accengage Upgrade.

  5. Click Start Upgrade and click Yes.

After clicking Yes, you will see a message that says “Do not cancel upgrade unless you’re instructed to by Airship.” You are now ready to integrate the Airship web SDK into your website.

Integrate the Airship Web SDK

Configure your web channel, download your SDK bundle, and implement the Airship SDK by following the steps in Web: Getting Started. Read Secure Bridge/Multiple Non-Registration Domains below before you start.

Note on Service Workers:

  • If you enabled the setting Use my own domain in the Accengage UI, then you must replace the Accengage service worker with the Airship service worker as part of this step. The Airship service worker MUST be placed in the exact same location as the Accengage service worker in order to move users from Accengage to Airship.

  • If you have not enabled this setting in Accengage, then you are not hosting the service worker file on your domain and thus do not need to worry about replacing it, as it is hosted for you by Accengage (now Airship).

  • See Service Worker Location for more information about specifying the path of your service worker. You will need to follow the instructions on specifying a new location for the Airship service worker file.

Secure Bridge/Multiple Non-Registration Domains

If you used an Accengage (now Airship) hosted domain to register (opt in) web users and you also want to use the Airship SDK on your own website (to prompt users to opt in before directing them to the registration domain), refer to this information when following the steps in Web: Getting Started. If you use your own HTTPS domain to register (opt in) web users, you can skip this Secure Bridge section.

 Note

In Airship, the Master domain is known as the Registration domain and your registered domains are your allowed domains.

  1. When configuring your web channel in Settings » Channels » Web Notifications, enable Secure Bridge. By default, the secure bridge only communicates with the non-HTTPS version of the registration domain. If you need to use the secure bridge with other domains, enter those domains in the Allowed Domains box.

    When you select the Secure Bridge option, your SDK bundle will include a secure-bridge.html file. This file must be placed on your registration domain.

  2. Place the JavaScript snippet (contained in the snippet.html file) on every allowed domain on which you want to show the soft opt-in prompt to your website visitors.

  3. Ensure that the registrationDomain and secureBridgePath are specified on all allowed domains you wish to prompt users on. The registrationDomain property must be a domain name accessible through HTTPS, but it must be specified in the config without the https prefix. Examples:

            “airship.com”, “www.mydomain.com”, “mysubdomain.domain.com”
            

    When specifying a registration domain, calling sdk.register() will fail if not executed on this specified registration domain. The promise returned will be rejected with message “Domain is not allowed for registration.”

Post-Implementation

After your web developer has completed the SDK integration steps:

  1. Make sure that no one in your organization attempts to send notifications, either from Accengage or Airship, for 24 hours. The 24-hour waiting period is mandatory, owing to the nature of service workers.

  2. After 24 hours from the time when your web developer completed the SDK integration steps, send a broadcast notification to your entire audience from the Accengage UI. This must be a broadcast notification to all users. Any end user that receives the push notification will be moved to Airship without having to visit your website and without having to opt in to notifications again. Devices must be online to receive this notification.

  3. Continue to use the Accengage UI to send notifications to your full audience for ~30 days. You will be able to use the Accengage UI to send notifications to non-upgraded users, upgraded users, and any new users who have registered via the Airship SDK since you implemented it.

  4. After 30 days, or when approximately 80% of your audience has moved to Airship (whichever comes first), start using the Airship UI exclusively for all web notifications.

 Note

It is not possible to guarantee that every user will move from Accengage to Airship during this process, due to inactive users, outdated registrations due to new devices, users’ devices being offline for extended period of time, etc.

User Mapping

After a user is moved from Accengage to Airship, they will retain the same unique identifier (UUID) in the Airship database. In Accengage, this ID was known as a Device ID. In Airship, it is known as a Channel ID.

If you previously mapped your Accengage Device IDs to a customer number or other internal identifier using the Accengage client ID field, you can reestablish the mapping to Channel IDs using Named UsersA customer-provided identifier used for mapping multiple devices and channels to a specific individual. .

Named User Migration Example

In this example we will take a CSV file containing your Accengage user data and map the Accengage Customer IDs to Airship Named Users.

 Note

If using this example script, make sure that you match the device_type in the associate call to the platform of the users you are migrating to Airship. For example, to migrate your iOS users, you would use named_user.associate(device_id, 'ios').

  1. Begin by downloading your user data from the Accengage UI. Then go to Targeting » Export targets.

  2. Click Export Database in CSV to save the file.

  3. Use the Named User Association endpoint to map Accengage Device and Customer IDs to Airship Channel IDs and Named Users.

    The example below uses the Airship Python Library to iterate over the CSV file and map Customer IDs to Named Users.

    You may also wish to try one of our other API wrappers to accomplish the same goal.

    import csv
    import urbanairship as ua

    app_key="<YOUR_APP_KEY>"
    master_secret="<YOUR_MASTER_SECRET>"

    # Create the Airship object

    airship = ua.Airship(app_key, master_secret)

    with open('export_xxx.csv') as migration_file:
        next(migration_file)
        accengage = csv.reader(migration_file, delimiter=';')
        for row in accengage:

            # Retrieve the "Device ID" (first column).
            device_id = row[0]

            # In this example Customer ID is the last column of our CSV.
            # Use the correct index for your setup.
            customer_id = row[-1]

            # Create a named user that maps to your Customer ID.
            named_user = ua.NamedUser(airship, customer_id)

            # Associate the named user with your Channel ID (formerly device ID).
            r = named_user.associate(device_id, 'web')

            # Print the results to the console.
            print(r, "Channel ID: ", device_id, "Named User: ", customer_id)

Français

Bienvenue ! Si vous lisez ce document, vous êtes prêt à transférer votre audience Accengage vers Airship. Et nous sommes prêts à vous aider à atteindre cet objectif.

Une grande partie de ce processus est automatisée par Airship, mais vous devrez effectuer certaines actions de votre côté, comme la création d’un compte Airship, la configuration de votre projet sur notre interface, et l’implémentation du SDK Airship. Ce guide vous accompagnera à travers ces étapes.

Créer un compte Airship

Après avoir signé votre contrat Airship, vous devez créer un compte Airship via ce lien d’inscription.

La personne de votre entreprise qui crée ce compte sera le contact principal qui interagit avec l’équipe Airship. Typiquement, il s’agit de votre responsable marketing, chef de projet ou chef de produit.

Accès de l’équipe

Le propriétaire de votre compte peut autoriser l’accès à d’autres personnes dans Settings » Team Access. Suivez les étapes de la section Manage Messaging Team Invitations.

 Important

Votre développeur web doit avoir accès à votre projet, avec un Full Access (accès complet) ou Administrator access (administrateur). Ceci est nécessaire pour compléter les étapes d’intégration.

Configuration du projet (environnement)

 Important

Chez Accengage, vous possédez un environnement unique pour chaque canal. Chez Airship, vous bénéficierez d’un seul projet auquel vous pouvez ajouter plusieurs canaux, par exemple, application, web, SMS, etc.

Vous aurez au moins deux projets pour chaque site Web: un pour les environnements Live (production) et un de Test (développement). Vous pouvez éventuellement créer des projets supplémentaires pour d’autres environnements de test ou de pré-production.

Airship créera vos projets pour vous. Si vous déplacez vos services Web notifications de Accengage à Airship, Airship configurera votre channel Web avec les détails de votre environnement Push Web, y compris votre URL et votre image par défaut.

Nous vous recommandons de lire notre Platform Overview, What Is Airship?, avant de commencer les étapes de configuration.

Configuration des applications

Le propriétaire de votre compte ou un membre de l’équipe avec l’autorisation Administrator (administrateur) ou Full Access (accès complet) doit effectuer les actions suivantes :

  1. Allez dans Settings » Quickstart Guide.

  2. Cliquez sur Add Channel   et sélectionnez les channels applications (iOS et/ou Android) que vous souhaitez gérer dans votre projet. Cliquez en dehors de la case afin de fermer cette section.

  3. Cliquez sur un channel et suivez les instructions.

  4. Configurez votre push provider:

    Dans cette étape, vous configurerez le push provider des notifications pour chacune de vos applications: APNs pour iOS, FCM pour Android. Suivez les instructions ci-dessous pour chaque OS, puis passez à Étape 5 pour installer le SDK de transition.

    iOS

    Vous devez générer un nouveau certificat APNs pour votre application Airship. Ne réutilisez pas le même que celui utilisé dans Accengage.

    Effectuez les étapes des deux sections suivantes de notre documentation iOS afin de créer, exportez et télécharger votre certificat de push Apple:

    Android

    Vous devez réutiliser le même projet et package FCM dans Airship que dans Accengage. Nous vous recommandons également d’utiliser votre server key existante.

  5. Installez le SDK Airship.

    Nous fournissons des modules dans nos SDK iOS et Android afin de vous accompagner lors de la transition d’Accengage à Airship.

  6. Envoyez une notification de test sur votre application:

  7. Mettez à jour les appels du SDK Airship qui font partie de votre intégration.

    Maintenant que vous avez installé notre SDK mobile et configuré les notifications, les fonctionnalités suivantes seront ajoutées automatiquement ou nécessiteront une adaptation minime:

    • Device ID: Les Device IDs contiendront les mêmes valeurs mais seront liés aux Channel IDs dans Airship.

    • Attributes: Les SDKs transitionnels Airship fournissent un mapping des appels faits pour remonter les attributs (Custom fields dans Accengage). Tous les attributs qui existent au niveau des utilisateurs dans Accengage seront migrés vers Airship.

      Vous devrez toutefois définir vos attributs dans l’interface Airship. Voir Add Attributes to Your Project afin de connaître la démarche à suivre.

    • Customer IDs est associé à Named Users

    Les fonctionnalités suivantes sont disponibles dans le SDK Airship mais ne sont pas reliées directement au SDK Accengage.

 Note

Vos deep links peuvent déjà fonctionner avec le SDK Airship. Si ce n’est pas le cas, notre documention vous aidera à les paramétrer.

Après l’implementation

Après avoir configuré votre Application avec Airship:

  1. Continuez à utiliser Accengage afin d’envoyer des notifications à votre base complète pendant ~30 jours. Vous pourrez envoyer des notifications aux utilisateurs ayant ou non mis à jour l’application, ainsi que tous les nouveaux utilisateurs qui se seront enregistrés via le SDK Airship depuis que celui-ci a été intégré à votre application. Si vous utilisez la fonction In-App d’Accengage, nous recommandons de créer un message in-app encourageant vos utilisateurs à mettre à jour leur application.

  2. Après ~30 jours, lorsque la plupart ou la totalité de votre base d’utilisateurs actifs aura mis à jour son application, commencez à utiliser exclusivement l’interface Airship pour toutes vos notifications.

 Note

Il n’est pas possible de garantir que chaque utilisateur migrera d’Accengage à Airship au cours de ce processus. Une différence de profils enregistrés peut être observé en raison d’utilisateurs inactifs, d’enregistrement obsolètes (nouveaux appareils enregistrés) ou d’appareils d’utilisateurs hors ligne pendant une période prolongée, etc.

Configuration Web Push

Le propriétaire de votre compte ou un membre de l’équipe avec l’autorisation Administrator (administrateur) ou Full Access (accès complet) doit effectuer les actions suivantes :

  1. Confirmez votre URL par défaut et votre image par défaut dans Settings » Channels » Web Notifications et mettez à jour toute valeur incorrecte ou obsolète. Ces champs ont été transférés du système Accengage dans le cadre du processus de mise à niveau.

  2. Mettez à jour le secteur d’activité et la spécialisation pour votre projet dans Settings » Edit Project. Voir nos types d’industries pour des exemples.

Intégration

Avant de commencer le processus d’implémentation, nous vous recommandons d’envoyer une notification globale à l’ensemble de votre audience via l’interface Accengage. Le but de cette étape est de s’assurer que votre base de donnée est à jour. Si vous envoyez déjà régulièrement des notifications à votre audience, vous pouvez sauter cette étape.

Les étapes de la section Intégration doivent être gérées par votre développeur Web. Il doit disposer d’un compte Airship avec Full Access (accès complet) ou Administrator access (accès administrateur) pour votre projet. Voir la section Accès de l’équipe ci-dessus.

Lancer la mise à jour

  1. À la racine de votre site web, supprimez uniquement le fichier acc_ww.js. Ne supprimez pas le Service Worker Accengage (acc_sw.js).

  2. Supprimez le snippet JavaScript Accengage de chaque page de votre site Web.

    Exemple de snippet JavaScript
        <script>
        (function(l,o,a,d,i,n,g,w,e,b){
        g='AccengageWebSDKObject';w='script';l[g]=l[g]||{};l[g][n]=d;
        l[d]=l[d]||[];l[d].p={'date':1*new Date(),'window':l,'document':o,'params':a};
        e=o.createElement(w);b=o.getElementsByTagName(w)[0];e.async=1;
        e.src='https://'+n+i+'/init.js';b.parentNode.insertBefore(e,b);
        })(window,document,{},'ACC','/pushweb/assets','customer-by.accengage.net');
        </script>
        

    Note: Dans les anciennes intégrations Accengage, nous nous appuyions sur un fichier manifest.json afin de stocker le sender ID GCM. Ce fichier n’est plus nécessaire puisque nous utilisons désormais le protocole VAPID web push.

    Vous pouvez supprimer en toute sécurité <link rel="manifest" href="/manifest.json"> si vous n’utilisez pas ce fichier pour d’autres usages.

  3. Connectez-vous à l’interface Airship, go.airship.eu.

  4. Ouvrez votre projet et allez dans Settings » Channels » Web Notifications » Accengage Upgrade.

  5. Cliquez sur Start Upgrade et cliquez sur Yes.

Après avoir cliqué sur Yes, le message suivant s’affiche “Do not cancel upgrade unless you’re instructed to by Airship” (“N’annulez pas la mise à jour à moins d’y être invité par Airship”). Vous êtes maintenant prêt à intégrer le SDK Web Airship dans votre site Web.

Intégrer le SDK Airship Web

Configurez votre canal Web, téléchargez votre SDK bundle et implémentez le SDK Airship en suivant les étapes dans Web: Getting Started. Lisez Secure Bridge/Gestion des Opt-in multi-domaines ci-dessous avant de commencer.

Information sur le Service Worker :

  • Si vous avez activé le paramètre Utiliser mon propre domaine dans l’interface Accengage, vous devez alors remplacer le service worker Accengage (fichier acc_sw.js) par le service worker Airship dans le cadre de cette étape. Le service worker Airship DOIT être placé exactement au même endroit que le service worker Accengage (même chemin et nom de fichier) afin de déplacer les utilisateurs de la base Accengage vers Airship.

  • Si vous n’avez pas activé ce paramètre dans Accengage, alors vous n’avez pas hébergé le fichier du service worker sur votre domaine et n’avez donc pas à vous soucier de cette étape. Il est hébergé pour vous par Accengage (maintenant Airship).

  • Pour plus d’informations sur la spécification du chemin d’accès de votre service worker, reportez-vous à la section Service Worker Location. Vous devrez suivre les instructions afin de spécifier le nouvel emplacement du fichier service worker Airship.

Secure Bridge/Gestion des Opt-in multi-domaines

Si vous avez utilisé un domaine hébergé chez Accengage afin de collecter vos opt-in Web et que vous souhaitez également utiliser le SDK Airship sur votre propre site Web, consultez les instructions dans la section Web: Getting Started. Cette configuration vous permet par exemple de demander l’approbation de l’utilisateur avant de le rediriger vers le domaine d’enregistrement. Si vous utilisez votre propre domaine HTTPS pour enregistrer les utilisateurs Web (opt-in), la section Secure Bridge n’est pas nécessaire.

 Note

Dans Airship, le nom de domaine Maître est connu sous le nom de Registration domain et vos domaines enregistrés sont vos allowed domains.

  1. Lors de la configuration de votre canal Web dans Settings » Channels » Web Notifications, activez Secure Bridge. Par défaut, le secure bridge communique uniquement avec la version non HTTPS du domaine d’enregistrement. Si vous avez besoin d’utiliser le secure bridge avec d’autres domaines, entrez ces domaines dans la zone Allowed Domains.

    Lorsque vous sélectionnez l’option Secure Bridge, votre SDK comprend un fichier secure-bridge.html. Ce fichier doit être placé sur votre domaine d’enregistrement.

  2. Placez l’extrait JavaScript (contenu dans le fichier snippet.html) sur chaque domaine autorisé sur lequel vous voulez afficher la pop-up de demande d’opt-in aux visiteurs de votre site Web.

  3. Assurez-vous que les champs registrationDomain et secureBridgePath sont spécifiés pour tous les domaines autorisés sur lesquels vous souhaitez inviter les utilisateurs. La propriété registrationDomain doit être un nom de domaine accessible via HTTPS, mais il doit être spécifié dans la configuration sans le préfixe https. Exemples :

        “airship.com”, “www.mydomain.com”, “mysubdomain.domain.com”
        

    Lors de la spécification d’un domaine d’enregistrement, appeler sdk.register() échouera s’il n’est pas exécuté sur ce domaine d’enregistrement spécifié. La demande retournée sera rejetée avec le message “Domain is not allowed for registration”.

Après l’intégration

Une fois que votre développeur web a terminé les étapes d’intégration du SDK :

  1. Assurez-vous que personne dans votre organisation ne tente d’envoyer des notifications, que ce soit depuis Accengage ou Airship, pendant 24 heures. La période d’attente de 24 heures est obligatoire en raison du fonctionnement des services workers.

  2. Après 24 heures à compter du moment où votre développeur Web a finalisé les étapes d’intégration du SDK, envoyez une notification à l’ensemble de votre audience à partir de l’interface Accengage. Il doit s’agir d’une notification diffusée à tous les utilisateurs. Tout utilisateur final qui reçoit la notification de push sera transféré sur Airship sans avoir à visiter votre site Web et sans avoir à accepter à nouveau les notifications. Les appareils doivent être en ligne pour recevoir cette notification.

  3. Continuez à utiliser l’interface Accengage pour envoyer des notifications à l’ensemble de votre base pendant environ 30 jours. Vous pourrez utiliser l’interface Accengage pour envoyer des notifications aux utilisateurs non mis à jour, mis à jour et à tout nouvel utilisateur qui s’est enregistré via le SDK Airship depuis son installation.

  4. Après 30 jours, ou lorsque environ 80 % de votre base de donnée est passée sur Airship (selon la première éventualité), commencez à utiliser l’interface Airship exclusivement pour toutes les notifications Web.

 Note

Il n’est pas possible de garantir que chaque utilisateur passera d’Accengage à Airship au cours de ce processus, en raison d’utilisateurs inactifs, d’enregistrements obsolètes dus à de nouveaux appareils, ou d’appareils hors ligne pendant une période prolongée, etc.

Mapping utilisateur

Lorsqu’un utilisateur passe d’Accengage à Airship, il conserve le même identifiant unique (UUID) dans la base de données Airship. Dans Accengage, cet ID était connu sous le nom de Device ID. Dans Airship, il est connu sous le nom de Channel ID.

Si vous avez déjà associé vos Devices ID Accengage à un numéro de client ou à un autre identifiant interne à l’aide d’un champ Accengage de type “ID Client”, vous pouvez rétablir l’association aux Channels ID en utilisant les Named UsersA customer-provided identifier used for mapping multiple devices and channels to a specific individual. .

Exemple de migration des Named User

Dans cet exemple, nous allons exporter un fichier CSV contenant l’ensemble de vos profils et utiliser l’ID client de chacun en tant que nouveau Named User Airship.

 Note

Si vous utilisez cet exemple, assurez-vous de faire correspondre le device_type dans l’appel associate à la plateforme aux utilisateurs que vous migrez vers Airship. Par exemple, pour migrer vos utilisateus iOS, vous utiliseriez named_user.associate(device_id, 'ios').

  1. Téléchargez votre base cliente à partir de l’interface Accengage. Cliquez sur Ciblage »» Cibles export.

  2. Cliquez sur Exporter la base actuelle et sauvegardez le fichier.

  3. Utilisez la route d’API Named User Association afin d’associer vos ID Client Accengage vers de nouveaux Named Users Airship.

    L’exemple ci-dessous utilise la Librairie Python Airship afin de boucler sur les lignes de votre fichier CSV et d’associer chaque ID Client en tant que Named User.

    Vous pouvez également utiliser nos autres librairies pour un même résultat.

    import csv
    import urbanairship as ua

    app_key="<YOUR_APP_KEY>"
    master_secret="<YOUR_MASTER_SECRET>"

    # Créez un objet Airship

    airship = ua.Airship(app_key, master_secret)

    with open('export_xxx.csv') as migration_file:
        next(migration_file)
        accengage = csv.reader(migration_file, delimiter=';')
        for row in accengage:

            # Récupérez le "Device ID" (première colonne).
            device_id = row[0]

            # Dans cet exemple, l'ID client correspond à la dernière colonne de notre fichier CSV
            # Adaptez le code pour  utiliser la colone adéquate
            customer_id = row[-1]

            # Créez un named user et associez-y votre ID client
            named_user = ua.NamedUser(airship, customer_id)

            # Associez votre named user avec votre Channel ID (anciennement device ID).
            r = named_user.associate(device_id, 'web')

            # Affichez le resultat sur la console
            print(r, "Channel ID: ", device_id, "Named User: ", customer_id)