カスタム構築サイト連携

お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。

Zoho Thriveでは、ビルダーソフトウェアを使用せず一から構築した独自作成サイトをZoho Thriveと連携し、ロイヤルティプログラムを運用できます。

連携を進める前に、サイト用のブランドを作成する必要があります。

ブランドの作成

Thriveコンソールの右上にある［設定アイコン］をクリックします。
次に、［連携］→［ストアの連携］→［独自作成］に移動します。
［設定］をクリックします。

ポップアップで、次の操作を行います。

［ブランド名］を入力してください。
［ブランドURL］（ロイヤルティプログラムを運用するWebサイトのURL）を入力してください。

［作成］をクリックします。

ブランドを作成したら、以下の手順に従って独自作成サイトとZoho Thriveを接続します。

サイトの連携

Thriveコンソールの右上にある［設定アイコン］をクリックします。
次に、［開発者設定］に移動します。
次の［シークレットキー］と［ブランドコード］をコピーし、安全に保存します。

以下のスクリプトをコピーし、サイトの各ページで、次の範囲（<head>タグから</head>タグまで）に貼り付けます。

var platformType='custom_user_site';

var thriveWidgetCode= '{{Brand code}}';

var ztUserData = {};

</script>

上記のプレースホルダーを、それぞれ対応する変数に置き換えます。

{{Brand code}}- この変数は、［その他］→［インストールページ］からコピーしたものと同じです。
{{Public Domain URL}}- 以下の表から、ご利用のデータセンターの公開ドメインURLをコピーします。利用中のデータセンターは、Zoho ThriveのWebアプリにアクセスし、そのURLを確認することで特定できます。

データセンター	ドメインURL	公開ドメインURL
米国	https://thrive.zoho.com	https://thrive.zohopublic.com
インド	https://thrive.zoho.in	https://thrive.zohopublic.in
ヨーロッパ	https://thrive.zoho.eu	https://thrive.zohopublic.eu
南アフリカ	https://thrive.zoho.sa	https://thrive.zohopublic.sa
オーストラリア	https://thrive.zoho.com.au	https://thrive.zohopublic.com.au
カナダ	https://thrive.zohocloud.ca	https://thrive.zohopublic.ca

以下のコードをコピーし、サイトの各ページの<body>タグと</body>タグの間に貼り付けます。

var ztUserData = {};

ztUserData['za_email_id'] = {{Email Address of Customer}};

ztUserData['user_unique_id'] = {{Unique Identifiable System ID of Customer}};

ztUserData['thrive_digest'] = {{Server Generated HMAC}};

ztUserData['signUpPage'] = {{Signup URL};

ztUserData['signInPage'] = {{Login URL}};

ztWidgetDelay = {{Time in secs}};

</script>

上記のプレースホルダーを、システムで定義されている対応する変数に置き換えます。

{{Email Address of Customer}} - この変数には、顧客のメールアドレスを格納する必要があります。
{{Unique Identifiable System ID of Customer}}- この変数には、システム内の顧客を一意に識別するIDを格納する必要があります。このIDは、顧客とそのデータを識別するために使用されます。
{{Server Generated HMAC}}- お客さま側から送信される上記の顧客データの改ざんを防ぐため、HMAC（ハッシュベースのメッセージ認証コード）を使用します。HMACを生成し、ここに設定する必要があります。

HMACの生成手順。

以下のコードから、使用するプログラミング言語に応じて1つ選択します。コードをコピーし、サーバー上で実行します。

NodeJS

const crypto = require('crypto')

let email_id='peter.prescott@zylker.com' // 顧客のメールアドレス

let customer_id = 'bfuyw3fiub3289uij' //顧客を一意に識別するシステムID

let digestRaw = email_id+customer_id

let algorithm = 'sha256'

let secret = 'e46788a75fe6a876ba83a3892cfd201f'; // シークレットキー

let HMACDigest = crypto.createHMAC(algorithm,secret).update(digestRaw).digest('hex')

Ruby

require 'base64'

require 'openssl'

email_id='peter.prescott@zylker.com' // 顧客のメールアドレス

customer_id='bfuyw3fiub3289uij' //顧客を一意に識別するシステムID

digestRaw= email_id+customer_id;

algorithm = OpenSSL::Digest.new('sha256')

secret = 'e46788a75fe6a876ba83a3892cfd201f' //シークレットキー

HMACDigest = OpenSSL::HMAC.hexdigest(algorithm, secret, digestRaw)

PHP

$email_id = 'peter.prescott@zylker.com'; //顧客のメールアドレス

$customer_id='bfuyw3fiub3289uij'; //顧客を一意に識別するシステムID

$digestRaw= $email_id.$customer_id;

$algorithm = 'sha256';

$secret = 'e46788a75fe6a876ba83a3892cfd201f'; //シークレットキー

$HMACDigest = hash_HMAC($algorithm, $digestRaw, $secret);

上記のコードでは、'peter.prescott@zylker.com' と'bfuyw3fiub3289uij'の代わりに、それぞれ対応する変数を指定します。email_id変数には顧客のメールアドレスを格納し、customer_idには顧客を一意に識別するシステムIDを格納する必要があります。
シークレットの差し込み項目secret, 'e46788a75fe6a876ba83a3892cfd201f'を、シークレットキー（［スクリプト］ページに表示）に置き換えます。
HMACDigestを返し、生成されたHMACコードで追跡コード内の{{Server Generated HMAC}}を置き換えます。
{{Signup URL}}：サイトの登録ページのURLです。
{{Login URL}}：サイトのサインイン／ログインページのURLです。
{{Time in secs}}：設定した時間が経過するまで、ウィジェットの読み込みを遅らせます。データの処理に時間がかかるサイトで役立ちます。遅延時間は最大40秒まで設定できます。

ポイントプログラムを実施しない場合、{{Signup URL}}と{{Login URL}}を変更する必要はありません。

これで、サイトとZoho Thriveの連携は完了です。

プログラムの作成時には、他にもお客さま側でデータを手動送信する必要があるケースが2つあります。

プログラムで次のミッション、購入、被紹介者による購入を使用する場合は、購入の詳細をZoho Thriveに送信するHTTP要求を作成します。
ポイントプログラム用の独自のミッションを作成する場合は、完了後にミッションの詳細をZoho Thriveに送信するHTTP要求を作成します。

上記の手順で問題が発生した場合やサポートが必要な場合は、support@zohothrive.comまでお気軽にお問い合わせください。