Magento v1の統合

Optimizelyマニュアル｜Magento v1をOptimizely Data Platformと統合して、強化されたマーケティング、履歴および継続的なデータ同期、ベストプラクティス構成を実現します。

注記

この記事では Magento v1 について説明します。 Magento v2 については、ここをクリックしてください。

Magento は非常に柔軟なプラットフォームであり、マーケティングを改善するためにコア機能に変更を加えることができます。 Optimizely Data Platform (ODP) コネクタは、ベスト プラクティスを使用して Magento と統合します。 Magento ストアの設定方法に懸念がある場合は、統合する前に[e-mail]までご連絡ください。

どのようなデータが統合されていますか?

	ヒストリカル	オンゴーイング	タイプ
顧客データ	Yes	Yes	作成 更新
注文データ	Yes	Yes	購入 キャンセル 戻る
製品データ	Yes	Yes	作成 更新
ウェブサイトデータ	No	Yes	ページビュー 製品ページビュー カートに追加 カートから削除 ニュースレターの購読

Magento 1.X コネクタの構成

1. 最新のコネクタ パッケージをダウンロードします: Zaius_Engage-0.14.2.tgz (変更ログ)

2. Magento 管理コンソールにログインします。

3. [システム] > [Magneto Connect] > [Magento Connect Manager]に移動します。

4. Magento Connect Manager にログインした後、「ファイルを選択...」をクリックし、手順 1 でダウンロードしたコネクタ ファイルを選択します。

5. 「アップロード」をクリックします。 ページの下部に、インストールプロセスの詳細を示すログが表示されます。

6. Magento 管理コンソールで、 [システム] > [システム]に移動します。 構成。

7. 「Sales」の下で、 「Zaius Engage」を選択します。 Zaius Engage をクリックしたときに 404 または権限エラーが発生した場合は、管理者セッションからログアウトして、再度ログインする必要があります。

8. トラッカー ID を指定したテキスト ボックスに貼り付け、 [保存]をクリックします。

9. [製品リスト表示の追跡]オプションが表示された場合は、 [Yes]をクリックします。

おめでとう！ 新しいイベントが ODP に送信されます。

Magento 1.X 権限の設定

ODP で Magento を使用するには、SOAP API 権限を持つユーザーを作成します。

1. [システム] > [Web サービス] >に移動します。 SOAP/XML-RPC - ユーザー。 ユーザーがまだ存在しない場合は、新しいユーザーを作成します。

注記

• • 統合を有効にするには、ODP に指定されたユーザー名と API キーを指定する必要があります。

  • このユーザーは、Magento からデータを取得するために ODP Engage API を使用する権限を持っている必要があります。

ユーザーに適切な権限があることを確認するには:

1. [システム] > [Web サービス] > [SOAP/XML-RPC - ロール]に移動して、適切な権限をユーザーに割り当てます。 ODP Engage は、顧客、製品、注文の最初のインポート中に使用されるカスタム API を提供します。

2. ユーザーを新しいロールに関連付けます。

3. [統合] > [Magento API]に移動し、サーバーの[ユーザー名] 、 [API キー] 、および[API URL]を入力します。 API URL は通常、次のようになります: http://your-magento-server/api/v2_soap?wsdl=1

ODP エンゲージの構成

ODP Engage は、プラグイン用の一連の構成オプションを提供します。

• 追跡識別子– ODP トラッカー ID。

• カート放棄秘密キー– カート放棄キャンペーンのリンク情報をエンコードするために使用される秘密の値。 一度設定したら変更しないでください。 これは、ODP によって提供されない、入力するランダムな文字列です。

• ODP スキーマ更新と ODP バッチ更新–オプションですが推奨される調整です。

カスタマー サクセス マネージャー (CSM) が推奨しない限り、他の設定を変更しないでください。

バッチ更新の構成 (0.12.0 以降)

多くの Magento サイトには、直接 SQL の挿入と更新を実行するさまざまなバックエンド プロセス、特に ERP があります。 直接 SQL によって Magento データベースが変更されると、Magento のオブザーバーはそれについて他のテクノロジー (ODP など) に通知しないため、それらのテクノロジーは Magento データセットから非同期になります。

