実装ガイド

アンケートのオプトイン モジュールの組み込み

次の操作: 省略可: アンケートのオプトインを変更して商品レビューを収集する

アンケートのオプトイン モジュールを設置すると、お客様が Google カスタマー レビュー プログラムに参加するかどうかを選択できるようになり、同意した場合は Google に必要な取引情報が送信されます。Google カスタマー レビューに参加するためには、このモジュールをすべての注文確認ページに設置する必要があります。アンケートのオプトイン モジュールを組み込む際に問題が生じた場合は、トラブルシューティングをお試しください。

このセクションでは次のトピックについて説明します。

ユーザーがオプトインを選択すると、商品の到着後に Google からアンケートが送信されます。詳しくは、Google カスタマー レビュー アンケートについての記事をご覧ください。

アンケートのオプトインは、パソコンとモバイルの両方に表示できます。必ずパソコンサイトとモバイルサイトの両方にオプトイン コード スニペットを追加してください。

組み込み手順

注文確認ページにアンケートのオプトイン モジュールを設置するには次のタスクを行う必要があります。

  1. DOCTYPE の更新
  2. オプトイン コードの追加

アンケートのオプトイン モジュールのコードは、ご購入手続きで表示される注文確認ページに設置します。すべての確認ページでは HTTPS を使用する必要があります(HTTP は不可)。

このモジュールによって Google カスタマー レビューのカスタマー アンケート オプトインが表示されるため、このモジュール内の注文の詳細はできる限り正確に表示する必要があります。

ご購入手続きにサードパーティの処理システムを使用している場合は、お使いのドメイン上の確認ページにリダイレクトし直す必要があります。

注文確認ページ上の他のコンテンツによって、Google カスタマー レビューのカスタマー アンケート オプトイン モジュールが隠れることのないようにしてください。

DOCTYPE の更新

確認ページには、HTML5 DOCTYPE を使用する必要があります。

<!DOCTYPE html>

この DOCTYPE は、ページ上の HTML コード内の最初の行に表示される必要があります。HTML5 DOCTYPE を使用することで、ウェブブラウザでのページのレンダリングが互換モードではなく標準モードで行われるようになります。互換モードは、一部のウェブブラウザで使われている技術で、標準モードの W3C と IETF 標準に厳密に準拠することなく、古いバージョンのブラウザ向けに設計されたウェブページとの下位互換性が維持されます。

注: DOCTYPE の前にコメントや空白文字を含めないでください。

オプトイン コードの追加

<!-- BEGIN GCR Opt-in Module Code -->

<script src="https://apis.google.com/js/platform.js?onload=renderOptIn"

 async defer>

</script>

 

<script>

 window.renderOptIn = function() {

   window.gapi.load('surveyoptin', function() {

     window.gapi.surveyoptin.render(

       {

// REQUIRED

         "merchant_id": "MERCHANT_ID",

         "order_id": "ORDER_ID",

         "email": "CUSTOMER_EMAIL",

         "delivery_country": "COUNTRY_CODE",

         "estimated_delivery_date": "YYYY-MM-DD",

 

         // OPTIONAL

         "products":[{"gtin":"GTIN1"}, {"gtin":"GTIN2">}],

         "opt_in_style": "OPT_IN_STYLE"

       });

    });

 }

</script>

<!-- END GCR Opt-in Module Code -->

 

上記のコードを終了タグ(</BODY>)の直前に挿入します。アンケート モジュールのコードをバッジコードと一緒に挿入する場合、順番はどちらが先であっても構いません。

2. 変数をサイト固有の動的な値に置き換えます。次の表は、利用可能な設定について説明しています。

 

変数

必須かどうか

説明

MERCHANT_ID

(販売者 ID)

必須

Merchant Center ID。この値は Google Merchant Center で入手できます。

ORDER_ID

(注文 ID)

必須

注文の一意の ID。

CUSTOMER_EMAIL

(購入者のメール)

必須

お客様のメールアドレス(name@domain.com の形式)。

