Linkly(미리 보기)

Linkly는 링크 단축기이며 추적기를 클릭합니다. 사용자 지정 도메인을 사용하여 브랜드가 지정된 짧은 링크를 만들고, UTM 매개 변수 및 대상을 다시 지정하는 픽셀을 추가하고, 변환을 보고하고, 국가, 플랫폼, 참조자 또는 캠페인별로 그룹화된 끌어오기 클릭 분석을 만듭니다.

이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.

서비스 클래스 Regions
Copilot Studio Premium 다음을 제외한 모든 Power Automate 지역 :
     - 미국 정부(GCC)
     - 미국 정부(GCC High)
     - 21Vianet에서 운영하는 중국 클라우드
     - 미국 국방부(DoD)
논리 앱 Standard 다음을 제외한 모든 Logic Apps 지역 :
     - Azure Government 지역
     - Azure 중국 지역
     - 미국 국방부(DoD)
Power Apps Premium 다음을 제외한 모든 Power Apps 지역 :
     - 미국 정부(GCC)
     - 미국 정부(GCC High)
     - 21Vianet에서 운영하는 중국 클라우드
     - 미국 국방부(DoD)
파워 오토메이트 Premium 다음을 제외한 모든 Power Automate 지역 :
     - 미국 정부(GCC)
     - 미국 정부(GCC High)
     - 21Vianet에서 운영하는 중국 클라우드
     - 미국 국방부(DoD)
연락처
Name Linkly 지원
URL https://linklyhq.com/support
이메일 support@linklyhq.com
커넥터 메타데이터
Publisher Linkly
웹 사이트 https://linklyhq.com
개인 정보 보호 정책 https://linklyhq.com/support/privacy
카테고리 마케팅; 웹 사이트

Linkly

Linkly는 링크 단축기이며 추적기를 클릭합니다. 고유한 도메인에 브랜드가 지정된 짧은 링크를 만들고, 국가, 플랫폼 및 참조자 분석으로 클릭할 때마다 추적하고, 대상을 다시 지정하는 픽셀을 발생시키고, 변환을 생성한 링크로 다시 기록합니다. 이 커넥터를 사용하면 흐름이 Linkly 작업 영역에서 링크를 만들고 관리하고 클릭 분석을 끌어오고 변환을 보고할 수 있습니다.

Publisher: Linkly

Prerequisites

Linkly 계정입니다. 무료 플랜은 이 커넥터의 모든 작업을 사용하기에 충분합니다. 또한 보고 및 목록 변환을 사용하려면 작업 영역에서 Linkly 변환 추적 기능을 사용하도록 설정해야 합니다.

지원되는 작업

작업 영역 나열

이 연결에 사용할 수 있는 작업 영역을 반환합니다. 이를 사용하여 다른 작업에 필요한 작업 영역을 찾습니다.

새 짧은 링크를 만들거나 링크 ID가 제공되면 기존 링크를 업데이트합니다. 사용자 지정 도메인 및 슬러그, UTM 매개 변수, 대상 다시 지정 픽셀 및 Open Graph 메타데이터를 지원합니다.

대상, 짧은 URL 및 구성을 포함하여 ID로 단일 링크를 검색합니다.

클릭 통계를 사용하여 작업 영역의 페이지를 매긴 링크 목록을 반환합니다. 검색 및 정렬을 지원합니다.

휴지통에 대한 링크를 이동합니다. 짧은 URL은 리디렉션을 중지하며 나중에 휴지통에서 링크를 복원할 수 있습니다.

클릭 분석 가져오기

날짜 범위, 국가, 브라우저, 플랫폼, 참조자 또는 ISP별로 선택적으로 필터링된 작업 영역 또는 특정 링크에 대한 시간 경과에 따른 클릭 수를 반환합니다.

차원별 클릭 수 가져오기

국가, 도시, 플랫폼, 참조자 또는 UTM 매개 변수와 같은 차원별로 그룹화된 클릭 수를 개수 내림차순으로 반환합니다.

사용자 지정 도메인 나열

작업 영역에 대해 구성된 사용자 지정 도메인을 반환합니다. 이러한 도메인 이름은 링크를 만들 때 사용할 수 있습니다.

변환 보고

구매, 등록 또는 사용자 지정 이벤트와 같은 변환을 기록하고 특성 토큰을 제공할 때 클릭한 링크에 특성을 지정합니다.

목록 변환

작업 영역에 기록된 가장 최근의 변환을 반환합니다.

자격 증명 가져오기

이 커넥터는 OAuth 2.0을 사용합니다. API 키가 필요하지 않습니다.

  1. Linkly 계정이 아직 없는 경우 등록합니다 https://linklyhq.com. 무료 플랜이 작동합니다.
  2. 연결을 만들 때 Linkly로 로그인을 선택하고 Linkly 계정으로 로그인합니다.
  3. 메시지가 표시될 때 이 연결에서 사용해야 하는 작업 영역을 선택한 다음 요청을 승인합니다.

연결은 선택한 작업 영역에 바인딩됩니다. 다른 작업 영역에서 작업하려면 두 번째 연결을 만듭니다.

