전송처 - Yahoo! 광고 디스플레이 광고 전환 측정 API(베타 버전)

개요

Yahoo! 광고 디스플레이 광고 전환 측정 API에 대한 도움말 페이지입니다.

광고 디스플레이 광고 전환 측정 API를 이용하여 전환 측정 결과를 Yahoo! 광고에 전송할 수 있습니다.
본 커넥터의 개요에 대해서는 야후 주식회사가 공개한 자료( 전환 상세 매칭에 대해 )를 참고해 주시기 바랍니다.

설정 항목

STEP1 기본 설정

연결 정보를 선택합니다.

컬럼 매핑

광고 디스플레이 광고 전환 측정 API로 데이터를 전송하기 위해서는 TROCCO에서 컬럼 이름과 타입을 매핑해야 합니다.
아래 표를 참고하여 TROCCO의 전송 설정 STEP2 '컬럼 정의' 탭에서 매핑을 수행하십시오.
각 컬럼에 대한 자세한 내용은 GitHub에 공개된 공식 문서를 참고하면 된다.

* 필수 컬럼에 (*) 가 붙은 컬럼(파라미터)은 전송 대상 데이터에 1개 이상 포함해야 합니다.

컬럼명 | 데이터 유형 | 필수 | 비고 | 비고 | 참고사항
| - | - | - | - | - | | - | | - | | - | - | - | - | - | - | - |
| email``|string| ✓(*) | 이메일 주소. 소문자 영숫자로 변환한 후 SHA-256으로 해시화하여 전송합니다. |
| phone_number``|string| ✓(*) | 전화번호. 하이픈이 없는 반각 숫자로 변환한 후 SHA-256으로 해시하여 전송합니다. | |
| yclid``|string| ✓(*) | 광고를 클릭한 사용자를 식별하는 파라미터. _ycl_yjad 쿠키의 값을 입력하세요. | string| ✓(*)
| yjr_yjad``|string| ✓(*) | 광고를 클릭한 사용자를 식별하는 파라미터. yjr_yjad 쿠키의 값을 입력하세요. | string| ✓(*)
| event_time``|timestamp| ✓ | 전환이 발생한 날짜 및 시간. 요청일로부터 90일 이내의 날짜를 입력해 주세요. 10자리 UNIX 시간으로 변환하여 전송합니다. |
| yahoo_ydn_conv_io``|string| ✓ | 고객 계정 전용 값입니다. 광고 관리 도구에서 얻은 "Con value |long``| - | 전환당 가치. 광고 관리 도구에서 가져온 \Conversion API 요청 파라미터` yahoo_ydn_con value의 값 또는 임의의 값을 입력하세요. | |

:::(Warning) (yahoo_ydn_conv_transaction_id 관련 주의 사항)

광고 관리 API 사양에 따라 yahoo_ydn_conv_transaction_id 값이 중복된 데이터를 전송해도 전송 작업은 오류로 처리되지 않습니다.
:::

:::(Info) (email과``phone_number의 값이 미리 해시화된 경우)

일반적으로 email과``phone_number의 값은 해시화되어 전송된다.
단, 값이 미리 해시화된 경우 다시 해시화되지 않고 원래의 해시값 그대로 전송됩니다.
:::