마켓플레이스란 무엇인가요?
마켓플레이스는 소매업체가 온라인에서 입지를 확장할 수 있는 유일한 기회이며 신규 또는 간헐적 구매자들을 쉽게 유입시킬 수 있습니다. 마켓플레이스는 마켓플레이스 판매자가 고객에게 직접 배송을 하는 방식으로 소규모 업체들이 다양한 고객층에 접근할 수 있도록 합니다.
판매자는 마켓플레이스를 통해 자신의 소매 사이트에서 제품을 판매하여 더 많은 대상 고객에게 제품의 가시성을 증가시킬 수 있으며 소매업체는 보다 다양한 고객층에게 판매할 추가적인 제품 오퍼링 기회를 확보합니다.
소매업체는 마켓플레이스 기능으로 사이트를 수익화하는 것 외에도 프리미엄 온라인 쉘프 공간을 활용할 수 있으며 마켓플레이스 벤더가 CitrusAd를 통해 최상의 위치에 입찰하게 되는 기회를 제공할 수 있습니다. 아래 문서를 잘 읽어 주십시오.
마켓플레이스 광고주 설정
통합 향상이 완료되면(아래 세부 정보 참조) 팀별로 Seller ID를 설정할 수 있습니다. 소매업체 팀에서 팀을 생성하는 경우에만 가능하며 팀 편집 시 또는 공급업체는 이 작업을 수행할 수 없습니다.
새 팀 생성 시 Seller ID를 선택할 수 있는 "선택사항 필드" 섹션이 있습니다. Seller ID는 제품 카탈로그에서 직접 선택할 수 있습니다. 제품 카탈로그에 없는 값은 입력할 수 없습니다.
통합 요구 사항
고급 단계 개요
CitrusAd와 표준 통합을 구축하는 것 외에도 다음 사항을 개선하여 통합을 향상시켜야 합니다.
- 제품 카탈로그 파일 또는 API에서 제품별 sellerId 설정
- 광고 반응을 분석하고 관련되는 경우 정확한 판매자 오퍼 렌더링
- CitrusAd에 주문 보고 시 고유 상품별 sellerId 보고
현재 CitrusAd의 기능은 판매자 ID가 없는 제품 판매자에 대한 사용 사례를 지원하지 않으며, 제품의 판매자 ID 변형이 존재합니다.이에 대한 확인된 해결 방법은 마켓플레이스 제품 외 모든 제품에 대해 소매업체 판매자 ID를 동기화하는 것이며, 마켓플레이스 판매자가 아닌 각 공급업체는 이 판매자 ID를 추가해야 합니다.자세한 사항은 기술 계정 관리자에게 문의하십시오.
제품 카탈로그 개선
CitrusAd와 동기화된 제품 카탈로그에 고유 제품 코드별 sellerId를 CitrusAd에 제공해야 합니다.
파일을 통한 카탈로그 동기화
다음 카탈로그 파일에 추가 열/섹션을 추가해야 합니다. seller_id.모든 seller_id 및 product_code 조합은 고유한 행이어야 합니다. 마켓플레이스 외 제품은 seller_id 를 비워둘 수 있습니다.
현재 브랜드 판매자(제품에 sellerId가 없는 경우)와 마켓플레이스 판매자(같은 제품에 sellerId 변형이 있는 경우)가 모두 있는 제품은 호환되지 않습니다. 이 카테고리에 해당되는 제품이 있는 경우 지금은 이러한 특정 제품에 대해 마켓플레이스 판매자만 온보딩하는 것이 좋습니다.
CitrusAd에서는 추후 호환 서비스 지원을 위해 노력하고 있습니다. 귀하의 전자 상거래 사이트가 이러한 특정 제품으로 구성된 경우 CitrusAd 담당자에게 해당 내용을 알려주시기 바랍니다.
파일을 통한 카탈로그 및 제품 동기화를 참조하십시오.
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",
"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 가 있는 경우 해당 Id가 제공됩니다. 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에 주문 보고 시 고유한 gtin당 sellerId( sellerId 를 gtin )를 지정해야 합니다.
이 단계는 필수이며 반드시 수행해야 합니다. 그렇지 않을 경우 광고가 주문에 귀속되지 않습니다.
파일을 통한 주문 동기화
다음의 주문 파일에 추가 열/섹션을 추가해야 합니다. seller_id.모든 seller_id 및 product_code 조합은 고유한 행이어야 합니다. 마켓플레이스 외 제품은 다음을 비워둘 수 있습니다. seller_id 를 비워둘 수 있습니다.
파일을 통해 주문 데이터 동기화를 참조하십시오.
API를 통한 주문 동기화
API를 통해 제품을 동기화 할 때 주문 보고 시 해당되는 경우 sellerId 를 동기화해야 합니다. 구매한 제품에 sellerId가 없는 경우 생략할 수 있습니다.
다음은 하나는 마켓플레이스 판매자의 제품이고 다른 하나는 마켓플레이스 외 제품인 경우 주문의 예입니다.
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가 없는 제품과 판매자 ID가 있는 제품은 CitrusAd 시스템에서 두 개의 고유한 엔터티입니다. 따라서 업데이트해야 하는 기존의 모든 캠페인에 대해 올바른 새 제품 변형을 선택하려면 캠페인을 마이그레이션해야 합니다.
- 마켓플레이스 판매자 ID 기능을 활성화하려 한다고 CitrusAd 기술 계정 관리자에게 알리십시오
- 기술 계정 관리자는 내부 속성이 마이그레이션 팀을 처리하도록 구성되어 있는지 확인할 수 있어야 합니다
- 판매자 ID 제품으로 제품 카탈로그 개선
- 판매자 ID를 보고하도록 주문 보고 기능 개선
- 기존 팀을 마이그레이션하는 경우 판매자 ID를 지정하도록 기존 팀을 편집하십시오.
- 팀을 편집하고 난 후 다시 제품을 선택하려면 각 팀의 캠페인을 편집해야 합니다. 그 이유는 캠페인에서 선택된 판매자 ID가 새있는 제품이 필요하지만 팀이 판매자 ID를 갖기 전에 생성된 캠페인에 선택된 제품의 올바른 변형이 없기 때문입니다.