고급 단계 개요
이 통합의 일부로 다음을 수행해야 합니다.
- 교차 판매 카테고리 게재 위치에 대한 추가 광고 요청을 구현해야 합니다.
- 여기에는 사이트에 광고를 배치하고 렌더링하는 작업과 클릭 수 및 노출 수를 보고하는 작업이 포함됩니다.
- 주문은 표준 통합의 일부로 CitrusAd에 제공되어야 합니다.
- CitrusAd에 카테고리 ID를 동기화하는 경우 filterMapping API를 사용하여 UI 카테고리 선택에 대해 사용자가 읽을 수 있는 값을 제공해야 합니다.
- 이름 대신 카테고리 ID로 통합된 경우에만 적용됩니다. (예: 광고 요청 시 필터:
category:123j-dsef-er로(category:Milk
- 이름 대신 카테고리 ID로 통합된 경우에만 적용됩니다. (예: 광고 요청 시 필터:
- (권장) - 카테고리 교차 판매 매핑을 동기화하여 승인을 자동화하고 캠페인 관리 업무를 줄일 수 있습니다.
광고 요청 및 사이트 통합
광고 요청
카테고리 교차 판매 시 독립형 게재 위치가 필요하므로 카테고리 교차 판매를 통합하려는 광고 유형별로 추가 광고 요청을 통합해야 합니다.
요청 형식은 아래 표시된 교차 판매 카테고리 광고 요청과 일치해야 합니다.
노출 수 및 클릭 수 보고
광고 요청을 통합한 후에는 표시된 각 광고에 대한 클릭 수와 노출 수가 올바르게 보고되고 있는지 확인해야 합니다. 노출 수 및 클릭 수 보고를 참조하십시오.
주문 보고
일반적으로 대부분의 통합은 표준 통합에 따라 모든 주문 정보를 CitrusAd에 보고합니다. 주문 데이터에 따라 모든 주문이 CitrusAd에 정확하게 보고되고 있는지 확인하십시오.
필터 매핑
필터 매핑 엔드포인트는 카테고리 ID를 사용자가 읽을 수 있는 값에 매핑하는 데 사용할 수 있습니다. 이는 UI가 사용자에게 값을 표시할 때 카테고리 ID를 동기화하는 경우 필요합니다.
제품 카탈로그에서 사용자가 읽을 수 있는 카테고리를 CitrusAd에 동기화하는 경우에는 이 단계가 필요하지 않습니다.
사용자가 category:12345-abcde 가 무엇인지 알기 어려우므로 filterMapping API를 사용하여 값을 사이트의 관련 카테고리 이름에 다음과 같이 매핑할 수 있습니다. category:Pantry.
이 정보를 동기화할 수 있는 파일 기반 방법이 없으므로 filterMapping API를 통해 수행해야 합니다.
사이트에 추가로 카테고리를 만들 때 카테고리 업데이트 시 filterMapping API가 사용되는지 확인해야 합니다.
카테고리 교차 판매 매핑(권장)
이러한 유형의 게재 위치를 통합할 시에는 서로 타기팅할 수 있는 카테고리에 대한 매핑을 제공하는 것이 좋으며 이를 통해 초기 통합 작업 후 작업을 간소화할 수 있습니다. 미리 설정된 카테고리만 선택 가능하도록 광고주 경험이 간소화되었습니다.
또한 교차 판매 매핑이 제공되는 경우 교차 판매 카테고리 캠페인에 대한 자동 승인을 구성할 수도 있습니다.
통합 방법
- crossSellCategory API를 사용하여 필요에 따라 매핑을 생성하고 관리할 수 있습니다.
- 또는 아래 표시된 형식으로 CitrusAd에서 호스팅하는 GCS 버킷에 TSV 파일을 제공할 수 있습니다.
API 통합
crossSellCategory API 참조에서 자세한 정보를 확인할 수 있습니다.
파일 통합
파일별로 통합할 시에는 CitrusAd는 카탈로그별 파일이 필요하며 그중 카테고리는 서로 타기팅할 수 있습니다.
파일의 각 행은 카테고리 및 타기팅될 수 있는 카테고리의 단일 매핑을 나타냅니다. 각 매핑은 단방향입니다(초콜릿과 우유를 동기화하는 경우 > 우유, 초콜릿 제품이 우유 카테고리에 표시될 수 있습니다. 유제품이 초콜릿에 표시되어야 하고 추가 줄이 필요한 경우).
다음 사양의 TSV 형식의 데이터 피드가 필요합니다.
| 열 이름 | 필수 입력 항목입니다 | 데이터 유형 | 설명 | 예시 |
|---|---|---|---|---|
category | 필수 입력 항목입니다 | 텍스트 | 광고된 제품의 카테고리를 식별하는 고유 카테고리 ID입니다. | category:cookies |
cross_category_id | 필수 입력 항목입니다 | 텍스트 | Category_id 제품이 교차 판매될 수 있는 적격 카테고리를 식별하는 고유 카테고리 ID입니다. | category:milk |
추가 파일 사양은 다음과 같습니다:
- TSV 파일만 지원됩니다
- TSV는 CRLF가 아닌 LF여야 합니다.
- TSV는 UTF-8로 인코딩되어야 하며 다른 유형 사용 시 오류가 발생할 수 있습니다.
- 다음의 이름 지정 규칙이 필요합니다:
^cross_sell_category.*.tsv$
예시 스니펫은 아래와 같습니다:
| 카테고리 | cross_category_id |
|---|---|
| category:cookies | category:milk |
| category:cookies | category:chocolate |
| category:milk | category:cookies |
위의 스니펫을 사용하면 쿠키 카테고리를 우유 및 초콜릿 카테고리로 교차 판매할 수 있으며 우유 카테고리를 쿠키 카테고리로 교차 판매할 수 있습니다. 초콜릿 카테고리는 타기팅할 수 있지만 다른 카테고리는 타기팅할 수 없습니다.
각 행은 고유한 매핑 조합입니다.
각 고유한 교차 판매 카테고리 매핑에 대해 고유한 행을 동기화해야 합니다. 단일 행에서 여러 cross_category_id를 동기화하려고 하면 파일 수집이 되지 않습니다.
기능 활성화 프로세스
추천 검색어 피드를 동기화할 준비가 되면 CitrusAd는 파일을 추가할 GCS 버킷을 구성합니다.
이 기능은 GCS 버킷에서만 지원되며 AWS/Azure/기타 등 외부 버킷은 지원되지 않습니다.
기술 계정 관리자가 이 기능을 활성화하는 방법을 안내해 드릴 수 있습니다.CitrusAd 플랫폼 운영 팀은 구성 작업을 수행해야 하므로 활성화하는 데 추가적인 작업 시간이 소요된다는 점을 참고하시기 바랍니다.