Google 게시자 태그 구축

태그 없는 요청으로 광고 소재 코드 로드하기

맞춤 파싱 및 디스플레이를 위한 원시 광고 소재 코드 요청

광고 태그 대신 태그 없는 요청을 사용하여 Ad Manager에서 트래피킹되는 원시 광고 소재 코드를 요청할 수 있습니다. 태그 없는 요청은 일반적으로 맞춤 파싱 및 디스플레이가 필요한 경우에 사용됩니다(예: 셋톱 박스 또는 기타 Google 태그나 SDK가 지원되지 않는 환경).

태그 없는 요청을 수행하면 Ad Manager에서는 광고를 실행 및 표시하지 않고 트래피킹된 상태 그대로 원시 광고 소재 코드만 반환합니다. 광고를 찾지 못한 경우에는 응답이 비어 있는 200/OK 상태를 반환합니다.

앱, 플레이어 또는 사이트는 코드를 실행하여 광고를 게재하고 노출 추적을 활성화해야 합니다.

이메일에 광고를 게재하기 위해 태그 없는 요청을 사용해서는 안 됩니다. 지원되지 않는 기능을 모두 확인하세요.

태그 없는 요청 수동으로 만들기

태그 없는 요청을 생성하려면 기본 URL로 시작하고 모든 필수 매개변수 및 추가 선택 매개변수를 포함하세요. 이러한 매개변수는 요청에 관한 광고 단위, 광고 소재 크기, 키 값 및 기타 정보를 지정합니다.