Getting Started

  1. 위에서 설명한 대로 연결을 만듭니다.
  2. 흐름에 링크 만들기 또는 업데이트 작업을 추가하고 대상 URL을 입력하고 필요에 따라 사용자 지정 도메인 및 슬러그를 입력합니다. 이 작업은 짧은 URL과 링크 ID를 반환합니다.
  3. 목록 링크, 클릭 분석 가져오기 또는 차원별 클릭 횟수 가져오기를 사용하여 클릭 데이터를 읽습니다. 작업 영역을 사용하는 작업을 사용하면 목록 작업 영역 으로 채워지는 목록에서 선택할 수 있습니다.
  4. 구매 또는 등록을 링크에 특성화하려면 방문 페이지 URL의 linkly_cid 값을 특성 토큰으로 변환 보고 로 전달합니다.

알려진 문제 및 제한 사항

  • 연결은 로그인할 때 선택한 단일 Linkly 작업 영역에 바인딩됩니다. 작업 영역당 하나의 연결을 만듭니다.
  • 변환 및목록 변환 을 보고하려면 Linkly 변환 추적 기능이 필요합니다. 작업 영역이 없으면 이러한 작업에서 오류가 발생합니다.
  • 실시간 클릭 웹후크는 트리거로 노출되지 않습니다. 대신 HTTP 트리거 흐름과 함께 Linkly의 웹후크 기능을 사용합니다.
  • 대량 링크 만들기, 링크 내보내기 및 도메인 관리는 Linkly API에서 사용할 수 있지만 이 커넥터에는 포함되지 않습니다.
  • API는 속도가 제한됩니다. 차원별 클릭 횟수 가져오기 는 제한을 초과하면 속도 제한 오류를 반환합니다. 잠시 후 다시 시도합니다.

자주 묻는 질문

내 작업이 실행되는 작업 영역은 무엇인가요?

작업 영역 매개 변수를 사용하는 작업은 연결에 사용할 수 있는 작업 영역 목록을 표시합니다. 링크 가져오기, 변환 보고 및 목록 변환과 같이 하나 없는 작업은 연결에 바인딩된 작업 영역을 사용합니다.

사용자 지정 도메인을 사용하려면 어떻게 해야 하나요?

먼저 Linkly에 도메인을 추가한 다음 링크 만들기 또는 업데이트의 도메인 필드에 해당 이름을 전달합니다. 목록 사용자 지정 도메인은 작업 영역에서 사용할 수 있는 이름을 반환합니다.

No. 링크가 휴지통으로 이동하고 리디렉션을 중지합니다. Linkly의 휴지통에서 복원할 수 있습니다.

배포 지침

  1. 작성자 포털에서 사용자 지정 커넥터를 열고 새 사용자 지정 커넥터 를 선택한 다음 OpenAPI 파일을 가져옵니다. apiDefinition.swagger.json를 선택합니다.
  2. 보안 탭에서 일반 Oauth 2 ID 공급자를 사용하여 OAuth 2.0을 선택합니다. Linkly에서 발급한 클라이언트 ID 및 클라이언트 암호를 입력하고, 권한 부여 URL을 https://app.linklyhq.com/oauth/authorize설정하고, 토큰 URL과 새로 고침 URL을 모두 로 https://app.linklyhq.com/oauth/token설정합니다.
  3. 커넥터를 만든 다음, 보안 탭에 표시된 리디렉션 URL을 복사하고 해당 클라이언트 ID에 대해 Linkly에 등록합니다.
  4. Linkly 계정으로 로그인하여 연결을 만든 다음 작업 영역 나열과 같은 작업을 테스트합니다.

actions

링크 가져오기

대상, 짧은 URL 및 구성을 포함하여 ID로 단일 링크를 검색합니다.
링크 나열

클릭 통계를 사용하여 작업 영역의 페이지를 매긴 링크 목록을 반환합니다. 검색 및 정렬을 지원합니다.
링크 만들기 또는 업데이트

새 짧은 링크를 만들거나 링크 ID가 제공되면 기존 링크를 업데이트합니다. 사용자 지정 도메인 및 슬러그, UTM 매개 변수, 대상 다시 지정 픽셀 및 Open Graph 메타데이터를 지원합니다.
링크 삭제

휴지통에 대한 링크를 이동합니다. 짧은 URL은 리디렉션을 중지하며 나중에 휴지통에서 링크를 복원할 수 있습니다.
목록 변환

작업 영역에 기록된 가장 최근의 변환을 반환합니다.
변환 보고

구매, 등록 또는 사용자 지정 이벤트와 같은 변환을 기록하고 특성 토큰을 제공할 때 클릭한 링크에 특성을 지정합니다.
사용자 지정 도메인 나열

작업 영역에 대해 구성된 사용자 지정 도메인을 반환합니다. 이러한 도메인 이름은 링크를 만들 때 사용할 수 있습니다.
작업 영역 나열

이 연결에 사용할 수 있는 작업 영역을 반환합니다. 이를 사용하여 다른 작업에 필요한 작업 영역을 찾습니다.
차원별 클릭 수 가져오기

국가, 도시, 플랫폼, 참조자 또는 UTM 매개 변수와 같은 차원별로 그룹화된 클릭 수를 개수 내림차순으로 반환합니다.
클릭 분석 가져오기

날짜 범위, 국가, 브라우저, 플랫폼, 참조자 또는 ISP별로 선택적으로 필터링된 작업 영역 또는 특정 링크에 대한 시간 경과에 따른 클릭 수를 반환합니다.

링크 가져오기

작업 ID:
GetLink

대상, 짧은 URL 및 구성을 포함하여 ID로 단일 링크를 검색합니다.

매개 변수

