> For the complete documentation index, see [llms.txt](https://godomall-help.nhn-commerce.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://godomall-help.nhn-commerce.com/beginner/geo.md).

# GEO 활용 가이드

커스텀 스킨에서 생성형 엔진 최적화(GEO) 마크업을 직접 넣는 방법을 안내합니다.

{% hint style="info" %}
**커스텀 스킨에는 왜 자동으로 들어가지 않나요?**

커스텀 스킨은 상점이 소유하고 직접 관리하는 영역입니다. \
고도몰이 스킨 파일을 수정하면 기존 화면이 깨질 수 있습니다. \
그래서 보안 패치를 포함해 커스텀 스킨은 대신 수정하지 않으며, 마크업도 자동으로 넣지 않습니다.

※ 무료 스킨(모먼트·스토리지·마이그릭 등)은 설정만 켜면 마크업이 자동으로 들어갑니다.
{% endhint %}

***

### Step 1. 넣을 위치 확인하기

* 위치: `관리자 > 디자인 > 디자인 설정 > 디자인 페이지 수정`
* 기능설명: 상품 상세 스킨 파일에 마크업 블록을 직접 붙여 넣습니다.

#### 1-1. 상품 상세 스킨 파일 열기

{% stepper %}
{% step %}
**메뉴 진입**

`관리자 > 디자인 > 디자인 설정 > 디자인 페이지 수정`으로 이동합니다.
{% endstep %}

{% step %}
**파일 열기**

상품 상세 스킨 파일 `goods/goods_view.html`을 엽니다.
{% endstep %}

{% step %}
**블록 붙여 넣기**

`{ # heder }` 줄 **바로 아래**에 Step 2의 기본 틀을 붙여 넣습니다.
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
마크업은 **상품 상세 페이지에만** 넣어 주세요. 목록이나 메인에 넣으면 검색엔진이 잘못된 정보로 인식합니다.
{% endhint %}

수정을 마친 뒤 \[저장] 버튼을 눌러야 반영됩니다.

***

### Step 2. 기본 틀 붙여 넣기

* 기능설명: 아래 블록을 복사한 뒤, 직접 입력하는 값만 상점 값으로 바꿔 주세요.

#### 2-1. 기본 틀

```html
<script type="application/ld+json">
{
  "@context": "https://schema.org/",
  "@type": "Product",
  "name": "{=gd_isset(goodsView['goodsNmDetail'])}",
  "image": "{=goodsView['social']}",
  "brand": { "@type": "Brand", "name": "{=gd_isset(goodsView['brandNm'])}" },
  "sku": "{=goodsView['goodsNo']}",
  "offers": {
    "@type": "Offer",
    "price": {가격},
    "priceCurrency": "KRW",
    "availability": "https://schema.org/InStock",
    "itemCondition": "https://schema.org/NewCondition",
    "url": "{상품 상세 주소}",
    "seller": { "@type": "Organization", "name": "{=gMall.mallNm}" }
  }
}
</script>
```

* `{가격}`과 `{상품 상세 주소}`는 Step 3을 보고 직접 채워 주세요.
* `availability`와 `itemCondition`은 기본값이 들어 있습니다. 상품에 맞지 않으면 Step 3을 보고 바꿔 주세요.

#### 2-2. 치환코드로 자동으로 채워지는 값

아래 항목은 틀에 적힌 치환코드를 그대로 두면 값이 채워집니다.

| 항목     | 치환코드                                      |
| ------ | ----------------------------------------- |
| 상품명    | `{=gd_isset(goodsView['goodsNmDetail'])}` |
| 대표 이미지 | `{=goodsView['social']}`                  |
| 브랜드명   | `{=gd_isset(goodsView['brandNm'])}`       |
| 상품번호   | `{=goodsView['goodsNo']}`                 |
| 상점명    | `{=gMall.mallNm}`                         |
| 짧은 설명  | `goodsDescription` `[확인 필요: 치환코드 전체 표기]`  |

짧은 설명은 기본 틀에 들어 있지 않습니다. 넣으려면 `"description"` 줄을 추가해 주세요.

{% hint style="warning" %}
짧은 설명은 값이 없는 상품이 많습니다. \
값이 비어 있으면 `"description"` 줄을 통째로 빼 주세요. 빈 값으로 두면 검색엔진이 오류로 판단합니다.
{% endhint %}

***

### Step 3. 직접 입력하는 값 채우기

* 기능설명: 가격·재고·상품 상태·상품 주소는 전용 치환코드가 없어 직접 넣어야 합니다.

스킨에서 이미 가격과 재고를 출력하는 부분의 값을 가져다 써 주세요. \
그래야 화면에 보이는 값과 마크업 값이 같아집니다.

#### 3-1. 가격 (`price`)

**화면에 표시되는 할인 적용가**를 넣습니다. 정가가 아니라 고객이 실제로 보는 가격입니다.

* 비로그인 상태에서 보이는 가격을 기준으로 합니다. 쿠폰·회원등급처럼 로그인 후 적용되는 할인은 빼 주세요.
* **숫자만** 넣습니다. 스킨에 `10,000원`으로 출력되더라도 마크업에는 `10000`만 넣어 주세요.
* 따옴표로 감싸지 않습니다.

| 구분    | 예                    |
| ----- | -------------------- |
| 올바른 예 | `"price": 10000`     |
| 틀린 예  | `"price": "10,000원"` |

{% hint style="danger" %}
**가격이 없으면 검색 결과에 상품으로 노출되지 않습니다.**

구글은 가격·후기·평점이 모두 없는 상품을 상품으로 인식하지 않습니다. \
커스텀 스킨에서는 평점을 넣지 않으므로 가격이 유일한 조건입니다. 가격을 비워 두면 마크업은 들어가지만 검색 결과에 나오지 않고, 구글 서치콘솔에 오류로 쌓입니다.

가격이 없는 상품에는 마크업을 넣지 말아 주세요. 무료 스킨은 이런 상품을 자동으로 제외하지만, 직접 넣는 경우에는 이 처리가 적용되지 않습니다.
{% endhint %}

#### 3-2. 재고 (`availability`)

상품 상태에 따라 아래 값 중 하나를 넣습니다.

| 상태   | 넣는 값                            |
| ---- | ------------------------------- |
| 판매 중 | `https://schema.org/InStock`    |
| 품절   | `https://schema.org/OutOfStock` |

**판정 기준**

| 상품 유형           | 판매 중                    | 품절                |
| --------------- | ----------------------- | ----------------- |
| 옵션 없는 상품        | 품절 상태가 "정상"이고 재고가 1개 이상 | 그 외               |
| 옵션 있는 상품        | 옵션 중 하나라도 "정상"이고 재고가 있음 | 모든 옵션이 품절 또는 임시품절 |
| 재고 관리를 쓰지 않는 상품 | 항상 판매 중                 | 해당 없음             |

#### 3-3. 상품 상태 (`itemCondition`)

상품 등록 시 선택한 상품 상태에 맞는 값을 넣습니다.

| 상품 상태        | 넣는 값                                      |
| ------------ | ----------------------------------------- |
| 새 상품         | `https://schema.org/NewCondition`         |
| 중고           | `https://schema.org/UsedCondition`        |
| 반품 · 리퍼 · 전시 | `https://schema.org/RefurbishedCondition` |

대부분 새 상품이므로 기본 틀에는 새 상품 값을 넣어 두었습니다.

#### 3-4. 상품 주소 (`url`)

`https://`로 시작하는 전체 주소를 넣습니다. 상대 경로는 인식되지 않습니다.

```
https://{상점도메인}/goods/goods_view.php?goodsNo={상품번호}
```

예) `https://www.example.com/goods/goods_view.php?goodsNo=1000000001`

