IntimateMerger Analytics Adapter : initial release by eknis · Pull Request #21 · IntimateMerger/Prebid.js

eknis · 2025-12-03T04:16:57Z

Type of change

Description of change

Other information

github-actions · 2025-12-03T04:19:31Z

Tread carefully! This PR adds 1 linter error (possibly disabled through directives):

modules/imAnalyticsAdapter.js (+1 error)

github-actions · 2025-12-03T04:37:39Z

Tread carefully! This PR adds 1 linter error (possibly disabled through directives):

modules/imAnalyticsAdapter.js (+1 error)

github-actions · 2025-12-03T06:41:22Z

Tread carefully! This PR adds 1 linter error (possibly disabled through directives):

modules/imAnalyticsAdapter.js (+1 error)

fecker

ちともろもろ確認したいのと、意識合わせしたいです。

各社のAnalytics Adaptor は、bid の分析をもろもろしているのですが、
IMでは不要なので、そのあたりは調整が必要かなと。

今の実装ならキャッシュは不要な気がしつつ、バッファリング送信機能をつけるなら必要になるかなと思っています。

AUCTION_INIT
- cache の初期化（auctionId の管理用）
- Consent データの初期化（auctionId に紐づけて管理）
- pvデータのみを送信（ちょっと悩み中。データとして使わないなら、ぶっちゃけまとめて送ってもいいかも？調整中）
AUCTION_END
- setTimeout で遅延実行（800 ms くらい？）
  - cache[auctionId] に入ってるものを送る
  - cache[auctionId] で、データ送信フラグを管理
- setTimeout で遅延実行（3分後くらい？）
  - cache[auctionId] を削除する
    − SPA でたまらないようにする
BID_WON
- cache[auctionId] に情報を蓄積する
- データ送信済だったら（フラグがたってたら）全データを再送する

実装イメージ

case EVENTS.AUCTION_END:
  setTimeout(() => {
    analyticsAdapter.sendEvents(args.auctionId);
  }, BID_WON_WAIT); // 800ms ?
  break;

こんなことを書いてる Adaptor がいるので、バッファリングいけるんじゃないかと思ってます。

case EVENTS.BID_WON:
  const auction = cache.auctions[args.auctionId];
  if (!auction) return;

  // transactionId 単位で、cache するか
  // 配列に push した方が楽かもしれない

  // 再送を考えて、Timestamp も入れてもいいかも

  if (auction.sendStatus & REQUEST_SENT) { // すでに送信済だったら
     analyticsAdapter.sendEvents(args.auctionId); // 再送する
  }

みたいな感じでいけたりしないかなぁと思ってきました。

許諾のデータは、
libraries/intentIqUtils/getCmpData.js を参考にして
gdpr と usp (ccpa) だけとっておくと幸せになれるかなとおもってきました。

import { allConsent } from '../../src/consentHandler.js';

/**
 * Retrieves consent data from the Consent Management Platform (CMP).
 * @return {Object} An object containing the following fields:
 * - `gdprString` (string): GDPR consent string if available.
 * - `uspString` (string): USP consent string if available.
 * - `gppString` (string): GPP consent string if available.
 */
export function getCmpData() {
  const consentData = allConsent.getConsentData();

  return {
    gdprApplies: consentData?.gdpr?.gdprApplies || false,
    gdprString: typeof consentData?.gdpr?.consentString === 'string' ? consentData.gdpr.consentString : null,
    uspString: typeof consentData?.usp === 'string' ? consentData.usp : null,
    gppString: typeof consentData?.gpp?.gppString === 'string' ? consentData.gpp.gppString : null,
  };
}

modules/imAnalyticsAdapter.js

eknis · 2025-12-09T08:56:14Z

時刻 0ms:   AUCTION_INIT
            ↓ sendStatus = 0
時刻 100ms: BID_WON #1
            ↓ sendStatus & WON_SENT = 0 → キャッシュに追加
時刻 200ms: BID_WON #2
            ↓ sendStatus & WON_SENT = 0 → キャッシュに追加
時刻 300ms: AUCTION_END
            ↓ 800msタイマー開始
時刻 1100ms: sendWonBidsData() 実行
             ↓ BID_WON #1, #2 をまとめて送信
             ↓ sendStatus |= WON_SENT → sendStatus = 1