속성 키 필수 형식 Description
링크 ID
 id True string

링크의 ID입니다.

반품

속성 경로 형식 Description
메타 픽셀 ID
 fb_pixel_id string

링크를 클릭할 때 실행될 메타(Facebook) 픽셀 ID입니다.
LinkedIn 파트너 ID
 linkedin_partner_id string

링크를 클릭할 때 발생할 LinkedIn Insight 태그 파트너 ID입니다.
UET 태그 ID Microsoft
 microsoft_uet_tag_id string

링크를 클릭할 때 발생할 Microsoft Advertising UET 태그 ID입니다.
Reddit 픽셀 ID
 reddit_pixel_id string

링크를 클릭할 때 실행될 Reddit 픽셀 ID입니다.
TikTok 픽셀 ID
 tiktok_pixel_id string

링크를 클릭할 때 실행될 TikTok 픽셀 ID입니다.
참조자 숨기기
 hide_referrer boolean

대상 사이트에서 참조자를 숨길지 여부입니다.
만료 날짜
 expiry_datetime string

링크가 작동을 중지하면 ISO 8601 형식입니다.
만료 대상
 expiry_destination uri

링크가 만료된 후 리디렉션할 URL입니다. 찾을 수 없는 페이지를 반환하려면 비워 둡니다.
X 픽셀 ID
 twitter_pixel_id string

링크를 클릭할 때 실행될 X(Twitter) 픽셀 ID입니다.
클로킹
 cloaking boolean

프레임 내에서 대상을 열어 대상을 숨길지 여부입니다.
짧은 URL
 full_url uri

전체 짧은 링크 URL입니다.
그래프 설명 열기
 og_description string

링크가 소셜 미디어에서 공유되는 경우 표시되는 설명입니다.
소셜 크롤러 추적 건너뛰기
 skip_social_crawler_tracking boolean

클릭 추적에서 소셜 미디어 미리 보기 크롤러를 제외할지 여부입니다.
본문 태그
 body_tags string

리디렉션 페이지의 본문에 삽입된 사용자 지정 HTML 또는 추적 태그입니다.
그래프 제목 열기
 og_title string

링크가 소셜 미디어에 공유되면 표시되는 제목입니다.
참고
 note string

링크에 대한 비공개 메모입니다.
Name
 name string

대시보드에 표시된 링크의 애칭입니다.
링크 ID
 id integer

링크의 고유 식별자입니다.
Google 태그 관리자 ID
 gtm_id string

링크를 클릭할 때 로드할 Google 태그 관리자 컨테이너 ID입니다.
그래프 이미지 열기
 og_image string

링크가 소셜 미디어에서 공유되는 경우 표시되는 이미지 URL입니다.
블록 봇
 block_bots boolean

알려진 봇이 링크를 따르지 못하도록 차단할지 여부입니다.
Snapchat 픽셀 ID
 snapchat_pixel_id string

링크를 클릭할 때 실행될 Snapchat 픽셀 ID입니다.
UTM 콘텐츠
 utm_content string

대상 URL에 추가된 utm_content 매개 변수입니다.
활성화됨
 enabled boolean

링크가 활성 상태인지 여부입니다.
대상 URL
 url uri

짧은 링크가 리디렉션하는 대상 URL입니다.
삭제됨
 deleted boolean

링크가 휴지통에 있는지 여부입니다.
웹후크
 webhooks array of string

이 링크를 클릭하기 위해 구독한 웹후크 URL입니다.
만료 클릭
 expiry_clicks integer

링크가 작동을 중지한 후의 클릭 수입니다.
Slack에 알림
 notify_slack boolean

링크를 클릭할 때 Slack 알림을 보낼지 여부입니다.
작업 영역 ID
 workspace_id integer

작업 영역의 ID입니다.
퍼블릭 분석
 public_analytics boolean

링크의 분석 페이지를 공개적으로 볼 수 있는지 여부입니다.
Pinterest 태그 ID
 pinterest_tag_id string

링크를 클릭할 때 발생할 Pinterest 태그 ID입니다.
UTM 원본
 utm_source string

대상 URL에 추가된 utm_source 매개 변수입니다.
슬러그
 slug string

짧은 링크에 대한 사용자 지정 경로입니다. 슬래시로 시작해야 합니다.
도메인
 domain string

후행 슬래시 없이 짧은 링크에 사용할 사용자 지정 도메인입니다.
전달 매개 변수
 forward_params boolean

짧은 링크에서 대상으로 쿼리 매개 변수를 전달할지 여부입니다.
UTM 중간
 utm_medium string

대상 URL에 추가된 utm_medium 매개 변수입니다.
헤드 태그
 head_tags string

리디렉션 페이지의 헤드에 삽입된 사용자 지정 HTML 또는 추적 태그입니다.
Google Analytics 4 태그 ID
 ga4_tag_id string

링크를 클릭할 때 실행될 Google Analytics 4 측정 ID입니다.
UTM 용어
 utm_term string

대상 URL에 추가된 utm_term 매개 변수입니다.
UTM 캠페인
 utm_campaign string

대상 URL에 추가된 utm_campaign 매개 변수입니다.

링크 나열

작업 ID:
ListLinks

클릭 통계를 사용하여 작업 영역의 페이지를 매긴 링크 목록을 반환합니다. 검색 및 정렬을 지원합니다.

매개 변수

속성 키 필수 형식 Description
Workspace
 workspace_id True string

