sGTM向けLINE Yahoo Conversion API：設定手順ガイド

LINE Yahoo Conversion API（Display Ads）を使用すると、サーバーからLINE Yahooのサーバーへ直接コンバージョンデータを送信し、Display Adsキャンペーンの測定と最適化に活用できます。

LINE Yahoo Conversion APIを利用すると、トラッキングの精度と安定性を向上できます。LINE Yahooは、Webとサーバーを組み合わせたハイブリッド型のトラッキング方式に対応しており、ブラウザ側のMeasurement tagとサーバー側のConversion API tagが連携して動作します。両方を組み合わせる場合、重複除外（デデュプリケーション）が必要です。

イベントとユーザーを照合するために、LINE Yahooはファーストパーティ識別子を使用します。これには匿名ID、クリックID、LINE User ID、さらにメールアドレスや電話番号などのハッシュ化された顧客データが含まれます。

このガイドでは、LINE Yahoo Conversion APIの仕組みと、sGTMでLINE Yahoo Conversion API tag（Display Ads）を設定する方法を説明します。

• トラッキングの信頼性と安定性の向上このtagは、sGTMコンテナからLINE YahooのConversion APIへコンバージョンイベントを直接送信します。これにより、ブラウザの制限、広告ブロッカー、Intelligent Tracking Prevention（ITP）の影響を回避できます。
• Cookie管理によるアトリビューションの向上サーバー側でAnonymous ID、Click ID、Complementary Click IDのcookieを自動的に読み取り、設定します。これによりcookieの有効期間を延長し、アトリビューションを改善できます。
• イベントの重複除外Transaction ID / Event IDの照合を使用して、ブラウザ側のMeasurement TagとConversion API間のイベント重複を除外します。これにより、二重計測を防ぎ、正確な指標を取得できます。
• 自動化されたPII保護送信前に、メールアドレスや電話番号などの機密性の高い顧客識別情報をSHA-256でハッシュ化します。
• 自動GA4イベントマッピング標準的なGA4イベント名（例：purchase、add_to_cart、begin_checkout）をLINE Yahooのイベントタイプへ自動的に変換します。
• 高速なサーバーパフォーマンスこのtagにはOptimistic Scenarioモードがあり、LINE Yahoo APIからのレスポンスを待たずに受信リクエストへ即時応答できます。これにより遅延を最小限に抑えられます。

1. LINE Yahoo Display Adsネットワーク上の広告をユーザーがクリックします。LINE Yahooは、この操作に対して以下のような識別子を割り当てます。

• Click ID（yclid）– 広告クリック後にランディングページURLへ追加される一意の識別子です。このtagは、サーバー側のファーストパーティcookie（_ly_c）に保存できるため、ページビュー間でも保持されます。
• Complementary Click ID – _ly_r cookieに保存される予備のクリックパラメータです。Safari ITPなどのブラウザのプライバシー保護機能によってURLパラメータやcookieが削除または短縮された場合の代替情報として使用されます。
• Anonymous ID – _ly_su cookieに保存される識別子です。認証されていない同一ブラウザセッションから発生した複数のイベントを時間の経過とともにグループ化します。
• ハッシュ化されたメールアドレス、ハッシュ化された電話番号、LINE User ID、Mobile ID（IDFA / AAID）など、その他のユーザー識別子も照合に使用できます。

2. ユーザーがコンバージョンイベントを完了します。例として、商品閲覧、カート追加、購入などがあります。そのイベントをブラウザから送信する代わりに、サーバーコンテナがLINE Yahooへ直接APIリクエストを送信します。その結果、データの精度が向上し、広告ブロッカーやブラウザの制限による影響を大幅に受けにくくなります。

3. APIは、Yahooキャンペーン管理ツールで生成されたTag IDとTag Access Tokenを使用して、各リクエストを認証します。

4. イベントを受信すると、LINE YahooはClick ID、Anonymous ID、LINE User ID、またはハッシュ化された顧客データを使用して、過去の広告接触との照合を試みます。一致する情報が見つかった場合、コンバージョンは該当する広告キャンペーンに紐付けられます。

5. 同じコンバージョンが、Web Measurement tagとConversion APIによってそれぞれ1回ずつ報告され、二重計測される場合があります。そのため、このtagはすべてのイベントにTransaction ID / Event IDを送信し、LINE Yahooがイベントを重複除外できるようにして、二重計測を防ぎます。

この設定を完了するには、まず sGTMコンテナを作成し、WebからsGTMコンテナへデータを送信する必要があります。

また、Webコンテナに LINE Yahoo Measurement tag を設定し、以下の認証情報を準備してください。

• Yahooキャンペーン管理ツールから取得したTag IDとTag Access Token
• LINE Developers Consoleから取得したChannel ID
• Conversion Settingsから取得したEvent Snippet ID

