Linkly (Vorschau)
Linkly ist ein Linkkürzung und Klickverfolgung. Erstellen Sie Brandinglinks mit benutzerdefinierten Domänen, fügen Sie UTM-Parameter hinzu, und fügen Sie Pixel neu an, melden Sie Konvertierungen und Pull-Click-Analysen nach Land, Plattform, Referrer oder Kampagne gruppiert.
Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:
| Dienst | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Alle Power Automate Regionen mit Ausnahme der folgenden: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Logik-Apps | Standard | Alle Logik-Apps-Regionen mit Ausnahme der folgenden Bereiche: - Azure Government Regionen - Azure China-Regionen - US Department of Defense (DoD) |
| Power Apps | Premium | Alle Power Apps Regionen mit Ausnahme der folgenden: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Power Automate | Premium | Alle Power Automate Regionen mit Ausnahme der folgenden: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Kontakt | |
|---|---|
| Name | Linkly Support |
| URL | https://linklyhq.com/support |
| support@linklyhq.com |
| Connectormetadaten | |
|---|---|
| Herausgeber | Linkly |
| Website | https://linklyhq.com |
| Datenschutzrichtlinie | https://linklyhq.com/support/privacy |
| Kategorien | Marketing; Website |
Linkly
Linkly ist ein Linkkürzung und Klickverfolgung. Es erstellt brandingierte kurze Links auf Ihrer eigenen Domäne, verfolgt jeden Klick mit Land, Plattform und Referrer-Aufschlüsselungen, löst retargeting Pixel und zeichnet Konvertierungen zurück auf den Link, der sie erzeugt hat. Mit diesem Connector können Flüsse Links erstellen und verwalten, Klickanalysen abrufen und Konvertierungen in einem Linkly-Arbeitsbereich melden.
Publisher: Linkly
Prerequisites
Ein Linkly-Konto . Der kostenlose Plan reicht aus, um jede Aktion in diesem Connector zu verwenden. Für Berichte und Auflistungskonvertierungen muss auch das Feature "Linkly conversion tracking" im Arbeitsbereich aktiviert sein.
Unterstützte Vorgänge
Arbeitsbereiche auflisten
Gibt die Arbeitsbereiche zurück, die für diese Verbindung verfügbar sind. Verwenden Sie ihn, um den Arbeitsbereich zu finden, den andere Aktionen erfordern.
Erstellen oder Aktualisieren eines Links
Erstellt einen neuen kurzen Link oder aktualisiert eine vorhandene Verknüpfung, wenn eine Link-ID angegeben wird. Unterstützt benutzerdefinierte Domänen und Slugs, UTM-Parameter, Retargeting Pixel und Open Graph-Metadaten.
Einen Link erhalten
Ruft einen einzelnen Link anhand seiner ID ab, einschließlich ziel, kurzer URL und Konfiguration.
Listenlinks
Gibt eine paginierte Liste der Verknüpfungen in einem Arbeitsbereich mit Klickstatistiken zurück. Unterstützt die Suche und Sortierung.
Löschen eines Links
Verschiebt einen Link in den Papierkorb. Die kurze URL beendet die Umleitung, und der Link kann später aus dem Papierkorb wiederhergestellt werden.
Click Analytics abrufen
Gibt die Anzahl der Klicks im Laufe der Zeit für einen Arbeitsbereich oder für bestimmte Links zurück, optional nach Datumsbereich, Land, Browser, Plattform, Referrer oder ISP gefiltert.
Abrufen der Anzahl von Klicks nach Dimension
Gibt Klickanzahlen zurück, die nach einer Dimension gruppiert sind, z. B. Land, Stadt, Plattform, Verweiser oder UTM-Parameter, sortiert nach absteigender Anzahl.
Benutzerdefinierte Domänen auflisten
Gibt die benutzerdefinierten Domänen zurück, die für einen Arbeitsbereich konfiguriert sind. Diese Domänennamen können beim Erstellen von Links verwendet werden.
Melden einer Konvertierung
Zeichnet eine Konvertierung auf, z. B. einen Kauf, eine Registrierung oder ein benutzerdefiniertes Ereignis, und attributet sie dem Link, auf den geklickt wurde, wenn ein Attributionstoken bereitgestellt wird.
Listenkonvertierungen
Gibt die zuletzt im Arbeitsbereich aufgezeichneten Konvertierungen zurück.
Abrufen von Anmeldeinformationen
Dieser Connector verwendet OAuth 2.0. Es ist kein API-Schlüssel erforderlich.
- Wenn Sie noch kein Linkly-Konto haben, registrieren Sie sich bei https://linklyhq.com. Der kostenlose Plan funktioniert.
- Wenn Sie eine Verbindung erstellen, wählen Sie "Mit Linkly anmelden " aus, und melden Sie sich mit Ihrem Linkly-Konto an.
- Wählen Sie den Arbeitsbereich aus, den diese Verbindung verwenden soll, wenn Sie dazu aufgefordert werden, und genehmigen Sie dann die Anforderung.
Die Verbindung ist an den von Ihnen ausgewählten Arbeitsbereich gebunden. Um in einem anderen Arbeitsbereich zu arbeiten, erstellen Sie eine zweite Verbindung.
Getting Started
- Erstellen Sie eine Verbindung wie oben beschrieben.
- Fügen Sie eine Linkaktion zu einem Fluss hinzu, geben Sie die Ziel-URL und optional eine benutzerdefinierte Domäne und einen Schrägstrich ein. Die Aktion gibt die kurze URL und die Link-ID zurück.
- Verwenden Sie Listenlinks, "Click Analytics abrufen " oder "Get click counts by dimension ", um Klickdaten zu lesen. Mit Aktionen, die einen Arbeitsbereich ausführen, können Sie ihn aus einer Liste auswählen, die von Listenarbeitsbereichen aufgefüllt wird.
- Um Käufe oder Registrierungen für Links zu attributieren, übergeben Sie den
linkly_cidWert von Ihrer Zielseiten-URL, um eine Konvertierung als Attributionstoken zu melden.
Bekannte Probleme und Einschränkungen
- Eine Verbindung ist an einen einzelnen Linkly-Arbeitsbereich gebunden, der beim Anmelden ausgewählt wurde. Erstellen Sie eine Verbindung pro Arbeitsbereich.
- Melden Sie eine Konvertierung und Listenkonvertierungen , die das Feature "Linkly conversion tracking" erfordern. Arbeitsbereiche ohne diese Aktionen erhalten einen Fehler.
- Echtzeitklick-Webhooks werden nicht als Trigger verfügbar gemacht. Verwenden Sie stattdessen das Webhook-Feature "Linkly" mit einem HTTP-ausgelösten Fluss.
- Die Massenverknüpfung, der Linkexport und die Domänenverwaltung sind in der Linkly-API verfügbar, sind jedoch nicht in diesem Connector enthalten.
- Die API ist eingeschränkt. Get click counts by dimension returns a rate-limit error when the limit is exceeded; Versuchen Sie es nach kurzer Verzögerung erneut.
Häufig gestellte Fragen
In welchem Arbeitsbereich werden meine Aktionen ausgeführt?
Aktionen, die einen Workspace-Parameter ausführen, zeigen eine Liste der Arbeitsbereiche an, die für die Verbindung verfügbar sind. Aktionen ohne einen, z. B. "Link abrufen", "Konvertierung melden " und "Listenkonvertierungen" verwenden den Arbeitsbereich, der an die Verbindung gebunden ist.
Wie verwende ich eine benutzerdefinierte Domäne?
Fügen Sie die Domäne zuerst in Linkly hinzu, und übergeben Sie dann ihren Namen im Feld "Domäne " von "Erstellen" oder aktualisieren Sie einen Link. Benutzerdefinierte Domänen auflisten gibt die namen zurück, die in einem Arbeitsbereich verfügbar sind.
Entfernt ein Link den Link dauerhaft?
No. Die Verknüpfung wird in den Papierkorb verschoben und die Umleitung beendet. Sie kann aus dem Papierkorb in Linkly wiederhergestellt werden.
Bereitstellungsanweisungen
- Öffnen Sie im Maker-Portal benutzerdefinierte Connectors, wählen Sie "Neuer benutzerdefinierter Connector " aus, und importieren Sie dann eine OpenAPI-Datei. Wähle
apiDefinition.swagger.jsonaus. - Wählen Sie auf der Registerkarte "Sicherheit " die Option "OAuth 2.0" mit dem generischen Oauth 2-Identitätsanbieter aus. Geben Sie die client-ID und den geheimen Clientschlüssel ein, die von Linkly ausgestellt wurde, legen Sie die Autorisierungs-URL fest
https://app.linklyhq.com/oauth/authorize, und legen Sie sowohl die Token-URL als auch die Aktualisierungs-URL aufhttps://app.linklyhq.com/oauth/token. - Erstellen Sie den Connector, kopieren Sie dann die auf der Registerkarte "Sicherheit" angezeigte Umleitungs-URL, und registrieren Sie ihn mit Linkly für diese Client-ID.
- Erstellen Sie eine Verbindung, indem Sie sich mit Ihrem Linkly-Konto anmelden, und testen Sie dann eine Aktion wie Listenarbeitsbereiche.
Aktionen
| Abrufen der Anzahl von Klicks nach Dimension |
Gibt Klickanzahlen zurück, die nach einer Dimension gruppiert sind, z. B. Land, Stadt, Plattform, Verweiser oder UTM-Parameter, sortiert nach absteigender Anzahl. |
| Arbeitsbereiche auflisten |
Gibt die Arbeitsbereiche zurück, die für diese Verbindung verfügbar sind. Verwenden Sie ihn, um den Arbeitsbereich zu finden, den andere Aktionen erfordern. |
| Benutzerdefinierte Domänen auflisten |
Gibt die benutzerdefinierten Domänen zurück, die für einen Arbeitsbereich konfiguriert sind. Diese Domänennamen können beim Erstellen von Links verwendet werden. |
| Click Analytics abrufen |
Gibt die Anzahl der Klicks im Laufe der Zeit für einen Arbeitsbereich oder für bestimmte Links zurück, optional nach Datumsbereich, Land, Browser, Plattform, Referrer oder ISP gefiltert. |
| Einen Link erhalten |
Ruft einen einzelnen Link anhand seiner ID ab, einschließlich ziel, kurzer URL und Konfiguration. |
| Erstellen oder Aktualisieren eines Links |
Erstellt einen neuen kurzen Link oder aktualisiert eine vorhandene Verknüpfung, wenn eine Link-ID angegeben wird. Unterstützt benutzerdefinierte Domänen und Slugs, UTM-Parameter, Retargeting Pixel und Open Graph-Metadaten. |
| Listenkonvertierungen |
Gibt die zuletzt im Arbeitsbereich aufgezeichneten Konvertierungen zurück. |
| Listenlinks |
Gibt eine paginierte Liste der Verknüpfungen in einem Arbeitsbereich mit Klickstatistiken zurück. Unterstützt die Suche und Sortierung. |
| Löschen eines Links |
Verschiebt einen Link in den Papierkorb. Die kurze URL beendet die Umleitung, und der Link kann später aus dem Papierkorb wiederhergestellt werden. |
| Melden einer Konvertierung |
Zeichnet eine Konvertierung auf, z. B. einen Kauf, eine Registrierung oder ein benutzerdefiniertes Ereignis, und attributet sie dem Link, auf den geklickt wurde, wenn ein Attributionstoken bereitgestellt wird. |
Abrufen der Anzahl von Klicks nach Dimension
Gibt Klickanzahlen zurück, die nach einer Dimension gruppiert sind, z. B. Land, Stadt, Plattform, Verweiser oder UTM-Parameter, sortiert nach absteigender Anzahl.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Workspace
|
workspace_id | True | string |
Der Arbeitsbereich, in dem sie arbeiten soll. Wählen Sie sie aus der Liste aus, oder geben Sie die ID ein. |
|
Dimension
|
counter | True | string |
Die Dimension zum Gruppieren von Klicks nach Land, Stadt, Plattform, Referer oder utm_campaign. |
|
Link-ID
|
link_id | string |
Die ID einer einzelnen Verknüpfung, nach der gefiltert werden soll. |
|
|
Link-IDs
|
link_ids | string |
Eine durch Trennstrich getrennte Liste von Link-IDs, nach der gefiltert werden soll. |
|
|
Startdatum
|
start | string |
Der Anfang des Datumsbereichs im Format JJJJ-MM-DD. |
|
|
Enddatum
|
end | string |
Das Ende des Datumsbereichs im Format JJJJ-MM-DD. |
|
|
Land
|
country | string |
Ein zweiseitiger ISO 3166-1-Ländercode, z. B. US. |
|
|
Bots einschließen
|
bots | boolean |
Gibt an, ob Klicks als Bots identifiziert werden sollen. Legen Sie den Wert auf "false" fest, um sie auszuschließen. |
|
|
Nur eindeutig
|
unique | boolean |
Gibt an, ob nur eindeutige Klicks gezählt werden sollen. |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Total
|
total | integer |
Gesamtklicks über alle Gruppen hinweg, einschließlich aller nicht in Werten zurückgegebenen. Wenn das Ergebnis abgeschnitten wird, ist dies größer als die Summe der Anzahl in Werten, sodass "Anzahl/Summe" immer noch einen genauen Prozentsatz angibt. |
|
Werte
|
values | array of object |
Gruppierte Anzahlen, sortiert nach absteigender Anzahl. Auf die obersten 10.000 Werte gekürzt; wenn die Dimension mehr unterschiedliche Werte aufweist als dies, werden die restlichen Werte nicht zurückgegeben. |
|
Anzahl
|
values.count | integer |
Die Anzahl der Klicks für diesen Wert. |
|
Wert
|
values.value | string |
Der Wert der Dimension, z. B. ein Ländercode. |
Arbeitsbereiche auflisten
Gibt die Arbeitsbereiche zurück, die für diese Verbindung verfügbar sind. Verwenden Sie ihn, um den Arbeitsbereich zu finden, den andere Aktionen erfordern.
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
|
array of object | ||
|
Arbeitsbereichs-ID
|
id | integer |
Der eindeutige Bezeichner des Arbeitsbereichs. |
|
Arbeitsbereichname
|
name | string |
Der Name des Arbeitsbereichs. |
Benutzerdefinierte Domänen auflisten
Gibt die benutzerdefinierten Domänen zurück, die für einen Arbeitsbereich konfiguriert sind. Diese Domänennamen können beim Erstellen von Links verwendet werden.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Workspace
|
workspace_id | True | string |
Der Arbeitsbereich, in dem sie arbeiten soll. Wählen Sie sie aus der Liste aus, oder geben Sie die ID ein. |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Domänen
|
domains | array of object |
Die benutzerdefinierten Domänen im Arbeitsbereich. |
|
Domänenname
|
domains.name | string |
Der Domänenname, z. B. go.yourcompany.com. |
Click Analytics abrufen
Gibt die Anzahl der Klicks im Laufe der Zeit für einen Arbeitsbereich oder für bestimmte Links zurück, optional nach Datumsbereich, Land, Browser, Plattform, Referrer oder ISP gefiltert.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Workspace
|
workspace_id | True | string |
Der Arbeitsbereich, in dem sie arbeiten soll. Wählen Sie sie aus der Liste aus, oder geben Sie die ID ein. |
|
Link-ID
|
link_id | string |
Die ID einer einzelnen Verknüpfung, nach der gefiltert werden soll. |
|
|
Link-IDs
|
link_ids | string |
Eine durch Trennstrich getrennte Liste von Link-IDs, nach der gefiltert werden soll. |
|
|
Startdatum
|
start | string |
Der Anfang des Datumsbereichs im Format JJJJ-MM-DD. |
|
|
Enddatum
|
end | string |
Das Ende des Datumsbereichs im Format JJJJ-MM-DD. |
|
|
Land
|
country | string |
Ein zweiseitiger ISO 3166-1-Ländercode, z. B. US. |
|
|
Browser
|
browser | string |
Ein Browsername, nach dem gefiltert werden soll, z. B. Chrome, Firefox oder Safari. |
|
|
Platform
|
platform | string |
Eine Plattform oder ein Betriebssystem zum Filtern nach, z. B. nach Windows, Mac, iOS oder Android. |
|
|
Verweiser
|
referer | string |
Eine verweisende Domäne, nach der gefiltert werden soll. |
|
|
Internetdienstanbieter
|
isp | string |
Ein Internetdienstanbietername, nach dem gefiltert werden soll. |
|
|
Bots einschließen
|
bots | boolean |
Gibt an, ob Klicks als Bots identifiziert werden sollen. Legen Sie den Wert auf "false" fest, um sie auszuschließen. |
|
|
Nur eindeutig
|
unique | boolean |
Gibt an, ob nur eindeutige Klicks gezählt werden sollen. |
|
|
Zeitzone
|
timezone | string |
Die IANA-Zeitzone, die für Datumsberechnungen verwendet wird, z. B. Europa/London. |
|
|
Frequenz
|
frequency | string |
Die Granularität der Zeitreihe, entweder Tag oder Stunde. |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Traffic
|
traffic | array of object |
Der Klick zählt im Laufe der Zeit. |
|
Bucket-Start
|
traffic.t | string |
Der Bucketanfang: YYYY-MM-DD für tägliche Buckets oder YYYY-MM-TTTHH:MM:SS für Stündliche Buckets. |
|
Klicks
|
traffic.y | integer |
Die Anzahl der Klicks im Bucket. |
Einen Link erhalten
Ruft einen einzelnen Link anhand seiner ID ab, einschließlich ziel, kurzer URL und Konfiguration.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Link-ID
|
id | True | string |
Die ID des Links. |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Metapixel-ID
|
fb_pixel_id | string |
Die Meta-Pixel-ID (Facebook), die ausgelöst werden soll, wenn auf den Link geklickt wird. |
|
LinkedIn Partner-ID
|
linkedin_partner_id | string |
Die LinkedIn Insight Tag-Partner-ID, die ausgelöst werden soll, wenn auf den Link geklickt wird. |
|
Microsoft UET-Tag-ID
|
microsoft_uet_tag_id | string |
Die Microsoft Advertising UET-Tag-ID, die ausgelöst werden soll, wenn auf den Link geklickt wird. |
|
Reddit Pixel ID
|
reddit_pixel_id | string |
Die Reddit Pixel-ID, die ausgelöst werden soll, wenn auf den Link geklickt wird. |
|
TikTok-Pixel-ID
|
tiktok_pixel_id | string |
Die TikTok-Pixel-ID, die ausgelöst werden soll, wenn auf den Link geklickt wird. |
|
Verweiser ausblenden
|
hide_referrer | boolean |
Gibt an, ob der Verweiser von der Zielwebsite ausgeblendet werden soll. |
|
Ablaufdatum
|
expiry_datetime | string |
Wenn der Link nicht mehr funktioniert, wird das ISO 8601-Format verwendet. |
|
Ablaufziel
|
expiry_destination | uri |
Die URL, zu der nach Ablauf des Links umgeleitet werden soll. Lassen Sie nichts, um eine nicht gefundene Seite zurückzugeben. |
|
X Pixel-ID
|
twitter_pixel_id | string |
Die X(Twitter)-Pixel-ID, die ausgelöst werden soll, wenn auf den Link geklickt wird. |
|
Verdecken
|
cloaking | boolean |
Gibt an, ob das Ziel ausgeblendet werden soll, indem er in einem Frame geöffnet wird. |
|
Kurze URL
|
full_url | uri |
Die vollständige URL für kurze Verknüpfungen. |
|
Open Graph Description
|
og_description | string |
Die Beschreibung, die angezeigt wird, wenn der Link in sozialen Medien geteilt wird. |
|
Tracking für soziale Netzwerke überspringen
|
skip_social_crawler_tracking | boolean |
Gibt an, ob Vorschaucrawler für soziale Medien von der Klickverfolgung ausgeschlossen werden sollen. |
|
Body-Tags
|
body_tags | string |
Benutzerdefinierte HTML- oder Tracking-Tags, die in den Textkörper der Umleitungsseite eingefügt wurden. |
|
Diagrammtitel öffnen
|
og_title | string |
Der Titel, der angezeigt wird, wenn der Link in sozialen Medien geteilt wird. |
|
Note
|
note | string |
Eine private Notiz zum Link. |
|
Name
|
name | string |
Ein Spitzname für den Link, der im Dashboard angezeigt wird. |
|
Link-ID
|
id | integer |
Der eindeutige Bezeichner des Links. |
|
Google Tag Manager-ID
|
gtm_id | string |
Die Google Tag Manager-Container-ID, die geladen werden soll, wenn auf den Link geklickt wird. |
|
Graph-Bild öffnen
|
og_image | string |
Die Bild-URL, die angezeigt wird, wenn der Link in sozialen Medien geteilt wird. |
|
Blockieren von Bots
|
block_bots | boolean |
Gibt an, ob bekannte Bots daran gehindert werden sollen, dem Link zu folgen. |
|
Pixel-ID von Snapchat
|
snapchat_pixel_id | string |
Die Pixels-ID von Snapchat, die ausgelöst werden soll, wenn auf den Link geklickt wird. |
|
UTM-Inhalt
|
utm_content | string |
Der an die Ziel-URL angefügte parameter utm_content. |
|
Enabled
|
enabled | boolean |
Gibt an, ob der Link aktiv ist. |
|
Ziel-URL
|
url | uri |
Die Ziel-URL, zu der der kurze Link umleitet. |
|
Gelöscht
|
deleted | boolean |
Gibt an, ob sich der Link im Papierkorb befindet. |
|
Webhooks
|
webhooks | array of string |
Die Webhook-URLs, die auf diesen Link geklickt haben, abonniert. |
|
Ablaufende Klicks
|
expiry_clicks | integer |
Die Anzahl der Klicks, nach denen der Link nicht mehr funktioniert. |
|
Slack benachrichtigen
|
notify_slack | boolean |
Gibt an, ob beim Klicken auf den Link eine Pufferbenachrichtigung gesendet werden soll. |
|
Arbeitsbereichs-ID
|
workspace_id | integer |
Die ID des Arbeitsbereichs. |
|
Public Analytics
|
public_analytics | boolean |
Gibt an, ob die Analyseseite für den Link öffentlich sichtbar ist. |
|
Pinterest-Tag-ID
|
pinterest_tag_id | string |
Die Pinterest-Tag-ID, die ausgelöst werden soll, wenn auf den Link geklickt wird. |
|
UTM-Quelle
|
utm_source | string |
Der utm_source Parameter, der an die Ziel-URL angefügt wurde. |
|
Slug
|
slug | string |
Ein benutzerdefinierter Pfad für den kurzen Link. Er muss mit einem Schrägstrich beginnen. |
|
Domäne
|
domain | string |
Die benutzerdefinierte Domäne, die für den kurzen Link verwendet werden soll, ohne einen nachgestellten Schrägstrich. |
|
Forward-Parameter
|
forward_params | boolean |
Gibt an, ob Abfrageparameter vom kurzen Link an das Ziel weitergeleitet werden sollen. |
|
UTM Medium
|
utm_medium | string |
Der utm_medium Parameter, der an die Ziel-URL angefügt wurde. |
|
Kopftags
|
head_tags | string |
Benutzerdefinierte HTML- oder Tracking-Tags, die in den Kopf der Umleitungsseite eingefügt wurden. |
|
Google Analytics 4 Tag-ID
|
ga4_tag_id | string |
Die Google Analytics 4 Mess-ID, die ausgelöst werden soll, wenn auf den Link geklickt wird. |
|
UTM-Begriff
|
utm_term | string |
Der an die Ziel-URL angefügte utm_term-Parameter. |
|
UTM-Kampagne
|
utm_campaign | string |
Der an die Ziel-URL angefügte utm_campaign-Parameter. |
Erstellen oder Aktualisieren eines Links
Erstellt einen neuen kurzen Link oder aktualisiert eine vorhandene Verknüpfung, wenn eine Link-ID angegeben wird. Unterstützt benutzerdefinierte Domänen und Slugs, UTM-Parameter, Retargeting Pixel und Open Graph-Metadaten.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Ziel-URL
|
url | uri |
Die Ziel-URL, zu der der kurze Link umleitet. Erforderlich zum Erstellen eines neuen Links. |
|
|
Link-ID
|
id | integer |
Die ID eines vorhandenen zu aktualisierenden Links. Lassen Sie nichts, um einen neuen Link zu erstellen. |
|
|
Name
|
name | string |
Ein Spitzname für den Link, der im Dashboard angezeigt wird. |
|
|
Domäne
|
domain | string |
Die benutzerdefinierte Domäne, die für den kurzen Link verwendet werden soll, ohne einen nachgestellten Schrägstrich. |
|
|
Slug
|
slug | string |
Ein benutzerdefinierter Pfad für den kurzen Link. Er muss mit einem Schrägstrich beginnen. |
|
|
Enabled
|
enabled | boolean |
Gibt an, ob der Link aktiv ist. |
|
|
Note
|
note | string |
Eine private Notiz zum Link. |
|
|
UTM-Quelle
|
utm_source | string |
Der utm_source Parameter, der an die Ziel-URL angefügt wurde. |
|
|
UTM Medium
|
utm_medium | string |
Der utm_medium Parameter, der an die Ziel-URL angefügt wurde. |
|
|
UTM-Kampagne
|
utm_campaign | string |
Der an die Ziel-URL angefügte utm_campaign-Parameter. |
|
|
UTM-Inhalt
|
utm_content | string |
Der an die Ziel-URL angefügte parameter utm_content. |
|
|
UTM-Begriff
|
utm_term | string |
Der an die Ziel-URL angefügte utm_term-Parameter. |
|
|
Metapixel-ID
|
fb_pixel_id | string |
Die Meta-Pixel-ID (Facebook), die ausgelöst werden soll, wenn auf den Link geklickt wird. |
|
|
Google Analytics 4 Tag-ID
|
ga4_tag_id | string |
Die Google Analytics 4 Mess-ID, die ausgelöst werden soll, wenn auf den Link geklickt wird. |
|
|
Google Tag Manager-ID
|
gtm_id | string |
Die Google Tag Manager-Container-ID, die geladen werden soll, wenn auf den Link geklickt wird. |
|
|
Blockieren von Bots
|
block_bots | boolean |
Gibt an, ob bekannte Bots daran gehindert werden sollen, dem Link zu folgen. |
|
|
Body-Tags
|
body_tags | string |
Benutzerdefinierte HTML- oder Tracking-Tags, die in den Textkörper der Umleitungsseite eingefügt wurden. |
|
|
Verdecken
|
cloaking | boolean |
Gibt an, ob das Ziel ausgeblendet werden soll, indem er in einem Frame geöffnet wird. |
|
|
Forward-Parameter
|
forward_params | boolean |
Gibt an, ob Abfrageparameter vom kurzen Link an das Ziel weitergeleitet werden sollen. |
|
|
Kopftags
|
head_tags | string |
Benutzerdefinierte HTML- oder Tracking-Tags, die in den Kopf der Umleitungsseite eingefügt wurden. |
|
|
Verweiser ausblenden
|
hide_referrer | boolean |
Gibt an, ob der Verweiser von der Zielwebsite ausgeblendet werden soll. |
|
|
Open Graph Description
|
og_description | string |
Die Beschreibung, die angezeigt wird, wenn der Link in sozialen Medien geteilt wird. |
|
|
Graph-Bild öffnen
|
og_image | string |
Die Bild-URL, die angezeigt wird, wenn der Link in sozialen Medien geteilt wird. |
|
|
Diagrammtitel öffnen
|
og_title | string |
Der Titel, der angezeigt wird, wenn der Link in sozialen Medien geteilt wird. |
|
|
TikTok-Pixel-ID
|
tiktok_pixel_id | string |
Die TikTok-Pixel-ID, die ausgelöst werden soll, wenn auf den Link geklickt wird. |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Metapixel-ID
|
fb_pixel_id | string |
Die Meta-Pixel-ID (Facebook), die ausgelöst werden soll, wenn auf den Link geklickt wird. |
|
LinkedIn Partner-ID
|
linkedin_partner_id | string |
Die LinkedIn Insight Tag-Partner-ID, die ausgelöst werden soll, wenn auf den Link geklickt wird. |
|
Microsoft UET-Tag-ID
|
microsoft_uet_tag_id | string |
Die Microsoft Advertising UET-Tag-ID, die ausgelöst werden soll, wenn auf den Link geklickt wird. |
|
Reddit Pixel ID
|
reddit_pixel_id | string |
Die Reddit Pixel-ID, die ausgelöst werden soll, wenn auf den Link geklickt wird. |
|
TikTok-Pixel-ID
|
tiktok_pixel_id | string |
Die TikTok-Pixel-ID, die ausgelöst werden soll, wenn auf den Link geklickt wird. |
|
Verweiser ausblenden
|
hide_referrer | boolean |
Gibt an, ob der Verweiser von der Zielwebsite ausgeblendet werden soll. |
|
Ablaufdatum
|
expiry_datetime | string |
Wenn der Link nicht mehr funktioniert, wird das ISO 8601-Format verwendet. |
|
Ablaufziel
|
expiry_destination | uri |
Die URL, zu der nach Ablauf des Links umgeleitet werden soll. Lassen Sie nichts, um eine nicht gefundene Seite zurückzugeben. |
|
X Pixel-ID
|
twitter_pixel_id | string |
Die X(Twitter)-Pixel-ID, die ausgelöst werden soll, wenn auf den Link geklickt wird. |
|
Verdecken
|
cloaking | boolean |
Gibt an, ob das Ziel ausgeblendet werden soll, indem er in einem Frame geöffnet wird. |
|
Kurze URL
|
full_url | uri |
Die vollständige URL für kurze Verknüpfungen. |
|
Open Graph Description
|
og_description | string |
Die Beschreibung, die angezeigt wird, wenn der Link in sozialen Medien geteilt wird. |
|
Tracking für soziale Netzwerke überspringen
|
skip_social_crawler_tracking | boolean |
Gibt an, ob Vorschaucrawler für soziale Medien von der Klickverfolgung ausgeschlossen werden sollen. |
|
Body-Tags
|
body_tags | string |
Benutzerdefinierte HTML- oder Tracking-Tags, die in den Textkörper der Umleitungsseite eingefügt wurden. |
|
Diagrammtitel öffnen
|
og_title | string |
Der Titel, der angezeigt wird, wenn der Link in sozialen Medien geteilt wird. |
|
Note
|
note | string |
Eine private Notiz zum Link. |
|
Name
|
name | string |
Ein Spitzname für den Link, der im Dashboard angezeigt wird. |
|
Link-ID
|
id | integer |
Die ID eines vorhandenen zu aktualisierenden Links. Lassen Sie nichts, um einen neuen Link zu erstellen. |
|
Google Tag Manager-ID
|
gtm_id | string |
Die Google Tag Manager-Container-ID, die geladen werden soll, wenn auf den Link geklickt wird. |
|
Graph-Bild öffnen
|
og_image | string |
Die Bild-URL, die angezeigt wird, wenn der Link in sozialen Medien geteilt wird. |
|
Blockieren von Bots
|
block_bots | boolean |
Gibt an, ob bekannte Bots daran gehindert werden sollen, dem Link zu folgen. |
|
Pixel-ID von Snapchat
|
snapchat_pixel_id | string |
Die Pixels-ID von Snapchat, die ausgelöst werden soll, wenn auf den Link geklickt wird. |
|
UTM-Inhalt
|
utm_content | string |
Der an die Ziel-URL angefügte parameter utm_content. |
|
Enabled
|
enabled | boolean |
Gibt an, ob der Link aktiv ist. |
|
Ziel-URL
|
url | uri |
Die Ziel-URL, zu der der kurze Link umleitet. Erforderlich zum Erstellen eines neuen Links. |
|
Gelöscht
|
deleted | boolean |
Gibt an, ob sich der Link im Papierkorb befindet. |
|
Webhooks
|
webhooks | array of string |
Die Webhook-URLs, die auf diesen Link geklickt haben, abonniert. |
|
Ablaufende Klicks
|
expiry_clicks | integer |
Die Anzahl der Klicks, nach denen der Link nicht mehr funktioniert. |
|
Slack benachrichtigen
|
notify_slack | boolean |
Gibt an, ob beim Klicken auf den Link eine Pufferbenachrichtigung gesendet werden soll. |
|
Arbeitsbereichs-ID
|
workspace_id | integer |
Die ID des Arbeitsbereichs. |
|
Public Analytics
|
public_analytics | boolean |
Gibt an, ob die Analyseseite für den Link öffentlich sichtbar ist. |
|
Pinterest-Tag-ID
|
pinterest_tag_id | string |
Die Pinterest-Tag-ID, die ausgelöst werden soll, wenn auf den Link geklickt wird. |
|
UTM-Quelle
|
utm_source | string |
Der utm_source Parameter, der an die Ziel-URL angefügt wurde. |
|
Slug
|
slug | string |
Ein benutzerdefinierter Pfad für den kurzen Link. Er muss mit einem Schrägstrich beginnen. |
|
Domäne
|
domain | string |
Die benutzerdefinierte Domäne, die für den kurzen Link verwendet werden soll, ohne einen nachgestellten Schrägstrich. |
|
Forward-Parameter
|
forward_params | boolean |
Gibt an, ob Abfrageparameter vom kurzen Link an das Ziel weitergeleitet werden sollen. |
|
UTM Medium
|
utm_medium | string |
Der utm_medium Parameter, der an die Ziel-URL angefügt wurde. |
|
Kopftags
|
head_tags | string |
Benutzerdefinierte HTML- oder Tracking-Tags, die in den Kopf der Umleitungsseite eingefügt wurden. |
|
Google Analytics 4 Tag-ID
|
ga4_tag_id | string |
Die Google Analytics 4 Mess-ID, die ausgelöst werden soll, wenn auf den Link geklickt wird. |
|
UTM-Begriff
|
utm_term | string |
Der an die Ziel-URL angefügte utm_term-Parameter. |
|
UTM-Kampagne
|
utm_campaign | string |
Der an die Ziel-URL angefügte utm_campaign-Parameter. |
Listenkonvertierungen
Gibt die zuletzt im Arbeitsbereich aufgezeichneten Konvertierungen zurück.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Limit
|
limit | integer |
Die maximale Anzahl der zurückzugebenden Konvertierungen zwischen 1 und 1000. |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Konvertierungen
|
conversions | array of object |
Die Konvertierungen, die zuletzt verwendet wurden. |
|
Betrag (Cent)
|
conversions.amount_cents | integer |
Der Wert in der kleinsten Währungseinheit. Kann negativ sein, um eine Rückerstattung aufzuzeichnen. |
|
Klick-ID
|
conversions.click_id | string |
Die ID des Attributklicks. |
|
Land
|
conversions.country | string |
Ein zweiseitiger ISO 3166-1-Ländercode, z. B. US. |
|
Währung
|
conversions.currency | string |
Der ISO 4217-Währungscode Der Standardwert ist USD. |
|
Ereignis-ID
|
conversions.event_id | string |
Ihr Bezeichner für das Ereignis. Wenn Sie denselben Wert zweimal melden, wird keine zweite Konvertierung erstellt. |
|
Ereignisname
|
conversions.event_name | string |
Was passiert ist, z. B. Kauf, Registrierung oder trial_started. |
|
Ereignistyp
|
conversions.event_type | string |
Der grobe Ereignistyp. Verwenden Sie lead to establish customer identity and sale to record revenue. Standardmäßig ist "benutzerdefiniert" festgelegt. |
|
Kunden-ID
|
conversions.external_id | string |
Ihr Bezeichner für den Kunden. Senden Sie es auf jedem Ereignis, damit spätere Verkäufe mit dem ursprünglichen Klick verknüpft werden können. |
|
Konvertierungs-ID
|
conversions.id | string |
Der eindeutige Bezeichner der Konvertierung. IDs sortieren chronologisch. |
|
Eingefügt an
|
conversions.inserted_at | date-time |
Wann die Konvertierung aufgezeichnet wurde. |
|
IP-Quelle
|
conversions.ip_source | string |
Deren Adresse wurde aufgezeichnet: Besucher, Server oder unbekannt. Der Server bedeutet, dass die Verbindungsadresse zu Ihrem Back-End oder einem Plattformrelay gehört, sodass sie von der geografischen Berichterstattung ausgeschlossen wird. |
|
Link-ID
|
conversions.link_id | integer |
Die ID des zugeordneten Links oder NULL, wenn die Konvertierung nicht einem Link zugeordnet werden konnte. |
|
Metadata
|
conversions.metadata | object |
Beliebige JSON-Metadaten, bis zu 10.000 Bytes. |
|
Aufgetreten bei
|
conversions.occurred_at | date-time |
Wenn die Konvertierung erfolgt ist, im ISO 8601-Format. Wird standardmäßig auf jetzt gesetzt. |
|
Source
|
conversions.source | string |
Welche Integration gemeldet hat. |
Listenlinks
Gibt eine paginierte Liste der Verknüpfungen in einem Arbeitsbereich mit Klickstatistiken zurück. Unterstützt die Suche und Sortierung.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Workspace
|
workspace_id | True | string |
Der Arbeitsbereich, in dem sie arbeiten soll. Wählen Sie sie aus der Liste aus, oder geben Sie die ID ein. |
|
Search
|
search | string |
Ein Suchbegriff zum Filtern von Links nach Name, URL oder Slug. |
|
|
Seite
|
page | integer |
Die zurückzugebende Seitenzahl, beginnend bei 1. |
|
|
Seitengröße
|
page_size | integer |
Die Anzahl der Links, die pro Seite zurückgegeben werden sollen. |
|
|
Sortieren nach
|
sort_by | string |
Das Feld, nach dem sortiert werden soll, z. B. nach clicks_total, Name oder inserted_at. |
|
|
Sortierrichtung
|
sort_dir | string |
Die Sortierrichtung, entweder asc oder desc. |
|
|
Gelöscht
|
deleted | boolean |
Gibt an, ob Links, die sich im Papierkorb befinden, anstelle aktiver Links zurückgegeben werden sollen. |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Links
|
links | array of object |
Die Links auf dieser Seite. |
|
Metapixel-ID
|
links.fb_pixel_id | string |
Die Meta-Pixel-ID (Facebook), die ausgelöst werden soll, wenn auf den Link geklickt wird. |
|
Menschliche Klicks Gesamtsumme
|
links.human_clicks_total | integer |
Lifetime clicks with no bot signal; die Teilmenge der clicks_total, bei der weder ein Bot-Benutzer-Agent noch eine überprüfte Bot-Kategorie erkannt wurde. Ab 2019 aufgenommen. |
|
Klicks (30 Tage)
|
links.clicks_thirty_days | integer |
Klicks in den letzten 30 Tagen, einschließlich Bot-Datenverkehr. |
|
TikTok-Pixel-ID
|
links.tiktok_pixel_id | string |
Die TikTok-Pixel-ID, die ausgelöst werden soll, wenn auf den Link geklickt wird. |
|
Verweiser ausblenden
|
links.hide_referrer | boolean |
Gibt an, ob der Verweiser von der Zielwebsite ausgeblendet werden soll. |
|
Verdecken
|
links.cloaking | boolean |
Gibt an, ob das Ziel ausgeblendet werden soll, indem er in einem Frame geöffnet wird. |
|
Kurze URL
|
links.full_url | uri |
Die vollständige URL für kurze Verknüpfungen. |
|
Klickt heute
|
links.clicks_today | integer |
Klickt bis heute (UTC), einschließlich Bot-Datenverkehr. |
|
Open Graph Description
|
links.og_description | string |
Die Beschreibung, die angezeigt wird, wenn der Link in sozialen Medien geteilt wird. |
|
Body-Tags
|
links.body_tags | string |
Benutzerdefinierte HTML- oder Tracking-Tags, die in den Textkörper der Umleitungsseite eingefügt wurden. |
|
Diagrammtitel öffnen
|
links.og_title | string |
Der Titel, der angezeigt wird, wenn der Link in sozialen Medien geteilt wird. |
|
Note
|
links.note | string |
Eine private Notiz zum Link. |
|
Name
|
links.name | string |
Ein Spitzname für den Link, der im Dashboard angezeigt wird. |
|
Link-ID
|
links.id | integer |
Der eindeutige Bezeichner des Links. |
|
Google Tag Manager-ID
|
links.gtm_id | string |
Die Google Tag Manager-Container-ID, die geladen werden soll, wenn auf den Link geklickt wird. |
|
Graph-Bild öffnen
|
links.og_image | string |
Die Bild-URL, die angezeigt wird, wenn der Link in sozialen Medien geteilt wird. |
|
Blockieren von Bots
|
links.block_bots | boolean |
Gibt an, ob bekannte Bots daran gehindert werden sollen, dem Link zu folgen. |
|
Gesamtklicks
|
links.clicks_total | integer |
Lebensdauerklicks, einschließlich Bot-Datenverkehr. |
|
Menschliche Klicks (30 Tage)
|
links.human_clicks_thirty_days | integer |
Klickt in den letzten 30 Tagen ohne Bot-Signal; die Teilmenge von clicks_thirty_days. |
|
UTM-Inhalt
|
links.utm_content | string |
Der an die Ziel-URL angefügte parameter utm_content. |
|
Menschenklicks heute
|
links.human_clicks_today | integer |
Klickt bis heute (UTC) ohne Bot-Signal. |
|
Enabled
|
links.enabled | boolean |
Gibt an, ob der Link aktiv ist. |
|
Ziel-URL
|
links.url | uri |
Die Ziel-URL, zu der der kurze Link umleitet. |
|
Gelöscht
|
links.deleted | boolean |
Gibt an, ob sich der Link im Papierkorb befindet. |
|
Arbeitsbereichs-ID
|
links.workspace_id | integer |
Die ID des Arbeitsbereichs. |
|
Public Analytics
|
links.public_analytics | boolean |
Gibt an, ob die Analyseseite für den Link öffentlich sichtbar ist. |
|
UTM-Quelle
|
links.utm_source | string |
Der utm_source Parameter, der an die Ziel-URL angefügt wurde. |
|
Slug
|
links.slug | string |
Ein benutzerdefinierter Pfad für den kurzen Link. Er muss mit einem Schrägstrich beginnen. |
|
Domäne
|
links.domain | string |
Die benutzerdefinierte Domäne, die für den kurzen Link verwendet werden soll, ohne einen nachgestellten Schrägstrich. |
|
Forward-Parameter
|
links.forward_params | boolean |
Gibt an, ob Abfrageparameter vom kurzen Link an das Ziel weitergeleitet werden sollen. |
|
UTM Medium
|
links.utm_medium | string |
Der utm_medium Parameter, der an die Ziel-URL angefügt wurde. |
|
Kopftags
|
links.head_tags | string |
Benutzerdefinierte HTML- oder Tracking-Tags, die in den Kopf der Umleitungsseite eingefügt wurden. |
|
Google Analytics 4 Tag-ID
|
links.ga4_tag_id | string |
Die Google Analytics 4 Mess-ID, die ausgelöst werden soll, wenn auf den Link geklickt wird. |
|
UTM-Begriff
|
links.utm_term | string |
Der an die Ziel-URL angefügte utm_term-Parameter. |
|
UTM-Kampagne
|
links.utm_campaign | string |
Der an die Ziel-URL angefügte utm_campaign-Parameter. |
|
Menschliche Klicks gestern
|
links.human_clicks_previous_day | integer |
Klickt gestern (UTC) ohne Bot-Signal. |
|
Seitennummer
|
page_number | integer |
Die aktuelle Seitenzahl. |
|
Seitengröße
|
page_size | integer |
Die Anzahl der Links, die pro Seite zurückgegeben werden sollen. |
|
Einträge insgesamt
|
total_entries | integer |
Die Gesamtanzahl der Verknüpfungen, die der Anforderung entsprechen. |
|
Seiten insgesamt
|
total_pages | integer |
Die Gesamtzahl der verfügbaren Seiten. |
|
Zeilen insgesamt
|
total_rows | integer |
Die Gesamtzahl der Zeilen. |
|
Anzahl der Arbeitsbereichslinks
|
workspace_link_count | integer |
Die Gesamtanzahl der Verknüpfungen im Arbeitsbereich. |
Löschen eines Links
Verschiebt einen Link in den Papierkorb. Die kurze URL beendet die Umleitung, und der Link kann später aus dem Papierkorb wiederhergestellt werden.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Workspace
|
workspace_id | True | string |
Der Arbeitsbereich, in dem sie arbeiten soll. Wählen Sie sie aus der Liste aus, oder geben Sie die ID ein. |
|
Link-ID
|
id | True | integer |
Die ID des Links. |
Gibt zurück
Eine Bestätigungsmeldung.
- response
- string
Melden einer Konvertierung
Zeichnet eine Konvertierung auf, z. B. einen Kauf, eine Registrierung oder ein benutzerdefiniertes Ereignis, und attributet sie dem Link, auf den geklickt wurde, wenn ein Attributionstoken bereitgestellt wird.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Betrag (Cent)
|
amount_cents | integer |
Wert in der kleinsten Währungseinheit. Kann negativ sein, um eine Rückerstattung oder Rückbuchung aufzuzeichnen, die sich auf frühere Einnahmen bezieht. |
|
|
Land
|
country | string |
Ländercode mit zwei Buchstaben für die Konvertierung. Abgeleitet für browserseitige Anrufe; Geben Sie sie explizit aus einer serverseitigen Integration an, bei der die Verbindungsadresse Ihre eigene Infrastruktur und nicht die des Kunden ist. |
|
|
Währung
|
currency | string |
ISO 4217-Währungscode. Der Standardwert ist USD. |
|
|
Ereignis-ID
|
event_id | string |
Ihr Bezeichner für dieses Ereignis. Wird als Idempotenzschlüssel verwendet; Wenn Sie denselben Wert zweimal melden, wird keine zweite Konvertierung erstellt. Gilt für jeden Ereignistyp, nicht nur für Einkäufe. |
|
|
Ereignisname
|
event_name | True | string |
Was passiert ist, z. B. Kauf, Anmeldung, trial_started. |
|
Ereignistyp
|
event_type | string |
Grober Typ, der den Trichter antreibt. Lead richtet Kundenidentität ein, Verkaufsdatensätze. Standardmäßig ist "benutzerdefiniert" festgelegt. |
|
|
Kunden-ID
|
external_id | string |
Ihr Bezeichner für den Kunden. Senden Sie es auf jedem Ereignis: Es ist, was einen späteren serverseitigen Verkauf mit dem Klick verknüpft, mit dem die Registrierung erstellt wurde. |
|
|
Attributionstoken
|
linkly_cid | string |
Das Zuordnungstoken, das von der Zielseiten-URL erfasst wurde. Auslassen, wenn nicht verfügbar; die Konvertierung wird dann ohne Verknüpfungszuordnung aufgezeichnet. |
|
|
Metadata
|
metadata | object |
Beliebiger JSON-Code, bis zu 10.000 Bytes codiert. |
|
|
Aufgetreten bei
|
occurred_at | date-time |
Wenn die Konvertierung erfolgt ist. Wird standardmäßig auf jetzt gesetzt. |
|
|
Besucher-IP
|
visitor_ip | string |
Die IP-Adresse des Endbenutzers, wenn Ihr Server sie hat. Lassen Sie es aus, es sei denn, Sie tun; für serverseitige Anrufe zeichnet Linkly andernfalls die Verbindungsadresse als Server, nicht den Kunden auf und schließt sie aus der geografischen Berichterstellung aus. Durch das Senden dieser Daten wird bestätigt, dass Sie eine rechtmäßige Grundlage haben, um sie zu teilen. Wird nie von der API zurückgegeben. |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Betrag (Cent)
|
amount_cents | integer |
Der Wert in der kleinsten Währungseinheit. Kann negativ sein, um eine Rückerstattung aufzuzeichnen. |
|
Klick-ID
|
click_id | string |
Die ID des Attributklicks. |
|
Land
|
country | string |
Ein zweiseitiger ISO 3166-1-Ländercode, z. B. US. |
|
Währung
|
currency | string |
Der ISO 4217-Währungscode Der Standardwert ist USD. |
|
Ereignis-ID
|
event_id | string |
Ihr Bezeichner für das Ereignis. Wenn Sie denselben Wert zweimal melden, wird keine zweite Konvertierung erstellt. |
|
Ereignisname
|
event_name | string |
Was passiert ist, z. B. Kauf, Registrierung oder trial_started. |
|
Ereignistyp
|
event_type | string |
Der grobe Ereignistyp. Verwenden Sie lead to establish customer identity and sale to record revenue. Standardmäßig ist "benutzerdefiniert" festgelegt. |
|
Kunden-ID
|
external_id | string |
Ihr Bezeichner für den Kunden. Senden Sie es auf jedem Ereignis, damit spätere Verkäufe mit dem ursprünglichen Klick verknüpft werden können. |
|
Konvertierungs-ID
|
id | string |
Der eindeutige Bezeichner der Konvertierung. IDs sortieren chronologisch. |
|
Eingefügt an
|
inserted_at | date-time |
Wann die Konvertierung aufgezeichnet wurde. |
|
IP-Quelle
|
ip_source | string |
Deren Adresse wurde aufgezeichnet: Besucher, Server oder unbekannt. Der Server bedeutet, dass die Verbindungsadresse zu Ihrem Back-End oder einem Plattformrelay gehört, sodass sie von der geografischen Berichterstattung ausgeschlossen wird. |
|
Link-ID
|
link_id | integer |
Die ID des zugeordneten Links oder NULL, wenn die Konvertierung nicht einem Link zugeordnet werden konnte. |
|
Metadata
|
metadata | object |
Beliebige JSON-Metadaten, bis zu 10.000 Bytes. |
|
Aufgetreten bei
|
occurred_at | date-time |
Wenn die Konvertierung erfolgt ist, im ISO 8601-Format. Wird standardmäßig auf jetzt gesetzt. |
|
Source
|
source | string |
Welche Integration gemeldet hat. |
Definitionen
string
Dies ist der grundlegende Datentyp "string".