X (Twitter) Web - 웹에서 앱으로 연결되는 캠페인

X (Twitter) Ads 설정

이 문서는 X (Twitter) 웹 캠페인(비앱 캠페인) 에 대한 Singular의 모바일, PC 및 콘솔 설치 어트리뷰션을 구성하는 방법을 설명합니다. X (Twitter) 앱 캠페인 을 구성하고 어트리뷰션하는 방법은 X (Twitter) Ads Attribution 가이드 를 참조하세요.

X (Twitter) 캠페인은 MMP 트래커 URL을 지원하지 않으므로, 모든 전환은 클릭스루 어트리뷰션으로만 측정되며 Singular Tracker를 Website URL에 설정합니다.

개요

Singular의 web-to-app 어트리뷰션 솔루션은 마케터가 모바일, PC 및 콘솔 플랫폼 전반에서 앱 설치를 유도하는 웹 캠페인을 실행할 수 있도록 지원합니다. 자세한 내용은 Web, Web-to-App, PC, & Console Campaign Optimization 을 참조하세요.

Singular에서 X (Twitter) Web Partner Configuration 추가하기

Singular에서 X (Twitter) Web CAPI Partner Configuration 추가하기

  1. Singular > Attribution > Partner Configuration 으로 이동합니다
  2. " Add a Partner "를 클릭한 후, " Twitter Web CAPI "를 입력하고 선택합니다
  3. 대화 상자에서 구성할 App과 App site(플랫폼)를 선택합니다. 이 연동에서는 모바일, PC 및 콘솔 앱이 지원됩니다
  4. 앱의 " Access Token ", " Access Secret ", " Consumer Key ", " Consumer Secret ", " Install Event ID " 및 " Pixel ID "를 붙여넣습니다.
    Access Token, Access Secret, Consumer Key, Consumer Secret, Install Event ID 및 Pixel ID 필드를 보여주는 Singular Twitter Web CAPI 파트너 구성
  5. 선택적으로 X (Twitter)로 전송할 추가 이벤트를 구성하고 "X Event ID"에 매핑합니다
    Singular에서 X Event ID에 매핑된 추가 이벤트 구성

  6. 완료하려면 " Save "를 클릭합니다.
"Twitter Web CAPI"용 Singular Link 생성하기

"Twitter Web CAPI"용 Singular Link 생성하기

  1. Singular > Attribution > Manage Links 로 이동합니다
  2. 왼쪽의 앱 목록에서 모바일 앱을 선택합니다
  3. "Create Link" -> Link Type "Partner" -> Source Name "Twitter Web CAPI" 를 선택합니다
  4. 단계별 링크 생성을 계속 진행합니다.
  5. (선택 사항) 링크에 iOS 딥링크 대상이 포함되어 있다면 Social Landing Page를 활성화합니다. 자세한 내용은 아래 를 참조하세요.
  6. "Generate" 를 클릭합니다
  7. 다음 단계를 위해 "Click-through Tracking Link" 를 복사합니다.

딥링크를 사용할 계획인가요?

X (Twitter)의 인앱 브라우저는 iOS Universal Links를 지원하지 않습니다. 사용자가 iOS의 X (Twitter) 앱 내에서 광고를 클릭하면 딥링크가 아무 알림 없이 실패하여, 사용자가 의도한 대상 대신 앱의 홈 화면에 도달하게 됩니다.

Singular의 Social Landing Page 가 이 문제를 해결합니다. 이는 Singular가 자동으로 생성하는 중간 페이지로, 별도의 설정이 필요하지 않습니다. 사용자가 광고를 클릭하면 이 페이지에 도달하며, CTA 버튼을 탭하면 앱 내 올바른 화면으로 딥링크가 안정적으로 실행됩니다.

활성화 방법: 링크 생성 플로우에서 Social Link Settings > Enable Landing Page 토글로 이동합니다.

⚠️ 링크에 딥링크 대상이 포함되어 있지 않은 경우에는 권장하지 않습니다.

Social Landing Page에 대해 자세히 알아보기

Twitter Web 캠페인 설정하기

