コンバージョントラッキング

記録されたすべてのクリックに、短く一意なクリックIDが付きます。それをサイトに渡し、誰かがコンバージョンしたときに報告すると、Letlinkがリード、売上、登録を正確なリンク、キャンペーン、国、デバイスに紐付けます。

1. クリックIDをサイトに渡す

リンクでクリックIDを付加をオンにします。訪問者はリンク先に?lk_click=…付きで到着します。パラメータ名はコンバージョン設定で変更できます。多くのアフィリエイトネットワークはsubidまたはclickidを想定しています。

またはリンク先URLにトークンを自分で入れます。{click_id}はクリックIDに置き換えられ（何も付加されません）、次のトークンも使えます：{slug}、{country}、{device}、{utm_source}、{utm_medium}、{utm_campaign}、{utm_term}、{utm_content}。

https://shop.example.com/offer?subid={click_id}&src={utm_source}&geo={country}

2a. ブラウザからコンバージョンを報告

スニペットをサイトのすべてのページに追加してください。クリックIDをファーストパーティCookieとローカルストレージに保存し、letlink()を呼び出したときにコンバージョンを報告します。

<script>window.letlink=window.letlink||function(){(letlink.q=letlink.q||[]).push(arguments)};</script>
<script async src="https://letl.ink/t.js" data-param="lk_click"></script>

<!-- on the thank-you page -->
<script>
  letlink('sale', { value: 49.90, currency: 'USD', order_id: 'ORDER-123' });
</script>

イベントはlead、sale、signup、custom（event_name付き）です。任意のフィールド：value、currency（ISOコード）、order_id、email（SendGridとMailchimp連携で使用）、metadata（追加フィールドの小さなオブジェクト）。

2b. サーバー間でコンバージョンを報告

ショップ、CRM、アフィリエイトネットワークは、GETまたはPOSTでポストバックURLを呼び出せます：

https://letl.ink/postback?click_id={click_id}&event=sale&amount=49.90&currency=USD&txid=ORDER-123

• クリックID：click_id、clickid、cid、subid、sub_id、aff_sub。
• 金額：amount、payout、value、revenue。マイナスの金額は返金を表します。
• トランザクション：txid、transaction_id、order_id。
• ステータス：approved（デフォルト）、pending、declined、refunded。保留中の売上を先に報告し、同じトランザクションIDで後から承認できます。
• ポストバックキー：コンバージョン設定でキーを設定し、すべてのポストバックにkey=…を付けます。キーのないポストバックは拒否されます。

またはAPIトークンを使ってPOST /api/v1/conversionsを呼び出します（GrowthとUltimate）。

応答

ポストバックとAPIは常に200で応答し、X-Letlink-Resultヘッダーにcreated、updated（既知のトランザクションの新しいステータス）、duplicate、unknown_click、bad_key、outside_window、not_allowed（プラン）、invalidのいずれかが入ります。再試行しても結果は変わらないため、ネットワークは再試行すべきではありません。

重複排除とアトリビューション

• コンバージョンはクリックID、イベント、トランザクションIDごとに1回だけカウントされ、最初に報告したチャネルのものが採用されます。
• アトリビューションはラストクリックです。スニペットは常に最新のクリックIDを保持します。
• コンバージョンは、クリック後のアトリビューション期間内のものだけがカウントされます。デフォルトは30日で、1〜365日で調整できます。

コンバージョンを広告プラットフォームに送信

GrowthとUltimateでは、承認済みコンバージョンを転送をオンにすると、元の広告クリックに照合した購入、リード、登録イベントとして、Meta、TikTok、LinkedIn、Pinterest、Snapchat、RedditのConversions APIと分析連携に送信されます。Google Tag Manager、Adobe Analytics、SendGrid、Mailchimpには常に送信されます。