Communitygithub.com

cameronalexander720/海外広告アトリビューションリンクスキル

海外広告のアトリビューションリンク、ディープリンク、ランディングページ、SDKタイミング、PushAPIコールバック、インストールリファラーフロー、広告パラメータマッピング、およびインストール後ルーティングの問題を設計・トラブルシューティングするためのエージェントスキルです。

海外広告アトリビューションリンクスキル とは?

このスキルは、海外広告のアトリビューションリンクに関わる技術設計とトラブルシューティングを効率化するために設計されています。開発者やAIエージェントユーザーが、複雑なアトリビューションチェーン(ディープリンク、ランディングページ、SDK連携、PushAPI、Google Install Referrerなど)を扱う際に、段階的なワークフローとドメイン知識を提供します。 主な機能は2つあります。1つ目は「ソリューション設計モード」で、アトリビューションリンクの技術設計、統合計画、機能アーキテクチャを、テンプレートに従って体系的に作成します。2つ目は「Q&Aモード」で、アトリビューションの挙動やパラメータの問題を診断し、既知のルールや優先順位に基づいて原因を特定するためのチェックリストを提供します。 このスキルは、Claude Code、Coder、CodexなどのAIエージェントでの使用に適しており、ユーザーが参照する必要のあるドキュメント(技術ソリューションテンプレート、アトリビューション知識、QAプレイブック)を要求に応じて動的に読み込む柔軟な構造を持っています。機密情報(企業名、プロジェクト名など)を出力から自動的に除外するガードレールも備えており、安全で汎用的なガイダンスを提供します。 さらに、アトリビューション完了とインストール後ルーティングの区別、Google Install Referrerの性質、イベントコールバックの構成要素など、ドメイン固有の注意点を明示しており、正確な技術判断を支援します。

対応~Claude Code~Codex CLI~Cursor
npx skills add cameronalexander720/overseas-ad-attribution-link-skill

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

海外広告アトリビューションリンクスキル は何をしますか?

動作モード

このスキルは、以下の2つの出力タイプで使用します。

  1. 技術ソリューション設計:海外広告アトリビューションリンク機能の設計。
  2. Q&Aおよびトラブルシューティング:アトリビューション、パラメータ、SDKタイミング、PushAPI、ランディングページ、ディープリンク、イベントコールバック、レポート制御、インストール後ルーティング動作に関する問題の解決。

最初にモードを特定します。ユーザーが技術的なソリューション、統合計画、製品/技術レビュー、機能設計、またはアーキテクチャを要求した場合はソリューション設計モードを使用します。ユーザーがチェーンの特定の動作理由、ソースの評価方法、パラメータの発生源、リンクステージの動作、またはメトリクスや動作症状のトラブルシューティング方法を尋ねた場合は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」などの汎用カテゴリを使用します。
  • 「初期リクエスト」、「フォールバックタイムアウト」、「ショートポーリングウィンドウ」などの相対的なタイミングを使用します。ユーザーが現在の成果物に日付を提供しない限り、過去の日付は避けます。

関連スキル