Collegamento (anteprima)
Linkly è un abbreviatore di collegamenti e fare clic tracker. Creare collegamenti brevi con domini personalizzati, aggiungere parametri UTM e retargeting pixel, conversioni di report e fare clic su analisi raggruppate per paese, piattaforma, referrer o campagna.
Questo connettore è disponibile nei prodotti e nelle aree seguenti:
| Service | Classe | Regions |
|---|---|---|
| Copilot Studio | Premium | Tutte le aree Power Automate ad eccezione delle seguenti: - Governo degli Stati Uniti (GCC) - Us Government (GCC High) - China Cloud gestito da 21Vianet - Dipartimento della Difesa degli Stati Uniti (DoD) |
| Logic Apps | Standard | Tutte le aree di App per la logica , ad eccezione delle seguenti: - aree Azure per enti pubblici - Aree di Azure Cina - Dipartimento della Difesa degli Stati Uniti (DoD) |
| Power Apps | Premium | Tutte le aree Power Apps ad eccezione delle seguenti: - Governo degli Stati Uniti (GCC) - Us Government (GCC High) - China Cloud gestito da 21Vianet - Dipartimento della Difesa degli Stati Uniti (DoD) |
| Power Automate | Premium | Tutte le aree Power Automate ad eccezione delle seguenti: - Governo degli Stati Uniti (GCC) - Us Government (GCC High) - China Cloud gestito da 21Vianet - Dipartimento della Difesa degli Stati Uniti (DoD) |
| Contatto | |
|---|---|
| Name | Supporto linkly |
| URL | https://linklyhq.com/support |
| Posta elettronica | support@linklyhq.com |
| Metadati del connettore | |
|---|---|
| Editore | Collegamento |
| Website | https://linklyhq.com |
| Informativa sulla privacy | https://linklyhq.com/support/privacy |
| Categorie | Marketing; Sito web |
Collegamento
Linkly è un abbreviatore di collegamenti e fare clic tracker. Crea collegamenti brevi personalizzati sul proprio dominio, tiene traccia di ogni clic con i dettagli di paese, piattaforma e referrer, attiva i pixel di reindirizzamento e registra le conversioni al collegamento che li ha prodotti. Questo connettore consente ai flussi di creare e gestire collegamenti, eseguire il pull delle conversioni di analisi e report in un'area di lavoro Linkly.
Publisher: Collegamento
Prerequisiti
Un account Linkly . Il piano gratuito è sufficiente per usare ogni azione in questo connettore. Per la creazione di report e l'elenco delle conversioni è necessaria anche l'abilitazione della funzionalità di rilevamento delle conversioni linkly nell'area di lavoro.
Operazioni supportate
Elencare le aree di lavoro
Restituisce le aree di lavoro disponibili per questa connessione. Usarlo per trovare l'area di lavoro necessaria per altre azioni.
Creare o aggiornare un collegamento
Crea un nuovo collegamento breve o ne aggiorna uno esistente quando viene fornito un ID collegamento. Supporta domini personalizzati e slug, parametri UTM, retargeting pixel e metadati Open Graph.
Ottenere un collegamento
Recupera un singolo collegamento in base al relativo ID, inclusa la destinazione, l'URL breve e la configurazione.
Collegamenti elenco
Restituisce un elenco impaginato dei collegamenti in un'area di lavoro, con statistiche di clic. Supporta la ricerca e l'ordinamento.
Eliminare un collegamento
Sposta un collegamento nel cestino. L'URL breve smette di reindirizzare e il collegamento può essere ripristinato in un secondo momento dal cestino.
Ottenere l'analisi dei clic
Restituisce i conteggi dei clic nel tempo per un'area di lavoro o per collegamenti specifici, filtrati facoltativamente per intervallo di date, paese, browser, piattaforma, referrer o ISP.
Ottenere i conteggi dei clic per dimensione
Restituisce i conteggi dei clic raggruppati in base a una dimensione, ad esempio paese, città, piattaforma, referrer o parametro UTM, ordinati in base al conteggio decrescente.
Elencare domini personalizzati
Restituisce i domini personalizzati configurati per un'area di lavoro. Questi nomi di dominio possono essere usati durante la creazione di collegamenti.
Segnalare una conversione
Registra una conversione, ad esempio un acquisto, un evento di iscrizione o personalizzato e lo assegna al collegamento selezionato quando viene fornito un token di attribuzione.
Elencare le conversioni
Restituisce le conversioni più recenti registrate nell'area di lavoro.
Recupero delle credenziali
Questo connettore usa OAuth 2.0. Non è necessaria alcuna chiave API.
- Se non si ha ancora un account Linkly, iscriversi all'indirizzo https://linklyhq.com. Il piano gratuito funziona.
- Quando si crea una connessione, scegliere Accedi con Linkly e accedere con l'account Linkly.
- Scegliere l'area di lavoro da usare quando richiesto, quindi approvare la richiesta.
La connessione è associata all'area di lavoro scelta. Per lavorare in un'altra area di lavoro, creare una seconda connessione.
Getting Started
- Creare una connessione come descritto in precedenza.
- Aggiungere l'azione Crea o aggiorna un collegamento a un flusso, immettere l'URL di destinazione e, facoltativamente, un dominio personalizzato e un slug. L'azione restituisce l'URL breve e l'ID collegamento.
- Usare i collegamenti elenco, Ottenere l'analisi dei clic o Ottenere i conteggi dei clic per dimensione per leggere i dati di clic. Le azioni che esere un'area di lavoro consentono di selezionarla da un elenco, popolato da Aree di lavoro elenco.
- Per attribuire acquisti o iscrizione a collegamenti, passare il valore dall'URL
linkly_ciddella pagina di destinazione a Segnala una conversione come token di attribuzione.
Problemi noti e limitazioni
- Una connessione è associata a una singola area di lavoro linkly, quella scelta durante l'accesso. Creare una connessione per area di lavoro.
- Per segnalare una conversione e le conversioni elenco è necessaria la funzionalità di rilevamento delle conversioni linkly. Le aree di lavoro senza che ricevano un errore da queste azioni.
- I webhook click in tempo reale non vengono esposti come trigger. Usare invece la funzionalità webhook di Linkly con un flusso attivato da HTTP.
- La creazione di collegamenti in blocco, l'esportazione dei collegamenti e la gestione del dominio sono disponibili nell'API Linkly, ma non sono incluse in questo connettore.
- L'API è limitata. Ottenere i conteggi dei clic per dimensione restituisce un errore di limite di velocità quando viene superato il limite; riprovare dopo un breve ritardo.
Domande frequenti
In quale area di lavoro vengono eseguite le azioni?
Le azioni che accettano un parametro Workspace mostrano un elenco delle aree di lavoro disponibili per la connessione. Le azioni senza un collegamento, ad esempio Recupera un collegamento, Segnala una conversione e Elenca conversioni, usano l'area di lavoro associata alla connessione.
Come si usa un dominio personalizzato?
Aggiungere prima il dominio in Linkly, quindi passarne il nome nel campo Dominio di Crea o aggiorna un collegamento. Elencare i domini personalizzati restituisce i nomi disponibili in un'area di lavoro.
Elimina un collegamento rimuove il collegamento in modo permanente?
No. Il collegamento viene spostato nel cestino e interrompe il reindirizzamento. Può essere ripristinato dal cestino in Linkly.
Istruzioni per la distribuzione
- Nel portale di creazione aprire Connettori personalizzati, scegliere Nuovo connettore personalizzato e quindi Importare un file OpenAPI. Seleziona
apiDefinition.swagger.json. - Nella scheda Sicurezza scegliere OAuth 2.0 con il provider di identità Oauth 2 generico . Immettere l'ID client e il segreto client rilasciati da Linkly, impostare l'URL di autorizzazione su
https://app.linklyhq.com/oauth/authorizee impostare sia l'URL del token che l'URL di aggiornamento suhttps://app.linklyhq.com/oauth/token. - Creare il connettore, quindi copiare l'URL di reindirizzamento visualizzato nella scheda Sicurezza e registrarlo con Linkly per l'ID client.
- Creare una connessione accedendo con l'account Linkly e quindi testare un'azione, ad esempio Elenca le aree di lavoro.
Azioni
| Collegamenti elenco |
Restituisce un elenco impaginato dei collegamenti in un'area di lavoro, con statistiche di clic. Supporta la ricerca e l'ordinamento. |
| Creare o aggiornare un collegamento |
Crea un nuovo collegamento breve o ne aggiorna uno esistente quando viene fornito un ID collegamento. Supporta domini personalizzati e slug, parametri UTM, retargeting pixel e metadati Open Graph. |
| Elencare domini personalizzati |
Restituisce i domini personalizzati configurati per un'area di lavoro. Questi nomi di dominio possono essere usati durante la creazione di collegamenti. |
| Elencare le aree di lavoro |
Restituisce le aree di lavoro disponibili per questa connessione. Usarlo per trovare l'area di lavoro necessaria per altre azioni. |
| Elencare le conversioni |
Restituisce le conversioni più recenti registrate nell'area di lavoro. |
| Eliminare un collegamento |
Sposta un collegamento nel cestino. L'URL breve smette di reindirizzare e il collegamento può essere ripristinato in un secondo momento dal cestino. |
| Ottenere i conteggi dei clic per dimensione |
Restituisce i conteggi dei clic raggruppati in base a una dimensione, ad esempio paese, città, piattaforma, referrer o parametro UTM, ordinati in base al conteggio decrescente. |
| Ottenere l'analisi dei clic |
Restituisce i conteggi dei clic nel tempo per un'area di lavoro o per collegamenti specifici, filtrati facoltativamente per intervallo di date, paese, browser, piattaforma, referrer o ISP. |
| Ottenere un collegamento |
Recupera un singolo collegamento in base al relativo ID, inclusa la destinazione, l'URL breve e la configurazione. |
| Segnalare una conversione |
Registra una conversione, ad esempio un acquisto, un evento di iscrizione o personalizzato e lo assegna al collegamento selezionato quando viene fornito un token di attribuzione. |
Collegamenti elenco
Restituisce un elenco impaginato dei collegamenti in un'area di lavoro, con statistiche di clic. Supporta la ricerca e l'ordinamento.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Workspace
|
workspace_id | True | string |
Area di lavoro in cui lavorare. Scegliere l'id dall'elenco oppure immetterne l'ID. |
|
Search
|
search | string |
Termine di ricerca per filtrare i collegamenti in base al nome, all'URL o al slug. |
|
|
Pagina
|
page | integer |
Numero di pagina da restituire, a partire da 1. |
|
|
Dimensioni pagina
|
page_size | integer |
Numero di collegamenti da restituire per pagina. |
|
|
Ordina per
|
sort_by | string |
Campo in base al quale eseguire l'ordinamento, ad esempio clicks_total, nome o inserted_at. |
|
|
Direzione ordinamento
|
sort_dir | string |
Direzione di ordinamento, asc o desc. |
|
|
Eliminato
|
deleted | boolean |
Indica se restituire i collegamenti presenti nel cestino anziché i collegamenti attivi. |
Valori restituiti
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Links
|
links | array of object |
Collegamenti in questa pagina. |
|
Meta Pixel ID
|
links.fb_pixel_id | string |
Id pixel Meta (Facebook) da attivare quando si fa clic sul collegamento. |
|
Totale clic umani
|
links.human_clicks_total | integer |
La durata fa clic senza segnale bot; il subset di clicks_total in cui non è stato rilevato né un agente utente bot né una categoria di bot verificato. Registrato dal 2019 in poi. |
|
Clic (30 giorni)
|
links.clicks_thirty_days | integer |
Fa clic negli ultimi 30 giorni, incluso il traffico del bot. |
|
TikTok Pixel ID
|
links.tiktok_pixel_id | string |
ID pixel TikTok da attivare quando si fa clic sul collegamento. |
|
Nascondi referrer
|
links.hide_referrer | boolean |
Indica se nascondere il referrer dal sito di destinazione. |
|
Occultamento
|
links.cloaking | boolean |
Indica se nascondere la destinazione aprendola all'interno di un frame. |
|
URL breve
|
links.full_url | uri |
URL di collegamento breve completo. |
|
Clic su Oggi
|
links.clicks_today | integer |
Fa clic finora (UTC), incluso il traffico del bot. |
|
Apri descrizione grafico
|
links.og_description | string |
Descrizione visualizzata quando il collegamento viene condiviso sui social media. |
|
Tag corpo
|
links.body_tags | string |
Tag HTML o di rilevamento personalizzati inseriti nel corpo della pagina di reindirizzamento. |
|
Apri titolo grafico
|
links.og_title | string |
Titolo visualizzato quando il collegamento viene condiviso sui social media. |
|
Note
|
links.note | string |
Nota privata sul collegamento. |
|
Name
|
links.name | string |
Nome alternativo per il collegamento, visualizzato nel dashboard. |
|
ID collegamento
|
links.id | integer |
Identificatore univoco del collegamento. |
|
Google Tag Manager ID
|
links.gtm_id | string |
ID contenitore di Google Tag Manager da caricare quando si fa clic sul collegamento. |
|
Apri immagine grafico
|
links.og_image | string |
URL dell'immagine visualizzato quando il collegamento viene condiviso sui social media. |
|
Blocca bot
|
links.block_bots | boolean |
Indica se bloccare i bot noti a seguire il collegamento. |
|
Totale clic
|
links.clicks_total | integer |
Clic sulla durata, incluso il traffico del bot. |
|
Clic umani (30 giorni)
|
links.human_clicks_thirty_days | integer |
Fa clic negli ultimi 30 giorni senza segnale bot; subset di clicks_thirty_days. |
|
Contenuto UTM
|
links.utm_content | string |
Parametro utm_content aggiunto all'URL di destinazione. |
|
Clic umani oggi
|
links.human_clicks_today | integer |
Fa clic finora (UTC) senza segnale bot. |
|
Enabled
|
links.enabled | boolean |
Indica se il collegamento è attivo. |
|
URL di destinazione
|
links.url | uri |
URL di destinazione a cui reindirizza il collegamento breve. |
|
Eliminato
|
links.deleted | boolean |
Indica se il collegamento si trova nel cestino. |
|
ID dell'area di lavoro
|
links.workspace_id | integer |
ID dell'area di lavoro. |
|
Analisi pubblica
|
links.public_analytics | boolean |
Indica se la pagina di analisi per il collegamento è visualizzabile pubblicamente. |
|
Origine UTM
|
links.utm_source | string |
Parametro utm_source aggiunto all'URL di destinazione. |
|
Slug
|
links.slug | string |
Percorso personalizzato per il collegamento breve. Deve iniziare con una barra. |
|
Domain
|
links.domain | string |
Dominio personalizzato da utilizzare per il collegamento breve, senza barra finale. |
|
Parametri di inoltro
|
links.forward_params | boolean |
Indica se inoltrare i parametri di query dal collegamento breve alla destinazione. |
|
UTM Medium
|
links.utm_medium | string |
Parametro utm_medium aggiunto all'URL di destinazione. |
|
Tag head
|
links.head_tags | string |
Tag HTML o di rilevamento personalizzati inseriti nell'intestazione della pagina di reindirizzamento. |
|
Google Analytics 4 Tag ID
|
links.ga4_tag_id | string |
ID misura di Google Analytics 4 da attivare quando si fa clic sul collegamento. |
|
Termine UTM
|
links.utm_term | string |
Parametro utm_term aggiunto all'URL di destinazione. |
|
Campagna UTM
|
links.utm_campaign | string |
Parametro utm_campaign aggiunto all'URL di destinazione. |
|
Clic umani ieri
|
links.human_clicks_previous_day | integer |
Fa clic ieri (UTC) senza segnale bot. |
|
Numero pagina
|
page_number | integer |
Numero di pagina corrente. |
|
Dimensioni pagina
|
page_size | integer |
Numero di collegamenti da restituire per pagina. |
|
Totale voci
|
total_entries | integer |
Numero totale di collegamenti corrispondenti alla richiesta. |
|
Totale pagine
|
total_pages | integer |
Numero totale di pagine disponibili. |
|
Righe totali
|
total_rows | integer |
Numero totale di righe. |
|
Conteggio collegamenti area di lavoro
|
workspace_link_count | integer |
Numero totale di collegamenti nell'area di lavoro. |
Creare o aggiornare un collegamento
Crea un nuovo collegamento breve o ne aggiorna uno esistente quando viene fornito un ID collegamento. Supporta domini personalizzati e slug, parametri UTM, retargeting pixel e metadati Open Graph.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
URL di destinazione
|
url | uri |
URL di destinazione a cui reindirizza il collegamento breve. Obbligatorio per creare un nuovo collegamento. |
|
|
ID collegamento
|
id | integer |
ID di un collegamento esistente da aggiornare. Lasciare vuoto per creare un nuovo collegamento. |
|
|
Name
|
name | string |
Nome alternativo per il collegamento, visualizzato nel dashboard. |
|
|
Domain
|
domain | string |
Dominio personalizzato da utilizzare per il collegamento breve, senza barra finale. |
|
|
Slug
|
slug | string |
Percorso personalizzato per il collegamento breve. Deve iniziare con una barra. |
|
|
Enabled
|
enabled | boolean |
Indica se il collegamento è attivo. |
|
|
Note
|
note | string |
Nota privata sul collegamento. |
|
|
Origine UTM
|
utm_source | string |
Parametro utm_source aggiunto all'URL di destinazione. |
|
|
UTM Medium
|
utm_medium | string |
Parametro utm_medium aggiunto all'URL di destinazione. |
|
|
Campagna UTM
|
utm_campaign | string |
Parametro utm_campaign aggiunto all'URL di destinazione. |
|
|
Contenuto UTM
|
utm_content | string |
Parametro utm_content aggiunto all'URL di destinazione. |
|
|
Termine UTM
|
utm_term | string |
Parametro utm_term aggiunto all'URL di destinazione. |
|
|
Meta Pixel ID
|
fb_pixel_id | string |
Id pixel Meta (Facebook) da attivare quando si fa clic sul collegamento. |
|
|
Google Analytics 4 Tag ID
|
ga4_tag_id | string |
ID misura di Google Analytics 4 da attivare quando si fa clic sul collegamento. |
|
|
Google Tag Manager ID
|
gtm_id | string |
ID contenitore di Google Tag Manager da caricare quando si fa clic sul collegamento. |
|
|
Blocca bot
|
block_bots | boolean |
Indica se bloccare i bot noti a seguire il collegamento. |
|
|
Tag corpo
|
body_tags | string |
Tag HTML o di rilevamento personalizzati inseriti nel corpo della pagina di reindirizzamento. |
|
|
Occultamento
|
cloaking | boolean |
Indica se nascondere la destinazione aprendola all'interno di un frame. |
|
|
Parametri di inoltro
|
forward_params | boolean |
Indica se inoltrare i parametri di query dal collegamento breve alla destinazione. |
|
|
Tag head
|
head_tags | string |
Tag HTML o di rilevamento personalizzati inseriti nell'intestazione della pagina di reindirizzamento. |
|
|
Nascondi referrer
|
hide_referrer | boolean |
Indica se nascondere il referrer dal sito di destinazione. |
|
|
Apri descrizione grafico
|
og_description | string |
Descrizione visualizzata quando il collegamento viene condiviso sui social media. |
|
|
Apri immagine grafico
|
og_image | string |
URL dell'immagine visualizzato quando il collegamento viene condiviso sui social media. |
|
|
Apri titolo grafico
|
og_title | string |
Titolo visualizzato quando il collegamento viene condiviso sui social media. |
|
|
TikTok Pixel ID
|
tiktok_pixel_id | string |
ID pixel TikTok da attivare quando si fa clic sul collegamento. |
Valori restituiti
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Meta Pixel ID
|
fb_pixel_id | string |
Id pixel Meta (Facebook) da attivare quando si fa clic sul collegamento. |
|
ID partner LinkedIn
|
linkedin_partner_id | string |
Id partner tag di LinkedIn informazioni dettagliate da attivare quando si fa clic sul collegamento. |
|
ID tag UET Microsoft
|
microsoft_uet_tag_id | string |
Id tag UET Microsoft Advertising da attivare quando si fa clic sul collegamento. |
|
Reddit Pixel ID
|
reddit_pixel_id | string |
ID pixel Reddit da attivare quando si fa clic sul collegamento. |
|
TikTok Pixel ID
|
tiktok_pixel_id | string |
ID pixel TikTok da attivare quando si fa clic sul collegamento. |
|
Nascondi referrer
|
hide_referrer | boolean |
Indica se nascondere il referrer dal sito di destinazione. |
|
Data di scadenza
|
expiry_datetime | string |
Quando il collegamento smette di funzionare, in formato ISO 8601. |
|
Destinazione scadenza
|
expiry_destination | uri |
URL a cui eseguire il reindirizzamento dopo la scadenza del collegamento. Lasciare vuoto per restituire una pagina non trovata. |
|
X Pixel ID
|
twitter_pixel_id | string |
ID pixel X (Twitter) da attivare quando si fa clic sul collegamento. |
|
Occultamento
|
cloaking | boolean |
Indica se nascondere la destinazione aprendola all'interno di un frame. |
|
URL breve
|
full_url | uri |
URL di collegamento breve completo. |
|
Apri descrizione grafico
|
og_description | string |
Descrizione visualizzata quando il collegamento viene condiviso sui social media. |
|
Ignorare il rilevamento di social crawler
|
skip_social_crawler_tracking | boolean |
Indica se escludere i crawler di anteprima dei social media dal rilevamento dei clic. |
|
Tag corpo
|
body_tags | string |
Tag HTML o di rilevamento personalizzati inseriti nel corpo della pagina di reindirizzamento. |
|
Apri titolo grafico
|
og_title | string |
Titolo visualizzato quando il collegamento viene condiviso sui social media. |
|
Note
|
note | string |
Nota privata sul collegamento. |
|
Name
|
name | string |
Nome alternativo per il collegamento, visualizzato nel dashboard. |
|
ID collegamento
|
id | integer |
ID di un collegamento esistente da aggiornare. Lasciare vuoto per creare un nuovo collegamento. |
|
Google Tag Manager ID
|
gtm_id | string |
ID contenitore di Google Tag Manager da caricare quando si fa clic sul collegamento. |
|
Apri immagine grafico
|
og_image | string |
URL dell'immagine visualizzato quando il collegamento viene condiviso sui social media. |
|
Blocca bot
|
block_bots | boolean |
Indica se bloccare i bot noti a seguire il collegamento. |
|
Snapchat Pixel ID
|
snapchat_pixel_id | string |
L'ID pixel di Snapchat da attivare quando si fa clic sul collegamento. |
|
Contenuto UTM
|
utm_content | string |
Parametro utm_content aggiunto all'URL di destinazione. |
|
Enabled
|
enabled | boolean |
Indica se il collegamento è attivo. |
|
URL di destinazione
|
url | uri |
URL di destinazione a cui reindirizza il collegamento breve. Obbligatorio per creare un nuovo collegamento. |
|
Eliminato
|
deleted | boolean |
Indica se il collegamento si trova nel cestino. |
|
Webhooks
|
webhooks | array of string |
Gli URL del webhook sottoscritti per fare clic su questo collegamento. |
|
Clic sulla scadenza
|
expiry_clicks | integer |
Numero di clic dopo il quale il collegamento smette di funzionare. |
|
Inviare una notifica a Slack
|
notify_slack | boolean |
Indica se inviare una notifica di Slack quando si fa clic sul collegamento. |
|
ID dell'area di lavoro
|
workspace_id | integer |
ID dell'area di lavoro. |
|
Analisi pubblica
|
public_analytics | boolean |
Indica se la pagina di analisi per il collegamento è visualizzabile pubblicamente. |
|
Pinterest Tag ID
|
pinterest_tag_id | string |
ID tag Pinterest da attivare quando si fa clic sul collegamento. |
|
Origine UTM
|
utm_source | string |
Parametro utm_source aggiunto all'URL di destinazione. |
|
Slug
|
slug | string |
Percorso personalizzato per il collegamento breve. Deve iniziare con una barra. |
|
Domain
|
domain | string |
Dominio personalizzato da utilizzare per il collegamento breve, senza barra finale. |
|
Parametri di inoltro
|
forward_params | boolean |
Indica se inoltrare i parametri di query dal collegamento breve alla destinazione. |
|
UTM Medium
|
utm_medium | string |
Parametro utm_medium aggiunto all'URL di destinazione. |
|
Tag head
|
head_tags | string |
Tag HTML o di rilevamento personalizzati inseriti nell'intestazione della pagina di reindirizzamento. |
|
Google Analytics 4 Tag ID
|
ga4_tag_id | string |
ID misura di Google Analytics 4 da attivare quando si fa clic sul collegamento. |
|
Termine UTM
|
utm_term | string |
Parametro utm_term aggiunto all'URL di destinazione. |
|
Campagna UTM
|
utm_campaign | string |
Parametro utm_campaign aggiunto all'URL di destinazione. |
Elencare domini personalizzati
Restituisce i domini personalizzati configurati per un'area di lavoro. Questi nomi di dominio possono essere usati durante la creazione di collegamenti.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Workspace
|
workspace_id | True | string |
Area di lavoro in cui lavorare. Scegliere l'id dall'elenco oppure immetterne l'ID. |
Valori restituiti
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Domains
|
domains | array of object |
Domini personalizzati nell'area di lavoro. |
|
Nome dominio
|
domains.name | string |
Nome di dominio, ad esempio go.yourcompany.com. |
Elencare le aree di lavoro
Restituisce le aree di lavoro disponibili per questa connessione. Usarlo per trovare l'area di lavoro necessaria per altre azioni.
Valori restituiti
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
|
array of object | ||
|
ID dell'area di lavoro
|
id | integer |
Identificatore univoco dell'area di lavoro. |
|
Nome area di lavoro
|
name | string |
Nome dell'area di lavoro. |
Elencare le conversioni
Restituisce le conversioni più recenti registrate nell'area di lavoro.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Limit
|
limit | integer |
Numero massimo di conversioni da restituire, compreso tra 1 e 1000. |
Valori restituiti
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Conversions
|
conversions | array of object |
Le conversioni, la prima più recente. |
|
Amount (Cents)
|
conversions.amount_cents | integer |
Valore nell'unità di valuta più piccola. Può essere negativo registrare un rimborso. |
|
Fare clic su ID
|
conversions.click_id | string |
ID del clic con attributi. |
|
Country
|
conversions.country | string |
Codice paese ISO 3166-1 a due lettere, ad esempio Stati Uniti. |
|
Valuta
|
conversions.currency | string |
Il codice valuta ISO 4217. Il valore predefinito è USD. |
|
ID evento
|
conversions.event_id | string |
Identificatore dell'evento. La segnalazione dello stesso valore due volte non crea una seconda conversione. |
|
Nome evento
|
conversions.event_name | string |
Cosa è successo, ad esempio acquistare, iscriversi o trial_started. |
|
Tipo di evento
|
conversions.event_type | string |
Tipo di evento grossolano. Usare il lead per stabilire l'identità e la vendita dei clienti per registrare i ricavi. L'impostazione predefinita è personalizzata. |
|
ID cliente
|
conversions.external_id | string |
Identificatore del cliente. Inviarlo a ogni evento in modo che le vendite successive possano essere collegate al clic originale. |
|
ID conversione
|
conversions.id | string |
Identificatore univoco della conversione. Gli ID ordinano cronologicamente. |
|
Inserito all'indirizzo
|
conversions.inserted_at | date-time |
Quando è stata registrata la conversione. |
|
Origine IP
|
conversions.ip_source | string |
Il cui indirizzo è stato registrato: visitatore, server o sconosciuto. Il server indica che l'indirizzo di connessione appartiene al back-end o a un inoltro della piattaforma, quindi viene escluso dalla creazione di report geografici. |
|
ID collegamento
|
conversions.link_id | integer |
ID del collegamento con attributi o Null se non è stato possibile attribuire la conversione a un collegamento. |
|
Metadata
|
conversions.metadata | object |
Metadati JSON arbitrari, fino a 10.000 byte. |
|
Si è verificato all'indirizzo
|
conversions.occurred_at | date-time |
Quando si verifica la conversione, in formato ISO 8601. Il valore predefinito è ora. |
|
Source
|
conversions.source | string |
Quale integrazione lo ha segnalato. |
Eliminare un collegamento
Sposta un collegamento nel cestino. L'URL breve smette di reindirizzare e il collegamento può essere ripristinato in un secondo momento dal cestino.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Workspace
|
workspace_id | True | string |
Area di lavoro in cui lavorare. Scegliere l'id dall'elenco oppure immetterne l'ID. |
|
ID collegamento
|
id | True | integer |
ID del collegamento. |
Valori restituiti
Messaggio di conferma.
- response
- string
Ottenere i conteggi dei clic per dimensione
Restituisce i conteggi dei clic raggruppati in base a una dimensione, ad esempio paese, città, piattaforma, referrer o parametro UTM, ordinati in base al conteggio decrescente.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Workspace
|
workspace_id | True | string |
Area di lavoro in cui lavorare. Scegliere l'id dall'elenco oppure immetterne l'ID. |
|
Dimension
|
counter | True | string |
Dimensione in base a cui raggruppare clic, ad esempio paese, città, piattaforma, referer o utm_campaign. |
|
ID collegamento
|
link_id | string |
ID di un singolo collegamento da filtrare. |
|
|
ID collegamento
|
link_ids | string |
Elenco delimitato da trattini di ID collegamento da filtrare. |
|
|
Data di inizio
|
start | string |
Inizio dell'intervallo di date, in formato AAAA-MM-DD. |
|
|
Data di fine
|
end | string |
Fine dell'intervallo di date, in formato AAAA-MM-DD. |
|
|
Country
|
country | string |
Codice paese ISO 3166-1 a due lettere, ad esempio Stati Uniti. |
|
|
Includere bot
|
bots | boolean |
Indica se includere clic identificati come bot. Impostare su false per escluderli. |
|
|
Solo univoco
|
unique | boolean |
Indica se contare solo clic univoci. |
Valori restituiti
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Total
|
total | integer |
I clic totali in tutti i gruppi, inclusi quelli non restituiti nei valori. Quando il risultato viene troncato, questo valore è maggiore della somma del conteggio in valori, quindi count/total restituisce comunque una percentuale accurata. |
|
Values
|
values | array of object |
Conteggi raggruppati, ordinati in base al numero decrescente. Troncato ai primi 10.000 valori; se la dimensione ha valori più distinti di quello, il resto non viene restituito. |
|
Conteggio
|
values.count | integer |
Numero di clic per questo valore. |
|
Value
|
values.value | string |
Valore della dimensione, ad esempio un codice paese. |
Ottenere l'analisi dei clic
Restituisce i conteggi dei clic nel tempo per un'area di lavoro o per collegamenti specifici, filtrati facoltativamente per intervallo di date, paese, browser, piattaforma, referrer o ISP.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Workspace
|
workspace_id | True | string |
Area di lavoro in cui lavorare. Scegliere l'id dall'elenco oppure immetterne l'ID. |
|
ID collegamento
|
link_id | string |
ID di un singolo collegamento da filtrare. |
|
|
ID collegamento
|
link_ids | string |
Elenco delimitato da trattini di ID collegamento da filtrare. |
|
|
Data di inizio
|
start | string |
Inizio dell'intervallo di date, in formato AAAA-MM-DD. |
|
|
Data di fine
|
end | string |
Fine dell'intervallo di date, in formato AAAA-MM-DD. |
|
|
Country
|
country | string |
Codice paese ISO 3166-1 a due lettere, ad esempio Stati Uniti. |
|
|
Browser
|
browser | string |
Nome del browser da filtrare, ad esempio Chrome, Firefox o Safari. |
|
|
Platform
|
platform | string |
Una piattaforma o un sistema operativo da filtrare, ad esempio Windows, Mac, iOS o Android. |
|
|
Sorgente di riferimento
|
referer | string |
Un dominio di riferimento in base a cui filtrare. |
|
|
ISP (Fornitore di Servizi Internet)
|
isp | string |
Nome del provider di servizi Internet da filtrare. |
|
|
Includere bot
|
bots | boolean |
Indica se includere clic identificati come bot. Impostare su false per escluderli. |
|
|
Solo univoco
|
unique | boolean |
Indica se contare solo clic univoci. |
|
|
Fuso orario
|
timezone | string |
Fuso orario IANA usato per i calcoli di data, ad esempio Europa/Londra. |
|
|
Frequenza
|
frequency | string |
Granularità della serie temporale, giorno o ora. |
Valori restituiti
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Traffic
|
traffic | array of object |
Il clic conta nel tempo. |
|
Avvio bucket
|
traffic.t | string |
Inizio bucket: AAAA-MM-DD per bucket giornalieri o AAAA-MM-GGTHH:MM:SS per bucket orari. |
|
Clic
|
traffic.y | integer |
Numero di clic nel bucket. |
Ottenere un collegamento
Recupera un singolo collegamento in base al relativo ID, inclusa la destinazione, l'URL breve e la configurazione.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
ID collegamento
|
id | True | string |
ID del collegamento. |
Valori restituiti
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Meta Pixel ID
|
fb_pixel_id | string |
Id pixel Meta (Facebook) da attivare quando si fa clic sul collegamento. |
|
ID partner LinkedIn
|
linkedin_partner_id | string |
Id partner tag di LinkedIn informazioni dettagliate da attivare quando si fa clic sul collegamento. |
|
ID tag UET Microsoft
|
microsoft_uet_tag_id | string |
Id tag UET Microsoft Advertising da attivare quando si fa clic sul collegamento. |
|
Reddit Pixel ID
|
reddit_pixel_id | string |
ID pixel Reddit da attivare quando si fa clic sul collegamento. |
|
TikTok Pixel ID
|
tiktok_pixel_id | string |
ID pixel TikTok da attivare quando si fa clic sul collegamento. |
|
Nascondi referrer
|
hide_referrer | boolean |
Indica se nascondere il referrer dal sito di destinazione. |
|
Data di scadenza
|
expiry_datetime | string |
Quando il collegamento smette di funzionare, in formato ISO 8601. |
|
Destinazione scadenza
|
expiry_destination | uri |
URL a cui eseguire il reindirizzamento dopo la scadenza del collegamento. Lasciare vuoto per restituire una pagina non trovata. |
|
X Pixel ID
|
twitter_pixel_id | string |
ID pixel X (Twitter) da attivare quando si fa clic sul collegamento. |
|
Occultamento
|
cloaking | boolean |
Indica se nascondere la destinazione aprendola all'interno di un frame. |
|
URL breve
|
full_url | uri |
URL di collegamento breve completo. |
|
Apri descrizione grafico
|
og_description | string |
Descrizione visualizzata quando il collegamento viene condiviso sui social media. |
|
Ignorare il rilevamento di social crawler
|
skip_social_crawler_tracking | boolean |
Indica se escludere i crawler di anteprima dei social media dal rilevamento dei clic. |
|
Tag corpo
|
body_tags | string |
Tag HTML o di rilevamento personalizzati inseriti nel corpo della pagina di reindirizzamento. |
|
Apri titolo grafico
|
og_title | string |
Titolo visualizzato quando il collegamento viene condiviso sui social media. |
|
Note
|
note | string |
Nota privata sul collegamento. |
|
Name
|
name | string |
Nome alternativo per il collegamento, visualizzato nel dashboard. |
|
ID collegamento
|
id | integer |
Identificatore univoco del collegamento. |
|
Google Tag Manager ID
|
gtm_id | string |
ID contenitore di Google Tag Manager da caricare quando si fa clic sul collegamento. |
|
Apri immagine grafico
|
og_image | string |
URL dell'immagine visualizzato quando il collegamento viene condiviso sui social media. |
|
Blocca bot
|
block_bots | boolean |
Indica se bloccare i bot noti a seguire il collegamento. |
|
Snapchat Pixel ID
|
snapchat_pixel_id | string |
L'ID pixel di Snapchat da attivare quando si fa clic sul collegamento. |
|
Contenuto UTM
|
utm_content | string |
Parametro utm_content aggiunto all'URL di destinazione. |
|
Enabled
|
enabled | boolean |
Indica se il collegamento è attivo. |
|
URL di destinazione
|
url | uri |
URL di destinazione a cui reindirizza il collegamento breve. |
|
Eliminato
|
deleted | boolean |
Indica se il collegamento si trova nel cestino. |
|
Webhooks
|
webhooks | array of string |
Gli URL del webhook sottoscritti per fare clic su questo collegamento. |
|
Clic sulla scadenza
|
expiry_clicks | integer |
Numero di clic dopo il quale il collegamento smette di funzionare. |
|
Inviare una notifica a Slack
|
notify_slack | boolean |
Indica se inviare una notifica di Slack quando si fa clic sul collegamento. |
|
ID dell'area di lavoro
|
workspace_id | integer |
ID dell'area di lavoro. |
|
Analisi pubblica
|
public_analytics | boolean |
Indica se la pagina di analisi per il collegamento è visualizzabile pubblicamente. |
|
Pinterest Tag ID
|
pinterest_tag_id | string |
ID tag Pinterest da attivare quando si fa clic sul collegamento. |
|
Origine UTM
|
utm_source | string |
Parametro utm_source aggiunto all'URL di destinazione. |
|
Slug
|
slug | string |
Percorso personalizzato per il collegamento breve. Deve iniziare con una barra. |
|
Domain
|
domain | string |
Dominio personalizzato da utilizzare per il collegamento breve, senza barra finale. |
|
Parametri di inoltro
|
forward_params | boolean |
Indica se inoltrare i parametri di query dal collegamento breve alla destinazione. |
|
UTM Medium
|
utm_medium | string |
Parametro utm_medium aggiunto all'URL di destinazione. |
|
Tag head
|
head_tags | string |
Tag HTML o di rilevamento personalizzati inseriti nell'intestazione della pagina di reindirizzamento. |
|
Google Analytics 4 Tag ID
|
ga4_tag_id | string |
ID misura di Google Analytics 4 da attivare quando si fa clic sul collegamento. |
|
Termine UTM
|
utm_term | string |
Parametro utm_term aggiunto all'URL di destinazione. |
|
Campagna UTM
|
utm_campaign | string |
Parametro utm_campaign aggiunto all'URL di destinazione. |
Segnalare una conversione
Registra una conversione, ad esempio un acquisto, un evento di iscrizione o personalizzato e lo assegna al collegamento selezionato quando viene fornito un token di attribuzione.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Amount (Cents)
|
amount_cents | integer |
Valore nell'unità di valuta più piccola. Può essere negativo registrare un rimborso o un chargeback, che netto rispetto ai ricavi precedenti. |
|
|
Country
|
country | string |
Codice paese a due lettere per la conversione. Dedotto per le chiamate sul lato browser; fornire in modo esplicito da un'integrazione lato server, in cui l'indirizzo di connessione è la propria infrastruttura anziché quella del cliente. |
|
|
Valuta
|
currency | string |
Codice valuta ISO 4217. Il valore predefinito è USD. |
|
|
ID evento
|
event_id | string |
Identificatore per questo evento. Usato come chiave di idempotenza; la segnalazione dello stesso valore due volte non creerà una seconda conversione. Si applica a qualsiasi tipo di evento, non solo agli acquisti. |
|
|
Nome evento
|
event_name | True | string |
Cosa è successo, ad esempio acquistare, iscriversi, trial_started. |
|
Tipo di evento
|
event_type | string |
Tipo grossolano che guida il imbuto. lead stabilisce l'identità del cliente, i record di vendita. L'impostazione predefinita è personalizzata. |
|
|
ID cliente
|
external_id | string |
Identificatore del cliente. Inviarlo a ogni evento: è ciò che collega una vendita sul lato server successiva al clic che ha generato l'iscrizione. |
|
|
Token di attribuzione
|
linkly_cid | string |
Token di attribuzione acquisito dall'URL della pagina di destinazione. Omettere se non disponibile; la conversione viene quindi registrata senza attribuzione di collegamenti. |
|
|
Metadata
|
metadata | object |
JSON arbitrario, con codifica fino a 10.000 byte. |
|
|
Si è verificato all'indirizzo
|
occurred_at | date-time |
Quando la conversione è avvenuta. Il valore predefinito è ora. |
|
|
IP visitatore
|
visitor_ip | string |
INDIRIZZO IP del cliente finale, quando il server lo ha. Omettere a meno che tu non lo faccia; per le chiamate sul lato server Linkly registra in caso contrario l'indirizzo di connessione come server, non il cliente e lo esclude dalla creazione di report geografici. L'invio di queste affermazioni ha una base legale per condividerlo. Non restituito mai dall'API. |
Valori restituiti
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Amount (Cents)
|
amount_cents | integer |
Valore nell'unità di valuta più piccola. Può essere negativo registrare un rimborso. |
|
Fare clic su ID
|
click_id | string |
ID del clic con attributi. |
|
Country
|
country | string |
Codice paese ISO 3166-1 a due lettere, ad esempio Stati Uniti. |
|
Valuta
|
currency | string |
Il codice valuta ISO 4217. Il valore predefinito è USD. |
|
ID evento
|
event_id | string |
Identificatore dell'evento. La segnalazione dello stesso valore due volte non crea una seconda conversione. |
|
Nome evento
|
event_name | string |
Cosa è successo, ad esempio acquistare, iscriversi o trial_started. |
|
Tipo di evento
|
event_type | string |
Tipo di evento grossolano. Usare il lead per stabilire l'identità e la vendita dei clienti per registrare i ricavi. L'impostazione predefinita è personalizzata. |
|
ID cliente
|
external_id | string |
Identificatore del cliente. Inviarlo a ogni evento in modo che le vendite successive possano essere collegate al clic originale. |
|
ID conversione
|
id | string |
Identificatore univoco della conversione. Gli ID ordinano cronologicamente. |
|
Inserito all'indirizzo
|
inserted_at | date-time |
Quando è stata registrata la conversione. |
|
Origine IP
|
ip_source | string |
Il cui indirizzo è stato registrato: visitatore, server o sconosciuto. Il server indica che l'indirizzo di connessione appartiene al back-end o a un inoltro della piattaforma, quindi viene escluso dalla creazione di report geografici. |
|
ID collegamento
|
link_id | integer |
ID del collegamento con attributi o Null se non è stato possibile attribuire la conversione a un collegamento. |
|
Metadata
|
metadata | object |
Metadati JSON arbitrari, fino a 10.000 byte. |
|
Si è verificato all'indirizzo
|
occurred_at | date-time |
Quando si verifica la conversione, in formato ISO 8601. Il valore predefinito è ora. |
|
Source
|
source | string |
Quale integrazione lo ha segnalato. |
Definizioni
string
Si tratta del tipo di dati di base 'string'.