Communitygithub.com

cameronalexander720/해외-광고-어트리뷰션-링크-스킬

해외 광고 어트리뷰션 링크, 딥 링크, 랜딩 페이지, SDK 타이밍, PushAPI 콜백, 설치 리퍼러 흐름, 광고 파라미터 매핑 및 설치 후 라우팅 문제를 설계하고 트러블슈팅하는 에이전트 스킬입니다.

해외-광고-어트리뷰션-링크-스킬란 무엇인가요?

이 스킬은 AI 에이전트(Claude Code, Cursor, Codex 등)가 해외 광고 어트리뷰션 링크와 관련된 기술 솔루션 설계 및 문제 해결을 수행할 수 있도록 지원합니다. 주요 기능으로는 딥 링크, 랜딩 페이지, SDK 어트리뷰션 타이밍, PushAPI 콜백, Google Install Referrer 흐름, 광고 파라미터 매핑, 설치 후 라우팅 문제 진단 등이 포함됩니다. 에이전트는 사용자 요청에 따라 '기술 솔루션 설계' 모드 또는 'Q&A 및 트러블슈팅' 모드로 전환하여 동작합니다. 설계 모드에서는 시나리오 명확화, 비즈니스 목표 식별, 모듈 정의, 데이터 소스 우선순위 지정, 클라이언트/백엔드 동작 명세, 검증 계획 수립 등 체계적인 워크플로우를 제공합니다. Q&A 모드에서는 관찰된 증상을 관련 체인 단계에 매핑하고, 참조 지식을 기반으로 원인을 설명하며, 확인 체크리스트를 제시합니다. 또한 어트리뷰션 완료와 설치 후 라우팅 성공의 차이, 사전/사후 어트리뷰션 구분, Google Install Referrer의 특성 등 도메인별 가드레일을 포함하여 정확하고 신뢰할 수 있는 분석을 보장합니다. 민감한 컨텍스트(회사명, 프로젝트명, 개인정보 등)는 일반화하여 출력하도록 설계되었습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add cameronalexander720/overseas-ad-attribution-link-skill

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

해외 광고 어트리뷰션 링크 스킬

운영 모드

이 스킬은 두 가지 출력 유형에 사용됩니다:

  1. 해외 광고 어트리뷰션 링크 기능에 대한 기술 솔루션 설계
  2. 어트리뷰션, 파라미터, SDK 타이밍, PushAPI, 랜딩 페이지, 딥 링크, 이벤트 콜백, 리포팅 제어 및 설치 후 라우팅 동작에 대한 Q&A 및 트러블슈팅

먼저 모드를 식별하세요. 사용자가 기술 솔루션, 통합 계획, 제품/기술 검토, 기능 설계 또는 아키텍처를 요청하는 경우 솔루션 설계 모드를 사용하세요. 사용자가 특정 체인이 특정 방식으로 동작하는 이유, 소스를 판단하는 방법, 파라미터의 출처, 링크 단계의 작동 방식, 또는 지표나 동작 증상을 트러블슈팅하는 방법을 묻는 경우 Q&A 모드를 사용하세요.

필수 참조 로드

요청에 필요한 참조만 로드하세요:

  • 기술 솔루션 또는 기능 아키텍처의 경우: references/technical-solution-template.md를 읽으세요.
  • 어트리뷰션 규칙, 데이터 소스 우선순위, 인터페이스 타이밍, 파라미터 매핑 또는 이벤트 콜백의 경우: references/attribution-knowledge.md를 읽으세요.
  • 사용법 질문, 진단 또는 설명의 경우: references/qa-playbook.md를 읽으세요.

사용자가 현재 작업을 위해 명시적으로 제공하지 않는 한, 고객별 소스 문서를 로드하거나 인용하지 마세요.

솔루션 설계 워크플로우

해외 광고 어트리뷰션 링크 솔루션을 작성할 때:

  1. 시나리오를 명확히 하세요: 딥 링크, 랜딩 페이지, SDK 어트리뷰션, PushAPI, Google Install Referrer 또는 혼합 체인.
  2. 비즈니스 목표를 식별하세요: 어트리뷰션 완료, 광고 계층 역채우기, 이벤트 콜백, 프로모션 콘텐츠로의 설치 후 라우팅, 모델 학습 신호, 리포팅 제어 또는 지표 조정.
  3. 액터 및 모듈을 정의하세요: 미디어 플랫폼, 광고 링크 생성기, 랜딩 페이지 스마트 스크립트, 앱 클라이언트, SDK/MMP, 백엔드 어트리뷰션 서비스, 리포팅 서비스, 관리 구성 및 데이터 웨어하우스.
  4. 데이터 소스와 우선순위를 지정하세요. 각 소스의 타이밍, 신뢰성, 매칭 키, 폴백 동작 및 허용된 사용을 문서화하세요.
  5. 클라이언트 타이밍을 지정하세요: 콜드 스타트, 최초 설치 열기, 개인정보 동의, SDK 콜백 타이밍, 폴백 타임아웃, 숏 폴링, 핫 스타트 및 세션 수준 제한.
  6. 백엔드 동작을 지정하세요: 매칭, 중복 제거, 스프레드 매핑, 광고 계층 역채우기, 이벤트 자격 및 콜백 라우팅.
  7. 사용자 대면 동작을 지정하세요: 자동 라우팅, 라우팅 프롬프트, 사용자가 이미 콘텐츠를 소비 중인 경우 라우팅 억제 또는 어트리뷰션 결과가 도착할 때까지 지연.
  8. 검증을 지정하세요: 소스/채널별 사례, 파라미터 예시, 예상 로그, 이벤트 콜백, 지표 확인, 그레이 릴리스 및 롤백 스위치.

