マーケットプレイスとは？
マーケットプレイスは、小売業者がオンライン上でのプレゼンスを拡大できる機会にも、新規のバイヤーや特段の意図なくマーケットプレイスを見て回っているバイヤーに簡単にエンゲージできる機会にもなります。マーケットプレイスを使用すると、小規模な事業者でもさまざまな顧客にリーチできます。商品は通常、マーケットプレイス出品者から顧客に直接発送されます。
マーケットプレイスなら、出品者は小売業者のサイトで商品を販売できるため、その商品の存在をより幅広い人々に知ってもらうことができます。一方、小売業者は、品揃えを強化し、より幅広い顧客を獲得することができます。
小売業者は、マーケットプレイス機能を利用してサイトを収益化するだけでなく、このプレミアムなオンライン販売スペースを活かして、マーケットプレイスのベンダーに対し、CitrusAdを通じた上位の広告ポジションへの入札を募ることができます。
マーケットプレイスの広告主を設定する
統合機能の強化（詳細は後述）が完了すると、チームごとに出品者IDを設定できるようになります。これは小売業者チームからチームを作成する場合にのみ可能で、チームを編集するときに設定したり、サプライヤーが設定したりすることはできません。
新しいチームを作成するときに、出品者IDを選択できる「任意の入力欄」セクションが表示されます。選択可能な出品者IDは、商品カタログから直接取得されます。商品カタログに存在しない値を入力することはできません。
統合の要件
概要
CitrusAdとの標準的な統合に加えて、以下を実施して統合を強化する必要があります。
- 商品カタログファイルまたはAPIで商品ごとにsellerIdを実装する
- 広告レスポンスを解析し、必要に応じて正しい出品者の商品をレンダリングする
- 注文をCitrusAdに報告する際は、商品ごとにsellerIdを報告する
現在、CitrusAdの機能は、製品の販売者が販売者IDを持たず、製品の販売者IDのバリエーションも存在するユースケースには完全に対応していません。これに対する回避策は、マーケットプレイス以外の製品で小売業者の販売者IDを同期することです。マーケットプレイスの販売者ではない各サプライヤーには、この販売者IDを追加する必要があります。詳細については、テクニカルアカウントマネージャーにお問い合わせください。
商品カタログの機能強化
Citrusと同期された商品カタログでは、商品コードごとにsellerIdをCitrusAdに提供する必要があります。
ファイルを介したカタログの同期
追加の列/セクションを seller_idのカタログファイルに追加する必要があります。 seller_id と product_code の組み合わせが単独の行である必要があります。マーケットプレイス以外の商品の場合、 seller_id は空白のままにすることができます。
現在、ブランド販売者 (製品に SellerId がない場合) とマーケットプレイス販売者 (同じ製品に SellerId のバリアントがある場合) の両方を持つ製品には互換性がありません。このカテゴリに該当する製品をお持ちの場合は、現時点ではこれらの特定の製品についてのみマーケットプレイス販売者を登録することをお勧めします。
お客様のeコマースサイトがこの特定の製品のユースケースで設定されている場合は、当社が互換性に対応いたしますので、CitrusAdの連絡先にこの問題についてお知らせください。
この例については、「ファイルを介したカタログおよび商品の同期（Syncing catalog and product via file）」をご覧ください。
APIを介したカタログの同期
APIを介して商品を同期する場合、 sellerId を sellerId と gtin の一意の組み合わせごとに同期する必要があります。
POST $BASE_URL/v1/catalog-products?teamId=<YOUR_TEAM_ID> HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Basic <API_KEY>
{
"catalogProducts": [
{
"catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b",
"gtin": "23556578965543",
"sellerId": "327272-sade2-3ja",
"dtmCookieId": "AAAF8xLBTA968AB6TOthAAAAAAE",
"inventory": 50,
"price": "19.99",
"tags": [
"imageurl:https://your.image.host.com/image.jpg",
"name:Covergirl Clean 120 Creamy Natural Liquid Foundation30mL"
],
"filters": [
"category:Health&Beauty",
"category:Grocery",
"Brand:Covergirl",
"Special_Flag:0"
],
"profit": "1.50"
},
{
"catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b",
"gtin": "23556578965543",
"sellerId": "09sa-d32s--faasw",
"inventory": 50,
"price": "19.99",
"tags": [
"imageurl:https://your.image.host.com/image.jpg",
"name:Covergirl Clean 120 Creamy Natural Liquid Foundation30mL"
],
"filters": [
"category:Health&Beauty",
"category:Grocery",
"Brand:Covergirl",
"Special_Flag:0"
],
"profit": "1.50"
},
{
"catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b",
"gtin": "23556578965738",
"inventory": 26,
"price": "8.50",
"tags": [
"imageurl:https://your.image.host.com/image.jpg",
"name:Kelloggs Froot Loops Breakfast Cereal 500g"
],
"filters": [
"Brand:Kelloggs",
"category:Pantry",
"category:BreakfastFoods",
"category:Cereals",
"Special_Flag:0"
],
"profit": "0.50"
}
]
}
広告レスポンスの機能強化
CitrusAdが広告を配信するとき、 sellerId が提供されます（ gtin に関連付けられている場合）。これはすべての広告タイプに適用されますが、商品広告からの広告レンダリングに対してのみ意味を持ちます。商品広告レスポンスの例を以下に示します。
{
"ads": [
{
"id": "display_QqHaKRrKlFm1Wxr9c_DXJN4HSE3NzMzNjM2",
"gtin": "7733636",
"discount": {
"amount": 0,
"minPrice": 0,
"maxPerCustomer": 0
},
"expiry": "2021-05-12T04:17:50.400902957Z",
"position": 1
},
{
"id": "display_NzsHqP0_iQedlo9VnrO2vqkwi_k3NzMzNjI4",
"gtin": "7733628",
"sellerId": "2834-ascre-2wcr4",
"discount": {
"amount": 0,
"minPrice": 0,
"maxPerCustomer": 0
},
"expiry": "2021-05-12T04:17:50.400908257Z",
"position": 2
}
],
"banners": [],
"products": [],
"memoryToken":"85ykKVv-luDHMWLZx2d6xcPq6sF7CgkJCSJDb3VudGVyIjogIjIiLAoJCQkiQWRzIjogWwoJCQkJImRpc3BsYXlfV05VV0NwQkRKMUpKNm5wdVZSVExvOU40TUxzNE1UWTBOemt5TWc9PSIsCgkJCQkiZGlzcGxheV9MME5NUHRxNmdCcVFvREJOd3J0dE9UTGJoWk0xTVRFeU9UYzRPUT09IiwKCQkJCSJkaXNwbGF5XzlCcEpmdUpaWk9VXzgyaWpFM3VCczgxd3VVczRNekkwTnpVeE5nPT0iLAoJCQkJImRpc3BsYXlfcW1VU1p4TkpMQ0lqeWQwdTFJRDk0RmxVZ0pnNE16STBOelV4Tnc9PSIsCgkJCQkiZGlzcGxheV9oeHlFZktCUnRrNWlxMThMQzE1SDJHcEN3QjgxTVRFeU9UYzVNQT09IiwKCQkJCSJkaXNwbGF5X1NkcjFEcU5aUEFtcGh0Q1FIUndoYUxFT1B0RXhNamsxT1RJNE5BPT0iLAoJCQkJImRpc3BsYXlfeVlSai1qV2Ntc2ozNzhrel9PMm0yOVlwTjhJeE5EazNPRE00TXc9PSIsCgkJCQkiZGlzcGxheV9Xbm9NZGZuLTRTVmhxcF9xQzVvLWxoT0paNm8xTkRJeE1UUTROdz09IgoJCQldLAoJCQkiVFRMIjogMTYyODk4NTYwMAoJCX0="
}
正しい出品者の商品が表示されるようにするには、CitrusAdから提供された sellerId を読み取り、適切な出品者の商品を顧客に表示する必要があります。
注文レポートの機能強化
CitrusAdに注文を報告する際は、 sellerId を gtin を指定する必要もあります。
この手順は必須であり、省略することはできません。省略すると、広告が注文に関連付けられません。
ファイルを介した注文の同期
追加の列/セクションを次の注文ファイルに追加する必要があります： seller_idのカタログファイルに追加する必要があります。 seller_id と product_code の組み合わせが単独の行である必要があります。マーケットプレイス以外の商品の購入の場合、 seller_id は空白のままにすることができます。
例については、「ファイルを介した注文データの同期（Syncing order data via file）」をご覧ください。
APIを介した注文の同期
APIを介して注文を同期する場合、注文の報告時に sellerId を同期する必要があります（該当するものがある場合）。購入した商品に sellerIdがない場合は、省略することができます。
以下は、1つの商品がマーケットプレイス出品者からの商品で、もう1つがマーケットプレイスの商品ではない場合の注文の例です。
POST $BASE_URL/v1/orders HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Basic <API_KEY>
{
"orders": [
{
"customerId": "npc-s243-ir",
"sessionId": "5cat7-9964-4f",
"orderDate": "2021-12-02T15:00:00Z",
"id": "abcti84ew-c158-4d78-a0af-b48bbwfrcss4",
"orderItems": [
{
"gtin": "9891998566P",
"quantity": 3,
"regularUnitPrice": "1.00",
"totalOrderItemPriceAfterDiscounts": "3.00",
"sellerId": "10sa-3s33-j8e3"
}
]
},
{
"gtin": "351998532P",
"quantity": 1,
"regularUnitPrice": "2.50",
"totalOrderItemPriceAfterDiscounts": "2.50"
}
]
}
]
}
既存のチームの移行
マーケットプレイスの販売者をサポートするために統合を拡張する場合、お客様または広告主が実行しなければならない手順が複数あります。CitrusAdシステム内で製品がどのように動作するかを知ることは大切です。
出品者IDのない製品とある製品は、CitrusAd システム内では異なるエンティティです。そのため、キャンペーンを移行して、更新する必要がある既存のキャンペーンすべてに対して新しい適切な商品バリエーションを選択する必要があります。
- CitrusAdのテクニカルアカウントマネージャーに、マーケットプレイスの出品者ID機能を有効にする旨を通知します。
- テクニカルアカウントマネージャーは、チーム移行の処理ができるように内部属性が設定されていることを確認する必要があります。
- 出品者があるID製品で製品カタログを拡張する
- 出品者IDを報告するために注文報告を拡張する
- 既存のチームを移行する場合は、既存のチームを編集して出品者IDを指定します。
- チームを編集後、各チームのキャンペーンを編集して、製品を再度選択する必要があります。この工程は、キャンペーンで選択された出品者IDを持つ新しい製品が必要であるのに対し、チームが出品者IDを取得する前に作成されたキャンペーンでは、製品の正しいバリアントが選択されないために発生します。