태그 없는 요청은 SSL(https://)을 사용하여 안전하게 생성되어야 합니다.

기본 URL로 시작하기

이 기본 URL(https://securepubads.g.doubleclick.net/gampad/adx?)을 사용하세요.

광고 요청 매개변수 지정

필수 매개변수

매개변수	설명
`iu`	Google Ad Manager 네트워크 코드를 포함한 Google Ad Manager 광고 단위 코드입니다. 여러 수준을 포함하려면 슬래시(`/`) 문자를 구분 기호로 사용합니다. 예 `iu=/123/homepage` `iu=/456/sports/baseball` 태그 없는 요청과 함께 복수 고객 관리(MCM)를 사용하는 경우 네트워크 코드에 `parent,child` 구조를 사용하세요. 예(MCM) `iu=/123,456/homepage`
`sz`	광고 소재 크기입니다. 여러 크기를 포함하려면 크기 사이에 파이프(`\|`) 문자를 넣어 구분 기호로 사용합니다. 예 `sz=320x50`(단일 크기인 경우) `sz=320x50\|300x50`(크기가 여러 개인 경우) 태그 없는 요청에서는 파이프(`\|`) 문자를 `%7c`로 인코딩하는 것이 좋습니다. 예 `&sz=216x36\|300x50\|320x50`은 `&sz=216x36%7c300x50%7c320x50`이 됩니다.
`url`	초기 광고 요청을 호스팅하는 도메인의 URL입니다. MCM 요청에만 필요합니다. 예 `url=www.example.com`
`c`	상관자(또는 캐시 무효화) 값입니다. 페이지가 로드될 때마다 광고 서버에 새로운 호출이 발생하여 노출수에 불일치가 발생하지 않도록 하기 위해 게시자가 생성하는 임의의 숫자로, 문자는 허용되지 않습니다. 예 `c=8362527364`
`tile`	웹페이지에서의 태그 위치입니다. 값은 고유한 정수여야 합니다. 쉽게 구현하려면 뒤로 갈수록 커지는 값을 지정하는 것이 좋습니다. 동일한 페이지에서 여러 광고 태그가 동일한 광고 단위 코드(`iu=`)와 상관자(`c=`) 값을 사용하는 경우에만 필요합니다. 예 `https://securepubads.g.doubleclick.net/gampad/adx?iu=/1234/homepage&sz=320x50&c=54631&tile=1 https://securepubads.g.doubleclick.net/gampad/adx?iu=/1234/homepage&sz=320x50&c=54631&tile=2` 증가된 타일(`tile=`) 값이 포함된 모든 요청은 30초 이내에 트리거되어야 동일한 연관자(`c=`)에 대해 동일한 광고 소재가 다시 선택되지 않습니다.

선택 매개변수

매개변수	설명
`d_imp`	지연된 노출 토글입니다. 포함된 경우 요청에 따라 노출수 계산이 사용 중지되며, 반환된 광고 소재의 조회된 노출 매크로 또는 `d_imp_hdr` 매개변수의 정보가 노출을 기록하는 데 사용됩니다. 예 `d_imp=1` `d_imp=0`(Google Ad Manager 노출수 계산 기본값)
`d_imp_hdr`	지연된 노출 헤더 정보 토글입니다. 포함된 경우 노출수 계산에 사용될 보기 URL이 HTTP 헤더에 반환됩니다. 기본적으로 이 헤더 정보는 정의되어 있지 않습니다. 노출수를 계산하려면 게시자가 이 보기 URL을 직업 핑해야 합니다. 노출수 계산 및 태그 없는 요청에 대해 자세히 알아보세요. `Google-Delayed-Impression` 헤더에는 Google Ad Manager 노출 URL이 포함됩니다. `Google-3rdParty-Delayed-Impression` 헤더에는 타사 노출 URL(광고 소재에 있는 경우)이 포함됩니다. 예 `d_imp_hdr=1` `d_imp_hdr=0`(지연된 노출 헤더 정보를 명시적으로 사용 중지)
`t`	슬롯 수준 키-값 쌍입니다. 각 키 및 값은 등호 `=` 문자로 구분되며, 키-값 쌍은 앰퍼샌드 `&` 문자로 구분됩니다. 각 키 및 값은 개별적으로 URL로 인코딩된 후 전체 문자열이 URL로 인코딩되어야 합니다. 키-값 세트 내의 각 키는 고유해야 합니다. 같은 키를 2회 이상 제공하면 연결된 값 중 하나만 반영됩니다. 예 매개변수 `t=genre%3Daction%26movie%3DMr+%2526+Mrs+Smith`는 키 'genre'를 값 'action'에, 키 'movie'를 'Mr & Mrs Smith'에 할당합니다. 키-값 할당 사이의 '&' 문자는 단독 인코딩되지만(`%26`), 값 내에서 발생하는 경우 이중 인코딩됩니다(`%2526`). `excl_cat`를 경쟁 제외 관련 특수 키로 사용합니다. 예 `t=excl_cat%3Dairlines` `t=interest%3Dsports%2Cnews%26excl_cat%3Dairlines` `" ' ! + # * ~ ; ^ ( ) < > [ ] =` 문자는 키 또는 값에 사용할 수 없습니다. 값에는 공백이 허용되지만(`%20` 또는 `+`로 이스케이프 처리) 키에는 허용되지 않습니다. 예 키 'a'를 `t=a%3Db%252Bc`와 함께 값 'b + c'로 설정하면 작동하지 않습니다.
`m`	HTTP 헤더의 Mime 유형 값 예 `m=text/wml`
`mob`	모바일 광고 요청 표시자 예 `mob=js`(유일하게 허용되는 값임)
`ppid`	게시자 제공 식별자(PPID) 매개변수를 통해 기기 전반에 대한 최대 게재빈도 설정, 잠재고객 분류 및 타겟팅, 순차적 광고 로테이션, 기타 잠재고객에 기반한 광고 게재 관리 시 사용할 수 있는 식별자를 Google Ad Manager에 보낼 수 있습니다. 예 `ppid=12JD92JD8078S8J29SDOAKC0EF230337`
`u_w`	광고 서버에서 이루어진 자동 탐색보다 우선하는 휴대기기 화면 너비입니다. 예 `u_w=1024`
`u_h`	광고 서버에서 이루어진 자동 탐색보다 우선하는 휴대기기 화면 높이입니다. 예 `u_h=768`
`submodel`	광고 서버에서 이루어진 자동 탐색보다 우선하는 휴대기기 하드웨어 정보입니다. 예 `submodel=iPhone4%2C1`(하위모델 값을 구분하는 쉼표는 인코딩됨) 하위모델 값: iPhone(1세대): `iphone1,1` iPhone 3G: `iphone1,2` iPhone 3GS: `iphone2,1` iPhone 4(GSM): `iphone3,1` iPhone 4(GSM): `iphone3,2` iPhone 4(CDMA): `iphone3,3` iPhone 4S: `iPhone4,1` iPhone 5(GSM 및 LTE): `iPhone5,1` iPhone 5(CDMA 및 LTE): `iPhone5,2` iPhone 5c:(GSM 및 CDMA): `iPhone5,3` iPhone 5c(GSM 및 CDMA): `iPhone5,4` iPhone 5s(GSM 및 CDMA): `iPhone6,1` iPhone 5s(GSM 및 CDMA): `iPhone6,2` iPhone 6 : `iPhone7,2` iPhone 6 Plus: `iPhone7,1` iPhone 6s: `iPhone8,1` iPhone 6s Plus: `iPhone8,2` iPhone SE: `iPhone8,4` iPhone 7: `iPhone9,1` iPhone 7 Plus: `iPhone9,2` 1세대 iPod: `iPod1,1` 2세대 iPod: `iPod2,1` 3세대 iPod: `iPod3,1` 4세대 iPod: `iPod4,1` 5세대 iPod: `iPod5,1` 1세대 iPad(Wi-Fi): `iPad1,1` 1세대 iPad(AT&T): `iPad1,2` 2세대 iPad(Wi-Fi): `iPad2,1` 2세대 iPad(AT&T): `iPad2,2` 2세대 iPad(Verizon): `iPad2,3` 2세대 iPad(Wi-Fi): `iPad2,4` 3세대 iPad(Wi-Fi): `iPad3,1` 3세대 iPad(Verizon): `iPad3,2` 3세대 iPad(AT&T): `iPad3,3` 4세대 iPad(Wi-Fi): `iPad3,4` 4세대 iPad(AT&T): `iPad3,5` 4세대 iPad(Verizon): `iPad3,6` iPad Mini(Wi-Fi): `iPad2,5` iPad Mini(AT&T-US, GSM & LTE 4, 17): `iPad2,6` iPad Mini(Verizon-World, GSM, DMA & LTE 1,3,5,13,25): `iPad2,7` iPad Mini Retina(Wi-Fi): `iPad4,4` iPad Mini Retina(LTE): `iPad4,5` iPad Air(Wi-Fi): `iPad4,1` iPad Air(LTE): `iPad4,2`

최대 게재빈도 설정 및 사용자 타겟팅에 재설정 가능한 기기 ID(RDID)를 사용할 수 있습니다. 태그 없는 요청을 위한 RDID 구성에 대해 자세히 알아보세요.

노출 추적 활성화하기

Ad Manager는 태그 없는 요청의 다운로드된 노출수('지연된' 노출수라고도 함)를 추적할 수 있습니다. 아래의 옵션을 사용하되, 모든 옵션을 함께 사용하지는 마세요. 모든 옵션을 함께 사용하면 노출수가 이중(또는 삼중)으로 계산될 수도 있습니다.

옵션 1을 사용하는 것이 좋지만, HTTP 응답 헤더에 대한 액세스 권한을 갖고 있어야 하며 헤더 기반 프로토콜을 구현할 수 있어야 합니다.

옵션 1: 노출수 계산 제어를 위해 HTTP 응답 헤더 읽기

d_imp=1 및 d_imp_hdr=1 매개변수를 태그 없는 요청에 추가하는 방법으로, Google-Delayed-Impression HTTP 헤더 URL을 사용하여 노출 핑을 수동으로 트리거할 때까지 Google Ad Manager에서 노출수나 다운로드된 노출수를 기록하지 않도록 합니다. 노출 핑이 트리거되면 Google Ad Manager에서 '광고 서버 노출수' 및 '다운로드된 광고 서버 노출수'를 기록합니다.

노출수가 두 번 계산되지 않도록 태그 없는 요청에서 반환된 광고 소재에 조회된 노출 매크로를 추가하지 마세요.

옵션 2: 조회된 노출 매크로 사용하기

HTTP 응답 헤더에 액세스할 수 없는 경우 인벤토리를 분류하고 태그 없는 요청에 의해 반환된 모든 광고 소재의 코드 스니펫에 조회된 노출 매크로를 추가해야 합니다. 이 매크로는 렌더링 시 광고 소재에 의해 전송될 URL로 확장됩니다.

태그 없는 요청을 생성하여 광고 소재 코드 가져오기

웹 콘텐츠

태그 없는 요청은 일반적으로 Google 태그나 SDK가 지원되지 않는 환경에서 사용됩니다. 웹에서 태그 없는 요청을 생성하는 경우 반환되는 원시 코드를 실행할 수 있도록 <iframe>에서 로드해야 합니다.

Google SDK가 없는 맞춤 환경

Google 태그나 SDK가 지원되지 않는 환경(예: 타사 셋톱 박스)에서 원시 광고 소재 코드를 가져오려면 다음 가이드라인을 따르세요.

User-Agent 요청 헤더에서 유효한 사용자 에이전트를 설정하여 타겟팅이 제대로 작동하도록 해야 합니다.
환경에서 자바스크립트 및 광고 소재 확장을 비롯한 리치 미디어 동작을 처리할 수 있어야 합니다.
Google Ad Manager에 HTTPS 요청을 전송해야 합니다.
응답 상태를 조사하여 요청이 올바르게 작성되었음을 나타내는 'HTTP 200/OK'를 찾아야 합니다.

HTML 이미지 태그(<img>)의 gampad/ad를 사용하는 태그 없는 요청은 자바스크립트 추적 코드를 지원하지 않으며, 다운로드된 노출수 계산에 대해 지원되지 않습니다.

이러한 광고에 대해 보고하려면 Ad Manager 보고에서 '총 코드 제공 횟수' 측정항목을 사용하세요.

도움이 되었나요?

어떻게 하면 개선할 수 있을까요?