時刻 1500ms: BID_WON #3（遅延）
             ↓ sendStatus & WON_SENT = 1 → 即座に個別送信
時刻 2000ms: BID_WON #4（遅延）
             ↓ sendStatus & WON_SENT = 1 → 即座に個別送信

modules/imAnalyticsAdapter.js

github-actions · 2025-12-18T07:32:36Z

Tread carefully! This PR adds 2 linter errors (possibly disabled through directives):

modules/imAnalyticsAdapter.js (+2 errors)

github-actions · 2025-12-19T02:55:44Z

Tread carefully! This PR adds 2 linter errors (possibly disabled through directives):

modules/imAnalyticsAdapter.js (+2 errors)

github-actions · 2025-12-19T03:00:23Z

Tread carefully! This PR adds 2 linter errors (possibly disabled through directives):

modules/imAnalyticsAdapter.js (+2 errors)

fecker

空いちゃってしません。直してリリースしましょう。

fecker · 2026-03-09T20:03:07Z

modules/imAnalyticsAdapter.js

+    gdprApplies: gdprConsent.gdprApplies,
+    gdpr: gdprConsent.consentString,


gdpr の consent はいらないかなと思ってきました・・・・（対応するつもりがほぼない）
他の adapter でやってたのですが gdpr に true / false （gdprApplies）を渡して、あげるのが幸せになれるかと思いました。

fecker · 2026-03-09T20:29:24Z

modules/imAnalyticsAdapter.js

