커머스 목적으로 부동산 매물을 게시하려면 비즈니스가 인증을 받아야 합니다.
1단계: 주택 매물 카탈로그를 만듭니다.
2단계: 품목과 가격을 설정합니다.
3단계: 옵션을 업데이트합니다.
4단계: 품목 카탈로그를 품목 세트로 필터링합니다.
5단계: 오프라인 전환을 전송합니다(선택 사항).
6단계: 부동산 타겟을 구축합니다. 사용자가 게시한 부동산 매물과는 달리, 파트너 통합의 경우 Messenger 채팅이 아니라 잠재 고객 양식을 통해 잠재 고객을 파트너에게 전송합니다. 커머스를 위한 잠재 고객 가져오기에 대해 자세히 알아보세요.
7단계: 주택 매물을 위한 광고를 만들고 게재합니다.
8단계: Facebook에서 사람들이 어떻게 광고에 참여하는지 알아보기 위해 게재 정보를 가져옵니다. 광고 인사이트를 참조하세요.
9단계: 디버그 도구를 사용하여 문제를 진단하고 해결합니다. 어드밴티지+ 카탈로그 광고 디버그 도구를 참조하세요.
카탈로그에는 광고하고자 하는 부동산의 리스트를 포함해야 합니다. 카탈로그 참고 자료를 참조하세요.
어드밴티지+ 카탈로그 광고의 주택 매물 리스트 카탈로그를 만들려면 vertical
을 home_listings
으로 설정합니다.
curl \
-F 'name=Home Listing Catalog Name' \
-F 'vertical=home_listings' \
-F 'access_token=<ACCESS TOKEN>' \
https://graph.facebook.com/<API_VERSION>
카탈로그 API를 사용하려면 마케팅 API 액세스 레벨이 필요하고 비즈니스 관리자를 통해 첫 번째 카탈로그를 생성하여 서비스 약관에 동의해야 합니다.
커머스를 위한 카탈로그를 만드는 방법에 대한 지침은 Marketplace 플랫폼 문서를 참조하세요.
품목에는 품목 ID, 이름, 이용 가능성, 설명, 주소, 침실, 욕실 등의 부동산 정보가 포함됩니다. 비즈니스에서 업로드하거나 가져온 품목 세트를 만들 수 있습니다. 단일 품목은 웹사이트나 앱에 표시된 단일 부동산을 나타냅니다.
카탈로그에서 모든 부동산에 대한 피드가 하나일 수도 있고, 하나의 피드가 단일 국가, 부동산 중개업소 또는 중개인의 부동산을 나타내어 피드가 여러 개일 수도 있습니다.
어드밴티지+ 카탈로그 광고의 경우 다음과 같은 형식 중 하나로 품목 피드를 제공해야 합니다.
파일 형식 | 설명 | 샘플 파일 |
---|---|---|
XML | 일반적으로 자동화된 피드 제공자 시스템에 의해 생성됩니다. 루트 | |
CSV, TSV | 첫 번째 행에는 값이 제공될 순서에 따라 선택된 필드 이름이 나열되어야 합니다. 그다음 행에서는 주택 매물별로 해당하는 값을 제공합니다. 중첩 또는 다중값 필드(예: image)는 JSON 인코딩 값을 사용하거나 | 다운로드(CSV) |
커머스 목적인 경우 다음과 같이 품목 피드를 XML 형식으로 제공해야 합니다.
파일 형식 | 설명 |
---|---|
XML | 일반적으로 자동화된 피드 제공자 시스템에 의해 생성됩니다. 루트 |
CSV, TSV, JSON | 현재 이 형식은 지원되지 않습니다. |
피드 파서가 UTF8
, UTF16
또는 UTF32
텍스트 인코딩을 자동으로 감지합니다. 예상치 못한 바이트 시퀀스가 나타날 경우 LATIN1
으로 돌아갑니다.
<?xml version="1.0" encoding="UTF-8"?> <listings> <title>example.com Feed</title> <link rel="self" href="http://www.example.com"/> <listing> <home_listing_id>12345678</home_listing_id> <name>1 Hacker Way, Menlo Park, CA 94025</name> <availability>for_rent</availability> <description>An amazing listing</description> <address format="simple"> <component name="addr1">1 Hacker Way</component> <component name="city">Menlo Park</component> <component name="region">California</component> <component name="country">United States</component> <component name="postal_code">94025</component> </address> <latitude>1.11414</latitude> <longitude>-1.835003</longitude> <neighborhood>Menlo Oaks</neighborhood> <image> <url>http://example.com/12345678-1.jpg</url> </image> <image> <url>http://example.com/12345678-2.jpg</url> </image> <image> <url>http://example.com/12345678-3.jpg</url> </image> <listing_type>for_rent_by_agent</listing_type> <num_baths>6</num_baths> <num_beds>5</num_beds> <num_units>1</num_units> <price>110000 USD</price> <property_type>house</property_type> <url>http://www.example.com/link_to_listing</url> <year_built>2007</year_built> </listing> </listings>
다음 지원되는 필드는 제품 카탈로그에 추가하는 품목을 위해 고안되었습니다.
현지화된 카탈로그는 주택 매물에 지원되는 필드를 참조하세요.
피드 파서가 UTF8
, UTF16
또는 UTF32
텍스트 인코딩을 자동으로 감지합니다. 예상치 못한 바이트 시퀀스가 나타날 경우 LATIN1
으로 돌아갑니다. 필드 값의 텍스트는 언어 사용에 제한이 없으나 필드 이름은 아래와 같이 정확하게 영어로 지정해야 합니다.
필드 이름 및 유형 | 설명 |
---|---|
유형: 문자열 | 어드밴티지+ 카탈로그 광고 및 커머스에 필수입니다. 고유한 주택(아파트/콘도) 매물 ID입니다. 가능한 한 가장 세분화된 ID를 지정하세요. 예: |
유형: 문자열 | 어드밴티지+ 카탈로그 광고에는 적용되지 않습니다. 커머스에는 선택 사항입니다. 건물 또는 아파트의 고유 ID입니다. 그룹별로 고유해야 합니다. |
유형: 문자열 | 어드밴티지+ 카탈로그 광고 및 커머스에 필수입니다. 주택 매물의 제목입니다. 예: |
유형: 문자열 | 어드밴티지+ 카탈로그 광고 및 커머스에 필수입니다. 주택 매물의 현재 구매 가능 여부입니다. 지원되는 값: |
유형: 문자열 | 어드밴티지+ 카탈로그 광고 및 커머스에 필수입니다. 위치를 나타내는 부동산의 전체 주소입니다. 주소 개체 매개변수를 참조하세요. 예: |
유형: 문자열 | 어드밴티지+ 카탈로그 광고 및 커머스에 필수입니다. 부동산이 위치한 도시입니다. 주소 개체 매개변수를 참조하세요. 예: |
유형: 문자열 | 어드밴티지+ 카탈로그 광고 및 커머스에 필수입니다. 부동산이 위치한 주, 국가, 지역 또는 도입니다. 주소 개체 매개변수를 참조하세요. 예: |
유형: 개체 | 어드밴티지+ 카탈로그 광고 및 커머스에 필수입니다. 부동산이 위치한 국가입니다. 주소 개체 매개변수를 참조하세요. 예: |
유형: 문자열 | 어드밴티지+ 카탈로그 광고 및 커머스에 필수입니다. 부동산이 위치한 국가입니다. 주소 개체 매개변수를 참조하세요. 예: |
유형: 부동 소수점 | 어드밴티지+ 카탈로그 광고 및 커머스에 필수입니다. 매물의 위도입니다. 예: |
유형: 부동 소수점 | 어드밴티지+ 카탈로그 광고 및 커머스에 필수입니다. 매물의 경도입니다. 예: |
유형: 문자열 | 어드밴티지+ 카탈로그 광고에 필수입니다. 커머스에는 선택 사항이지만 사용하는 것이 좋습니다. 허용되는 최대 동네 수: 20 부동산 매물이 위치한 동네입니다. 여러 동네를 포함할 수 있습니다. 동네가 두 개 이상인 경우 각 유형에 대해 열을 추가하고 각 열 이름에 JSON 경로 구문을 사용하여 동네 개수를 표시하세요. 예: |
유형: 문자열 | 어드밴티지+ 카탈로그 광고 및 커머스에 필수입니다. 부동산의 매매 또는 임대 가격입니다. 가격은 금액 뒤에 [3자리 ISO 통화 코드](https://en.wikipedia.org/wiki/ISO_4217?fbclid=IwAR0_xYfUmL3kIUA6sMeEaFAzbJa4MLeMiPDPrftFSX6wkKiTXxPinC-5j70">를 적고 금액과 통화 사이에 공백이 들어가는 형식이어야 합니다. 예: |
유형: 개체 | 어드밴티지+ 카탈로그 광고 및 커머스에 필수입니다. 최대 이미지 수: 20 최대 용량: 4MB 광고에 사용된 이미지의 URL입니다.
예: 이미지 개체 매개변수를 를 참조하세요. |
유형: 문자열 | 어드밴티지+ 카탈로그 광고 및 커머스에 필수입니다. 부동산 매물 페이지 링크입니다. 유효한 URL이어야 합니다. 이미지 개체 매개변수를 를 참조하세요. 예: |
유형: 문자열 | 어드밴티지+ 카탈로그 광고에 선택 사항입니다. 커머스에 필수입니다. 최대 문자 수: 5,000 부동산에 대한 설명입니다. 예: |
유형: 부동 소수점 | 어드밴티지+ 카탈로그 광고에 선택 사항입니다. 커머스에 필수입니다. 총 침실 개수입니다. 스튜디오의 경우 예: |
유형: 부동 소수점 | 어드밴티지+ 카탈로그 광고에 선택 사항입니다. 총 욕실 개수입니다. 커머스의 경우 최소 |
유형: 부동 소수점 | 어드밴티지+ 카탈로그 광고에는 적용되지 않습니다. 커머스에 필수입니다. 부동산의 총 방 개수입니다. |
유형: 문자열 | 어드밴티지+ 카탈로그 광고에 선택 사항입니다. 부동산 유형입니다. 어드밴티지+ 카탈로그 광고에 지원되는 값: |
유형: 문자열 | 어드밴티지+ 카탈로그 광고에 선택 사항입니다. 부동산 매물의 유형입니다. 어드밴티지+ 카탈로그 광고에 지원되는 값: |
유형: 정수 | 어드밴티지+ 카탈로그 광고에는 적용되지 않습니다. 커머스에 필수입니다. 품목의 면적 또는 공간입니다. |
유형: 문자열 | 어드밴티지+ 카탈로그 광고에는 적용되지 않습니다. 커머스에 필수입니다. 바닥 면적 값의 단위(제곱피트 또는 제곱미터)입니다. 지원되는 값: |
유형: 문자열 | 어드밴티지+ 카탈로그 광고에는 적용되지 않습니다. 커머스에는 선택 사항입니다. 에어컨 유형입니다. 지원되는 값: |
유형: 문자열 | 어드밴티지+ 카탈로그 광고에는 적용되지 않습니다. 커머스에는 선택 사항입니다. 부동산에서 제공하는 가구 유형입니다. 지원되는 값: |
유형: 문자열 | 어드밴티지+ 카탈로그 광고에는 적용되지 않습니다. 커머스에는 선택 사항입니다. 부동산에 설치된 난방 유형입니다. 지원되는 값: |
유형: 문자열 | 어드밴티지+ 카탈로그 광고에는 적용되지 않습니다. 커머스에는 선택 사항입니다. 사용 가능한 세탁 유형입니다. 지원되는 값: |
유형: 정수 | 어드밴티지+ 카탈로그 광고 및 커머스에 필수입니다. 임대 가능한 총 유닛(아파트, 콘도) 수입니다. 예: |
유형: 문자열 | 어드밴티지+ 카탈로그 광고에는 적용되지 않습니다. 커머스에는 선택 사항입니다. 부동산에서 제공하는 주차 유형입니다. 지원되는 값: |
유형: 문자열 | 어드밴티지+ 카탈로그 광고에는 적용되지 않습니다. 커머스에는 선택 사항입니다. 파트너 회사가 매물을 인증했는지 여부입니다. 지원되는 값: |
유형: 문자열 | 부동산이 건축된 연도로, YYYY 형식을 사용한 4자리 연도입니다. 예: 1994. |
유형: 문자열 | 어드밴티지+ 카탈로그 광고에는 적용되지 않습니다. 커머스에는 선택 사항입니다. 부동산에서 허용되는 반려 동물: |
유형: 개체 | 매물이 제공되는 날짜 및 가격의 리스트입니다. 값을 제공하면 Facebook이 구매 가능한 날짜를 기준으로 매물을 추천하고 광고에서 관련 가격을 동적으로 표시합니다. 구매 가능한 날짜 개체 매개변수를 참조하세요. |
유형: 개체 | 매물로의 앱 링크입니다. |
유형: 문자열 | 카탈로그에서 품목이 활성화되어 있거나 보관되어 있는지 여부를 관리합니다. 활성 상태의 품목만 광고, Shop 또는 기타 채널에서 사용자에게 노출됩니다. 지원되는 값: 예: 참고: 일부 파트너 플랫폼(예: Shopify)은 준비 상태의 카탈로그에 품목을 동기화할 수 있습니다. 이는 이 필드의 이름은 이전에 |
커머스 국가별 필수 필드에 대한 Marketplace 플랫폼 문서를 참조하세요.
필드 이름 및 유형 | 설명 |
---|---|
유형: 문자열 | 어드밴티지+ 카탈로그 광고 및 커머스에 필수입니다. 이미지 소스 URL입니다. 다음과 같은 이미지 사양을 준수하세요.
|
유형: 문자열 | 어드밴티지+ 카탈로그 광고 및 커머스에 필수입니다. 이미지 내용을 나타내기 위해 이미지에 붙이는 태그입니다. 하나의 이미지에 여러 개의 태그를 연결할 수 있습니다. 예:
|
필드 이름 및 유형 | 설명 |
---|---|
유형: 문자열 | 필수 항목. 호텔의 상세 주소입니다. 예: |
유형: 문자열 | 필수 항목. 호텔이 위치한 도시입니다. 예: |
유형: 문자열 | 필수 항목. 호텔이 위치한 주, 국가, 지역 또는 도입니다. 예: |
유형: 문자열 | 필수 항목. 호텔의 국가입니다. 예: |
유형: 문자열 | 숙박 시설의 우편번호입니다. 우편번호 시스템이 없는 국가의 경우 필수 항목입니다. 예: |
available_dates_price_config
를 사용하면 주어진 날짜 범위에서 각 숙박 시설의 이용 가능 여부와 가격을 제공할 수 있습니다. 이 필드에 날짜 범위를 포함하면 Facebook이 이 이용 가능 여부를 제품 추천에 반영하여 누군가 사이트에서 검색한 날짜에 이용 가능한 품목을 표시하려고 시도합니다. 또는, 가격을 포함하면 광고 크리에이티브에 날짜별 가격도 표시할 수 있습니다. 이 기능을 활성화하려면 픽셀 이벤트에 Facebook lease_start_date
및 lease_end_date
를 보내야 합니다.
필드 이름 및 유형 | 설명 |
---|---|
유형: 문자열 |
ISO-8601 형식으로 이용 가능한 날짜 범위의 시작입니다(시작 날짜 포함). 예: |
유형: 문자열 |
ISO-8601 형식으로 이용 가능한 날짜 범위의 끝입니다(종료 날짜 제외). 예: |
유형: 문자열 | 이 기간에 포함되는 품목의 정수 가격입니다. 예: 품목이 |
유형: 문자열 |
ISO-4217 통화 코드입니다. 예: |
유형: 문자열 | 지정된 요율에 대한 투숙 기간입니다. 허용되는 값: |
품목의 이용 가능 여부와 JSON에 표시되는 방식의 예시는 다음과 같습니다.
"available_dates_price_config": [ { // available until 11/01 at $150/night "end_date": "2018-11-01", "rate": "15000", "currency": "USD", "interval": "nightly", }, { // available from 11/01 - 12/01 at $200/night "start_date": "2018-11-01", "end_date": "2018-12-01", "rate": "20000", "currency": "USD", "interval": "nightly", }, { // available from 11/01 onward at $500/week "start_date": "2018-11-01", "rate": "50000", "currency": "USD", "interval": "weekly", }, ]
앱 링크 사양에 따라 피드에 딥 링크를 제공합니다. 피드의 딥 링크 정보는 Facebook 웹 크롤러로 앱 링크 메타데이터와 함께 수집하는 모든 정보보다 우선합니다.
앱 링크의 딥 링크 정보가 있다면 이 데이터를 지정할 필요가 없습니다. Facebook은 앱 링크의 정보를 사용하여 올바른 딥 링크를 표시합니다. 광고에 딥 링크를 표시하려면 어드밴티지+ 카탈로그 광고, 광고 템플릿을 참조하세요.
어드밴티지+ 카탈로그 광고의 경우, 직접 업로드 시 다음과 같은 방법으로 카탈로그의 주택 매물 정보를 새로 고침할 수 있습니다. 직접 업로드 피드 참고 자료를 참조하세요.
예 — 수동으로 일회성 업로드를 실행할 수 있습니다.
curl \
-F "url=http://www.example.com/sample_feed.xml" \
-F "access_token=
커머스의 경우, 정기(예약) 피드 업로드를 설정하고 피드를 업데이트하여 카탈로그에서 주택 매물 정보를 새로 고침할 수 있습니다. Marketplace에서는 일정 설정 옵션을 사용하는 것이 좋습니다.
커머스는 다언어 경험을 지원합니다. 카탈로그에 보조 언어 피드를 추가하면 해당 단일 카탈로그에서 보조 언어로 다른 피드를 만들 수 있습니다. 관련 타겟이 품목을 보면 보조 피드에 대한 정보가 기본 언어를 재정의합니다.
이 기능은 특정 국가 파트너에게만 적용됩니다. 시장에서의 가능성에 대해 알아보려면 Facebook 담당자에게 문의하세요.
어드밴티지+ 카탈로그 광고에서 광고하는 카탈로그의 품목 그룹입니다. 각 품목 카탈로그에는 여러 목록 세트가 포함될 수 있습니다.
curl \
-F "name=test set" \
-F 'filter={"availability":{"eq":"for_sale"}}' \
-F "access_token=" \
https://graph.facebook.com/
위의 filter
는 다음 연산자와 데이터로 구성됩니다.
연산자 | 필터의 유형 |
---|---|
| 하위 문자열 포함(대소문자 구분하지 않음) |
| 하위 문자열 미포함(대소문자 구분하지 않음) |
| 하위 문자열 포함(대소문자 구분) |
| 하위 문자열 미포함(대소문자 구분) |
| 같음(대소문자 구분하지 않음) |
| 같지 않음(대소문자 구분하지 않음) |
| 보다 작음(숫자 필드 전용) |
| 보다 작거나 같음(숫자 필드 전용) |
| 보다 큼(숫자 필드 전용) |
| 보다 크거나 같음(숫자 필드 전용) |
데이터 | 필터링할 데이터 |
---|---|
| 품목 구매 가능 여부. 예: |
| 품목 유형. 예: |
| 부동산 유형. 예: |
| 매물 가격 |
| 이름 |
| 시/군 |
| 국가 |
| 지역 또는 주/도 |
| 우편번호 |
| 침실 수 |
| 욕실 수 |
오프라인 전환 이벤트를 전송하고 전환하기 전에 Facebook 광고와 커머스 품목을 조회하거나 클릭한 고객 수를 확인합니다. 오프라인 전환 API를 사용하고 4단계. 오프라인 이벤트 업로드의 다음 필드를 추가합니다.
매칭 키는 사용자에 대한 전환을 비교합니다.
키 | 설명 |
---|---|
| 이메일 주소 해시 |
| 전화번호 해시 |
| 이름 해시 |
| 성 해시 |
| Apple 또는 Android 광고 ID 해시 |
| 우편번호 해시 |
| 시/군 해시 |
| 주/도 해시 |
| 국가 해시 |
| 생년월일(DD 형식) 해시 |
| 생년월일(YYYY 형식) 해시 |
| 성별 해시 |
| 나이 해시 |
| Marketplace 잠재 고객의 잠재 고객 ID |
맞춤 데이터는 딜러에 대한 전환을 비교합니다.
필드 | 설명 |
---|---|
| 카탈로그 업로드의 |
|
|
이벤트 상세 정보는 발생한 오프라인 전환 이벤트를 설명합니다. 이벤트 발생 후 48시간 이내에는 업로드 빈도가 매일입니다.
필드 | 설명 |
---|---|
| 필수 항목 이벤트 유형 enum:
|
| 필수 항목 이벤트가 발생한 시각 |
| 필수 항목 임대 가격. 비임대 이벤트일 경우 |
| 필수 항목 통화 코드 |