COUNTRY_CODE

(国コード)

必須

国コード(2 文字)。お客様が注文した商品の配送先を表しています。この値は、ISO 3166-1 alpha-2 形式である必要がありますこのフィールドには「ZZ」を使用しないでください(例: US)。

ESTIMATED_DELIVERY_DATE

(配送予定日)

必須

注文の配送予定日。YYYY は西暦、MM は月、DD は日付を指します(例: "2016-09-13")。

GTIN1、GTIN2

(GTIN: 国際取引商品番号)

省略可

GTIN 値(数字)。

OPT_IN_STYLE

(オプトインの形式)

省略可

オプトイン モジュールのダイアログ ボックスを表示する形式を指定します。指定できる値は次のとおりです。

「CENTER_DIALOG」: ページ中央のダイアログ ボックスに表示されます。

 

「BOTTOM_RIGHT_DIALOG」: ページ下部右側のダイアログ ボックスに表示されます。

 

「BOTTOM_LEFT_DIALOG」: ページ下部左側のダイアログ ボックスに表示されます。

 

「TOP_RIGHT_DIALOG」: ページ上部右側のダイアログ ボックスに表示されます。

 

「TOP_LEFT_DIALOG」: ページ上部左側のダイアログ ボックスに表示されます。

 

「BOTTOM_TRAY」: ページ下部に表示されます。

 

デフォルト値は「CENTER_DIALOG」です。

 

次のコード スニペットをウェブページに貼り付け、オプトイン モジュールで使用する言語を指定します。

<!-- BEGIN GCR Language Code -->

<script>

 window.___gcfg = {

   lang: 'LANGUAGE'

 };

</script>

<!-- END GCR Language Code -->

コピーしたコードをページの終了タグ(</BODY>)の直前に挿入します。オプトイン コードも挿入する場合、順番はどちらが先であっても構いません。

lang パラメータの値「LANGUAGE」を、サポートされている次のいずれかの言語の値と置き換えます。

  • af
  • ar
  • cs
  • da
  • de
  • en
  • en-AU
  • en-GB
  • en-US
  • es
  • es_419
  • fil
  • fr
  • ga
  • id
  • it
  • ja
  • ms
  • nl
  • no
  • pl
  • pt-BR
  • pt-PT
  • ru
  • sv
  • tr
  • zh_CN
  • zh_TW

lang パラメータの値を指定しなかった場合は、ユーザーのブラウザ設定に基づいた言語設定がアンケート モジュールで使用されます。

アンケートのオプトイン コードサンプル

変数値は通常、注文確認ページでサーバーサイド コードと置き換えられます。次のサンプルは、PHP でオプトイン モジュール コードを挿入する方法を示しています。

<!-- BEGIN GCR Opt-in Module Code -->

<script src="https://apis.google.com/js/platform.js?onload=renderOptIn"

 async defer>

</script>

 

<script>

 window.renderOptIn = function() {

   window.gapi.load('surveyoptin', function() {

     window.gapi.surveyoptin.render(

       {

         "merchant_id": 42,

         "order_id": "<?php echo $order_id ?>",

         "email": "<?php echo $email_address ?>",

         "delivery_country": "<?php echo $user_country ?>",

         "estimated_delivery_date": "<?php echo $delivery_date ?>",

   "products": [{"gtin":"<?php echo $gtin_1 ?>"}, {"gtin":"<?php echo $gtin_2 ?>"}],

         "opt_in_style": "BOTTOM_LEFT_DIALOG"

       });

    });

 }

</script>

<!-- END GCR Opt-in Module Code -->

 

<!-- BEGIN GCR Language Code -->

<script>

 window.___gcfg = {

   lang: 'en_US'

 };

</script>

<!-- END GCR Language Code -->

ページ上にオプトイン モジュールが表示されない場合、またはページ読み込み時にエラーが表示される場合は、トラブルシューティングをお試しください。

この情報は役に立ちましたか?
改善できる点がありましたらお聞かせください。