매크로는 광고 소재 코드의 특수 문자열입니다. Ad Manager는 나중에 이 문자열을 광고 소재의 설정에 따라 다른 값 또는 코드로 대체합니다. 매크로가 유용한 것은 변경이 필요한 경우 광고 소재 코드를 직접 업데이트할 필요 없이 매크로 참조를 업데이트하면 되기 때문입니다.
Google에서 각 매크로를 사용하는 방법을 추천하고는 있지만, 매크로는 사용자에게 도움이 된다면 어떤 용도로든 사용할 수 있습니다. 매크로는 게재 중 광고 서버에 의해 처리되는 모든 코드에 포함될 수 있습니다. 이러한 코드로는 서드 파티 또는 맞춤 광고 소재 코드, Studio 코드, 클릭연결 URL, 광고 태그 등이 있습니다.
매크로에 관한 중요사항
- 대소문자 구분
매크로는 대소문자를 구분합니다.%%Cachebuster%%가 아닌%%CACHEBUSTER%%를 사용하세요. - 이스케이프 처리되지 않은 버전 및 이스케이프 처리된 버전의 확장
이스케이프 처리되지 않은 매크로 버전과 이스케이프 처리된 매크로 버전은 서로 다르게 확장됩니다. 이스케이프 처리된 매크로와 이스케이프 처리되지 않은 매크로를 사용하는 방법을 자세히 알아보세요. - 매크로 삽입
Ad Manager는 서드 파티를 인식하는 경우 서드 파티 광고 소재 또는 VAST 태그 URL에 대해 매크로를 자동으로 삽입합니다. 맞춤 광고 소재 및 광고 소재 템플릿의 경우 매크로를 직접 추가해야 합니다. 매크로를 어디에 배치해야 할지 잘 모르겠다면 광고 소재 공급업체에 문의하세요.
광고 소재 템플릿을 사용하여 트래피킹하는 경우 클릭 매크로가 템플릿에 사용되는 경우에만 클릭연결 URL 입력이 제공됩니다. - 예약된 문자 및 URL 인코딩(퍼센트 인코딩)
Ad Manager는 퍼센트 기호가 앞에 오는 특정 소문자를 예약합니다.%a
%c
%h
%i
%n
%p
%k이러한 문자열은 매크로 확장을 방해할 수 있으므로 URL 인코딩에 사용하면 안 됩니다.
- 프로그래매틱 다이렉트에는 매크로가 지원되지 않음
프로그래매틱 다이렉트에 사용할 수 있는 기능을 참조하세요.
목록에서 특정 매크로로 이동하기
|
렌더링 매크로 |
GDPR에 대한 광고 요청 매크로 |
렌더링 매크로
렌더링 매크로는 일반적으로 광고 소재를 렌더링하는 데 사용되어 광고 소재가 올바르게 표시되고 제대로 작동하도록 합니다.
광고 단위| 매크로 |
|---|
%%ADUNIT%% |
광고 단위 매크로는 광고가 게재될 때 Google 게시자 태그에서 광고 소재 코드로 광고 단위 경로를 삽입합니다.
다음은 ADUNIT 매크로를 서드 파티 광고 소재 코드 스니펫에 추가하는 방법입니다.
<script type="text/javascript">
document.write('<sc'+'ript type="text/javascript" src="http://www.3rdparty.com/?dfpAdUnit=%%ADUNIT%%"></scr'+'ipt>');
</script>
광고 단위 매크로는 네트워크 코드 등 원래 광고 요청에 포함된 전체 광고 단위 경로로 확장됩니다. 다음은 광고가 게재될 때 광고 단위 경로를 펼치는 방법에 대한 예입니다.
<script type="text/javascript">
document.write('<sc'+'ript type="text/javascript" src="http://www.3rdparty.com/?dfpAdUnit=/1234/site/section"<>/scr'+'ipt>');
</script>
이 매크로는 승인된 추천 광고 단위에만 작동합니다. 추천된 광고 단위가 세 번째 수준인 경우, 매크로가 광고 소재 스니펫에 사용될 때 두 번째 수준 광고 단위까지만 확장됩니다. 추천된 광고 단위가 승인되면 매크로는 광고 소재 스니펫에서 세 번째 광고 단위 수준까지 확장됩니다.
| 매크로 | 이스케이프 처리 |
|---|---|
%%DEST_URL_ESC%% |
이스케이프 처리됨 |
%%DEST_URL_ESC_ESC%% |
이중 이스케이프 처리됨 |
%%DEST_URL_UNESC%% |
이스케이프 처리되지 않음 |
도착 URL 매크로는 광고 소재의 클릭연결 URL로 확장되며, 이 URL은 광고 항목의 클릭연결 URL이거나 광고 항목 내 광고 소재에 대한 오버라이드 설정입니다.
도착 URL 매크로는 맞춤 광고 소재 및 광고 소재 템플릿에 사용 시 유용합니다. 광고 소재 코드에 광고 소재의 클릭연결 URL을 포함해야 하고 광고 소재 또는 템플릿이 여러 광고 항목에 걸쳐 사용되어 클릭연결 URL이 변경되는 경우 이 매크로가 도움이 될 수 있습니다.
클릭연결 URL 매크로에는 '이스케이프 처리됨, 이중 이스케이프 처리됨, 이스케이프 처리되지 않음', 이렇게 3가지가 있습니다. 일반적으로 이스케이프 처리해야 하는 양, 즉 ESC를 1회, 2회 포함할지 또는 아예 포함하지 않을지는 서드 파티 클릭 추적 회사에 따라 다릅니다. 어떤 서드 파티 클릭 추적 회사는 URL을 이스케이프 처리할 것을 요구하고, 어떤 회사는 이를 요구하지 않습니다. 서드 파티 클릭 추적 회사에서 요구하는 이스케이프 처리 수준은 일반적으로 서드 파티 광고 태그 또는 Ad Manager의 맞춤 광고 소재 코드에서 click= 문자열의 형태로 태그에 지정되어 있습니다.
-
click=: 한 번 이스케이프 처리(%%DEST_URL_ESC%%) -
click0=: 이스케이프 처리하지 않음(%%DEST_URL_UNESC%%) -
click1=: 한 번 이스케이프 처리(%%DEST_URL_ESC%%) -
click2=: 두 번 이스케이프 처리(%%DEST_URL_ESC_ESC%%)
%%DEST_URL_ESC%%와 동일하게 기능하는 %%DEST_URL%%도 지원합니다. 명확하게 하기 위해 %%DEST_URL_ESC%%를 사용하는 것이 좋지만 이전의 광고 소재와 템플릿을 다시 코딩할 필요는 없습니다.%u 또는 %%DEST_URL%% 매크로가 포함되어 있는 경우 광고 소재를 클릭하면 xsd:string URL로 이동합니다. 최대 1,024자까지 입력 가능합니다.| 매크로 |
|---|
%%FILE:file_display_name%% |
파일 서버 매크로 %%FILE:file_display_name%%은 광고 소재에 업로드된 광고 소재 애셋의 전체 URL로 확장됩니다. 이 매크로를 사용하여 맞춤 광고 소재 코드와 함께 업로드된 애셋(예: 이미지)을 호출하세요.
이 매크로를 사용하려면 file_display_name을 광고 소재 애셋의 표시 이름으로 교체합니다. 이는 광고 소재 세부정보를 확인할 때 Ad Manager에 이 이름이 표시되기 때문입니다.
| 매크로 |
|---|
%%HEIGHT%% |
%%WIDTH%% |
위의 매크로는 광고 게재 프로세스가 진행되는 동안 Ad Manager에서 광고 소재의 '타겟 광고 단위 크기' 입력란 값으로 정의된 광고 소재의 높이와 너비를 광고 소재의 맞춤 코드에 삽입합니다.
높이 및 너비 매크로는 다른 크기의 광고 소재에 재사용할 광고 소재 템플릿을 만드는 경우에 특히 유용할 수 있습니다. 광고 소재별로 크기를 하드 코딩하는 대신 높이 및 너비 매크로를 통해 값을 각 광고 소재에 동적으로 삽입할 수 있습니다.
| 매크로 |
|---|
%%PATTERN:key%% |
%%PATTERN:TARGETINGMAP%% |
%%PATTERN:url%% |
패턴 일치 매크로는 타겟팅 값과 같은 맞춤 변수를 하나 이상 광고 소재에 전달하는 데 사용됩니다. 이 매크로를 사용하여 키-값을 전달하거나, 전체 타겟팅 문자열을 대체하거나, 리퍼러 URL을 확장할 수 있습니다. 이 방법은 콘텐츠 선호도 등의 사용자 관련 정보를 토대로 다양한 광고 소재를 게재하려고 할 때 유용합니다.
패턴 일치 매크로는 광고 소재당 100개까지만 대체할 수 있습니다.
패턴 일치 매크로 이스케이프 처리
패턴 일치 매크로는 받은 값을 그대로 반환합니다. 동영상 광고 소재에서 'VAST 태그 URL'이나 '서드 파티 추적 URL' 입력란과 같이 URL 입력란 중 하나에서 매크로를 사용하는 경우 확장된 값을 이스케이프 처리된 상태로 반환해야 할 수 있습니다. 이렇게 하려면 요청에서 해당 값을 삼중으로 이스케이프 처리해야 합니다.
%%PATTERN:key%%
예를 들어, 특정 광고 항목에 두 개의 광고 소재(각각 여성 및 남성 사용자의 관심을 끌기 위한 광고 소재)가 있다고 가정해 보겠습니다. 매크로에 사용된 '키'는 영숫자 문자나 밑줄(_)이어야 합니다.
이 경우 진행 방식은 다음과 같습니다.
- 키-값을 사용하여 맞춤 값(이 경우 사용자의 성별)을 페이지의 광고 태그에 전달합니다.
googletag.defineSlot("/1234/adunit1/adunit2", [728, 90], "div-gpt-ad-123456789-0")
.addService(googletag.pubads())
.setTargeting("gender", "male"); - 맞춤 또는 서드 파티 광고 소재에서
<some creative script here>...&gender=%%PATTERN:gender%%매크로를 사용하여 맞춤 값(사용자의 성별)을 동적으로 전달합니다. %%PATTERN:gender%%의 전체 매크로가 'male'로 교체됩니다.- Ad Manager에서 'male' 광고 소재 파일을 호출하여 사용자에게 게재합니다.
%%PATTERN:TARGETINGMAP%%
%%PATTERN:TARGETINGMAP%% 매크로를 사용하여 전체 타겟팅 지도를 대체하고 동적으로 패스백 태그를 생성할 수 있습니다.
광고 태그에 TARGETINGMAP 매크로를 추가하는 방법은 다음과 같습니다.
.updateTargetingFromMap(%%PATTERN:TARGETINGMAP%%).display();
다음은 광고가 게재될 때 전체 키-값 문자열의 예입니다.
.updateTargetingFromMap({"key1":["value1"], "key2": ["value2","value3"]}).display();
이 매크로를 사용하여 두 Ad Manager 네트워크('네트워크 A'와 '네트워크 B') 간에 패스백 태그를 설정할 수 있습니다.
다음은 Ad Manager 네트워크 A에 예약된 샘플 광고 소재입니다.
<script type='text/javascript' src='http://www.googletagservices.com/tag/js/gpt.js'>
googletag.pubads().definePassback('/network_B/Homepage', [468, 60])
.setTargeting("myAdUnit", "%%ADUNIT%%")
.updateTargetingFromMap(%%PATTERN:TARGETINGMAP%%)
.display();
</script>
Ad Manager 네트워크 B에 판매된 캠페인 중 게재할 캠페인이 없는 경우 다음과 같이 패스백 광고 소재를 사용하여 네트워크 A에 노출을 돌려줄 수 있습니다.
<script src='//www.googletagservices.com/tag/js/gpt.js'>
googletag.pubads()
.definePassback('%%PATTERN:myAdUnit%%', [468, 60])
.updateTargetingFromMap(%%PATTERN:TARGETINGMAP%%)
.setTargeting("kwd", "noloop") // 무한 루프 방지
.display();
</script>또한 요청에서 외부 광고 서버로 전달되는 TARGETINGMAP을 패스백 태그에 사용하여 동적 광고 소재에 여러 값을 지정할 수 있습니다.
다음은 Ad Manager에 예약된 샘플 광고 소재입니다.
<script type="text/javascript">
document.write('<sc'+'ript type="text/javascript" src="http://www.3rdparty.com/generatePassback.php?dfpAdUnit=%%ADUNIT%%&targeting='+encodeURIComponent(JSON.stringify(%%PATTERN:TARGETINGMAP%%))+'"></scr'+'ipt>');
</script>
Ad Manager에서 게재할 때는 광고 소재가 다음과 같이 확장됩니다.
<script type="text/javascript">
document.write('<sc'+'ript type="text/javascript" src="http://www.3rdparty.com/generatePassback.php?dfpAdUnit=/network_A/first_level_ad_unit/second_level_ad_unit&targeting=%7B%22kw%22%3A%5B%22testpercentp%22%5D%7D"></scr'+'ipt>');
</script>
이제 제3자가 동적으로 생성된 'dfpAdUnit' 및 'targeting' 매개변수에 액세스하고 다음과 같은 패스백을 빌드할 수 있습니다.
<script src='//www.googletagservices.com/tag/js/gpt.js'>
googletag.pubads()
.definePassback('/network_A/first_level_ad_unit/second_level_ad_unit', [728, 90])
.setTargeting("kw", "noloop") // 무한 루프 방지(https://support.google.com/admanager/answer/2811375 참조)
.updateTargetingFromMap({"kw":["testpercentp"]}).display();
</script>
이를 위해 제3자에게 다음과 같은 템플릿 코드를 제공할 수 있습니다.
myTargetingObject = JSON.parse('$targeting'); document.write('<sc'+'ript src="https://www.googletagservices.com/tag/js/gpt.js"></scr'+'ipt>');
document.write('<scr'+'ipt>');
callback = function() {
googletag.pubads().definePassback('$dfpAdUnit', [728, 90])
.setTargeting("kwd", "noloop")
.updateTargetingFromMap(myTargetingObject)
.display();
};
window.googletag = window.googletag || {};
googletag.cmd = googletag.cmd || [];
googletag.cmd.push(callback);
document.write('</sc'+'ript>'); %%PATTERN:url%%
예약된 키 url을 사용하여 참조 페이지의 URL로 확장할 수도 있습니다.
url은 예약된 키이며, 키 이름이 url인 Campaign Manager 360 태그에 있는 모든 키-값은 리퍼러 URL로 덮어쓰기됩니다.
| 매크로 |
|---|
%%TAG_PARAM%% |
태그 매개변수 매크로는 다른 광고 태그 매개변수와 함께 사용되며, 다음 매개변수와만 함께 사용할 수 있습니다.
지원되는 경우 매개변수 값으로 확장됩니다.
예를 들어 %%TAG_PARAM:correlator%%(지원됨)가 광고 태그의 correlator 값으로 확장되지만 %%TAG_PARAM:ppid%%(지원되지 않음)는 어떠한 값으로도 확장되지 않습니다.
| 매크로 |
|---|
%%TARGET_IN_NEW_WINDOW%% |
새 창 매크로의 타겟은 광고 소재가 게재되는 광고 단위에 지정된 타겟 창 설정이 '_blank'(새 창)인지 아닌지 나타냅니다.
-
타겟 창이
_blank인 경우 매크로가1로 확장됩니다. -
타겟 창이 다른 값이거나 아예 지정되지 않은 경우에는 매크로가
0으로 확장됩니다.
실제 타겟 창 설정 값을 삽입하려면 %%TARGET_WINDOW%% 매크로를 사용합니다.
| 매크로 |
|---|
%%TARGET_WINDOW%% |
타겟 창 매크로는 광고 소재가 게재되는 광고 단위에 지정된 타겟 창으로 확장됩니다. 광고 소재 코드 내의 매크로를 사용하면 사용자가 광고를 보게 될 각 사이트의 설정에 따라 광고 소재를 클릭했을 때 새 창으로 이동할지 아니면 동일한 창에서 방문 페이지를 로드할지 지정할 수 있습니다.
예를 들어 AdManager_News.com 광고 단위의 타겟 창은 _top으로 설정되어 있고 AdManager_Fashion.com 광고 단위의 타겟 창은 _new로 설정되어 있습니다. %%TARGET_WINDOW%% 매크로가 광고 소재 코드에 포함되어 있는 경우 이 매크로는 AdManager_News.com 사용자에게는 _top으로 확장되고 AdManager_Fashion.com 사용자에게는 _new로 확장됩니다.
다음은 구현의 예입니다.
<a href="%%CLICK_URL_UNESC%%%%DEST_URL%%" target="%%TARGET_WINDOW%%"><img src="my ad"></a>
타겟 창 설정 값이 '_blank'인지 다른 값인지 알아보려면 %%TARGET_IN_NEW_WINDOW%% 매크로를 사용합니다.
| 매크로 |
|---|
%%TFCD%% |
아동 대상 콘텐츠용 태그(TFCD)를 사용하면 지정된 광고 요청이 아동 대상 콘텐츠가 포함된 페이지에서 전송된다는 사실을 서드 파티에 알릴 수 있습니다. 이 매크로는 아동 온라인 개인 정보 보호법(COPPA) 준수를 지원하기 위한 것입니다.
이 매크로는 coppa=%%TFCD%% 또는 이와 유사한 형식으로 모든 제3자 광고 소재 리디렉션이나 요청에 포함할 수 있습니다. 또한 자바스크립트에 사용하여 아동 대상 서비스로 취급하기 위한 GPT 패스백 태그 요청을 설정할 수도 있습니다. 매크로는 Ad Manager에 요청을 전송한 페이지, 사이트 또는 모바일 앱의 성격에 따라 아동 대상 콘텐츠에서는 1로, 기타 콘텐츠에서는 0으로 확장됩니다.
Google 광고 서비스를 사용하고 있으며 사이트 또는 앱 수준에서 아동 대상 서비스를 구현하려는 경우 아동 대상 서비스로 취급하기 위한 사이트 또는 앱 태그하기를 참조하시기 바랍니다.
| 매크로 |
|---|
[%URI_ENCODE:variable%] |
URI 인코딩 매크로는 URI, 즉 URL에 사용하기 위한 광고 소재 템플릿 변수 값의 공백과 기타 특수문자를 올바르게 번역합니다.
예
광고 소재 템플릿에 '색상'이라는 '목록' 변수가 있으며, 변수의 값으로 '진한 파란색'과 '연한 녹색'이 있다고 가정하겠습니다. 기본적으로 Ad Manager는 다음과 같이 [%Color%]를 광고 소재 템플릿 스니펫에 추가합니다.
<a href="https://paint.com/wall.html?color=[%Color%]">Paint!</a>
광고 소재가 생성되면 Ad Manager가 [%Color%]를 선택된 목록 항목의 리터럴 텍스트 문자열로 교체합니다. 이 예에서 리터럴 텍스트 문자열은 공백 문자를 포함하며 공백 문자가 인코딩되어야 하기 때문에 URL을 분할합니다. [%URI_ENCODE:Color%]를 사용하여 이 문제를 해결하세요.
<a href="https://paint.com/wall.html?color=[%URI_ENCODE:Color%]">페인트하기</a>
[%Color%] |
진한 파란색 |
[%URI_ENCODE:Color%] |
dark%20blue |
이 매크로는 광고 소재 템플릿 변수를 사용하여 클릭연결 URL 또는 리디렉션 URL을 정의할 때 특히 유용합니다. 인코딩이 올바르지 않으면 광고 소재의 전체 URL이 작동하지 않을 수 있습니다.
예
광고 소재 템플릿에 'LandingPage'라는 'URL' 변수가 있다고 가정하겠습니다. 기본적으로 Ad Manager는 다음과 같이 [%LandingPage%]를 광고 소재 템플릿 스니펫에 추가합니다.
<a href="%%CLICK_URL_UNESC%%[%LandingPage%]">여기를 클릭</a>
[%LandingPage%] URL이 ?page=home&sport=baseball 등의 쿼리 매개변수를 포함하면 URL 형식이 잘못 지정되어 리디렉션이 제대로 작동하지 않게 됩니다. 이 예에서는 앰퍼샌드(&) 이후의 내용이 리디렉션 URL이 아닌 전체 URL의 값으로 인식됩니다. [%URI_ENCODE:LandingPage%]를 사용하여 이 문제를 해결하세요.
<a href="%%CLICK_URL_UNESC%%[%URI_ENCODE:LandingPage%]">여기를 클릭</a>
[%LandingPage%] |
https://www.mysportswebsite.com? |
[%URI_ENCODE:LandingPage%] |
https%3A%2F%2Fwww.mysportswebsite.com%3F |
추적 매크로
이 매크로는 주로 추적 및 보고 용도로 사용됩니다.
캐시 버스터(임의의 숫자)| 매크로 |
|---|
%%CACHEBUSTER%% |
캐시 버스터(cache buster) 매크로를 사용하면, 코드가 실행될 때마다 광고 서버에 새로운 호출을 수행하여 노출수를 정확하게 계산할 수 있습니다. 광고 소재 코드에 캐시 무효화 매크로를 추가하지 않는 경우 Google Ad Manager와 서드 파티 광고 서버 사이에 노출수 계산 불일치가 발생할 가능성이 높습니다. 서드 파티 중 일부는 캐시 버스터(cache buster) 매크로를 요구하지 않을 수도 있습니다.
대부분의 광고 소재 공급업체는 태그에 캐시 버스터(cache buster) 매크로를 삽입할 수 있는 자리표시자를 제공합니다. 예를 들어 서드 파티 광고 소재 코드에 다음과 같은 태그가 포함되어 있다고 가정해 보겠습니다.
http://abc.3rd-party-serving.com/Targeting/;adServer.php?ab=cd&e=12fg=click&ord=[RANDOM_NUMBER]
[RANDOM_NUMBER]를 선택하고 캐시 버스터(cache buster) 매크로 삽입을 클릭하면 다음과 같이 자리표시자를 대체할 수 있습니다.
http://abc.3rd-party-serving.com/Targeting/adServer.php?ab=cd&e=12fg=click&ord=%%CACHEBUSTER%%
Campaign Manager 360 노출 추적기를 사용할 때 불일치를 줄이려면 표준 광고 태그를 선택하고 CACHEBUSTER 매크로를 삽입하세요.
http://ad.doubleclick.net/ad/Nxxxx.site/Byyyy;sz=1x1;
ord=%%CACHEBUSTER%%?
VAST 응답의 캐시 버스터(cache buster) 매크로
%%CACHEBUSTER%% 매크로는 지정된 광고 소재의 모든 이벤트에 대해 같은 임의의 숫자로 확장됩니다. 동영상 광고의 경우 매크로가 VAST 응답의 모든 동영상 추적 이벤트에 대해 같은 임의의 숫자로 확장되기 때문에 특히 유용합니다.
| 매크로 | 이스케이프 처리 |
|---|---|
%%CLICK_URL_UNESC%% |
이스케이프 처리되지 않음 |
%%CLICK_URL_ESC%% |
이스케이프 처리됨 |
%%CLICK_URL_ESC_ESC%% |
이중 이스케이프 처리됨 |
클릭 매크로는 특수 URL로 확장되어 서드 파티 광고 소재용 Ad Manager에서 클릭수를 추적할 수 있습니다. 이 매크로는 일반적으로 앵커 태그(<a>)에서 광고 소재의 클릭연결 URL과 페어링됩니다. 클릭 매크로를 이미지 또는 iframe의 소스로 입력하지 마세요. 이렇게 하면 이미지 또는 iframe이 렌더링될 때마다 클릭이 기록되며 이는 적법하지 않아 무효 클릭으로 필터링됩니다.
링크의 시작에는 %%CLICK_URL_UNESC%%를 사용합니다. 클릭 추적 프로그램이 다른 URL의 매개변수인 경우 %%CLICK_URL_ESC%%를 사용합니다.
<a href="%%CLICK_URL_UNESC%%http://www.google.com">link</a>
<a href="http://www.google.com?rd_url=%%CLICK_URL_ESC%%">link</a>
이스케이프 처리된 매크로 및 이스케이프 처리되지 않은 매크로에 대해 자세히 알아보세요.
클릭 매크로 구현 확인
잘못 삽입된 클릭 매크로는 클릭수를 추적하지 못합니다. Ad Manager가 의도대로 클릭수를 기록하는지 확인하려면 다음 단계를 따르세요.
- 광고 소재를 미리 봅니다.
- 미리보기를 클릭합니다.
Ad Manager에 클릭수가 기록된다는 확인 메시지가 표시됩니다. 이 확인이 표시되지 않는다면 클릭 매크로가 제대로 구현되지 않은 것입니다.
| 매크로 | 확장 대상 |
|---|---|
%eaid! |
광고 항목 ID |
%eadv! |
게재 중인 광고 항목의 광고주 ID |
%ebuy! |
게재 중인 광고 항목의 주문 ID |
%ecid! |
광고 소재 ID |
%eenv! |
환경(태그 유형) 표시기: iframe의 경우 i, 자바스크립트의 경우 j |
%epid! |
광고 항목이 게재되고 있는 광고 단위의 ID |
%esid! |
광고 항목이 게재되고 있는 광고 단위가 속한 최상위 수준의 광고 단위 ID
이는 기존 매크로이며 일부 네트워크에서는 작동하지 않을 수 있습니다.
|
광고 소재를 페이지에 게재할 때 Ad Manager의 ID 값을 표시하려면, 맞춤 광고 소재 코드 또는 클릭연결 URL 내에서 확장 매크로를 사용합니다. 일반적으로 문제 해결 또는 기타 보고 목적으로 Ad Manager의 ID를 게시자 본인 데이터베이스의 ID와 일치시키는 데 사용됩니다.
확장 매크로는 Ad Manager 클릭연결 URL에서 사용하기에 안전한 문자라면 어떤 문자로도 서로 구분할 수 있습니다. 예를 들어 http://www.site.com/?%eaid!;%ecid!는 http://www.site.com/?1234567;4265598로 확장될 수 있습니다.
| 매크로 |
|---|
%%ADVERTISING_IDENTIFIER_PLAIN%%(기기 식별자) |
%%ADVERTISING_IDENTIFIER_TYPE%%(기기 유형) |
%%ADVERTISING_IDENTIFIER_IS_LAT%%(광고 추적 제한 설정) |
인앱 게시자는 %%ADVERTISING_IDENTIFIER_PLAIN%% 매크로를 사용하여 재설정이 가능한 기기 ID를 광고 파트너에게 전송하여 관심기반 광고를 게재하는 데 사용할 수 있습니다. 이렇게 하면 광고주와 대행사에 재설정 가능한 기기 ID의 액세스 권한을 더 쉽게 부여할 수 있습니다.
또한 인앱 게시자는 %%ADVERTISING_IDENTIFIER_TYPE%% 매크로를 사용하여 기기 유형을 전송하고 %%ADVERTISING_IDENTIFIER_IS_LAT%% 매크로를 사용하여 기기의 광고 추적 제한 신호를 나타내는 광고 추적 제한(LAT) 설정을 전송합니다.
지원되는 기기 유형을 비롯하여 사용자 타겟팅에 재설정 가능 기기 ID에 대해 자세히 알아보세요.
기본 요건
광고 소재에 HTTPS 암호화를 설정합니다. 이 요건은 광고 소재뿐만 아니라 전환추적에 사용하는 제3자 픽셀에도 적용됩니다. 광고 소재에 HTTPS 암호화가 설정되지 않았거나 자동 SSL 호환성을 재정의한 경우 매크로가 값을 확장하지 않지만 광고 소재는 계속 게재됩니다.
작동 방식
- Ad Manager에서 게시자가 광고 소재/추적 URL에 매크로를 포함합니다.
-
매크로가 확장되어 사용자의 기기 ID를 갖게 된 다음, 제3자를 호출할 때 광고 소재에 포함됩니다.
형식
이 매크로는 대문자 32자리 16진수 값을 다섯 개로 나누어 표시하고 하이픈으로 구분하여 총 36자(영숫자 32자리와 하이픈 4자리)의 8-4-4-4-12 형식으로 전송합니다.
예: 201F2EB1-8041-9E39-CD07-FCBBA5A29B41
지원되는 기기 유형 및 광고 추적 제한(LAT)에 들어갈 수 있는 값을 확인합니다.
| 매크로 |
|---|
%%PREVIEW_MODE%% |
백엔드 시스템이나 서드 파티 시스템에서 미리보기 노출을 계산하지 못하도록 하려면, 맞춤 광고 소재 코드의 미리보기 모드 매크로를 사용합니다. Ad Manager 미리보기로 광고 소재를 보는 경우 매크로는 true로, 일반 노출인 경우에는 false로 확장됩니다.
| 매크로 |
|---|
%%SCHEME%% |
스키마 매크로는 http: 또는 https: 중 광고 소재가 게재 중인 웹페이지의 보안 스키마와 일치하는 항목으로 확장되며, 다음과 같이 URL의 앞부분에 삽입할 수 있습니다.
<img src=%%SCHEME%%//www.website.com/img/logo.gif>
| 매크로 |
|---|
%%SITE%% |
광고 태그에 있는 URL 매개변수의 도메인으로 확장됩니다(예: google.com). 이 매크로는 요청 출처에 따라 광고 소재를 수정하는 데 사용할 수 있으며 익명으로 표시된 Ad Exchange 광고에서는 작동하지 않습니다.
| 매크로 | 이스케이프 처리 |
|---|---|
%%VIEW_URL_ESC%% |
이스케이프 처리됨 |
%%VIEW_URL_UNESC%% |
이스케이프 처리되지 않음 |
조회된 노출 매크로를 사용하면 광고 소재가 사용자의 기기에 다운로드되어 로드되기 시작할 때마다 Ad Manager가 노출수를 계산하게 됩니다. 이 매크로는 페이지 외부 광고 소재에서만 사용하세요.
보기 핑을 보내는 데는 여러 가지 방법이 있지만 다음과 같이 <img> 태그를 사용하는 것이 좋습니다.
<!-- 이 img 태그는 표시되지 않으며 브라우저가 VIEW_URL에 요청을 보내게 합니다. -->
<img src="%%VIEW_URL_UNESC%%" style="display:none">
<!-- 이 img 태그는 실제 광고를 표시합니다.-->
<img src="[%Imagefile%]" border="0">
첫 번째 <img> 태그는 VIEW_URL에서 1x1 이미지를 가져옵니다. 또한 스타일을 “display:none”으로 설정하여 숨겨지고 페이지 레이아웃에 영향을 주지 않습니다.
GDPR에 대한 광고 요청 매크로
이러한 매크로는 GDPR이 적용되는 광고 요청에 가장 일반적으로 사용됩니다.
GDPR| 매크로 |
|---|
${GDPR} |
요청과 연결된 gdpr= 값으로 확장됩니다.
| 매크로 |
|---|
${GDPR_CONSENT_XXXX} |
요청과 연결된 투명성 및 동의(TC) 문자열로 확장됩니다. 투명성 및 동의(TC) 문자열이 비어 있거나 잘못되어 있는 경우 이 매크로는 확장되지 않습니다. 이 매크로를 사용하여 TC 문자열을 비프로그래매틱 광고 소재의 URL에 있는 서드 파티 광고 소재 제공업체에 전달하세요.
'XXXX'를 서드 파티 제공업체의 IAB GVL ID로 바꾸세요. TC 문자열이 비어 있거나 잘못되어 있는 경우 이 매크로는 확장되지 않습니다.
삽입한 IAB GVL ID와 연결된 서드 파티 제공업체가 사용자 동의를 얻지 못하면 ${GDPR_CONSENT_XXXX} 매크로가 포함된 광고 소재는 차단될 수 있습니다.
VAST 태그에서 사용되고 서드 파티 제공업체에 사용자 동의가 없으면 이 매크로는 확장되지 않습니다.
${GDPR_CONSENT_XXXX} 매크로는 URL 내에서 한 번만 사용할 수 있습니다. TC 문자열 전달 및 URL 길이 제한에 대한 요구사항을 파악하려면 서드 파티 광고 소재 공급업체에 문의하세요. 매크로는 관련 IAB TCF v2.0 요청에서 수정되지 않은 전체 TC 문자열로 대체됩니다.
투명성 및 동의 프레임워크(TCF) 매크로는 HTML5 광고 소재의 HTML로 구현되면 확장되지 않습니다. 디스플레이 리디렉션 및 맞춤 디스플레이 광고 소재만 각각 '제3자 URL' 및 'HTML 코드' 입력란을 통해 TCF 매크로를 확장합니다.
| 매크로 |
|---|
${ADDTL_CONSENT} |
요청과 연결된 추가 동의(AC) 문자열로 확장됩니다.
| 매크로 |
|---|
%%TFUA%% |
값이 1로 확장되어 동의 연령 미만의 EEA 및 영국 사용자에 대한 요청이 태그 지정됩니다.
동영상 매크로
이 매크로는 일반적으로 동영상 광고 소재가 컨텍스트 또는 콘텐츠 세부정보를 포함하도록 하는 데 사용됩니다.
동영상 광고 길이(밀리초)| 매크로 |
|---|
%%VIDEO_AD_DURATION%% |
동영상 광고의 길이(밀리초)로 확장됩니다. VAST 래퍼/리디렉션의 경우 매크로는 Ad Manager에서 선언된 광고 길이로 확장됩니다.
| 매크로 | 이스케이프 처리 |
|---|---|
%%DESCRIPTION_URL_UNESC%% |
이스케이프 처리되지 않음 |
%%DESCRIPTION_URL_ESC%% |
이스케이프 처리됨 |
%%DESCRIPTION_URL_ESC_ESC%% |
이중 이스케이프 처리됨 |
매크로가 URL 내부에 있을 때는 %%DESCRIPTION_URL_ESC%%(단독 이스케이프 처리됨)를 사용하고 다른 컨텍스트에서는 %%DESCRIPTION_URL_UNESC%%(이스케이프 처리되지 않음)를 사용합니다. 이스케이프 처리된 매크로와 이스케이프 처리되지 않은 매크로의 비교 자세히 알아보기
리디렉션 광고 태그에서는 원래 Google 게시자 태그의 description_url 쿼리 매개변수에서 설명 URL 매개변수로 확장됩니다. 설명 URL은 리퍼러 URL과 동일해야 합니다. IMA SDK가 페이지 URL을 제대로 감지하지 못하는 삽입이 있거나 동영상용 Ad Exchange 또는 애드센스에서 동영상을 사용 중인 경우 Google 게시자 태그에 description_url을 지정해야 합니다.
%%DESCRIPTION_URL%%을 지원합니다. 이는 %%DESCRIPTION_URL_UNESC%%와 동일하게 기능하므로 이전의 광고 소재와 템플릿을 다시 코딩할 필요는 없습니다.| 매크로 | 이스케이프 처리 |
|---|---|
%%REFERRER_URL_UNESC%% |
이스케이프 처리되지 않음 |
%%REFERRER_URL_ESC%% |
단독 이스케이프 처리됨 |
%%REFERRER_URL_ESC_ESC%% |
이중 이스케이프 처리됨 |
매크로가 URL 내부에 있을 때는 %%REFERRER_URL_ESC%%(단독 이스케이프 처리됨)를 사용하고 다른 컨텍스트에서는 %%REFERRER_URL_UNESC%%(이스케이프 처리되지 않음)를 사용합니다. 이스케이프 처리된 URL 매크로 및 이스케이프 처리되지 않은 URL 매크로 비교 자세히 알아보기
이 매크로는 리디렉션 광고 태그에서 리퍼러 URL(동영상 플레이어가 위치한 페이지 URL)로 확장됩니다. 확장은 Ad Manager가 광고 태그의 URL 쿼리 매개변수를 파싱하고 리퍼러 URL을 분리한 후 매크로 텍스트를 해당 URL로 대체하는 방식으로 이뤄집니다. 이는 다음 조건이 충족되는 경우에 Google IMA SDK에서만 작동합니다.
- 이 매크로가 작동하려면 페이지에서 스크립트 액세스를 활성화해야 합니다.
- 매크로는 iframe 내에서 작동하지 않습니다.
%%REFERRER_URL%%을 지원합니다. 이는 %%REFERRER_URL_UNESC%%와 동일하게 기능하므로 이전의 광고 소재와 템플릿을 다시 코딩할 필요는 없습니다.동영상 콘텐츠 매크로
이 매크로는 동영상 콘텐츠 소스를 타겟팅하는 광고에 사용됩니다.
| 매크로 |
|---|
%%VIDEO_DURATION%% |
동영상의 길이(밀리초 단위)로 확장됩니다.
| 매크로 |
|---|
%%VIDEO_ID%% |
현재 재생 중인 동영상 콘텐츠의 ID로 확장됩니다. 이 ID는 CMS에 있는 고유 ID이거나 MRSS의 dfpvideo:ContentID 값입니다.
| 매크로 |
|---|
%%VIDEO_METADATA:key%% |
동영상 콘텐츠와 연결된 키-값을 기반으로 광고 소재가 게재 중인 동영상의 메타데이터로 확장됩니다. 키-값은 Ad Manager의 '동영상' 탭에 설정되어 있습니다.
동영상 메타데이터 키가 타겟팅되면 동영상 메타데이터 매크로에 의해 확장될 수 있습니다. 매크로에 사용된 '키'는 영숫자 문자나 밑줄(_)이어야 합니다.
| 매크로 | 이스케이프 처리 |
|---|---|
%%VIDEO_TITLE%% |
단독 이스케이프 처리됨 |
동영상 제목 매크로는 확장되면 Ad Manager에 정의된 동영상 제목을 표시합니다.
이 매크로가 작동하려면 콘텐츠 처리가 필요합니다.
| 매크로 |
|---|
%%FW_CAID%% |
프리휠 맞춤 광고 ID로 확장됩니다.
이 매크로는 프리휠을 사용하여 동영상 광고를 게재하는 게시자에만 적용됩니다.
| 매크로 |
|---|
%%IAB_CATEGORIES%% |
라벨로 직접 분류한 광고 소재의 광고 카테고리를 전달하는 데 사용됩니다. 이 매크로는 적용 가능한 표준 IAB 카테고리의 쉼표로 구분된 목록을 반환합니다(Google 분류 카테고리에서 전환됨).
이 매크로는 FreeWheel로 동영상 인벤토리를 공유하고 광고 카테고리를 맞춤 매개변수로 전달하려는 게시자가 사용할 수 있습니다. 예를 들어 &iab_categories=%%IAB_CATEGORIES%%를 VAST 리디렉션 태그에 추가할 수 있습니다.