これに対処するために、ODP は、最後のスキャン以降に更新された製品、顧客、注文を見つけるために Magento に存在するバッチ更新モジュールを構築しました。

1. [ODP Engage] > [ODP Schema Update] > [Run It!]に移動します。これにより、バッチ プロセスがどのエントリを同期するかを認識できるようになります。 これにより、ODP が同期するデータベース テーブルに 2 つの列 ( zaius_created_atとzaius_updated_at) が追加されます。

2. 「ODP バッチ更新」パネルで、Crontab の行を変更して、更新を実行する頻度を指定します。 更新頻度が高いほど、各更新の処理にかかる時間が短くなります。ただし、ODP が同期する必要があるものがあるかどうかを判断するために、データベースに対して小さなクエリが実行されます。 ODP では、高頻度の更新 (5 分ごとを意味する「*/5 * * * *」など) またはトラフィックの少ない時間に毎日バッチ (午前 1 時を意味する「0 1 * * *」など) のいずれかを推奨します。 Magento サーバーの時計によって示されます)。

3. [有効/無効]オプションを[有効]に設定します。

ローカリゼーションの構成 (0.13.0 以降)

多くの Magento サイトは複数の言語/通貨コードの組み合わせをサポートしており、それぞれを個別の store_view として作成します。

ODP Engage モジュールで機能する ODP ローカリゼーションは、そのようなサイトのサポートを追加し、それらの store_view を自動的に検出し、追加のローカライズされたバージョンの製品を送信します。 これらの製品は、対話したことのない製品であっても、顧客の好みの言語で動的な製品グリッドを生成するために必要なすべての情報を提供します。

この機能はまだベータ段階にあり、この機能を最大限に活用するには、ODP サポート チームが ODP プラットフォームで特定の更新を行う必要があります。 この機能を初期化する前に、CSM に相談して変更を加えてください。

1. ODP Engage構成ページに移動します。

2. [ODP Localizations]で、 [Enable/Disable]を[Enable]に切り替えます。

ODP ダブル オプトイン ベータ版 (0.13.3 以降)

ODP Engage には、ダブル オプトイン ワークフローをサポートする新しいオプションがあります。 ODP Engage 構成で「

ステータスが非アクティブの場合にイベントを送信」オプションを設定します。 [ステータスが非アクティブのイベントを送信]オプションを有効にすると、サブスクリプション ステータス 2 (「非アクティブ」) の新規ユーザーは、アクション「email_submitted」で「ニュースレター」イベントをトリガーします。

ユーザーは、イベント トリガー キャンペーンを設定して、ユーザーがオプトインし、そのキャンペーンへのエンゲージメントを定期的に発生する送信のフィルターとして使用できるようにすることができます。 ODP CSM はこれを設定するのに役立ちます。

Magentoクーポンコード

ODP でメールにクーポン コードを追加するには、以下の Liquid を追加して、使用するクーポン コードの ID として rules_id を設定します。

{% assign Coupon_rule = '{"rule_id": 1}' %}

{{ zaius.magento.api_config | magento_v1_coupon_code: クーポン_ルール }}

[プロモーション] > [ショッピング カートの価格ルール]で確認できます。

変更ログ