작업할 작업 영역입니다. 목록에서 선택하거나 ID를 입력합니다.
Search
 search string

이름, URL 또는 슬러그별로 링크를 필터링하는 검색 용어입니다.
페이지
 page integer

반환할 페이지 번호(1부터 시작)입니다.
페이지 크기
 page_size integer

페이지당 반환할 링크 수입니다.
정렬 기준:
 sort_by string

정렬 기준 필드(예: clicks_total, 이름 또는 inserted_at)입니다.
정렬 방향
 sort_dir string

asc 또는 desc의 정렬 방향입니다.
삭제됨
 deleted boolean

활성 링크 대신 휴지통에 있는 링크를 반환할지 여부입니다.

반품

속성 경로 형식 Description
Links
 links array of object

이 페이지의 링크입니다.
메타 픽셀 ID
 links.fb_pixel_id string

링크를 클릭할 때 실행될 메타(Facebook) 픽셀 ID입니다.
사용자 클릭 합계
 links.human_clicks_total integer

봇 신호 없이 수명 클릭 봇 사용자 에이전트 또는 확인된 봇 범주가 검색되지 않은 clicks_total 하위 집합입니다. 2019년부터 기록됩니다.
클릭(30일)
 links.clicks_thirty_days integer

봇 트래픽을 포함하여 지난 30일 동안을 클릭합니다.
TikTok 픽셀 ID
 links.tiktok_pixel_id string

링크를 클릭할 때 실행될 TikTok 픽셀 ID입니다.
참조자 숨기기
 links.hide_referrer boolean

대상 사이트에서 참조자를 숨길지 여부입니다.
클로킹
 links.cloaking boolean

프레임 내에서 대상을 열어 대상을 숨길지 여부입니다.
짧은 URL
 links.full_url uri

전체 짧은 링크 URL입니다.
오늘 클릭
 links.clicks_today integer

봇 트래픽을 포함하여 오늘(UTC)을 클릭합니다.
그래프 설명 열기
 links.og_description string

링크가 소셜 미디어에서 공유되는 경우 표시되는 설명입니다.
본문 태그
 links.body_tags string

리디렉션 페이지의 본문에 삽입된 사용자 지정 HTML 또는 추적 태그입니다.
그래프 제목 열기
 links.og_title string

링크가 소셜 미디어에 공유되면 표시되는 제목입니다.
참고
 links.note string

링크에 대한 비공개 메모입니다.
Name
 links.name string

대시보드에 표시된 링크의 애칭입니다.
링크 ID
 links.id integer

링크의 고유 식별자입니다.
Google 태그 관리자 ID
 links.gtm_id string

링크를 클릭할 때 로드할 Google 태그 관리자 컨테이너 ID입니다.
그래프 이미지 열기
 links.og_image string

링크가 소셜 미디어에서 공유되는 경우 표시되는 이미지 URL입니다.
블록 봇
 links.block_bots boolean

알려진 봇이 링크를 따르지 못하도록 차단할지 여부입니다.
총 클릭 수
 links.clicks_total integer

수명 클릭(봇 트래픽 포함)
사용자 클릭(30일)
 links.human_clicks_thirty_days integer

봇 신호 없이 지난 30일 동안 클릭; clicks_thirty_days 하위 집합입니다.
UTM 콘텐츠
 links.utm_content string

대상 URL에 추가된 utm_content 매개 변수입니다.
오늘 사람의 클릭
 links.human_clicks_today integer

봇 신호 없이 오늘(UTC)을 클릭합니다.
활성화됨
 links.enabled boolean

링크가 활성 상태인지 여부입니다.
대상 URL
 links.url uri

짧은 링크가 리디렉션하는 대상 URL입니다.
삭제됨
 links.deleted boolean

링크가 휴지통에 있는지 여부입니다.
작업 영역 ID
 links.workspace_id integer

작업 영역의 ID입니다.
퍼블릭 분석
 links.public_analytics boolean

링크의 분석 페이지를 공개적으로 볼 수 있는지 여부입니다.
UTM 원본
 links.utm_source string

대상 URL에 추가된 utm_source 매개 변수입니다.
슬러그
 links.slug string

짧은 링크에 대한 사용자 지정 경로입니다. 슬래시로 시작해야 합니다.
도메인
 links.domain string

후행 슬래시 없이 짧은 링크에 사용할 사용자 지정 도메인입니다.
전달 매개 변수
 links.forward_params boolean

짧은 링크에서 대상으로 쿼리 매개 변수를 전달할지 여부입니다.
UTM 중간
 links.utm_medium string

대상 URL에 추가된 utm_medium 매개 변수입니다.
헤드 태그
 links.head_tags string

리디렉션 페이지의 헤드에 삽입된 사용자 지정 HTML 또는 추적 태그입니다.
Google Analytics 4 태그 ID
 links.ga4_tag_id string

링크를 클릭할 때 실행될 Google Analytics 4 측정 ID입니다.
UTM 용어
 links.utm_term string

대상 URL에 추가된 utm_term 매개 변수입니다.
UTM 캠페인
 links.utm_campaign string

대상 URL에 추가된 utm_campaign 매개 변수입니다.
어제 사람의 클릭
 links.human_clicks_previous_day integer

봇 신호 없이 어제(UTC)를 클릭합니다.
페이지 번호
 page_number integer

현재 페이지 번호입니다.
페이지 크기
 page_size integer