references/technical-solution-template.md를 구조로 사용하세요. 좁은 요청과 관련 없는 섹션은 제거하세요.

Q&A 워크플로우

사용법 질문에 답변할 때:

  1. 관찰된 증상 또는 결정 지점을 다시 설명하세요.
  2. 관련 체인 단계를 명명하세요: 광고 클릭, 랜딩 페이지, 설치, 최초 열기, SDK 콜백, 사전 어트리뷰션, 사후 어트리뷰션, 광고 정보 요청, 이벤트 콜백 또는 분석 조정.
  3. 이를 references/attribution-knowledge.md의 알려진 규칙에 매핑하세요.
  4. 특히 PushAPI, Google Install Referrer 또는 SDK 데이터가 늦게 도착하는 경우 소스 우선순위와 타이밍을 통해 가능한 원인을 설명하세요.
  5. 확인 체크리스트를 제공하세요: 로그, 필드, 요청 타이밍, 사용자 상태, 스프레드/광고 계층 필드, 이벤트 자격 및 리포팅 스위치.
  6. 확인된 사실과 가정을 분리하세요. 현재 프로젝트에 자체 규칙이 있는 경우, 일반 패턴을 재정의하기 전에 사용자에게 관련 규칙이나 문서 발췌문을 요청하세요.

도메인 가드레일

  • 어트리뷰션 완료와 설치 후 라우팅/재생 성공을 구분하세요. 사용자가 어트리뷰션되었지만 프로모션 콘텐츠로 라우팅되지 않을 수 있습니다.
  • 사전 어트리뷰션과 사후 어트리뷰션을 구분하세요. 사전 어트리뷰션은 즉각적인 앱 동작에 영향을 미칩니다. 사후 어트리뷰션은 나중에 어트리뷰션을 완료할 수 있지만 폴링 또는 라우팅 보상이 필요할 수 있습니다.
  • Google Install Referrer를 최초 설치 열기 지향으로 취급하세요. 설치 후 새로운 광고 클릭마다 업데이트된다고 가정하지 마세요.
  • 사용자가 프로젝트별 규칙을 명시하지 않는 한, "최신 필드 우선" 규칙보다 명시적인 소스 우선순위 규칙을 선호하세요.
  • 이벤트 콜백을 논의할 때 미디어 이벤트 매핑, 자격 규칙, 중복 제거 및 리포팅 스위치를 분리하세요.
  • 지표 문제가 나타나면 어트리뷰션 로직이 잘못되었다고 결론 내리기 전에 어트리뷰션 타이밍과 앱 경험을 모두 검사하세요.

민감 컨텍스트 가드레일

  • 생성된 재사용 가능한 지침에 회사명, 프로젝트명, 문서명, 과거 날짜, 개인 이름, 로컬 파일 경로, 토큰, URL, 패키지명, 캠페인명 또는 원시 로그 예제를 포함하지 마세요.
  • Facebook, TikTok, Snapchat, Google과 같은 공개 미디어/플랫폼 이름은 솔루션 설계 또는 트러블슈팅과 관련된 경우 유지될 수 있습니다.
  • 내부 회사명, 프로젝트명, 문서 제목, 캠페인명, 패키지명 및 원시 계정 식별자는 제거하거나 일반화해야 합니다.
  • 소스가 내부적이거나, 고객별이거나, 답변에 필요하지 않은 경우 "미디어 SDK", "MMP SDK", "소셜 미디어 채널", "광고 네트워크", "랜딩 페이지 로그" 또는 "설치 소스 API"와 같은 일반 카테고리를 사용하세요.
  • "초기 요청", "폴백 타임아웃", "숏 폴링 윈도우"와 같은 상대적 타이밍을 사용하세요. 사용자가 현재 작업에 날짜를 제공하지 않는 한 과거 날짜를 피하세요.

관련 스킬