概要

この統合の一環として、以下の操作を実行する必要があります。

1. クロスセルカテゴリプレースメントに追加の広告リクエストを実装します。
   1. これには、サイト上に広告を配置してレンダリングする作業や、クリック数やインプレッション数を報告する作業が含まれます。
   2. 注文は、標準統合の一部としてEpsilon Retail Mediaに提供される必要があります。
2. If you synchronise category IDs with Epsilon Retail Media, you will need to use the filterMapping API to provide human readable values for the UI category selection
   1. これは、名前ではなくカテゴリIDを使用して統合されている場合にのみ適用されます。(広告をリクエストする場合、フィルタがcategory:Milkではなくcategory:123j-dsef-erになる場合など)
3. (推奨) - カテゴリのクロスセルマッピングを同期すると、承認を自動化し、キャンペーン管理の負荷を軽減できます。

広告リクエストとサイト統合

広告リクエスト

カテゴリクロスセルには独立したプレースメントが必要なため、カテゴリクロスセルを統合する広告タイプごとに追加の広告リクエストを統合する必要があります。

リクエストの形式は、以下に示すクロスセルカテゴリの広告リクエストと一致しなくてはなりません。

• 商品広告 - カテゴリクロスセル広告のリクエスト
• バナー広告 - カテゴリクロスセル広告のリクエスト
• バナーX - カテゴリクロスセル広告のリクエスト

インプレッション数とクリック数の報告

Once you have integrated your ad request, you will also need to ensure you are reporting clicks and impressions correctly for each ad shown. Ensure you read Reporting impressions & clicks.

注文の報告

Generally, most integrations report all order information to Epsilon Retail Media as per a standard integration. You need to ensure you are reporting all orders correctly to Epsilon Retail Media as per Order data.

フィルタマッピング

フィルターマッピングエンドポイントを使用すると、カテゴリIDを人間が読み取れる値にマッピングできます。この場合、UIがユーザーに値を表示するときにカテゴリIDを同期する場合に必要です。

📘

商品カタログ内の人間が読めるカテゴリをEpsilon Retail Mediaと同期する場合、この手順は必要ありません。

ユーザーは category:12345-abcdeが何であるかを理解できません。filterMapping APIを使用すると、値をサイト上の関連するカテゴリ名 ( category:Pantryなど) にマッピングできます。

There is no file based method to synchronise this information, it must be done via the filterMapping API.

🚧

サイトに追加のカテゴリを作成するときは、カテゴリの更新にfilterMapping APIが使用されていることを確認する必要があります。

カテゴリのクロスセルマッピング(推奨)

このタイプのプレースメントを統合する場合は、どのカテゴリが相互にターゲティングできるかのマッピングを提供することを強くお勧めします。これにより、最初の統合作業後の業務を効率化することができます。広告主のエクスペリエンスは、すでに選択が許可されているカテゴリのみを許可するよう合理化されています。

さらに、クロスセルマッピングが提供されている場合、クロスセルカテゴリキャンペーンの自動承認を設定することもできます。

統合方法

• You are able to use the crossSellCategory API to create and manage mappings as you require.
• あるいは、以下に示す形式で、Epsilon Retail MediaがホストするGCSバケットにTSVファイルを提供することもできます。

API統合

All required information can be seen in the crossSellCategory API reference.

ファイル統合

ファイルごとに統合する場合、Epsilon Retail Mediaはカタログごとにファイルを必要とします。そのカテゴリ間で相互にターゲットを設定できます。

ファイル内の各行は、カテゴリの1つのマッピングと、それがターゲットにできるカテゴリを示しています。各マッピングは一方向です (チョコレート -> ミルクを同期すると、チョコレート製品がミルクカテゴリに表示されます。乳製品をチョコレート上に表示できるようにする必要があり、追加の行が必要な場合)。

以下の仕様に準拠したTSV形式のデータフィードが必要です。

追加のファイル仕様は次のとおりです。

• TSVファイルのみがサポートされている
• TSVはCRLFではなくLFでなくてはならない
• TSVはUTF-8でエンコードされている必要があり、どのタイプでもフィードが失敗する原因になる
• 以下の命名規則が必要: ^cross_sell_category.*.tsv$

スニペットの例は次のとおりです。

上記のスニペットにより、クッキーカテゴリをミルクカテゴリとチョコレートカテゴリにクロスセルできるようになります。ミルクカテゴリをクッキーカテゴリにクロスセルできます。チョコレートカテゴリをターゲットにすることはできますが、他のカテゴリをターゲットにはできません。

❗️

各行は一意のマッピングの組み合わせです

一意のクロスセルカテゴリマッピングごとに一意の行を同期する必要があります。単一行内の複数のcross_category_idを同期しようとすると、ファイルの取り込みは失敗します。

🚧

列の順序

ファイルの最初の列がcategory列であることを確認してください。cross_category_idを最初の列として同期すると、取り込みに失敗します。

機能の有効化プロセス

検索用語候補フィードの同期を開始する準備ができたら、Epsilon Retail MediaがファイルをドロップするためのGCSバケットを設定します。

この機能は、GCSバケットでのみサポートされています。AWS/Azure/その他の外部バケットはサポートされていません。

テクニカルアカウントマネージャーが、この機能の有効化についてご案内します。Epsilon Retail Mediaのプラットフォーム運用チームは設定を行う必要があるため、有効化にはさらに時間がかかることにご注意ください。