# 다이나믹 상품 광고 - Dynamic Product Ads

## 다이나믹 상품 광고 — 데이터 피드 온보딩

{% hint style="info" %}
본 가이드는 Appier 다이나믹 상품 광고를 위해 상품 카탈로그를 연동하는 데 필요한 모든 정보를 담고 있습니다. 설정 중 문의 사항이 있으시면 <support@appier.com>으로 연락해 주시기 바랍니다.
{% endhint %}

***

### 개요

**다이나믹 상품 광고**는 사용자의 검색 활동과 관심사를 기반으로 가장 관련성 높은 상품을 자동으로 노출하는 광고 솔루션입니다. 이 개인화된 추천 시스템 구현을 위해 Appier는 **데이터 피드**, 즉 상품 카탈로그 정보를 담은 구조화된 파일이 필요합니다.

본 페이지는 피드 준비 방법, Appier로의 전달 방법, 그리고 온보딩 과정에서 예상되는 사항을 안내합니다. 가이드를 검토하신 후, 페이지 하단의 온보딩 체크리스트를 참고하여 필요한 정보를 Appier에 공유해 주세요.

***

### 파일 사양

#### 지원 파일 형식

Appier는 다음 형식의 상품 피드를 지원합니다.

<table><thead><tr><th width="204.44793701171875">형식</th><th width="195.078125">확장자</th><th>비고</th></tr></thead><tbody><tr><td>CSV</td><td><code>.csv</code></td><td>대부분의 클라이언트에게 권장</td></tr><tr><td>XML</td><td><code>.xml</code></td><td>표준 XML 구조를 따라야 합니다</td></tr><tr><td>TSV</td><td><code>.tsv</code></td><td>탭으로 구분된 형식</td></tr><tr><td>RSS</td><td><code>.rss</code></td><td>RSS 2.0 피드 형식</td></tr><tr><td>JSON</td><td><code>.json</code></td><td>상품 객체의 플랫 JSON 배열</td></tr></tbody></table>

#### 파일 인코딩

모든 피드 파일은 **UTF-8** 인코딩을 사용해 주세요.

#### 피드 유형

<table><thead><tr><th width="204.65106201171875">유형</th><th width="283.45318603515625">설명</th><th>권장 업데이트 주기</th></tr></thead><tbody><tr><td><strong>전체 피드 (Full Feed)</strong></td><td>전체 상품 카탈로그를 포함</td><td>매일 (daily)</td></tr><tr><td><strong>부분 피드 (Partial Feed)</strong></td><td>업데이트되거나 새로 추가된 상품만 포함</td><td>매시간 (hourly) 또는 변경 발생 시</td></tr></tbody></table>

대부분의 클라이언트에게는 **매일 전체 피드(daily full feed)**&#xB85C; 시작하는 것을 권장합니다. 연동이 안정화된 후, 더 빈번한 업데이트가 필요한 경우 부분 피드로 전환할 수 있습니다.

#### 파일 형식 예시

**CSV 예시**

```csv
id,title,image_link,link,price,sale_price,currency,availability,google_product_category,description
P001,블루 런닝화,https://example.com/images/P001.jpg,https://example.com/products/P001,32000,25600,KRW,in stock,스포츠 > 신발,통기성 메쉬 어퍼가 적용된 경량 런닝화.
P002,코튼 티셔츠,https://example.com/images/P002.jpg,https://example.com/products/P002,8900,8900,KRW,in stock,의류 > 상의,다양한 컬러로 출시된 클래식 핏 코튼 티셔츠.
```

**XML 예시**

```xml
<?xml version="1.0" encoding="UTF-8"?>
<products>
  <product>
    <id>P001</id>
    <title>블루 런닝화</title>
    <image_link>https://example.com/images/P001.jpg</image_link>
    <link>https://example.com/products/P001</link>
    <price>32000</price>
    <sale_price>25600</sale_price>
    <currency>KRW</currency>
    <availability>in stock</availability>
    <google_product_category>스포츠 &gt; 신발</google_product_category>
    <description>통기성 메쉬 어퍼가 적용된 경량 런닝화.</description>
  </product>
</products>
```