1. Google Tag Manager に移動し、サーバーコンテナを開いてください。

2. Templates に移動し、Tag Templates で Search Gallery をクリックしてください。

3. LINE Yahoo Conversion API Tag を検索してください。

4. Add to workspace をクリックし、確認してください。

5. Tags に移動し、New をクリックしてください。

6. Tag Configuration をクリックし、LINE Yahoo Conversion API Tag を選択してください。

7. Event Type Setup Method で、次のいずれかを選択してください：

• Standard – この特定のタグに対して、単一のLINE Yahooイベントタイプを明示的に設定できます（たとえば、タグが常に purchase または add_to_cart を送信するように指定できます）。GA4イベントの自動マッピングに依存せず、イベントタイプごとに専用タグを使用したい場合に便利です。また、デバッグやイベントを個別に管理する場合にも便利です。
• Inherit from client – タグはクライアントから受信したイベント名を自動的に読み取り、標準的なeCommerceおよびWebイベント名を対応するLINE Yahoo APIのイベント名へ自動的にマッピングします（例：view_item → view_product、begin_checkout → check_out）。すべてのGA4イベントをConversion API Event Typesにマッピングできるわけではありません。マッピングできないものはカスタムイベントとして送信されます。

8. 事前に保存した Tag ID, Tag Access Token と Channel ID を入力してください。Channel ID は、LINE User ID を User Identifiers Parameters で渡す場合にのみ必要です。Inherit from client を選択した場合は、Event Snippet ID も入力してください。

9. Test Mode で、このタグを現在テスト目的で使用するかどうかを設定してください。true の場合、イベントは計測から除外されます。

10. Use Optimistic Scenario をオンにすると、タグはAPIからのレスポンスを待たずに gtmOnSuccess() を呼び出します。これによりsGTMのレスポンス時間は短縮されますが、実際には成功していない場合でも、タグのステータスは常に fired successfully として返されます。

11. Anonymous ID and Click ID Settings では、次のパラメータを設定できます：

• Set Anonymous ID cookie – オンにすると、タグはサーバーサイドのファーストパーティCookie _ly_su を自動的に読み取るか作成します。このCookieには、ログイン済みユーザーの識別子が利用できない場合にサイト訪問者向けに生成される匿名のブラウザ／ユーザー識別子（anonymous_id）が保存されます。これにより、LINE Yahooは同じ未認証ブラウザセッションから発生した複数のイベントを時間の経過とともにまとめて扱うことができます。
• Set Click ID cookie – オンにすると、タグは受信URLまたはリクエストデータ内のLINE Yahoo Display Adsクリック識別子を検出し、サーバーサイドのファーストパーティCookie _ly_c に保存します。これにより、クリックIDがページビューをまたいで保持され、その後ユーザージャーニーで発生するコンバージョンイベントを元の広告クリックに正しく紐付けられます。
• Set complementary Click ID cookie – 有効にすると、タグは補完／バックアップ用のクリックパラメータデータを保存するため、セカンダリのファーストパーティCookie _ly_r を管理します。これは、主要なURLパラメータやCookieがブラウザのプライバシー保護機能（Safari ITPなど）によって削除、制限、短縮された場合に、クリックのアトリビューションを補完するフォールバック機構として機能します。
• Cookies settings – サーバーサイドのファーストパーティCookieをユーザーのブラウザにどのように書き込むかを設定します。

  • Cookie Domain – デフォルトの auto を設定すると、Cookieドメインが自動的にトップレベルドメインに設定され、サブドメイン間でCookieを利用できるようになります。必要に応じて上書きし、Cookie保存用のドメインを明示的に指定することもできます。
  • Cookie SameSite – プライバシーとクロスドメイントラッキング機能のバランスを取るため、クロスサイトでのCookie送信を制御します。詳細については Mozillaのドキュメント を参照してください。
  • Cookie HTTP Only Flag – タグによって作成されたCookieにクライアントサイドJavaScriptからアクセスできるかどうかを決定します。false の場合、ブラウザスクリプト（Web版LINE Tagなど）がCookie値を読み取れます。true の場合、CookieはHTTPヘッダーに限定され、ブラウザのJavaScriptからはアクセスできません。
  • Cookie Expiration – CookieのTTL（time-to-live）を決定します。Cookieの有効期間を、組織のプライバシーポリシーやブラウザのCookie保存に関する規定に合わせることができます。

12. Server Event Data Parameters では、コンバージョンイベントのペイロードに付与される主要なメタデータと属性を定義できます：