보안서버를 쓰는 상점은 `https://www.{상점도메인}` 형태로 통일해 주세요.

{% hint style="danger" %}
**평점(aggregateRating)은 넣지 마세요.**

커스텀 스킨에는 평균 평점을 가져다 쓸 수 있는 값이 없습니다. \
임의로 만든 평점은 실제 후기와 달라져 검색엔진에서 불이익을 받을 수 있습니다.
{% endhint %}

***

### Step 4. 넣기 전에 특수문자 확인하기

* 기능설명: 상품명·설명에 들어간 특수문자 때문에 마크업이 깨지지 않도록 미리 확인합니다.

상품명이나 설명에 따옴표(`"`)나 꺾쇠(`<`, `>`)가 있으면 마크업이 깨질 수 있습니다. 페이지가 비정상적으로 동작할 수도 있습니다.

1. 해당 문자가 들어간 상품이 있는지 먼저 확인해 주세요.
2. 있다면 상품명에서 해당 문자를 빼 주세요.

***

### Step 5. 제대로 들어갔는지 확인하기

* 기능설명: 페이지 소스와 구글 리치 결과 테스트로 적용 결과를 확인합니다.

#### 5-1. 페이지 소스 확인하기

1. 상품 상세페이지에서 마우스 오른쪽 버튼을 누른 뒤 \[페이지 소스 보기]를 누릅니다.
2. `application/ld+json`을 검색합니다.
3. 블록이 하나만 있는지 확인합니다. 둘 이상이면 중복이므로 하나만 남겨 주세요.

#### 5-2. 구글 리치 결과 테스트로 검사하기

1. 구글 리치 결과 테스트에 상품 상세 주소를 넣고 검사합니다.
2. "상품" 항목이 잡히고 오류가 없으면 정상입니다.

{% embed url="<https://search.google.com/test/rich-results>" %}

{% hint style="info" %}
경고는 권장 항목이 비어 있다는 뜻입니다. 검색 노출에는 지장이 없습니다.
{% endhint %}

**자주 나오는 오류**

| 메시지                                       | 원인                      | 조치                                  |
| ----------------------------------------- | ----------------------- | ----------------------------------- |
| 가격을 인식할 수 없음                              | `price`에 콤마나 "원"이 섞여 있음 | 숫자만 남깁니다.                           |
| 이미지를 가져올 수 없음                             | 이미지 주소가 상대 경로임          | `https://`로 시작하는 전체 주소로 바꿉니다.       |
| offers, review, aggregateRating 중 하나가 필요함 | 가격이 비어 있음               | 가격을 넣습니다. 가격이 없는 상품이면 마크업을 넣지 않습니다. |
| 구문 오류                                     | 상품명이나 설명에 따옴표·꺾쇠가 있음    | 상품명에서 해당 문자를 뺍니다.                   |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://godomall-help.nhn-commerce.com/beginner/geo.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