페이지당 반환할 링크 수입니다.
총 항목
 total_entries integer

요청과 일치하는 총 링크 수입니다.
총 페이지 수
 total_pages integer

사용 가능한 총 페이지 수입니다.
총 행 수
 total_rows integer

총 행 수입니다.
작업 영역 링크 수
 workspace_link_count integer

작업 영역의 총 링크 수입니다.

링크 만들기 또는 업데이트

작업 ID:
CreateOrUpdateLink

새 짧은 링크를 만들거나 링크 ID가 제공되면 기존 링크를 업데이트합니다. 사용자 지정 도메인 및 슬러그, UTM 매개 변수, 대상 다시 지정 픽셀 및 Open Graph 메타데이터를 지원합니다.

매개 변수

속성 키 필수 형식 Description
대상 URL
 url uri

짧은 링크가 리디렉션하는 대상 URL입니다. 새 링크를 만드는 데 필요합니다.
링크 ID
 id integer

업데이트할 기존 링크의 ID입니다. 새 링크를 만들려면 비워 둡니다.
Name
 name string

대시보드에 표시된 링크의 애칭입니다.
도메인
 domain string

후행 슬래시 없이 짧은 링크에 사용할 사용자 지정 도메인입니다.
슬러그
 slug string

짧은 링크에 대한 사용자 지정 경로입니다. 슬래시로 시작해야 합니다.
활성화됨
 enabled boolean

링크가 활성 상태인지 여부입니다.
참고
 note string

링크에 대한 비공개 메모입니다.
UTM 원본
 utm_source string

대상 URL에 추가된 utm_source 매개 변수입니다.
UTM 중간
 utm_medium string

대상 URL에 추가된 utm_medium 매개 변수입니다.
UTM 캠페인
 utm_campaign string

대상 URL에 추가된 utm_campaign 매개 변수입니다.
UTM 콘텐츠
 utm_content string

대상 URL에 추가된 utm_content 매개 변수입니다.
UTM 용어
 utm_term string

대상 URL에 추가된 utm_term 매개 변수입니다.
메타 픽셀 ID
 fb_pixel_id string

링크를 클릭할 때 실행될 메타(Facebook) 픽셀 ID입니다.
Google Analytics 4 태그 ID
 ga4_tag_id string

링크를 클릭할 때 실행될 Google Analytics 4 측정 ID입니다.
Google 태그 관리자 ID
 gtm_id string

링크를 클릭할 때 로드할 Google 태그 관리자 컨테이너 ID입니다.
블록 봇
 block_bots boolean

알려진 봇이 링크를 따르지 못하도록 차단할지 여부입니다.
본문 태그
 body_tags string

리디렉션 페이지의 본문에 삽입된 사용자 지정 HTML 또는 추적 태그입니다.
클로킹
 cloaking boolean

프레임 내에서 대상을 열어 대상을 숨길지 여부입니다.
전달 매개 변수
 forward_params boolean

짧은 링크에서 대상으로 쿼리 매개 변수를 전달할지 여부입니다.
헤드 태그
 head_tags string

리디렉션 페이지의 헤드에 삽입된 사용자 지정 HTML 또는 추적 태그입니다.
참조자 숨기기
 hide_referrer boolean

대상 사이트에서 참조자를 숨길지 여부입니다.
그래프 설명 열기
 og_description string

링크가 소셜 미디어에서 공유되는 경우 표시되는 설명입니다.
그래프 이미지 열기
 og_image string

링크가 소셜 미디어에서 공유되는 경우 표시되는 이미지 URL입니다.
그래프 제목 열기
 og_title string

링크가 소셜 미디어에 공유되면 표시되는 제목입니다.
TikTok 픽셀 ID
 tiktok_pixel_id string

링크를 클릭할 때 실행될 TikTok 픽셀 ID입니다.

반품

속성 경로 형식 Description
메타 픽셀 ID
 fb_pixel_id string

링크를 클릭할 때 실행될 메타(Facebook) 픽셀 ID입니다.
LinkedIn 파트너 ID
 linkedin_partner_id string

링크를 클릭할 때 발생할 LinkedIn Insight 태그 파트너 ID입니다.
UET 태그 ID Microsoft
 microsoft_uet_tag_id string

링크를 클릭할 때 발생할 Microsoft Advertising UET 태그 ID입니다.
Reddit 픽셀 ID
 reddit_pixel_id string

링크를 클릭할 때 실행될 Reddit 픽셀 ID입니다.
TikTok 픽셀 ID
 tiktok_pixel_id string

링크를 클릭할 때 실행될 TikTok 픽셀 ID입니다.
참조자 숨기기
 hide_referrer boolean

대상 사이트에서 참조자를 숨길지 여부입니다.
만료 날짜
 expiry_datetime string

링크가 작동을 중지하면 ISO 8601 형식입니다.
만료 대상
 expiry_destination uri

링크가 만료된 후 리디렉션할 URL입니다. 찾을 수 없는 페이지를 반환하려면 비워 둡니다.
X 픽셀 ID
 twitter_pixel_id string

링크를 클릭할 때 실행될 X(Twitter) 픽셀 ID입니다.
클로킹
 cloaking boolean

프레임 내에서 대상을 열어 대상을 숨길지 여부입니다.
짧은 URL
 full_url uri

전체 짧은 링크 URL입니다.
그래프 설명 열기
 og_description string