***

### 필드 설명

아래 표는 피드 내 포함되는 모든 상품 필드를 나열합니다. **필수**로 표시된 필드는 피드가 올바르게 처리되기 위해 **반드시 필요**합니다.

> **중요:** Appier의 표준 필드명과 다른 필드명을 사용하는 경우, **"클라이언트 필드명"** 컬럼에 기입하고 매핑 정보를 Appier에 공유해 주세요.

<table><thead><tr><th width="227.60418701171875">Appier 필드명</th><th width="142.484375">필수/선택</th><th>설명</th></tr></thead><tbody><tr><td><code>id</code></td><td><strong>필수</strong></td><td>각 상품의 고유 식별자. 한 번 지정된 ID는 변경하지 마세요. 반각 32자 이하, ASCII 범위(0x21~0x7e) 내 문자만 허용.</td></tr><tr><td><code>title</code></td><td><strong>필수</strong></td><td>상품명. 전각 50자 또는 반각 100자 이하. 광고 효과를 높이기 위해 고유하고 명확한 상품명을 사용해 주세요.</td></tr><tr><td><code>image_link</code></td><td><strong>필수</strong></td><td>상품 메인 이미지 URL. 600×600px 이상 권장. 정사각형 형식 권장, 모든 이미지에 동일한 크기 사용.</td></tr><tr><td><code>link</code></td><td><strong>필수</strong> (웹)</td><td>웹사이트 내 상품 상세 페이지 URL.</td></tr><tr><td><code>ios_url</code></td><td><strong>필수</strong> (앱)</td><td>iOS 앱 내 상품 페이지로 이동하는 딥링크 URL. iOS 앱이 있고 딥링크를 지원하는 경우 필요.</td></tr><tr><td><code>android_url</code></td><td><strong>필수</strong> (앱)</td><td>Android 앱 내 상품 페이지로 이동하는 딥링크 URL. Android 앱이 있고 딥링크를 지원하는 경우 필요.</td></tr><tr><td><code>price</code></td><td><strong>필수</strong></td><td>할인 전 정가.</td></tr><tr><td><code>sale_price</code></td><td><strong>필수</strong></td><td>할인 적용 후 현재 판매 가격.</td></tr><tr><td><code>currency</code></td><td><strong>필수</strong></td><td><a href="https://en.wikipedia.org/wiki/ISO_4217">ISO 4217</a> 표준 3자리 통화 코드 (예: <code>KRW</code>, <code>USD</code>, <code>JPY</code>).</td></tr><tr><td><code>availability</code></td><td><strong>필수</strong></td><td>재고 있음: <code>in stock</code>, 재고 없음: <code>out of stock</code>으로 설정.</td></tr><tr><td><code>google_product_category</code></td><td><strong>필수</strong></td><td><p>상품 카테고리를 계층 형식으로 입력. <code>></code>(앞뒤 공백 포함)로 여러 계층 구분. </p><p>예: <code>Category_A > Category_B</code>. </p><p>계층 구조가 없는 경우 쉼표로 구분: <code>Category_A > Category_B , Category_X</code></p></td></tr><tr><td><code>description</code></td><td>선택 (권장)</td><td>상품 설명. 전각 2,500자 또는 반각 5,000자 이하. 전체 대문자, 짧거나 반복적인 설명은 피해 주세요.</td></tr><tr><td><code>extra_image_link</code></td><td>선택</td><td><p>추가 상품 이미지 URL. 600px 이상 권장. 최대 10개, <code>|</code>로 구분. </p><p>예: <code>image_link_1|image_link_2|image_link_3</code></p></td></tr><tr><td><code>keyword</code></td><td>선택</td><td>상품 관련 키워드, 쉼표로 구분.</td></tr></tbody></table>

