カスタム構築サイトの連携

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

Zoho Thriveでは、独自構築したWebサイト（ビルダーソフトウェアを使わず一から構築したサイト）を利用する企業がZoho Thriveと連携し、ロイヤルティプログラムを実施できます。

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

ブランドの作成

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

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

［ブランド名］を入力します。
［ブランドURL］（プログラムを実施するWebサイトのURL）を入力します。

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

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

Webサイトの連携

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

以下のスクリプトをコピーし、Webサイトの各ページの<head>タグと</head>タグの間に貼り付けます。

var platformType='custom_user_site';

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

var ztUserData = {};

</script>

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

{{Brand code}}：この変数は、［その他］→［インストールページ］からコピーしたものと同じです。
{{Public Domain URL}}：以下の表から、ご利用のデータセンターの公開ドメインURLをコピーします。どのデータセンターからZoho Thriveにアクセスしているかは、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'] = {{メール 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>

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

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

HMACの生成手順。

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

NodeJS

const crypto = require('crypto')

let email_id='peter.prescott@ジルカー.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@ジルカー.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@ジルカー.com'; //顧客のメールアドレス

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

$digestRaw= $email_id.$customer_id;

$algorithm = 'sha256';

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

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

上記のスクリプトでは、'peter.prescott@ジルカー.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までお気軽にお問い合わせください。