링크가 소셜 미디어에서 공유되는 경우 표시되는 설명입니다.
소셜 크롤러 추적 건너뛰기
 skip_social_crawler_tracking boolean

클릭 추적에서 소셜 미디어 미리 보기 크롤러를 제외할지 여부입니다.
본문 태그
 body_tags string

리디렉션 페이지의 본문에 삽입된 사용자 지정 HTML 또는 추적 태그입니다.
그래프 제목 열기
 og_title string

링크가 소셜 미디어에 공유되면 표시되는 제목입니다.
참고
 note string

링크에 대한 비공개 메모입니다.
Name
 name string

대시보드에 표시된 링크의 애칭입니다.
링크 ID
 id integer

업데이트할 기존 링크의 ID입니다. 새 링크를 만들려면 비워 둡니다.
Google 태그 관리자 ID
 gtm_id string

링크를 클릭할 때 로드할 Google 태그 관리자 컨테이너 ID입니다.
그래프 이미지 열기
 og_image string

링크가 소셜 미디어에서 공유되는 경우 표시되는 이미지 URL입니다.
블록 봇
 block_bots boolean

알려진 봇이 링크를 따르지 못하도록 차단할지 여부입니다.
Snapchat 픽셀 ID
 snapchat_pixel_id string

링크를 클릭할 때 실행될 Snapchat 픽셀 ID입니다.
UTM 콘텐츠
 utm_content string

대상 URL에 추가된 utm_content 매개 변수입니다.
활성화됨
 enabled boolean

링크가 활성 상태인지 여부입니다.
대상 URL
 url uri

짧은 링크가 리디렉션하는 대상 URL입니다. 새 링크를 만드는 데 필요합니다.
삭제됨
 deleted boolean

링크가 휴지통에 있는지 여부입니다.
웹후크
 webhooks array of string

이 링크를 클릭하기 위해 구독한 웹후크 URL입니다.
만료 클릭
 expiry_clicks integer

링크가 작동을 중지한 후의 클릭 수입니다.
Slack에 알림
 notify_slack boolean

링크를 클릭할 때 Slack 알림을 보낼지 여부입니다.
작업 영역 ID
 workspace_id integer

작업 영역의 ID입니다.
퍼블릭 분석
 public_analytics boolean

링크의 분석 페이지를 공개적으로 볼 수 있는지 여부입니다.
Pinterest 태그 ID
 pinterest_tag_id string

링크를 클릭할 때 발생할 Pinterest 태그 ID입니다.
UTM 원본
 utm_source string

대상 URL에 추가된 utm_source 매개 변수입니다.
슬러그
 slug string

짧은 링크에 대한 사용자 지정 경로입니다. 슬래시로 시작해야 합니다.
도메인
 domain string

후행 슬래시 없이 짧은 링크에 사용할 사용자 지정 도메인입니다.
전달 매개 변수
 forward_params boolean

짧은 링크에서 대상으로 쿼리 매개 변수를 전달할지 여부입니다.
UTM 중간
 utm_medium string

대상 URL에 추가된 utm_medium 매개 변수입니다.
헤드 태그
 head_tags string

리디렉션 페이지의 헤드에 삽입된 사용자 지정 HTML 또는 추적 태그입니다.
Google Analytics 4 태그 ID
 ga4_tag_id string

링크를 클릭할 때 실행될 Google Analytics 4 측정 ID입니다.
UTM 용어
 utm_term string

대상 URL에 추가된 utm_term 매개 변수입니다.
UTM 캠페인
 utm_campaign string

대상 URL에 추가된 utm_campaign 매개 변수입니다.

링크 삭제

작업 ID:
DeleteLink

휴지통에 대한 링크를 이동합니다. 짧은 URL은 리디렉션을 중지하며 나중에 휴지통에서 링크를 복원할 수 있습니다.

매개 변수

속성 키 필수 형식 Description
Workspace
 workspace_id True string

작업할 작업 영역입니다. 목록에서 선택하거나 ID를 입력합니다.
링크 ID
 id True integer

링크의 ID입니다.

반품

확인 메시지입니다.

response
string

목록 변환

작업 ID:
ListConversions

작업 영역에 기록된 가장 최근의 변환을 반환합니다.

매개 변수

속성 키 필수 형식 Description
Limit
 limit integer

반환할 최대 변환 수(1에서 1000 사이)입니다.

반품

속성 경로 형식 Description
Conversions
 conversions array of object

변환, 가장 최근의 첫 번째.
금액(센트)
 conversions.amount_cents integer

가장 작은 통화 단위의 값입니다. 환불을 기록하는 것은 부정적일 수 있습니다.
ID 클릭
 conversions.click_id string

특성이 지정된 클릭의 ID입니다.
Country
 conversions.country string

두 글자 ISO 3166-1 국가 코드(예: 미국)입니다.
통화
 conversions.currency string

ISO 4217 통화 코드입니다. 기본값은 USD입니다.
이벤트 ID
 conversions.event_id string

이벤트에 대한 식별자입니다. 동일한 값을 두 번 보고해도 두 번째 변환은 생성되지 않습니다.
이벤트 이름
 conversions.event_name string

구매, 등록 또는 trial_started 등의 변경 내용이 있습니다.
이벤트 유형
 conversions.event_type string

거친 이벤트 유형입니다. 잠재 고객을 사용하여 고객 ID 및 판매를 설정하여 수익을 기록합니다. 기본값은 사용자 지정입니다.
고객 ID
 conversions.external_id string

