Google の新しいタグ プラットフォームに関するドキュメントをご覧いただきありがとうございます。このサイトは公開ベータ版です。(フィードバック

グローバル サイトタグ API リファレンス

グローバル サイトタグ(gtag.js)API は、次の構文を持つ単一の関数 gtag() で構成されています。

gtag(<command>, <command parameters>);
  • <command> は次のいずれかのコマンドです。
  • <command parameters>gtag() に渡されるパラメータです。コマンド パラメータはコマンドによって異なります。以下のコマンド リファレンスを参照してください。

コマンドがグローバル スニペットの下にある限り、ページ上のどこでも gtag コマンドを呼び出すことができます。グローバル スニペットをページに追加する方法については、インストール ガイドをご覧ください。

config

ターゲットに設定情報(Google 広告または Google アナリティクスなどのサービスに固有の設定)を追加することができます。

gtag('config', '<TARGET_ID>', {<additional_config_info>});

<TARGET_ID> は、Google アナリティクスのプロパティ、Google 広告アカウントなど、ヒットのターゲットを一意に識別する ID です。<additional_config_info> はパラメータと値のペア(複数可)です。

次の例では、Google 広告アカウントにデータを送信するようにタグを設定しています。

gtag('config', 'AW-CONVERSION_ID');

Google アナリティクスでも同様に config コマンドを使用できます。

gtag('config', 'GA_MEASUREMENT_ID');

以下の例は、追加の設定情報を送信する方法を示しています。値として false を渡す send_page_view パラメータと、値として 'agency' を渡す groups パラメータを使用し、アナリティクス アカウントにデータを送信するようにタグを設定しています。

gtag('config', 'GA_MEASUREMENT_ID', {
  'send_page_view': false,
  'groups': 'agency'
});

get

set コマンドで設定された値を含む gtag.js からさまざまな値を取得できます。

gtag('get', '<target>', '<field_name>', callback)
引数 説明
<target> string UA-XXXXXXXX-Y

値の取得元のターゲット。

<field_name> FieldName client_id 取得するフィールドの名前。
callback Function (field) => console.log(field)

リクエストされたフィールドで呼び出される関数。設定されていない場合は undefined

FieldName

フィールド名には、gtag('set') コマンドで設定したカスタム フィールドの名前か、次のいずれかの値を指定できます。

フィールド名 サポートされているターゲット
client_id
  • Google アナリティクス 4
  • Google アナリティクス ユニバーサル アナリティクス
session_id
  • Google アナリティクス 4
gclid
  • Google 広告
  • Floodlight

Promise に値を取得する

const gclidPromise = new Promise(resolve => {
  gtag('get', 'DC-XXXXXXXX', 'gclid', resolve)
});

gclidPromise.then((gclid) => {
  // Do something with gclid...
})

Measurement Protocol にイベントを送信する

gtag('get', 'UA-XXXXXXXX-Y', 'client_id', (clientID) => {
  sendOfflineEvent(clientID, "tutorial_begin")
});

function sendOfflineEvent(clientID, eventName, eventData) {
  // Send necessary data to your server...
}

設定した値を取得する

gtag('set', {currency: 'USD'});

gtag('get', 'UA-XXXXXXXX-Y', 'currency', (currency) => {
  // Do something with currency value you set earlier.
})

set

ページ上の後続のすべての gtag() 呼び出しで保持される値を設定できます。

gtag('set', {<parameter-value-pair>, <parameter-value-pair>});

<parameter-value-pair> はキー名で、gtag() 呼び出しで保持される値です。たとえば、以下のコードはページ上の後続のすべてのイベントで、country の値を 'US' に、また currency の値を 'USD' に設定します。

gtag('set', {
  'country': 'US',
  'currency': 'USD'
});

set コマンドの使用は、event コマンドに値を直接渡すのとは異なります。値を event コマンドに直接渡すと、それらの値は呼び出し中のイベントにのみ適用されますが、set を使用すると、値は現在のページで保持され、後続のすべてのイベントとともに渡されます。次の 2 つの例で確認してみましょう。

gtag('event', 'login', {'method': 'Google'});
gtag('event', 'share');

および

gtag('set', {'method': 'Google'});
gtag('event', 'login');
gtag('event', 'share');

最初の例では、login イベントは 'Google' という method 値とともに渡され、share イベントはパラメータなしで渡されます。2 番目の例では、loginshare の両方が、'Google' という method 値とともに渡されます。

event

イベントデータを送信するには、event コマンドを使用します。

gtag('event', '<event_name>', {<event_params>});

<event_name> は以下のいずれかです。

<event_params> はパラメータと値のペア(複数可)です。ペアが複数ある場合はカンマで区切ります。

次の event コマンドは、推奨イベント screen_view を 2 つのパラメータ(app_namescreen_name)とともに呼び出します。

gtag('event', 'screen_view', {
  'app_name': 'myAppName',
  'screen_name': 'Home'
});

consent を設定するには、consent コマンドを使用します。

gtag('consent', {<consent_arg>}, {<consent_params>});

これらのパラメータの設定について詳しくは、ヘルプセンターの consent をご覧ください。

<consent_arg> は、'default' または 'update' のいずれかです。'default' は、デフォルトで使用する必要がある同意パラメータを設定するために使用され、'update' は、ユーザーが同意を示した場合にそれらのパラメータを更新するために使用されます。

サポートされている <consent_params> は次のとおりです。

フィールド名 使用できる値
ad_storage 'allowed' | 'denied'
analytics_storage 'allowed' | 'denied'
wait_for_update 任意の正の整数

パラメータ スコープ

パラメータ値のスコープは、個々のイベント、特定の <TARGET_ID> に送信されたすべてのイベント、またはグローバルにすべてのイベントに対して設定できます。スコープの設定には、eventconfigset コマンドを使用します。

あるスコープに設定されているパラメータ値によって、別のスコープに設定されている同じパラメータの値が変更されることはありません。以下の例の場合、先に set コマンドで割り当てられた currency のグローバル値は、config コマンドでは変更されません。両方のコマンドが実行された後も、currency のグローバル値は 'EUR' のままになります。

// Set global currency to Euros
gtag('set', { 'currency': 'EUR' });

// Set currency for <TARGET_ID>
gtag('config','<TARGET_ID>', { 'currency': 'USD' });

パラメータの優先順位

別のスコープで同じパラメータに異なる値が割り当てられている場合でも、イベントの処理時にはいずれか 1 つの値のみが使用されます。スコープが event のパラメータ値はスコープが config のパラメータよりも優先され、config パラメータは set を使ったグローバル スコープのパラメータより優先されます。

// Set global currency to Euros
gtag('set', { 'currency': 'EUR' });

// Set currency for <TARGET_ID1> to 'USD'
gtag('config','<TARGET_ID1>', { 'currency': 'USD' });

// Process a conversion event with currency: 'GBP'
gtag('event','conversion', { 'currency': 'GBP', 'send_to': '<TARGET_ID1>' });

// Process a conversion event with currency: 'EUR'
gtag('event','conversion');

// Process a conversion event with currency: 'USD'
gtag('event','conversion', { 'send_to': '<TARGET_ID1>' });