• Automap Server Event Data Parameters – オンにすると、タグは受信イベントオブジェクトから event_time や transaction_id / event_id などの標準イベントメタデータを自動的に抽出します。transaction_id / event_id の値は、イベントデータ内の transaction_id、event_id、または eventId から抽出され、イベントの重複排除に使用されます。
• Server Event Data Parameters – ここでは、変数を使用して event_time と transaction_id / event_id を手動で上書きできます。フィールドは次の正規表現に一致する必要があります：^[!"#$%&\'()*+,\-./0-9:;=\?@A-Z_a-z~]+$。これはイベントの重複排除に使用されます。

13. User Identifiers Parameters では、LINE Yahooへ送信するコンバージョンイベントにユーザー識別データをどのように収集・整形・付与するかを制御できます。少なくとも1つのユーザー識別子が必要です（自動マッピングまたは手動指定のいずれか）。メールアドレスと電話番号はハッシュ化され、電話番号は E.164規格 に変換されます。

• Automap User Identifiers Parameters – オンにすると、タグは受信イベントオブジェクトからユーザー情報を自動的に抽出してマッピングします。パラメータの完全な一覧については リファレンスドキュメント を参照してください。
• User Identifiers Parameters – ここでは、次のユーザー識別子を手動で上書きできます：Email Address, Phone Number, Anonymous ID, Click ID, Complementary Click ID, Mobile ID (iOS IDFA または Android AAID), LINE User ID。LINE User ID を渡す場合は、Channel ID も必ず指定してください。

14. Web Parameters では、ブラウザレベルのデータ（Page URL, Page Referrer, User Agent, IP Address）を設定できます。このコンテキストデータは、LINE Yahooがイベントの送信元を確認し、コンバージョンを正しいページや広告クリックの経路に紐付けるのに役立ちます。パラメータの完全な一覧については リファレンスドキュメント を参照してください。

• Automap Web Parameters – オンにすると、タグは受信イベントオブジェクトからWebコンテキストの詳細を自動的に抽出します。
• Web Parameters – ここでは、変数を使用して Page URL, Page Referrer, User Agent, IP Address を手動で上書きできます。

15. Event Parameters では、ユーザーの操作／コンバージョンイベントに関連するビジネスおよびeCommerceパラメータを設定できます。パラメータの完全な一覧については リファレンスドキュメント を参照してください。

• Automap Event Parameters – オンにすると、タグは受信イベントオブジェクトから Amount, Currency と Items を自動的に抽出してマッピングします。通貨は JPY のみサポートされています。Items には最大10個のオブジェクトを含む配列を指定します。各オブジェクトには item_id、category_id、price、quantity を含めることができます。

  • Custom Item ID Key – Data Layer の items 配列内で、どのプロパティを商品識別子として使用するかを指定します。イベントパラメータを自動マッピングする場合、タグは items 配列内の各商品オブジェクトから標準キー item_id を探します。Data Layer で商品IDに別のプロパティ名（id、sku、product_id、item_sku など）を使用している場合、そのキー名を入力すると、タグは代わりにそのプロパティから商品IDを抽出します。
• Event Parameters – ここでは、変数を使用して Amount, Currency と Items を上書きできます。

16. Tag Execution Consent Settings では、ユーザーの同意ステータスに基づいて、タグを実行してHTTPリクエストデータを送信するかどうかを制御できます：

• Send data always – 同意が許可されているか拒否されているかに関係なく、タグはすべてのトリガーで実行され、APIへデータを送信します。
• Send data in case marketing consent given – ad_storage の同意（Google Consent Mode または Stape's Data Tag パラメータ）が付与されていない場合、タグは安全に実行を中止します。

17. Page View などのトリガーを選択してください。

ヒント：Automap Event Parameters を使用して1つのタグで複数のイベントを自動処理したい場合は、カスタムトリガーで Event Name に対する正規表現一致を使用できます（例：page_view|purchase|add_to_cart）。

18. Save をクリックしてください。

1. GTMで Preview モードを開き、サイト上でいくつかの操作を行ってイベントを発生させてください。タグが実行されていることを確認してください。

2. キャンペーン管理ツールで、ツール → 計測タグに移動し、イベントが正常に送信されていることを確認します。

LINE Yahoo Measurement tagとLINE Yahoo Conversion API tagを組み合わせることで、より包括的なトラッキング環境を構築できます。

ブラウザとサーバー側の両方のイベントを取得できるため、ブラウザ制限が発生した場合でもコンバージョン測定を維持できます。

sGTM向けLINE Yahoo Conversion API tagを利用すると、サーバー側の実装を簡素化し、GA4イベントをLINE Yahooイベントタイプへ自動的に変換できます。また、Anonymous IDやClick ID cookieをサーバー側で管理し、ユーザー識別子をコンテナ外へ送信する前に安全にハッシュ化することで、収集するデータをより細かく管理できます。