고객의 식별자입니다. 이후 판매가 원래 클릭에 연결될 수 있도록 모든 이벤트에 보냅니다.
변환 ID
 conversions.id string

변환의 고유 식별자입니다. ID는 시간순으로 정렬됩니다.
에 삽입됨
 conversions.inserted_at date-time

변환이 기록된 경우입니다.
IP 원본
 conversions.ip_source string

주소가 기록된 사람: 방문자, 서버 또는 알 수 없음. 서버는 연결 주소가 백 엔드 또는 플랫폼 릴레이에 속하므로 지리적 보고에서 제외됩니다.
링크 ID
 conversions.link_id integer

특성이 지정된 링크의 ID이거나, 변환이 링크에 기인할 수 없는 경우 null입니다.
Metadata
 conversions.metadata object

임의 JSON 메타데이터(최대 10,000바이트)
발생 날짜
 conversions.occurred_at date-time

변환이 발생한 경우 ISO 8601 형식입니다. 기본값은 현재로 설정됩니다.
Source
 conversions.source string

어떤 통합에서 보고했습니다.

변환 보고

작업 ID:
CreateConversion

구매, 등록 또는 사용자 지정 이벤트와 같은 변환을 기록하고 특성 토큰을 제공할 때 클릭한 링크에 특성을 지정합니다.

매개 변수

속성 키 필수 형식 Description
금액(센트)
 amount_cents integer

가장 작은 통화 단위의 값입니다. 환불 또는 환불을 기록하는 것은 부정적일 수 있으며, 이는 이전 수익에 대한 순입니다.
Country
 country string

변환을 위한 두 글자 국가 코드입니다. 브라우저 쪽 호출에 대해 유추됨; 는 연결 주소가 고객이 아닌 고유한 인프라인 서버 쪽 통합에서 명시적으로 제공합니다.
통화
 currency string

ISO 4217 통화 코드입니다. 기본값은 USD입니다.
이벤트 ID
 event_id string

이 이벤트의 식별자입니다. 멱등 키로 사용됨; 동일한 값을 두 번 보고해도 두 번째 변환이 생성되지 않습니다. 구매뿐만 아니라 모든 이벤트 유형에 적용됩니다.
이벤트 이름
 event_name True string

발생한 일(예: 구매, 등록, trial_started)
이벤트 유형
 event_type string

깔때기를 구동하는 거친 형식입니다. 잠재 고객은 고객 ID, 판매 기록 수익을 설정합니다. 기본값은 사용자 지정입니다.
고객 ID
 external_id string

고객의 식별자입니다. 모든 이벤트에 보내기: 이후 서버 쪽 판매를 등록을 생성한 클릭에 다시 연결하는 것입니다.
특성 토큰
 linkly_cid string

방문 페이지 URL에서 캡처된 특성 토큰입니다. 사용할 수 없는 경우 생략합니다. 그러면 변환이 링크 특성 없이 기록됩니다.
Metadata
 metadata object

임의 JSON( 최대 10,000바이트로 인코딩됨)
발생 날짜
 occurred_at date-time

변환이 발생한 경우입니다. 기본값은 현재로 설정됩니다.
방문자 IP
 visitor_ip string

서버에 있는 경우 최종 고객의 IP입니다. 사용하지 않는 한 생략합니다. 서버 쪽 호출의 경우 Linkly는 연결 주소를 고객이 아닌 서버로 기록하고 지리적 보고에서 제외합니다. 이 어설션을 보내면 이를 공유할 수 있는 합법적인 근거가 있습니다. API에서 반환되지 않습니다.

반품

속성 경로 형식 Description
금액(센트)
 amount_cents integer

가장 작은 통화 단위의 값입니다. 환불을 기록하는 것은 부정적일 수 있습니다.
ID 클릭
 click_id string

특성이 지정된 클릭의 ID입니다.
Country
 country string

두 글자 ISO 3166-1 국가 코드(예: 미국)입니다.
통화
 currency string

ISO 4217 통화 코드입니다. 기본값은 USD입니다.
이벤트 ID
 event_id string

이벤트에 대한 식별자입니다. 동일한 값을 두 번 보고해도 두 번째 변환은 생성되지 않습니다.
이벤트 이름
 event_name string

구매, 등록 또는 trial_started 등의 변경 내용이 있습니다.
이벤트 유형
 event_type string

거친 이벤트 유형입니다. 잠재 고객을 사용하여 고객 ID 및 판매를 설정하여 수익을 기록합니다. 기본값은 사용자 지정입니다.
고객 ID
 external_id string

고객의 식별자입니다. 이후 판매가 원래 클릭에 연결될 수 있도록 모든 이벤트에 보냅니다.
변환 ID
 id string

변환의 고유 식별자입니다. ID는 시간순으로 정렬됩니다.
에 삽입됨
 inserted_at date-time

변환이 기록된 경우입니다.
IP 원본
 ip_source string

주소가 기록된 사람: 방문자, 서버 또는 알 수 없음. 서버는 연결 주소가 백 엔드 또는 플랫폼 릴레이에 속하므로 지리적 보고에서 제외됩니다.
링크 ID
 link_id integer

특성이 지정된 링크의 ID이거나, 변환이 링크에 기인할 수 없는 경우 null입니다.
Metadata
 metadata object

임의 JSON 메타데이터(최대 10,000바이트)
발생 날짜
 occurred_at date-time

