Google AdSense

이 페이지

사이트의 Astro 레이아웃과 정적 파일을 통해 Google AdSense를 통합합니다. 이 방식은 사이트 코드를 사용하므로 EmDash 플러그인이 필요하지 않습니다. 사이트의 소스 코드와 배포에 접근할 수 있어야 하며, AdSense 계정의 인증 코드와 게시자 ID도 필요합니다.

사이트 승인, 광고 게재, 동의 요구 사항은 Google이 관리합니다. 계정에 대해서는 사이트 연결에 관한 Google의 안내를 따르세요. 아래 예시는 해당 코드를 EmDash의 어디에 넣어야 하는지를 보여 줄 뿐이며, AdSense 승인을 보장하지 않습니다.

인증 및 광고 코드 추가

  1. 수익화하려는 공개 페이지가 사용하는 공유 레이아웃을 엽니다. 블로그 템플릿에서는 src/layouts/Base.astro입니다. 기존 <EmDashHead>와 나머지 head 콘텐츠는 그대로 둡니다.

  2. AdSense 코드를 레이아웃의 <head>에 붙여 넣습니다. 다음 로더 예시는 자리 표시자 게시자 ID를 사용합니다. ca-pub-0000000000000000 값 전체를 본인의 값으로 바꾸세요.

    <script
        is:inline
        async
        src="https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-0000000000000000"
        crossorigin="anonymous"
    ></script>

    Astro의 is:inline은 스크립트를 번들링하지 않고 작성한 그대로 유지합니다. 여러 광고 단위가 한 페이지를 공유하더라도 스크립트는 페이지당 한 번만 로드하세요. Astro의 스크립트 처리 문서를 참고하세요.

    AdSense의 메타 태그 인증 방법을 선택한 경우, Google이 제공한 태그를 그대로 같은 <head>에 넣습니다. 다음 예시는 자리 표시자 ID를 사용한 AdSense 계정 태그입니다.

    <meta name="google-adsense-account" content="ca-pub-0000000000000000" />

    EmDash의 Settings > SEO에 있는 Google Verification 필드는 google-adsense-account가 아니라 google-site-verification을 출력합니다. 이 필드에 AdSense 게시자 ID를 넣지 마세요.

  3. 자동 광고의 경우 AdSense에서 게재 위치를 설정합니다. 수동 광고 단위의 경우 Google의 광고 단위 마크업과 초기화 스크립트를 광고가 표시될 Astro 컴포넌트나 페이지에 붙여 넣습니다. Astro가 그대로 유지하도록 초기화용 <script>에는 is:inline을 추가하세요. 공유 로더는 단위마다 반복하지 말고 레이아웃에 한 번만 두세요.

실행 가능한 광고 코드는 게시물 콘텐츠가 아니라 신뢰할 수 있는 사이트 소스에 보관하세요. 광고 스크립트를 활성화하기 전에 동의 요구 사항을 적용하세요. 이 예시는 동의 관리자를 구현하지 않습니다. 사이트에서 Content Security Policy를 설정하는 경우, Google의 최신 안내에서 요구하는 리소스에 맞게 구성하세요.

루트에서 ads.txt 제공

Astro 사이트 프로젝트에서 사이트의 src/ 디렉터리와 같은 위치에 public/ads.txt를 만듭니다. Astro는 public 파일을 변경 없이 복사하므로 이 파일은 /ads.txt에서 제공됩니다.

AdSense가 제공한 줄을 일반 텍스트로 파일에 복사합니다. 다음 예시는 자리 표시자 게시자 ID를 사용합니다. 계정에 맞는 Google의 정확한 줄을 사용하세요.

google.com, pub-0000000000000000, DIRECT, f08c47fec0942fa0

ads.txt가 이미 있다면 다른 광고 제공업체의 항목은 유지한 채 AdSense 줄을 추가합니다. 필요한 도메인과 파일 내용은 Google의 ads.txt 안내를 따르세요. 이 파일은 EmDash 미디어 라이브러리가 아니라 사이트 프로젝트에 보관하세요.

배포 및 확인

레이아웃이나 public/ 파일을 변경한 후 사이트를 배포합니다. AdSense에 등록된 공개 도메인에서 다음을 확인하세요.

  • 페이지 소스의 <head>에 선택한 인증 태그 또는 스크립트가 본인의 게시자 ID와 함께 포함되어 있고, 공유 AdSense 로더가 하나만 있습니다.
  • https://your-domain.example/ads.txt가 404나 HTML 페이지가 아니라 예상한 일반 텍스트를 반환합니다.
  • 브라우저의 네트워크 및 콘솔 패널에 스크립트 오류나 사이트 보안 정책에 의해 차단된 요청이 표시되지 않습니다. 광고 차단기 때문에 로컬 확인에서 광고가 로드되지 않을 수 있습니다.

AdSense로 돌아가 인증과 검토를 요청하세요. 스크립트가 정상적으로 로드되거나 ads.txt 파일에 접근할 수 있다는 사실만으로 사이트가 승인되었거나 광고가 표시된다는 뜻은 아닙니다.

플러그인에서 통합 재사용

여러 사이트에서 공유하는 통합의 경우, 신뢰할 수 있는 네이티브 플러그인이 page:fragments를 통해 스크립트를 제공할 수 있습니다. 호스트 레이아웃은 해당하는 EmDash 삽입 컴포넌트를 렌더링해야 합니다. 샌드박스 플러그인은 스크립트나 원시 HTML을 삽입할 수 없습니다. 정적 public/ads.txt 파일은 여전히 사이트 수준의 배포 문제로 남습니다.