***

### 연동 방법

Appier는 프로덕트 피드 수신을 위한 세 가지 방법을 지원합니다. 기술 환경에 맞는 방법을 선택해 주세요.

#### 방법 A — HTTP/HTTPS 링크 (권장)

피드 파일의 직접 다운로드 URL을 제공해 주세요. 가장 간단한 방법입니다.

**요건:**

* 로그인이나 인증 없이 직접 파일을 다운로드할 수 있는 URL이어야 합니다.
* 안정적이고 고정된 URL로 접근 가능해야 합니다.
* IP 허용 목록이 필요한 경우, Appier 서버 IP를 안내해 드립니다. 담당자에게 문의해 주세요.

**URL 예시:**

```
https://www.example.com/feed/products.xml
https://feed.example.com/products_feed.txt
```

***

#### 방법 B — FTP Pull (Appier가 클라이언트 FTP 서버에서 가져오기)

FTP/SFTP 서버에 피드를 호스팅하는 경우, Appier가 스케줄에 따라 자동으로 파일을 가져옵니다.

**Appier에 제공해야 할 정보:**

* FTP 서버 주소 및 포트
* 사용자명과 비밀번호 (또는 SSH 키)
* 파일 경로 및 파일명

> **IP 허용 목록:** FTP 서버에 IP 제한이 있는 경우, Appier 서버 IP를 허용 목록에 추가해 주세요. IP 주소는 문의해 주세요.

***

#### 방법 C — FTP Puch (클라이언트가 Appier FTP 서버에 업로드)

Appier의 FTP 서버에 직접 피드를 업로드할 수 있는 인증 정보를 제공해 드립니다. 외부 HTTP 요청을 지원하지 않는 시스템에 적합합니다.

**Appier가 제공하는 정보:**

* FTP 서버 주소
* 전용 계정 인증 정보
* 업로드 대상 파일 경로

**주의 사항:**

* 날짜가 포함된 파일명(예: `products_20250101.csv`) 대신 **고정된 파일명**(예: `products.csv`)을 사용해 주세요. 이를 통해 Appier 시스템이 최신 파일을 안정적으로 참조할 수 있습니다.
* 예약된 동기화 시간 전에 지정된 경로에 파일을 업로드해 주세요.

***

### 동기화 스케줄

Appier는 설정 가능한 스케줄에 따라 데이터 피드를 동기화합니다. 권장 설정은 다음과 같습니다.

| 피드 유형                | 권장 빈도                     |
| -------------------- | ------------------------- |
| 전체 피드 (Full Feed)    | 하루 1회 (예: 현지 시간 오전 02:00) |
| 부분 피드 (Partial Feed) | 매시간 또는 대량 재고 업데이트 후       |

최적의 동기화 스케줄은 온보딩 시 Appier와 함께 설정합니다.

***

### 온보딩 체크리스트

연동을 원활하게 시작하기 위해, 온보딩 전 또는 진행 중에 아래 정보를 Appier에 공유해 주세요. 이를 통해 데이터 피드 연동 설정을 효율적으로 진행할 수 있습니다.

| 항목        | 내용                                     |
| --------- | -------------------------------------- |
| 데이터 소스 링크 | 피드 파일이 호스팅된 URL 또는 FTP 경로              |
| 전송 방법     | HTTP/HTTPS 링크, FTP Pull, FTP Push 중 선택 |
| 업데이트 빈도   | 피드 업데이트 예정 빈도 (예: 매일, 매시간)             |
| 예상 상품 수   | 카탈로그의 대략적인 상품 수                        |
| 인증 요건     | 피드 접근에 필요한 인증 정보, 토큰 또는 IP 허용 목록       |
| 필드명 매핑    | Appier 표준 필드명과 다른 경우 매핑 정보 제공          |

***

### 문의하기

연동 과정에서 문의 사항이나 문제가 발생하면 <support@appier.com>으로 이메일을 보내 주세요.