registerPreTrackCallback

registerPreTrackCallback 変数を使用すると、イメージリクエスト URL がコンパイルされたがまだ送信されていないときに実行する JavaScript 関数をフックできます。この変数を使用して、AppMeasurement によって収集されたデータをパートナーまたは社内インフラストラクチャに送信できます。

registerPreTrackCallback 変数を呼び出すたびに、その関数をフックして、イメージリクエスト URL がコンパイルされるたびに実行します。同じページの読み込みで同じ関数を複数回登録しないでください。

Web SDK 拡張機能を使用したコールバックのプレトラック

Web SDK は、データがコンパイルされた後、データがAdobeに送信される前に関数をフックすることはできません。 ただし、onBeforeEventSend を使用して、データが送信される直前に実行する関数を登録できます。

Web SDK を手動で実装するコールバックのプレトラック

Web SDK は、データがコンパイルされた後、データがAdobeに送信される前に関数をフックすることはできません。 ただし、onBeforeEventSend を使用して、doPlugins と同様に、データが送信される直前に実行する関数を登録できます。 詳しくは、Web SDK ドキュメントの イベントのグローバルな変更を参照してください。

// Set the trackingCode XDM field to "New value"
alloy("configure", {
  "onBeforeEventSend": function(content) {
    content.xdm.marketing.trackingCode = "New value";
  }
})

Adobe Analytics拡張機能を使用したコールバックのプレトラック

Adobe Analytics 拡張機能には、この変数を使用する専用のフィールドはありません。AppMeasurement 構文に従って、カスタムコードエディターを使用します。

AppMeasurementの s.registerPreTrackCallback と Analytics 拡張機能のカスタムコードエディター

s.registerPreTrackCallback は、関数を唯一の引数として受け取る関数です。ネストされた関数は、イメージリクエストの送信直前に実行されます。

s.registerPreTrackCallback(function(){/* Desired code */});

コードでイメージリクエスト URL を使用する場合は、ネストされた関数内で requestUrl 文字列引数を参照します。requestUrl 変数は、目的の用途に合わせて解析できます。この変数を調整しても、データ収集には影響しません。

s.registerPreTrackCallback(function(requestUrl){
  console.log(requestUrl); // Outputs the full image request URL
});

s.registerPreTrackCallback 関数には、ネストされた関数で使用できる、追加の引数を含めることができます。

s.registerPreTrackCallback(function(requestUrl,a,b,c) {
    console.log(requestUrl); // Full image request URL
    console.log(a); // param1
    console.log(b); // param2
    console.log(c); // param3
}, "param1", "param2", "param3");