Twitter Web 캠페인 설정하기

  1. Twitter Ads Manager에서 캠페인을 생성하고 Sales 또는 Website Traffic 캠페인 목표 중 하나를 선택합니다:
    • Sales - Singular Partner Configuration에서 설정한 이벤트를 기반으로 최적화합니다
    • Website Traffic - 클릭을 기준으로 최적화합니다
    Twitter Ads Manager에서 Sales 또는 Website Traffic 캠페인 목표 선택
  2. 미디어를 추가할 때, 위 섹션의 Singular Link를 Website URL로 설정합니다
    Twitter Ads Manager에서 미디어를 추가할 때 Singular Link를 Website URL로 설정하기
  3. X Ads는 링크 매크로를 처리하지 않으므로 모든 캠페인 매크로를 수동으로 입력합니다. 예시:
    https://singular.sng.link/XXXXX/YYYY?pcn={campaign_name}&pscn={ad_group_name}&pcrn={ad_name}&wpsrc=Twitter%20Web%20CAPI&_forward_params=1&wpcn={campaign_name}&wpscn={ad_group_name}&wpcrn={ad_name}
    에서
    https://singular.sng.link/XXXXX/YYYY?pcn=Singular%20CName%20Test&pscn=Singular%20AdGroup%20Test1&pcrn=Singular%20Ad%20Test2&wpsrc=Twitter%20Web%20CAPI&_forward_params=1&wpcn=Singular%20CName%20Test&wpscn=Singular%20AdGroup%20Test1&wpcrn=Singular%20Ad%20Test2
    로 변경합니다 X Ads용으로 캠페인 매크로를 수동으로 입력한 Singular Link 예시

FAQ

Access 및 Consumer Token과 Secret은 어디에서 찾을 수 있나요?
  1. X Developer Account에 가입하지 않았다면, X Developer Portal의 안내에 따라 가입하고 APP을 생성하세요: X Ads API: Getting Started .
  2. Developer APP을 생성한 후, X Developer Portal 대시보드로 이동합니다.
  3. " Projects & Apps " 페이지로 이동하여 프로젝트를 선택하고 APP의 credentials 페이지를 엽니다. X Developer Portal의 Projects & Apps 페이지에서 앱 credentials 페이지 열기
  4. Keys and tokens 페이지에서 연동에 필요한 모든 API credentials를 찾을 수 있습니다: X Developer Portal의 Keys and tokens 페이지에서 API credentials 찾기
X Event ID와 X Pixel ID는 어디에서 찾을 수 있나요?
  1. X Ads Manager 페이지로 이동합니다.
  2. " Tools & Events Manager " 페이지로 이동합니다. X Ads Manager에서 Tools & Events Manager 페이지로 이동하기
  3. 상단에서 " X pixel "을 복사하고, 하단 표에서 " Event IDs "를 복사합니다 Tools & Events Manager에서 상단의 X pixel ID와 표의 Event ID 복사하기

    새로운 pixel 또는 이벤트인 경우, X Ad의 단계별 가이드를 따라 " Pixel "을 생성하세요. Generating the Pixel and Creating Events 에 대해 자세히 알아보세요.
Singular는 API를 통해 어떤 데이터를 전송하나요?
Parameter Details
conversion_time
  • 설치 또는 이벤트 타임스탬프.
event_id
  • 표준 X Event ID입니다. 이 값은 X가 이벤트를 중복 제거하는 데 도움을 주기 위해 사용됩니다.
twclid
  • X (Twitter) 클릭 ID
  • 자동으로 전달됨
hashed email
  • twclid가 제공되는 경우 선택 사항입니다.
  • 해시된 이메일은 Singular instrumented 이벤트 속성 "ehash"로 전달될 수 있습니다
  • 해시된 이메일 값은 정규화되고 SHA 256으로 해시되어야 합니다
IP address
  • 클라이언트 IP 주소
user agent
  • 이벤트에 해당하는 브라우저의 user agent
X (Twitter) Conversions API의 제한 사항은 무엇인가요?
  • 캠페인 데이터를 자동으로 채우는 매크로가 없습니다. Singular에서 이 분류를 확인하려면, 위의 " Twitter Web 캠페인 설정하기 " 메뉴에서 안내된 대로 Website URL을 추가할 때 이를 수동으로 설정해야 합니다.
  • X Ads는 X Conversion API를 기존 X pixel 구현을 보완하거나 웹사이트에 JavaScript를 구현할 수 없는 경우에 사용할 것을 권장합니다.
  • 모바일 연동의 경우, X와 Singular는 모바일 전환 데이터를 X Ads와의 Singular 전용 모바일 어트리뷰션 연동을 통해 전달할 것을 권장합니다. X Conversions API를 통해 모바일 전환 데이터를 전달하는 데 관심이 있다면 Singular 고객 성공 매니저에게 문의하세요.