Lien (préversion)
Linkly est un raccourcisseur de liens et un suivi de clic. Créez des liens courts personnalisés avec des domaines personnalisés, ajoutez des paramètres ET des pixels de reciblage, des conversions de rapports et extrayez les analyses de clic regroupées par pays, plateforme, référent ou campagne.
Ce connecteur est disponible dans les produits et régions suivants :
| Service | classe | Regions |
|---|---|---|
| Copilot Studio | Premium | Toutes les régions Power Automate , à l’exception des éléments suivants : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Applications logiques | Standard | Toutes les régions Logic Apps , à l’exception des suivantes : - Régions Azure Government - Régions Azure Chine - Us Department of Defense (DoD) |
| Power Apps | Premium | Toutes les régions Power Apps , à l’exception des suivantes : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Power Automate | Premium | Toutes les régions Power Automate , à l’exception des éléments suivants : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Contact | |
|---|---|
| Name | Prise en charge des liens |
| URL | https://linklyhq.com/support |
| Messagerie électronique | support@linklyhq.com |
| Métadonnées du connecteur | |
|---|---|
| Éditeur | Lien |
| Website | https://linklyhq.com |
| Politique de confidentialité | https://linklyhq.com/support/privacy |
| Categories | Marketing; Site internet |
Lien
Linkly est un raccourcisseur de liens et un suivi de clic. Il crée des liens courts personnalisés sur votre propre domaine, effectue le suivi de chaque clic avec les répartitions de pays, de plateforme et de référence, déclenche le reciblage des pixels et enregistre les conversions vers le lien qui les a produits. Ce connecteur permet aux flux de créer et de gérer des liens, d’extraire les conversions d’analyse de clic et de rapport dans un espace de travail Linkly.
Publisher : Lien
Prerequisites
Un compte Linkly . Le plan gratuit est suffisant pour utiliser chaque action dans ce connecteur. Les conversions de rapports et de référencement nécessitent également que la fonctionnalité de suivi des conversions linkly soit activée sur l’espace de travail.
Opérations prises en charge
Répertorier les espaces de travail
Retourne les espaces de travail disponibles pour cette connexion. Utilisez-le pour rechercher l’espace de travail dont d’autres actions ont besoin.
Créer ou mettre à jour un lien
Crée un lien court ou met à jour un lien existant lorsqu’un ID de lien est fourni. Prend en charge les domaines et les slugs personnalisés, les paramètres DE NIVEAU DE travail, les pixels de reciblage et les métadonnées Open Graph.
Obtenir un lien
Récupère un lien unique par son ID, y compris sa destination, son URL courte et sa configuration.
Liens de liste
Retourne une liste paginé des liens d’un espace de travail, avec des statistiques en cliquant sur. Prend en charge la recherche et le tri.
Supprimer un lien
Déplace un lien vers la corbeille. Son URL courte cesse de rediriger, et le lien peut être restauré ultérieurement à partir de la corbeille.
Obtenir l’analytique des clics
Retourne le nombre de clics au fil du temps pour un espace de travail ou pour des liens spécifiques, éventuellement filtrés par plage de dates, pays, navigateur, plateforme, référence ou ISP.
Obtenir les nombres de clics par dimension
Retourne les nombres de clics regroupés par une dimension telle que le pays, la ville, la plateforme, le référent ou le paramètre PAA, classées par nombre décroissant.
Répertorier les domaines personnalisés
Retourne les domaines personnalisés configurés pour un espace de travail. Ces noms de domaine peuvent être utilisés lors de la création de liens.
Signaler une conversion
Enregistre une conversion telle qu’un achat, une inscription ou un événement personnalisé et l’attribue au lien qui a été cliqué lorsqu’un jeton d’attribution est fourni.
Conversions de liste
Retourne les conversions les plus récentes enregistrées dans l’espace de travail.
Obtention des informations d’identification
Ce connecteur utilise OAuth 2.0. Aucune clé API n’est nécessaire.
- Si vous n’avez pas encore de compte Linkly, inscrivez-vous à https://linklyhq.com. Le plan gratuit fonctionne.
- Lorsque vous créez une connexion, choisissez Se connecter avec Linkly et connectez-vous avec votre compte Linkly.
- Choisissez l’espace de travail que cette connexion doit utiliser lorsque vous y êtes invité, puis approuver la demande.
La connexion est liée à l’espace de travail que vous avez choisi. Pour travailler dans un autre espace de travail, créez une deuxième connexion.
Getting Started
- Créez une connexion comme décrit ci-dessus.
- Ajoutez l’action Créer ou mettre à jour un lien à un flux, entrez l’URL de destination et, éventuellement, un domaine personnalisé et une suggestion. L’action retourne l’URL courte et l’ID de lien.
- Utilisez des liens de liste, Obtenir l’analytique des clics ou obtenir le nombre de clics par dimension pour lire les données de clic. Les actions qui effectuent un espace de travail vous permettent de le sélectionner dans une liste, qui est remplie par les espaces de travail de liste.
- Pour attribuer des achats ou des inscriptions à des liens, transmettez la
linkly_cidvaleur de votre URL de page d’accueil pour signaler une conversion en tant que jeton d’attribution.
Problèmes connus et limitations
- Une connexion est liée à un espace de travail Linkly unique, celui choisi lors de la connexion. Créez une connexion par espace de travail.
- Signaler une conversion et les conversions de liste nécessitent la fonctionnalité de suivi des conversions linkly. Les espaces de travail sans qu’ils reçoivent une erreur de ces actions.
- Les webhooks de clic en temps réel ne sont pas exposés en tant que déclencheurs. Utilisez plutôt la fonctionnalité webhook de Linkly avec un flux déclenché par HTTP.
- La création de liens en bloc, l’exportation de liens et la gestion de domaine sont disponibles dans l’API Linkly, mais ne sont pas incluses dans ce connecteur.
- L’API est limitée. Obtenir le nombre de clics par dimension retourne une erreur de limite de débit lorsque la limite est dépassée ; réessayez après un court délai.
Questions fréquentes
Quel espace de travail mes actions s’exécutent-ils ?
Les actions qui prennent un paramètre d’espace de travail affichent la liste des espaces de travail disponibles pour la connexion. Les actions sans un lien, telles que Obtenir un lien, signaler une conversion et des conversions de liste, utilisent l’espace de travail lié à la connexion.
Comment utiliser un domaine personnalisé ?
Ajoutez d’abord le domaine dans Linkly, puis transmettez son nom dans le champ Domaine de Créer ou mettre à jour un lien. Répertorier les domaines personnalisés retourne les noms disponibles dans un espace de travail.
Supprimer un lien supprime-t-il définitivement le lien ?
Non. Le lien est déplacé vers la corbeille et arrête la redirection. Il peut être restauré à partir de la corbeille dans Linkly.
Instructions de déploiement
- Dans le portail Maker, ouvrez des connecteurs personnalisés, choisissez Nouveau connecteur personnalisé , puis importez un fichier OpenAPI. Sélectionnez
apiDefinition.swagger.json. - Sous l’onglet Sécurité , choisissez OAuth 2.0 avec le fournisseur d’identité Oauth 2 générique . Entrez l’ID client et le secret client émis par Linkly, définissez l’URL
https://app.linklyhq.com/oauth/authorized’autorisation sur , puis définissez l’URL du jeton et l’URL d’actualisation surhttps://app.linklyhq.com/oauth/token. - Créez le connecteur, puis copiez l’URL de redirection affichée sous l’onglet Sécurité et inscrivez-la avec Linkly pour cet ID client.
- Créez une connexion en vous connectant avec votre compte Linkly, puis testez une action telle que liste d’espaces de travail.
Actions
| Conversions de liste |
Retourne les conversions les plus récentes enregistrées dans l’espace de travail. |
| Créer ou mettre à jour un lien |
Crée un lien court ou met à jour un lien existant lorsqu’un ID de lien est fourni. Prend en charge les domaines et les slugs personnalisés, les paramètres DE NIVEAU DE travail, les pixels de reciblage et les métadonnées Open Graph. |
| Liens de liste |
Retourne une liste paginé des liens d’un espace de travail, avec des statistiques en cliquant sur. Prend en charge la recherche et le tri. |
| Obtenir les nombres de clics par dimension |
Retourne les nombres de clics regroupés par une dimension telle que le pays, la ville, la plateforme, le référent ou le paramètre PAA, classées par nombre décroissant. |
| Obtenir l’analytique des clics |
Retourne le nombre de clics au fil du temps pour un espace de travail ou pour des liens spécifiques, éventuellement filtrés par plage de dates, pays, navigateur, plateforme, référence ou ISP. |
| Obtenir un lien |
Récupère un lien unique par son ID, y compris sa destination, son URL courte et sa configuration. |
| Répertorier les domaines personnalisés |
Retourne les domaines personnalisés configurés pour un espace de travail. Ces noms de domaine peuvent être utilisés lors de la création de liens. |
| Répertorier les espaces de travail |
Retourne les espaces de travail disponibles pour cette connexion. Utilisez-le pour rechercher l’espace de travail dont d’autres actions ont besoin. |
| Signaler une conversion |
Enregistre une conversion telle qu’un achat, une inscription ou un événement personnalisé et l’attribue au lien qui a été cliqué lorsqu’un jeton d’attribution est fourni. |
| Supprimer un lien |
Déplace un lien vers la corbeille. Son URL courte cesse de rediriger, et le lien peut être restauré ultérieurement à partir de la corbeille. |
Conversions de liste
Retourne les conversions les plus récentes enregistrées dans l’espace de travail.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Limit
|
limit | integer |
Nombre maximal de conversions à retourner, comprises entre 1 et 1 000. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Conversions
|
conversions | array of object |
Les conversions, les plus récentes en premier. |
|
Montant (cents)
|
conversions.amount_cents | integer |
Valeur dans la plus petite unité monétaire. Peut être négatif pour enregistrer un remboursement. |
|
Cliquez sur ID
|
conversions.click_id | string |
ID du clic attribué. |
|
Country
|
conversions.country | string |
Code pays ISO 3166-1 à deux lettres, par exemple états-Unis. |
|
Monnaie
|
conversions.currency | string |
Code ISO 4217 de la devise. La valeur par défaut est USD. |
|
ID de l’événement
|
conversions.event_id | string |
Votre identificateur pour l’événement. La création de rapports sur la même valeur deux fois ne crée pas de deuxième conversion. |
|
Nom de l'événement
|
conversions.event_name | string |
Ce qui s’est passé, par exemple l’achat, l’inscription ou trial_started. |
|
Type d’événement
|
conversions.event_type | string |
Type d’événement grossière. Utilisez le prospect pour établir l’identité et la vente des clients pour enregistrer les revenus. La valeur par défaut est personnalisée. |
|
ID de client
|
conversions.external_id | string |
Votre identificateur pour le client. Envoyez-le sur chaque événement afin que les ventes ultérieures puissent être liées au clic d’origine. |
|
Conversion ID
|
conversions.id | string |
Identificateur unique de la conversion. Les ID trient chronologiquement. |
|
Inséré à
|
conversions.inserted_at | date-time |
Lorsque la conversion a été enregistrée. |
|
IP Source
|
conversions.ip_source | string |
Dont l’adresse a été enregistrée : visiteur, serveur ou inconnu. Le serveur signifie que l’adresse de connexion appartient à votre serveur principal ou à un relais de plateforme, elle est donc exclue de la création de rapports géographiques. |
|
ID de lien
|
conversions.link_id | integer |
ID du lien attribué ou null si la conversion n’a pas pu être attribuée à un lien. |
|
Metadata
|
conversions.metadata | object |
Métadonnées JSON arbitraires, jusqu’à 10 000 octets. |
|
S’est produit à
|
conversions.occurred_at | date-time |
Lorsque la conversion s’est produite, au format ISO 8601. La valeur par défaut est définie sur maintenant. |
|
Source
|
conversions.source | string |
Quelle intégration l’a signalée. |
Créer ou mettre à jour un lien
Crée un lien court ou met à jour un lien existant lorsqu’un ID de lien est fourni. Prend en charge les domaines et les slugs personnalisés, les paramètres DE NIVEAU DE travail, les pixels de reciblage et les métadonnées Open Graph.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
URL de destination
|
url | uri |
URL de destination vers laquelle le lien court est redirigé. Obligatoire pour créer un lien. |
|
|
ID de lien
|
id | integer |
ID d’un lien existant à mettre à jour. Laissez vide pour créer un lien. |
|
|
Name
|
name | string |
Surnom du lien, affiché dans le tableau de bord. |
|
|
Domaine
|
domain | string |
Domaine personnalisé à utiliser pour le lien court, sans barre oblique de fin. |
|
|
Slug
|
slug | string |
Chemin d’accès personnalisé pour le lien court. Il doit commencer par une barre oblique. |
|
|
Enabled
|
enabled | boolean |
Indique si le lien est actif. |
|
|
Note
|
note | string |
Note privée sur le lien. |
|
|
SOURCE OLE
|
utm_source | string |
Paramètre utm_source ajouté à l’URL de destination. |
|
|
MEDIUM DE L’APPLIANCE
|
utm_medium | string |
Paramètre utm_medium ajouté à l’URL de destination. |
|
|
CAMPAGNE DE L’ANALYSE DES DONNÉES
|
utm_campaign | string |
Paramètre utm_campaign ajouté à l’URL de destination. |
|
|
CONTENU DE L’OBJET
|
utm_content | string |
Paramètre utm_content ajouté à l’URL de destination. |
|
|
TERMES DE LA DURÉE DE L’EXPRESSION
|
utm_term | string |
Paramètre utm_term ajouté à l’URL de destination. |
|
|
ID de méta pixel
|
fb_pixel_id | string |
ID de pixel Meta (Facebook) à déclencher lorsque le lien est cliqué. |
|
|
ID de balise Google Analytics 4
|
ga4_tag_id | string |
ID de mesure Google Analytics 4 à déclencher lorsque le lien est cliqué. |
|
|
Google Tag Manager ID
|
gtm_id | string |
ID de conteneur Google Tag Manager à charger lorsque le lien est cliqué. |
|
|
Bloquer les bots
|
block_bots | boolean |
Indique s’il faut empêcher les bots connus de suivre le lien. |
|
|
Balises de corps
|
body_tags | string |
Balises HTML ou de suivi personnalisées insérées dans le corps de la page de redirection. |
|
|
Masquage
|
cloaking | boolean |
Indique s’il faut masquer la destination en l’ouvrant à l’intérieur d’un cadre. |
|
|
Paramètres de transfert
|
forward_params | boolean |
Indique s’il faut transférer les paramètres de requête à partir du lien court vers la destination. |
|
|
Balises de tête
|
head_tags | string |
Balises HTML ou de suivi personnalisées insérées dans la tête de la page de redirection. |
|
|
Masquer le référent
|
hide_referrer | boolean |
Indique s’il faut masquer le référent du site de destination. |
|
|
Ouvrir la description du graphe
|
og_description | string |
Description affichée lorsque le lien est partagé sur les réseaux sociaux. |
|
|
Ouvrir l’image graph
|
og_image | string |
URL de l’image affichée lorsque le lien est partagé sur les réseaux sociaux. |
|
|
Ouvrir le titre du graphe
|
og_title | string |
Titre affiché lorsque le lien est partagé sur les réseaux sociaux. |
|
|
TikTok Pixel ID
|
tiktok_pixel_id | string |
ID de pixel TikTok à déclencher lorsque le lien est cliqué. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
ID de méta pixel
|
fb_pixel_id | string |
ID de pixel Meta (Facebook) à déclencher lorsque le lien est cliqué. |
|
ID de partenaire LinkedIn
|
linkedin_partner_id | string |
L’ID de partenaire LinkedIn Insight Tag à déclencher lorsque le lien est cliqué. |
|
ID de balise UET Microsoft
|
microsoft_uet_tag_id | string |
L’id de balise UET Microsoft Advertising à déclencher lorsque le lien est cliqué. |
|
Reddit Pixel ID
|
reddit_pixel_id | string |
ID de pixel Reddit à déclencher lorsque le lien est cliqué. |
|
TikTok Pixel ID
|
tiktok_pixel_id | string |
ID de pixel TikTok à déclencher lorsque le lien est cliqué. |
|
Masquer le référent
|
hide_referrer | boolean |
Indique s’il faut masquer le référent du site de destination. |
|
Date d’expiration
|
expiry_datetime | string |
Lorsque le lien cesse de fonctionner, au format ISO 8601. |
|
Destination d’expiration
|
expiry_destination | uri |
URL à rediriger après l’expiration du lien. Laissez vide pour retourner une page introuvable. |
|
X Pixel ID
|
twitter_pixel_id | string |
ID X (Twitter) Pixel à déclencher lorsque le lien est cliqué. |
|
Masquage
|
cloaking | boolean |
Indique s’il faut masquer la destination en l’ouvrant à l’intérieur d’un cadre. |
|
URL courte
|
full_url | uri |
URL complète du lien court. |
|
Ouvrir la description du graphe
|
og_description | string |
Description affichée lorsque le lien est partagé sur les réseaux sociaux. |
|
Ignorer le suivi du robot social
|
skip_social_crawler_tracking | boolean |
Indique s’il faut exclure les analyseurs d’aperçu des réseaux sociaux du suivi des clics. |
|
Balises de corps
|
body_tags | string |
Balises HTML ou de suivi personnalisées insérées dans le corps de la page de redirection. |
|
Ouvrir le titre du graphe
|
og_title | string |
Titre affiché lorsque le lien est partagé sur les réseaux sociaux. |
|
Note
|
note | string |
Note privée sur le lien. |
|
Name
|
name | string |
Surnom du lien, affiché dans le tableau de bord. |
|
ID de lien
|
id | integer |
ID d’un lien existant à mettre à jour. Laissez vide pour créer un lien. |
|
Google Tag Manager ID
|
gtm_id | string |
ID de conteneur Google Tag Manager à charger lorsque le lien est cliqué. |
|
Ouvrir l’image graph
|
og_image | string |
URL de l’image affichée lorsque le lien est partagé sur les réseaux sociaux. |
|
Bloquer les bots
|
block_bots | boolean |
Indique s’il faut empêcher les bots connus de suivre le lien. |
|
ID de pixel de l’espace de travail
|
snapchat_pixel_id | string |
ID de Pixel De Augmente à déclencher lorsque le lien est cliqué. |
|
CONTENU DE L’OBJET
|
utm_content | string |
Paramètre utm_content ajouté à l’URL de destination. |
|
Enabled
|
enabled | boolean |
Indique si le lien est actif. |
|
URL de destination
|
url | uri |
URL de destination vers laquelle le lien court est redirigé. Obligatoire pour créer un lien. |
|
Supprimé
|
deleted | boolean |
Indique si le lien se trouve dans la corbeille. |
|
Webhooks
|
webhooks | array of string |
Les URL de webhook ont souscrit aux clics sur ce lien. |
|
Clics d’expiration
|
expiry_clicks | integer |
Nombre de clics après lesquels le lien cesse de fonctionner. |
|
Notifier Slack
|
notify_slack | boolean |
Indique s’il faut envoyer une notification Slack lorsque le lien est cliqué. |
|
ID d’espace de travail
|
workspace_id | integer |
L'identifiant de l’espace de travail. |
|
Analyse publique
|
public_analytics | boolean |
Indique si la page d’analyse du lien est visible publiquement. |
|
ID de balise De Pinterest
|
pinterest_tag_id | string |
ID de balise Pinterest à déclencher lorsque le lien est cliqué. |
|
SOURCE OLE
|
utm_source | string |
Paramètre utm_source ajouté à l’URL de destination. |
|
Slug
|
slug | string |
Chemin d’accès personnalisé pour le lien court. Il doit commencer par une barre oblique. |
|
Domaine
|
domain | string |
Domaine personnalisé à utiliser pour le lien court, sans barre oblique de fin. |
|
Paramètres de transfert
|
forward_params | boolean |
Indique s’il faut transférer les paramètres de requête à partir du lien court vers la destination. |
|
MEDIUM DE L’APPLIANCE
|
utm_medium | string |
Paramètre utm_medium ajouté à l’URL de destination. |
|
Balises de tête
|
head_tags | string |
Balises HTML ou de suivi personnalisées insérées dans la tête de la page de redirection. |
|
ID de balise Google Analytics 4
|
ga4_tag_id | string |
ID de mesure Google Analytics 4 à déclencher lorsque le lien est cliqué. |
|
TERMES DE LA DURÉE DE L’EXPRESSION
|
utm_term | string |
Paramètre utm_term ajouté à l’URL de destination. |
|
CAMPAGNE DE L’ANALYSE DES DONNÉES
|
utm_campaign | string |
Paramètre utm_campaign ajouté à l’URL de destination. |
Liens de liste
Retourne une liste paginé des liens d’un espace de travail, avec des statistiques en cliquant sur. Prend en charge la recherche et le tri.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Workspace
|
workspace_id | True | string |
Espace de travail dans lequel travailler. Choisissez-le dans la liste ou entrez son ID. |
|
Search
|
search | string |
Terme de recherche pour filtrer les liens par nom, URL ou slug. |
|
|
Page
|
page | integer |
Numéro de page à retourner, à partir de 1. |
|
|
Taille de la page
|
page_size | integer |
Nombre de liens à retourner par page. |
|
|
Trier par
|
sort_by | string |
Champ à trier, par exemple clicks_total, nom ou inserted_at. |
|
|
Direction du tri
|
sort_dir | string |
Direction de tri, asc ou desc. |
|
|
Supprimé
|
deleted | boolean |
Indique s’il faut retourner des liens qui se trouvent dans la corbeille au lieu de liens actifs. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Links
|
links | array of object |
Liens de cette page. |
|
ID de méta pixel
|
links.fb_pixel_id | string |
ID de pixel Meta (Facebook) à déclencher lorsque le lien est cliqué. |
|
Nombre total de clics humains
|
links.human_clicks_total | integer |
Clics de durée de vie sans signal de bot ; le sous-ensemble de clicks_total où ni un agent utilisateur de bot ni une catégorie de bot vérifié n’a été détecté. Enregistré à partir de 2019. |
|
Clics (30 jours)
|
links.clicks_thirty_days | integer |
Cliquez au cours des 30 derniers jours, y compris le trafic du bot. |
|
TikTok Pixel ID
|
links.tiktok_pixel_id | string |
ID de pixel TikTok à déclencher lorsque le lien est cliqué. |
|
Masquer le référent
|
links.hide_referrer | boolean |
Indique s’il faut masquer le référent du site de destination. |
|
Masquage
|
links.cloaking | boolean |
Indique s’il faut masquer la destination en l’ouvrant à l’intérieur d’un cadre. |
|
URL courte
|
links.full_url | uri |
URL complète du lien court. |
|
Clics aujourd’hui
|
links.clicks_today | integer |
Clics jusqu’à présent (UTC), y compris le trafic de bot. |
|
Ouvrir la description du graphe
|
links.og_description | string |
Description affichée lorsque le lien est partagé sur les réseaux sociaux. |
|
Balises de corps
|
links.body_tags | string |
Balises HTML ou de suivi personnalisées insérées dans le corps de la page de redirection. |
|
Ouvrir le titre du graphe
|
links.og_title | string |
Titre affiché lorsque le lien est partagé sur les réseaux sociaux. |
|
Note
|
links.note | string |
Note privée sur le lien. |
|
Name
|
links.name | string |
Surnom du lien, affiché dans le tableau de bord. |
|
ID de lien
|
links.id | integer |
Identificateur unique du lien. |
|
Google Tag Manager ID
|
links.gtm_id | string |
ID de conteneur Google Tag Manager à charger lorsque le lien est cliqué. |
|
Ouvrir l’image graph
|
links.og_image | string |
URL de l’image affichée lorsque le lien est partagé sur les réseaux sociaux. |
|
Bloquer les bots
|
links.block_bots | boolean |
Indique s’il faut empêcher les bots connus de suivre le lien. |
|
Nombre total de clics
|
links.clicks_total | integer |
Clics de durée de vie, y compris le trafic de bot. |
|
Clics humains (30 jours)
|
links.human_clicks_thirty_days | integer |
Clics au cours des 30 derniers jours sans signal de bot ; sous-ensemble de clicks_thirty_days. |
|
CONTENU DE L’OBJET
|
links.utm_content | string |
Paramètre utm_content ajouté à l’URL de destination. |
|
Clics humains aujourd’hui
|
links.human_clicks_today | integer |
Cliquez jusqu’à présent (UTC) sans signal de bot. |
|
Enabled
|
links.enabled | boolean |
Indique si le lien est actif. |
|
URL de destination
|
links.url | uri |
URL de destination vers laquelle le lien court est redirigé. |
|
Supprimé
|
links.deleted | boolean |
Indique si le lien se trouve dans la corbeille. |
|
ID d’espace de travail
|
links.workspace_id | integer |
L'identifiant de l’espace de travail. |
|
Analyse publique
|
links.public_analytics | boolean |
Indique si la page d’analyse du lien est visible publiquement. |
|
SOURCE OLE
|
links.utm_source | string |
Paramètre utm_source ajouté à l’URL de destination. |
|
Slug
|
links.slug | string |
Chemin d’accès personnalisé pour le lien court. Il doit commencer par une barre oblique. |
|
Domaine
|
links.domain | string |
Domaine personnalisé à utiliser pour le lien court, sans barre oblique de fin. |
|
Paramètres de transfert
|
links.forward_params | boolean |
Indique s’il faut transférer les paramètres de requête à partir du lien court vers la destination. |
|
MEDIUM DE L’APPLIANCE
|
links.utm_medium | string |
Paramètre utm_medium ajouté à l’URL de destination. |
|
Balises de tête
|
links.head_tags | string |
Balises HTML ou de suivi personnalisées insérées dans la tête de la page de redirection. |
|
ID de balise Google Analytics 4
|
links.ga4_tag_id | string |
ID de mesure Google Analytics 4 à déclencher lorsque le lien est cliqué. |
|
TERMES DE LA DURÉE DE L’EXPRESSION
|
links.utm_term | string |
Paramètre utm_term ajouté à l’URL de destination. |
|
CAMPAGNE DE L’ANALYSE DES DONNÉES
|
links.utm_campaign | string |
Paramètre utm_campaign ajouté à l’URL de destination. |
|
Clics humains hier
|
links.human_clicks_previous_day | integer |
Clique hier (UTC) sans signal de bot. |
|
Numéro de page
|
page_number | integer |
Numéro de page actif. |
|
Taille de la page
|
page_size | integer |
Nombre de liens à retourner par page. |
|
Nombre total d’entrées
|
total_entries | integer |
Nombre total de liens correspondant à la requête. |
|
Total Pages
|
total_pages | integer |
Nombre total de pages disponibles. |
|
Lignes de totaux
|
total_rows | integer |
Nombre total de lignes. |
|
Nombre de liens d’espace de travail
|
workspace_link_count | integer |
Nombre total de liens dans l’espace de travail. |
Obtenir les nombres de clics par dimension
Retourne les nombres de clics regroupés par une dimension telle que le pays, la ville, la plateforme, le référent ou le paramètre PAA, classées par nombre décroissant.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Workspace
|
workspace_id | True | string |
Espace de travail dans lequel travailler. Choisissez-le dans la liste ou entrez son ID. |
|
Dimension
|
counter | True | string |
Dimension par laquelle regrouper les clics, par exemple pays, ville, plateforme, référence ou utm_campaign. |
|
ID de lien
|
link_id | string |
ID d’un lien unique à filtrer. |
|
|
ID de lien
|
link_ids | string |
Liste séparée par un trait d’union des ID de lien à filtrer. |
|
|
Date de début
|
start | string |
Début de la plage de dates, au format AAAA-MM-DD. |
|
|
Date de fin
|
end | string |
Fin de la plage de dates, au format AAAA-MM-DD. |
|
|
Country
|
country | string |
Code pays ISO 3166-1 à deux lettres, par exemple états-Unis. |
|
|
Inclure des bots
|
bots | boolean |
Indique s’il faut inclure des clics identifiés en tant que bots. Définissez la valeur false pour les exclure. |
|
|
Unique uniquement
|
unique | boolean |
Indique s’il faut compter uniquement des clics uniques. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Total
|
total | integer |
Nombre total de clics sur tous les groupes, y compris les valeurs non retournées. Lorsque le résultat est tronqué, cela est supérieur à la somme du nombre dans les valeurs, de sorte que le nombre / total donne toujours un pourcentage précis. |
|
Values
|
values | array of object |
Nombre groupé, classé par nombre décroissant. Tronqué aux 10 000 premières valeurs ; si la dimension a plus de valeurs distinctes que cela, le reste n’est pas retourné. |
|
Nombre
|
values.count | integer |
Nombre de clics pour cette valeur. |
|
Value
|
values.value | string |
Valeur de la dimension, par exemple un code de pays. |
Obtenir l’analytique des clics
Retourne le nombre de clics au fil du temps pour un espace de travail ou pour des liens spécifiques, éventuellement filtrés par plage de dates, pays, navigateur, plateforme, référence ou ISP.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Workspace
|
workspace_id | True | string |
Espace de travail dans lequel travailler. Choisissez-le dans la liste ou entrez son ID. |
|
ID de lien
|
link_id | string |
ID d’un lien unique à filtrer. |
|
|
ID de lien
|
link_ids | string |
Liste séparée par un trait d’union des ID de lien à filtrer. |
|
|
Date de début
|
start | string |
Début de la plage de dates, au format AAAA-MM-DD. |
|
|
Date de fin
|
end | string |
Fin de la plage de dates, au format AAAA-MM-DD. |
|
|
Country
|
country | string |
Code pays ISO 3166-1 à deux lettres, par exemple états-Unis. |
|
|
Browser
|
browser | string |
Nom du navigateur à filtrer par exemple Chrome, Firefox ou Safari. |
|
|
Platform
|
platform | string |
Une plateforme ou un système d’exploitation à filtrer par exemple Windows, Mac, iOS ou Android. |
|
|
Référent
|
referer | string |
Domaine de référence à filtrer. |
|
|
Fournisseur d'Accès à Internet
|
isp | string |
Nom du fournisseur de services Internet à filtrer. |
|
|
Inclure des bots
|
bots | boolean |
Indique s’il faut inclure des clics identifiés en tant que bots. Définissez la valeur false pour les exclure. |
|
|
Unique uniquement
|
unique | boolean |
Indique s’il faut compter uniquement des clics uniques. |
|
|
Fuseau horaire
|
timezone | string |
Fuseau horaire IANA utilisé pour les calculs de date, par exemple Europe/Londres. |
|
|
Fréquence
|
frequency | string |
Granularité de la série chronologique, jour ou heure. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Traffic
|
traffic | array of object |
Le nombre de clics est compté au fil du temps. |
|
Démarrage du compartiment
|
traffic.t | string |
Début du compartiment : AAAA -MM-DD pour les compartiments quotidiens ou AAAA-MM-DDTHH :MM :SS pour les compartiments horaires. |
|
Clics
|
traffic.y | integer |
Nombre de clics dans le compartiment. |
Obtenir un lien
Récupère un lien unique par son ID, y compris sa destination, son URL courte et sa configuration.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID de lien
|
id | True | string |
ID du lien. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
ID de méta pixel
|
fb_pixel_id | string |
ID de pixel Meta (Facebook) à déclencher lorsque le lien est cliqué. |
|
ID de partenaire LinkedIn
|
linkedin_partner_id | string |
L’ID de partenaire LinkedIn Insight Tag à déclencher lorsque le lien est cliqué. |
|
ID de balise UET Microsoft
|
microsoft_uet_tag_id | string |
L’id de balise UET Microsoft Advertising à déclencher lorsque le lien est cliqué. |
|
Reddit Pixel ID
|
reddit_pixel_id | string |
ID de pixel Reddit à déclencher lorsque le lien est cliqué. |
|
TikTok Pixel ID
|
tiktok_pixel_id | string |
ID de pixel TikTok à déclencher lorsque le lien est cliqué. |
|
Masquer le référent
|
hide_referrer | boolean |
Indique s’il faut masquer le référent du site de destination. |
|
Date d’expiration
|
expiry_datetime | string |
Lorsque le lien cesse de fonctionner, au format ISO 8601. |
|
Destination d’expiration
|
expiry_destination | uri |
URL à rediriger après l’expiration du lien. Laissez vide pour retourner une page introuvable. |
|
X Pixel ID
|
twitter_pixel_id | string |
ID X (Twitter) Pixel à déclencher lorsque le lien est cliqué. |
|
Masquage
|
cloaking | boolean |
Indique s’il faut masquer la destination en l’ouvrant à l’intérieur d’un cadre. |
|
URL courte
|
full_url | uri |
URL complète du lien court. |
|
Ouvrir la description du graphe
|
og_description | string |
Description affichée lorsque le lien est partagé sur les réseaux sociaux. |
|
Ignorer le suivi du robot social
|
skip_social_crawler_tracking | boolean |
Indique s’il faut exclure les analyseurs d’aperçu des réseaux sociaux du suivi des clics. |
|
Balises de corps
|
body_tags | string |
Balises HTML ou de suivi personnalisées insérées dans le corps de la page de redirection. |
|
Ouvrir le titre du graphe
|
og_title | string |
Titre affiché lorsque le lien est partagé sur les réseaux sociaux. |
|
Note
|
note | string |
Note privée sur le lien. |
|
Name
|
name | string |
Surnom du lien, affiché dans le tableau de bord. |
|
ID de lien
|
id | integer |
Identificateur unique du lien. |
|
Google Tag Manager ID
|
gtm_id | string |
ID de conteneur Google Tag Manager à charger lorsque le lien est cliqué. |
|
Ouvrir l’image graph
|
og_image | string |
URL de l’image affichée lorsque le lien est partagé sur les réseaux sociaux. |
|
Bloquer les bots
|
block_bots | boolean |
Indique s’il faut empêcher les bots connus de suivre le lien. |
|
ID de pixel de l’espace de travail
|
snapchat_pixel_id | string |
ID de Pixel De Augmente à déclencher lorsque le lien est cliqué. |
|
CONTENU DE L’OBJET
|
utm_content | string |
Paramètre utm_content ajouté à l’URL de destination. |
|
Enabled
|
enabled | boolean |
Indique si le lien est actif. |
|
URL de destination
|
url | uri |
URL de destination vers laquelle le lien court est redirigé. |
|
Supprimé
|
deleted | boolean |
Indique si le lien se trouve dans la corbeille. |
|
Webhooks
|
webhooks | array of string |
Les URL de webhook ont souscrit aux clics sur ce lien. |
|
Clics d’expiration
|
expiry_clicks | integer |
Nombre de clics après lesquels le lien cesse de fonctionner. |
|
Notifier Slack
|
notify_slack | boolean |
Indique s’il faut envoyer une notification Slack lorsque le lien est cliqué. |
|
ID d’espace de travail
|
workspace_id | integer |
L'identifiant de l’espace de travail. |
|
Analyse publique
|
public_analytics | boolean |
Indique si la page d’analyse du lien est visible publiquement. |
|
ID de balise De Pinterest
|
pinterest_tag_id | string |
ID de balise Pinterest à déclencher lorsque le lien est cliqué. |
|
SOURCE OLE
|
utm_source | string |
Paramètre utm_source ajouté à l’URL de destination. |
|
Slug
|
slug | string |
Chemin d’accès personnalisé pour le lien court. Il doit commencer par une barre oblique. |
|
Domaine
|
domain | string |
Domaine personnalisé à utiliser pour le lien court, sans barre oblique de fin. |
|
Paramètres de transfert
|
forward_params | boolean |
Indique s’il faut transférer les paramètres de requête à partir du lien court vers la destination. |
|
MEDIUM DE L’APPLIANCE
|
utm_medium | string |
Paramètre utm_medium ajouté à l’URL de destination. |
|
Balises de tête
|
head_tags | string |
Balises HTML ou de suivi personnalisées insérées dans la tête de la page de redirection. |
|
ID de balise Google Analytics 4
|
ga4_tag_id | string |
ID de mesure Google Analytics 4 à déclencher lorsque le lien est cliqué. |
|
TERMES DE LA DURÉE DE L’EXPRESSION
|
utm_term | string |
Paramètre utm_term ajouté à l’URL de destination. |
|
CAMPAGNE DE L’ANALYSE DES DONNÉES
|
utm_campaign | string |
Paramètre utm_campaign ajouté à l’URL de destination. |
Répertorier les domaines personnalisés
Retourne les domaines personnalisés configurés pour un espace de travail. Ces noms de domaine peuvent être utilisés lors de la création de liens.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Workspace
|
workspace_id | True | string |
Espace de travail dans lequel travailler. Choisissez-le dans la liste ou entrez son ID. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Domains
|
domains | array of object |
Domaines personnalisés dans l’espace de travail. |
|
Nom de domaine
|
domains.name | string |
Nom de domaine, par exemple go.yourcompany.com. |
Répertorier les espaces de travail
Retourne les espaces de travail disponibles pour cette connexion. Utilisez-le pour rechercher l’espace de travail dont d’autres actions ont besoin.
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
|
array of object | ||
|
ID d’espace de travail
|
id | integer |
Identificateur unique de l’espace de travail. |
|
Nom de l’espace de travail
|
name | string |
Nom de l’espace de travail. |
Signaler une conversion
Enregistre une conversion telle qu’un achat, une inscription ou un événement personnalisé et l’attribue au lien qui a été cliqué lorsqu’un jeton d’attribution est fourni.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Montant (cents)
|
amount_cents | integer |
Valeur dans la plus petite unité monétaire. Peut être négatif pour enregistrer un remboursement ou une rétrofacturation, ce qui filet contre les recettes antérieures. |
|
|
Country
|
country | string |
Code de pays à deux lettres pour la conversion. Déduit pour les appels côté navigateur ; fournissez-le explicitement à partir d’une intégration côté serveur, où l’adresse de connexion est votre propre infrastructure plutôt que celle du client. |
|
|
Monnaie
|
currency | string |
Code monétaire ISO 4217. La valeur par défaut est USD. |
|
|
ID de l’événement
|
event_id | string |
Votre identificateur pour cet événement. Utilisé comme clé d’idempotency ; la création de la même valeur deux fois ne crée pas de deuxième conversion. S’applique à n’importe quel type d’événement, pas seulement aux achats. |
|
|
Nom de l'événement
|
event_name | True | string |
Ce qui s’est passé, par exemple l’achat, l’inscription, trial_started. |
|
Type d’événement
|
event_type | string |
Type grossière qui conduit l’entonnoir. lead établit l’identité du client, les enregistrements de vente chiffre d’affaires. La valeur par défaut est personnalisée. |
|
|
ID de client
|
external_id | string |
Votre identificateur pour le client. Envoyez-le sur chaque événement : c’est ce qui lie une vente côté serveur ultérieure au clic qui a produit l’inscription. |
|
|
Jeton d’attribution
|
linkly_cid | string |
Jeton d’attribution capturé à partir de l’URL de la page d’accueil. Omettre s’il n’est pas disponible ; la conversion est ensuite enregistrée sans attribution de lien. |
|
|
Metadata
|
metadata | object |
JSON arbitraire, jusqu’à 10 000 octets encodés. |
|
|
S’est produit à
|
occurred_at | date-time |
Lorsque la conversion s’est produite. La valeur par défaut est définie sur maintenant. |
|
|
Adresse IP du visiteur
|
visitor_ip | string |
Adresse IP du client final, lorsque votre serveur l’a. Omettez à moins que vous ne le fassiez ; pour les appels côté serveur Linkly enregistre sinon l’adresse de connexion en tant que serveur, et non le client, et l’exclut de la création de rapports géographiques. L’envoi de ces affirmations vous donne une base légale pour la partager. Jamais retourné par l’API. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Montant (cents)
|
amount_cents | integer |
Valeur dans la plus petite unité monétaire. Peut être négatif pour enregistrer un remboursement. |
|
Cliquez sur ID
|
click_id | string |
ID du clic attribué. |
|
Country
|
country | string |
Code pays ISO 3166-1 à deux lettres, par exemple états-Unis. |
|
Monnaie
|
currency | string |
Code ISO 4217 de la devise. La valeur par défaut est USD. |
|
ID de l’événement
|
event_id | string |
Votre identificateur pour l’événement. La création de rapports sur la même valeur deux fois ne crée pas de deuxième conversion. |
|
Nom de l'événement
|
event_name | string |
Ce qui s’est passé, par exemple l’achat, l’inscription ou trial_started. |
|
Type d’événement
|
event_type | string |
Type d’événement grossière. Utilisez le prospect pour établir l’identité et la vente des clients pour enregistrer les revenus. La valeur par défaut est personnalisée. |
|
ID de client
|
external_id | string |
Votre identificateur pour le client. Envoyez-le sur chaque événement afin que les ventes ultérieures puissent être liées au clic d’origine. |
|
Conversion ID
|
id | string |
Identificateur unique de la conversion. Les ID trient chronologiquement. |
|
Inséré à
|
inserted_at | date-time |
Lorsque la conversion a été enregistrée. |
|
IP Source
|
ip_source | string |
Dont l’adresse a été enregistrée : visiteur, serveur ou inconnu. Le serveur signifie que l’adresse de connexion appartient à votre serveur principal ou à un relais de plateforme, elle est donc exclue de la création de rapports géographiques. |
|
ID de lien
|
link_id | integer |
ID du lien attribué ou null si la conversion n’a pas pu être attribuée à un lien. |
|
Metadata
|
metadata | object |
Métadonnées JSON arbitraires, jusqu’à 10 000 octets. |
|
S’est produit à
|
occurred_at | date-time |
Lorsque la conversion s’est produite, au format ISO 8601. La valeur par défaut est définie sur maintenant. |
|
Source
|
source | string |
Quelle intégration l’a signalée. |
Supprimer un lien
Déplace un lien vers la corbeille. Son URL courte cesse de rediriger, et le lien peut être restauré ultérieurement à partir de la corbeille.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Workspace
|
workspace_id | True | string |
Espace de travail dans lequel travailler. Choisissez-le dans la liste ou entrez son ID. |
|
ID de lien
|
id | True | integer |
ID du lien. |
Retours
Message de confirmation.
- response
- string
Définitions
string
Il s’agit du type de données de base « string ».