변환이 발생한 경우 ISO 8601 형식입니다. 기본값은 현재로 설정됩니다.
Source
 source string

어떤 통합에서 보고했습니다.

사용자 지정 도메인 나열

작업 ID:
ListDomains

작업 영역에 대해 구성된 사용자 지정 도메인을 반환합니다. 이러한 도메인 이름은 링크를 만들 때 사용할 수 있습니다.

매개 변수

속성 키 필수 형식 Description
Workspace
 workspace_id True string

작업할 작업 영역입니다. 목록에서 선택하거나 ID를 입력합니다.

반품

속성 경로 형식 Description
Domains
 domains array of object

작업 영역의 사용자 지정 도메인입니다.
도메인 이름
 domains.name string

도메인 이름(예: go.yourcompany.com)입니다.

작업 영역 나열

작업 ID:
ListWorkspaces

이 연결에 사용할 수 있는 작업 영역을 반환합니다. 이를 사용하여 다른 작업에 필요한 작업 영역을 찾습니다.

반품

속성 경로 형식 Description
array of object
작업 영역 ID
 id integer

작업 영역의 고유 식별자입니다.
작업 영역 이름
 name string

작업 영역의 이름입니다.

차원별 클릭 수 가져오기

작업 ID:
GetClickCounters

국가, 도시, 플랫폼, 참조자 또는 UTM 매개 변수와 같은 차원별로 그룹화된 클릭 수를 개수 내림차순으로 반환합니다.

매개 변수

속성 키 필수 형식 Description
Workspace
 workspace_id True string

작업할 작업 영역입니다. 목록에서 선택하거나 ID를 입력합니다.
Dimension
 counter True string

클릭을 그룹화할 차원(예: 국가, 도시, 플랫폼, 참조자 또는 utm_campaign)입니다.
링크 ID
 link_id string

필터링할 단일 링크의 ID입니다.
링크 ID
 link_ids string

필터링할 링크 ID의 하이픈으로 구분된 목록입니다.
시작 날짜
 start string

날짜 범위의 시작(YYYY-MM-DD 형식)
종료 날짜
 end string

날짜 범위의 끝(YYYY-MM-DD 형식)
Country
 country string

두 글자 ISO 3166-1 국가 코드(예: 미국)입니다.
봇 포함
 bots boolean

봇으로 식별된 클릭을 포함할지 여부입니다. 제외하려면 false로 설정합니다.
고유 전용
 unique boolean

고유한 클릭만 계산할지 여부입니다.

반품

속성 경로 형식 Description
Total
 total integer

값에 반환되지 않은 항목을 포함하여 모든 그룹의 총 클릭 수입니다. 결과가 잘리면 값의 개수 합계보다 크므로 count/total은 여전히 정확한 백분율을 제공합니다.
가치들
 values array of object

그룹화된 개수, 카운트 내림차순으로 정렬됩니다. 상위 10,000개 값으로 잘렸습니다. 차원에 해당 값보다 더 많은 고유 값이 있으면 나머지는 반환되지 않습니다.
개수
 values.count integer

이 값의 클릭 횟수입니다.
Value
 values.value string

차원의 값(예: 국가 코드)입니다.

클릭 분석 가져오기

작업 ID:
GetClicks

날짜 범위, 국가, 브라우저, 플랫폼, 참조자 또는 ISP별로 선택적으로 필터링된 작업 영역 또는 특정 링크에 대한 시간 경과에 따른 클릭 수를 반환합니다.

매개 변수

속성 키 필수 형식 Description
Workspace
 workspace_id True string

작업할 작업 영역입니다. 목록에서 선택하거나 ID를 입력합니다.
링크 ID
 link_id string

필터링할 단일 링크의 ID입니다.
링크 ID
 link_ids string

필터링할 링크 ID의 하이픈으로 구분된 목록입니다.
시작 날짜
 start string

날짜 범위의 시작(YYYY-MM-DD 형식)
종료 날짜
 end string

날짜 범위의 끝(YYYY-MM-DD 형식)
Country
 country string

두 글자 ISO 3166-1 국가 코드(예: 미국)입니다.
Browser
 browser string

필터링할 브라우저 이름(예: Chrome, Firefox 또는 Safari)입니다.
Platform
 platform string

Windows, Mac, iOS 또는 Android와 같이 필터링할 플랫폼 또는 운영 체제입니다.
리퍼러
 referer string

필터링할 참조 도메인입니다.
인터넷 서비스 공급자 (ISP)
 isp string

필터링할 인터넷 서비스 공급자 이름입니다.
봇 포함
 bots boolean

봇으로 식별된 클릭을 포함할지 여부입니다. 제외하려면 false로 설정합니다.
고유 전용
 unique boolean

고유한 클릭만 계산할지 여부입니다.
시간대
 timezone string

날짜 계산에 사용되는 IANA 표준 시간대(예: 유럽/런던)입니다.
빈도
 frequency string

시계열의 세분성(일 또는 시간)입니다.

반품

속성 경로 형식 Description
Traffic
 traffic array of object

클릭 횟수는 시간이 지남에 따라 계산됩니다.
버킷 시작
 traffic.t string

버킷 시작: 일일 버킷의 경우 YYYY-MM-DD, 매시간 버킷의 경우 YYYY-MM-DDTHH:MM:SS입니다.
클릭 수
 traffic.y integer

버킷의 클릭 수입니다.

정의

string

기본 데이터 형식 'string'입니다.