バージョン	リリース	ログ
0.14.2	2019-05-01	* バグ修正。 オブザーバーのリスト イベントにフォールバック タイムスタンプを追加しました。
0.14.1	2019-01-30	* バグ修正。 「getLangcode」を「getLangCode」に書き換えました
0.14.0	2019-01-25	* ODP に影響を与えなかったレガシー サブスクライバ状態の一括インポートを削除しました。 * 一括購読者のインポートにリストのサポートを追加しました * 重大なパフォーマンス上の問題を引き起こす不要な製品リスト イベントを削除しました。 * より広範な互換性を実現するためにローカリゼーションをクリーンアップしました。 * より厳格な監査に対してダブル オプトイン ワークフローをさらに更新しました。 設定での可視性を確保するためにデフォルトを追加しました。 * サブスクライバ API にパラメータを追加して、電子メール アドレスで特定のサブスクライバを取得できるようにしました (トラブルシューティング目的)
0.13.4	2018-11-05	* ダブル オプトイン ワークフローのベータ サポートを更新しました。
0.13.3	2018-10-22	* ダブル オプトイン ワークフローのベータ サポートを追加しました * 加入者情報を取得する際の潜在的な未定義のケースをクリーンアップしました (ログに表示される可能性がありましたが、追跡や読み込みは中断されませんでした)
0.13.2	2018-09-19	* さまざまな一括インポート エラーに対するホットフィックス * より広範な互換性を実現するためにローカリゼーション コードを微調整 * ODP 固有のログへのエラーの追加ログ * Magento の「getIsSalable」関数を使用して設定される製品在庫フィールドを追加しました。
0.13.1	2018-07-13	* 新しいローカリゼーション機能を使用するときに製品のライブ アップデートを追跡するためのホットフィックス。
0.13.0	2018-07-12	*ローカライゼーションの更新:継承、言語間のリンク、さまざまな通貨レポートなどを含む、ローカライズされた store_view のサポートを追加します。 (パブリック ベータ段階では、設定には ODP チームのサポートが必要です。カスタマー サクセス マネージャーにお問い合わせください) * 構成可能な製品のサポートの改善 (さらに追加予定) * ODP サポート チームがより正確かつ迅速にトラブルシューティングを提供できるようにするための API の改善および拡張。
0.12.2	2018-07-12	* クーポン コード サポートのホットフィックス。クーポンが適切なタイプを設定せず、生成されたコードが複数回使用可能になる場合に対処します。
0.12.1	2018-06-20	* より多くの環境をカバーし、API の一貫性を向上させるバッチ更新用のホットフィックス。
0.12.0	2018-06-04	* 一部のアドレスが途中で切断される原因となる顧客アドレスのインポートの問題をさらに修正しました。 影響を受ける場合は、アップデートをインストールしてから、ODP サポートに顧客の再インポートを依頼してください。 * サブスクライバのインポートと更新を修正し、サブスクリプション イベントに適切なタイムスタンプが付けられるようにします。サブスクライバの同期が防止され、すべてのサブスクライバが ODP 内でアクティブに関与しているように見えます。 * 新機能: バッチ更新。 特定の状況では、(製品に対する頻繁に) 更新が Magento によって検出されません。これは、Magento が ODP を更新していないことを意味します。 これにより、Magento と ODP が同期しなくなる可能性があります。 定期的な更新を ODP に送信するように Magento を設定するオプションのコンポーネントを追加しました。 この機能を有効にすると、Magento データベース (zaius_created_at および zaius_updated_at) に列が追加され、バッチ プロセスが新しいデータ ポイントと更新されたデータ ポイントのみの更新を送信できるようになります。 これまで商品フィード以外のケースは特定されていませんでしたが、この機能は商品、顧客、注文に対して利用可能です (ただし、返金やキャンセルは対象外です)。 設定の詳細については、上記の「バッチ更新の有効化」を参照してください。
0.11.1	2018-05-14	* 一部のアドレスが途中で切断される原因となる顧客アドレスのインポートの問題を修正しました。 影響を受ける場合は、アップデートをインストールしてから、ODP サポートに顧客の再インポートを依頼してください。
0.11.0		Magento EE フルページキャッシュをサポート
0.10.2		Python および .NET クライアントの WS-I 準拠のために修正されました。
0.10.1		注文が無効な Magento ストアに対応する場合でも、最初のデータ取り込みは失敗しなくなりました。
0.10.0		WS-I モードが有効な場合、ODP は Magento で動作します。
0.9.0		購入の都度、商品の在庫情報・残数が表示されるようになりました。
0.8.3		注文では、ネイティブ通貨ではなく基本通貨が使用されるようになりました。
0.8.2		プラグインが正しく動作しないという古い PHP バージョンのサポートにおける回帰を修正しました。
0.8.1		ODP へのすべての API 呼び出しは、暗号化された接続を介してデータを送信するようになりました。
0.8.0		製品/注文/顧客 ID に一意の ID をプレフィックスとして付けることを許可し、複数の Magento インスタンスを単一の ODP アカウントにプルできるようにします。
0.7.2		製品の場合、ODP は、キャッシュされた再スケールされたイメージのバージョンではなく、アイテムの「メディア URL」を使用するようになりました。
0.7.1		Magentoメーカーフィールドから製品ブランド情報を提供します。
0.7.0		ODP キャンペーンを通じて固有のクーポン コードを生成するためのサポートを追加します。
0.6.11		カート放棄リンクの処理に関する潜在的な問題を修正しました。
0.6.10		* 7.1.2までのphpでのインストールをサポート * カート放棄には静的なカート作成時間が必要であった (他の Magento プラグインはカート作成タイムスタンプを変更できる) 結果、カート放棄キャンペーンで問題が発生するバグを修正しました。
0.6.8		バックエンド注文追跡では、「保留中」から「完了」に直接移行する注文が正しく処理されるようになりました。 以前は「処理」がスキップされていたため、注文購入イベントは送信されませんでした。 これは、「フロントエンドで注文を追跡」オプションがオフになっている場合にのみ適用されます。
0.6.7		* カート放棄リンクは、複数のサーバーでのインストールで機能するようになりました。 * 注文は作成時ではなく、注文が「処理中」状態に移行したときに追跡されるようになりました (「フロントエンドで注文を追跡」オプションがオフになっている場合のみ)。
0.6.6		* UTM パラメータは、放棄されたカートのリダイレクト中に渡されます。 * カスタム フィールドが製品でオプションで返されるようになりました。 * デバッグを支援するために、データが ODP に送信されるときに、プラグインのバージョン番号 (0.6.6) が ODP に返されます。
0.6.4		* 放棄カート リンクは、ODP Engage を使用するとより確実に機能します。 * 製品画像が ODP に正しくインポートされるようになりました。
0.6.2		顧客の取り込み時に、顧客の購読解除ステータスに関する履歴情報を提供します。
0.6.1		バックエンド注文と製品エンティティの投稿に関連するバグを修正しました。
0.6.0		* デフォルトの注文は、注文後ページの完全な読み込みに依存するのではなく、Magento バックエンド経由で生成されます。 * 請求先住所の UTF-8 破損に関連する問題を修正。これにより、外国ロケールの顧客の注文が失われる可能性があります。
0.5.7		システムにログインしていない顧客に対してもカート放棄が機能するようにします (ただし、その ID はユーザー ステッチを通じて推測できます)。
0.5.5		イメージ ファイルが見つからない場合に例外ではなくエラーが生成されることに関連するマイナーなバグ修正。
0.5.4		管理コンソールから入力された購入の誤った処理に関連する軽微なバグ修正。
0.5.3		サードパーティの支払い処理業者へのリダイレクトを伴うチェックアウトをより確実に処理できるように、注文追跡戦略を変更しました。
0.5.2		製品エンティティの image_url と説明をキャプチャします。
0.5.1		ショッピングカート放棄キャンペーンの情報を提供します。
0.5.0		注文のキャンセルと注文の返金をサポートします。
0.4.0		* 新しい一括取得 API により、初期インポート プロセスが合理化され、全般的に改善されます。 * 製品エンティティの価格を取得します。 * 関連する Magento Web サイト、ストア、およびすべてのイベント (および一括インポートされた注文) のストア ビューをキャプチャして、スコープ設定と分析に役立てます。
0.3.2		複数配送のチェックアウトが失敗する原因となっていた注文追跡のバグを修正しました。
0.3.1		* 欠落している可能性のある内部データ フィールドの安全な処理を追加しました。 チェックアウトプロセスが完了しないという問題が発生した場合は、これで問題が解決されるはずです。 * 顧客のログアウト時に明示的に匿名モードに戻ります。
0.3.0