Module Integrate

Le module Integrate permet aux partenaires Adobe d’intégrer leurs efforts de collecte de données à votre organisation. Cette intégration donne la possibilité d’établir une connexion de données bidirectionnelle. En règle générale, l’utilisation du module Integrate est gérée par un partenaire Adobe.

Processus du module Integrate

Implémentation du module Integrate

Une organisation travaillant avec un partenaire Adobe peut suivre cette procédure pour commencer à utiliser le module Integrate.

Obtention du code de module Integrate

L’obtention du code de module requiert un utilisateur disposant de l’accès Administrateur de produit ou appartenant à un profil de produit ayant accès au gestionnaire de code. La méthode d’obtention du code de module est la même pour toutes les méthodes d’implémentation, y compris les balises dans Adobe Experience Platform.

Placez le module Integrate dans votre implémentation

La mise en oeuvre du module Integrate sur votre site nécessite l’accès à la collecte de données Adobe Experience Platform. Si vous utilisez une mise en œuvre JavaScript héritée, vous devez accéder au code source du site web de votre entreprise.

Méthodes du module Integrate

Une fois le module Integrate mis en œuvre, utilisez ces méthodes pour le configurer afin qu’il envoie et reçoive des données du partenaire Adobe souhaité.

add

La méthode add instancie un objet partenaire, qui sert de boutique intermédiaire de données variables lors du partage de données entre les systèmes partenaires et votre mise en œuvre. Cette méthode est requise pour toutes les intégrations. Un objet partenaire distinct doit être utilisé pour chaque partenaire unique si plusieurs partenaires sont utilisés dans une seule mise en œuvre.

s.Integrate.add("<partner_name>");

En règle générale, votre organisation travaille avec un partenaire Adobe pour déterminer la valeur du nom du partenaire.

beacon

La méthode beacon crée une demande d’image et la dirige vers l’URL spécifiée. Ces demandes d’image sont différentes des demandes d’image standard. La méthode de balise envoie généralement des données au partenaire Adobe plutôt qu’à des serveurs de collecte de données Adobe.

p.beacon("<partner_url>/track?qs1=value1&qs2=value2");

En règle générale, votre organisation travaille avec le partenaire Adobe pour déterminer la valeur du nom du partenaire. Les chaînes de requête incluses dans l’URL sont facultatives et dépendent du partenaire. Le module Integrate inclut automatiquement une chaîne de requête contenant un nombre aléatoire afin d’empêcher la mise en cache du navigateur.

delay

Adobe travaille avec des équipes en interne pour que cette méthode soit documentée.

get

La méthode get permet à un client d’importer des variables de partenaire et de les stocker dans l’objet partenaire. Une fois que les données se trouvent dans l’objet partenaire, elles peuvent être affectées aux variables Analytics et envoyées dans une demande d’image. Cette méthode appelle une URL dirigée vers un objet JSON contenant les données souhaitées.

s.Integrate.<partner_name>.get("<url_to_json_object>?pid=value1&pid2=value2");

Le module Integrate ajoute automatiquement d’autres chaînes de requête à l’URL. Une chaîne de requête var spécifie le nom de l’objet JSON attendu par le module de la part du partenaire. Un nombre aléatoire est également ajouté pour empêcher la mise en cache du navigateur.

ready

Adobe travaille avec des équipes en interne pour que cette méthode soit documentée.

useVars

La méthode useVars permet au client de partager des valeurs de variable avec un partenaire Adobe.

s.Integrate.<partner_name>.useVars = function (s,p) {
    p.<partner_var1> = s.eVar1;
    p.<partner_var2> = s.eVar2;
}

En règle générale, votre organisation travaille avec un partenaire Adobe pour déterminer les valeurs du nom du partenaire et celles utilisées par le partenaire.

setVars

La méthode setVars permet au client de renseigner les variables Analytics à l’aide des données de partenaire récupérées. Les données du partenaire peuvent être obtenues à partir d’une méthode get, d’une affectation statique ou de tout autre mécanisme qui renseigne l’objet partenaire à l’aide de données.

s.Integrate.<partner_name>.setVars = function (s,p) {
    s.eVar1 = p.<partner_var1>;
    s.eVar2 = p.<partner_var2>;
}

En règle générale, votre organisation travaille avec un partenaire Adobe pour déterminer les valeurs du nom du partenaire et celles utilisées par le partenaire.

script

La méthode script permet à un partenaire Adobe d’appeler du code JavaScript supplémentaire à partir du site du partenaire si certaines conditions sont remplies (par exemple, si la variable de campagne est définie).

p.script("<partner_url>/script?qs1=value1&qs2=value2");

En règle générale, votre organisation travaille avec le partenaire Adobe pour déterminer la valeur du nom du partenaire. Les chaînes de requête incluses dans l’URL sont facultatives et dépendent du partenaire. Le module Integrate inclut automatiquement une chaîne de requête contenant un nombre aléatoire afin d’empêcher la mise en cache du navigateur.