+  return {
+    gdprApplies: gdprConsent.gdprApplies,
+    gdpr: gdprConsent.consentString,
+    usp: uspConsent


coppa も念の為取得しておいて頂けるとうれしいです。
coppa = Number(coppaDataHandler.getCoppa());

fecker · 2026-03-09T20:32:08Z

modules/imAnalyticsAdapter.js

+  const gdprConsent = request.gdprConsent || {};
+  const uspConsent = request.uspConsent;
+
+  return {


アメリカ・カナダがそこそこ入っていたので、
ggp: gppDataHandler.getConsentData().applicableSections; （Number が入ります）
ggpString: gppDataHandler.getConsentData().gppString;
で取得をお願いします。
（真面目にやるとここを見るのが良さげ？）

fecker · 2026-03-09T20:33:53Z

modules/imAnalyticsAdapter.js

+
+        case EVENTS.AUCTION_END:
+          logMessage('IM Analytics: AUCTION_END', args);
+          this.scheduleWonBidsSend(args.auctionId);


細かいのですが、handleActionEnd() の方が良いのかなと思ったり。
で、その中で２つの処理を schedule するのが良いのでは？って思いました。

別のAdapterでやってたのですが、
（あまりユースケースはないかもですが、）Cache の肥大化対策をしてるものがいました。

一定時間後（5秒〜 10秒後）に、cache[auctions] をクリアする処理があってもいいかもす。

fecker · 2026-03-09T20:57:22Z

modules/imAnalyticsAdapter.js

+     * @param {Object} auctionArgs - Auction arguments
+     * @param {Object} consentData - Consent data object
+     */
+    handleAucInitData(auctionArgs, consentData) {


consentData って、auction の中でキャッシュされてるので、それを使いまわした方が良いのではと思ったのですが、どうすか？

handleAuction で、引数があわないのが気持ちわるい感じがします。

fecker · 2026-03-09T21:00:19Z

modules/imAnalyticsAdapter.js

+     */
+    transformAucInitData(auctionArgs) {
+      return {
+        timestamp: auctionArgs.timestamp,


細かいですが、ボリュームが増えるので、short にした方がエコかもです。
(僕なら ts とかにしちゃいますｗ）

fecker · 2026-03-09T21:01:48Z

modules/imAnalyticsAdapter.js

+        pageUrl: window.location.href,
+        referrer: document.referrer || '',


細かいですが、url とか短くしちゃって良いかなと。少しでもネットワークコストを下げる的な。
（まぁ、payload なので圧縮かかるかなと思いつつ）

fecker · 2026-03-09T21:02:50Z

modules/imAnalyticsAdapter.js

+        return;
+      }
+
+      const consentData = auction.consentData || getConsentData(null);


cache からとるだけで大丈夫なんじゃないかなって思いました。

fecker · 2026-03-09T21:04:03Z

modules/imAnalyticsAdapter.js

+     */
+    sendWonBidsData(auctionId) {
+      const auction = cache.auctions[auctionId];
+      if (!auction || !auction.wonBids || auction.wonBids.length === 0 || (auction.sendStatus & WON_SENT)) {


全部一緒に送ることを考えると最後の条件はいらないかなと。
（送れてきても、全部一緒に送ることで集計が楽になるはず）の

fecker · 2026-03-09T21:05:14Z

modules/imAnalyticsAdapter.js

+      });
+
+      // Clear cached bids after sending to prevent duplicates
+      auction.sendStatus |= WON_SENT;


細かいですが、sendToApi する前に、セットした方が良かったりしますか？
（時間がかかったたときに微妙なので）の

fecker

遅くなってすいません。リリースに向かいましょう。

fecker · 2026-03-10T02:24:54Z

modules/imAnalyticsAdapter.js

+function getConsentData(bidderRequests) {
+  if (!bidderRequests || !bidderRequests[0]) {
+    return EMPTY_CONSENT_DATA;
+  }
+


bidderRequests から取るより、Adapter から取得した方が分かりやすいかなと思ったのですが、どっちがいいっすかね・・？（0番目から取るよりという意味で。他のAnalytics Adapter はどうですか？）

fecker · 2026-03-10T02:40:31Z

modules/imAnalyticsAdapter.js

+        timestamp,
+        wonBids: auction.wonBids


少しでも小さくと・・・ ts, bids あたりで良いかもです。

fecker · 2026-03-10T02:41:06Z

modules/imAnalyticsAdapter.js

+
+const DEFAULT_BID_WON_TIMEOUT = 800; // 0.8 second for initial batch
+const DEFAULT_CID = 5126;
+const API_BASE_URL = 'https://b6.im-apps.net/bids';


（完全に趣味ですが）Prebid にあわせて、bid にしませんか？

IntimateMerger Analytics Adapter : initial release

e73e918

IntimateMerger Analytics Adapter : sendBeacon

280a6d6

IntimateMerger Analytics Adapter : refactoring

0103771

IntimateMerger Analytics Adapter : fix sendBeacon

92606c4

eknis requested review from april418 and fecker December 4, 2025 07:11

eknis marked this pull request as ready for review December 4, 2025 07:11

IntimateMerger Analytics Adapter : update comment

0a7a285

fecker reviewed Dec 5, 2025

View reviewed changes

IntimateMerger Analytics Adapter : refactoring

8d67535

fecker reviewed Dec 17, 2025

View reviewed changes

eknis added 2 commits December 18, 2025 12:49

IntimateMerger Analytics Adapter : add test

18de1b7

IntimateMerger Analytics Adapter : refactoring

6042b68

IntimateMerger Analytics Adapter : update cache

a627e77

IntimateMerger Analytics Adapter : fix test

75c5bd7

eknis added 2 commits December 19, 2025 12:49

IntimateMerger Analytics Adapter : fix space

7fe1ad8

IntimateMerger Analytics Adapter :add md

e1ce492

eknis requested a review from fecker December 25, 2025 05:51

fecker reviewed Mar 9, 2026

View reviewed changes

fecker reviewed Mar 10, 2026

View reviewed changes

		gdprApplies: gdprConsent.gdprApplies,
		gdpr: gdprConsent.consentString,

		pageUrl: window.location.href,
		referrer: document.referrer \|\| '',

Conversation

eknis commented Dec 3, 2025

Type of change

Description of change

Other information

Uh oh!

github-actions bot commented Dec 3, 2025

Uh oh!

github-actions bot commented Dec 3, 2025

Uh oh!

github-actions bot commented Dec 3, 2025

Uh oh!

fecker left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

eknis commented Dec 9, 2025

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

github-actions bot commented Dec 18, 2025

Uh oh!

github-actions bot commented Dec 19, 2025

Uh oh!

github-actions bot commented Dec 19, 2025

Uh oh!

fecker left a comment

Choose a reason for hiding this comment

Uh oh!

fecker Mar 9, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

fecker Mar 9, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

fecker Mar 9, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

fecker Mar 9, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

fecker left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

fecker Mar 9, 2026 •

edited

Loading

fecker Mar 9, 2026 •

edited

Loading

fecker Mar 9, 2026 •

edited

Loading

fecker Mar 9, 2026 •

edited

Loading