서드 파티는 자체 Ad Manager 네트워크를 보유하지 않을 수 있으므로 Ad Manager의 직접 사용자가 아닙니다. 대신 Ad Manager 고객인 고객을 위해 Ad Manager와의 서비스 또는 통합을 만듭니다. 이 가이드에서는 권장사항, 도움말, 유용한 정보를 제공하여 타사 통합의 기본사항을 설명합니다.
이 가이드에서는 Ad Manager API에 대한 실무 지식이 있다고 가정합니다. Ad Manager API에 익숙하지 않은 경우 시작하기 문서를 참조하세요.
서드 파티로 시작하기
Ad Manager API를 사용하여 Ad Manager 고객의 네트워크에 액세스하려면 아래의 가이드라인을 따르세요. Google의 추가 승인이 필요하지 않지만 Ad Manager API에 액세스하거나 이를 사용하면 Ad Manager API 이용약관에 동의하는 것으로 간주됩니다.
서드 파티로 Ad Manager 통합을 테스트하는 방법
제3자로서 클라이언트의 프로덕션 네트워크에 대해 실행하기 전에 Ad Manager 통합을 테스트하는 방법이 궁금할 수 있습니다. 테스트 네트워크를 만드는 것이 좋습니다. Ad Manager 고객이 아니어도 이 작업을 수행할 수 있습니다. Google 계정이 있으면 누구나 테스트 네트워크를 만들 수 있습니다.
그러나 테스트 네트워크와 프로덕션 네트워크의 차이점에 유의하세요. 테스트 네트워크에서는 광고를 게재할 수 없습니다. 또한 클라이언트가 프로덕션 네트워크에서 사용할 수 있는 모든 기능이 테스트 네트워크에 포함되어 있지 않을 수도 있습니다. 테스트 네트워크에서 사용할 수 없는 Ad Manager 기능을 테스트해야 하는 경우 한 가지 옵션은 Ad Manager 리셀러를 통해 비테스트 네트워크에 대한 액세스 권한을 구매하는 것입니다.
또한 애플리케이션이 제대로 작동하기 위해 프로덕션 네트워크에서 사용할 수 있어야 하는 기능을 고객에게 명확히 알려야 합니다. 애플리케이션은 예외를 포착하고 적절하게 실패하거나 클라이언트 목록을 유지하고 각 클라이언트에게 있는 기능과 없는 기능을 유지하여 기능이 존재하지 않을 수 있는 경우를 처리해야 합니다. Google 담당자와 함께 네트워크 기능을 관리하는 것은 고객의 책임입니다.
인증: 클라이언트의 Ad Manager 네트워크에 올바르게 액세스하는 방법
애플리케이션이 클라이언트의 Ad Manager 네트워크에 액세스하려면 안전한 방식으로 인증 워크플로를 설정해야 합니다.
이 작업에는 두 단계가 포함됩니다.
- 클라이언트의 네트워크에 액세스하는 데 사용할 Google 계정 이메일 주소를 만듭니다.
- 고객에게 이 계정을 Ad Manager 네트워크에 사용자로 추가하도록 안내합니다.
1단계에서는 클라이언트마다 별도의 Google 계정을 만들거나 모든 클라이언트에 사용할 기본 계정을 만들 수 있습니다. 이메일 주소가 도용된 경우 계정을 더 안전하게 보호할 수 있습니다. 후자의 경우 1단계를 한 번만 수행하면 됩니다.
1단계에서 무엇을 하든 2단계에서 각각의 신규 고객에게 자신이 만든 적절한 Google 계정을 사용자로 Ad Manager 네트워크에 추가하도록 요청해야 합니다.
1. Google 계정 만들기
Ad Manager 네트워크에 추가할 수 있는 Google 계정을 만드는 방법에는 여러 가지가 있습니다.
옵션 1: OAuth2 서비스 계정을 만들어 Google 계정 역할을 하는 서비스 계정 이메일 주소를 생성합니다. 새 서비스 계정을 만드는 방법
옵션 2: 신규 사용자로 가입하여 일반 Google 계정 ('Gmail' 계정)을 만들 수 있습니다. 이미 Google 계정이 있는 경우 시크릿 창 또는 새 브라우저 세션에서 가입을 완료합니다. 또는 회사에서 Google Workspace를 사용하는 경우 회사 도메인에 Google 계정을 만들어 대신 사용할 수 있습니다. 이 가이드에서는 두 계정을 모두 '일반' Google 계정이라고 합니다.
2. 고객에게 네트워크에 Google 계정을 추가하도록 요청합니다.
클라이언트의 네트워크에 액세스할 수 있는 Google 계정을 확보한 후 고객에게 Ad Manager 네트워크에 계정을 신규 사용자로 추가해 달라고 요청하세요.
어떤 경로를 선택하든 애플리케이션이 클라이언트 네트워크에서 필요한 데이터에 액세스할 수 있도록 계정에 필요한 역할과 권한을 클라이언트와 논의해야 합니다.
이제 클라이언트의 Ad Manager 네트워크에 API 호출을 시작할 수 있습니다. networkCode SOAP 헤더를 API 호출 대상 클라이언트의 네트워크 코드로 설정해야 합니다. Google의 모든 클라이언트 라이브러리에서 이를 프로그래매틱 방식으로 설정할 수 있습니다. 예를 들어 광고 자바 클라이언트 라이브러리에서 DfpSession 인스턴스를 빌드할 때 프로그래매틱 방식으로 네트워크 코드를 설정할 수 있습니다.
API를 통해 최신 상태로 유지
지원 중단되거나 서비스 종료되는 API 버전과 새 버전이 출시되는 시점을 최신 상태로 유지하는 것이 중요합니다. 버전이 지원 종료될 때 클라이언트가 손상될 위험이 있을 때 혹시 모를 상황을 피하고 싶을 것입니다. 지원 중단 및 서비스 종료가 임박하면 Google이 고객을 위해와 마찬가지로 서드 파티에 연락을 취할 수 없는 경우도 있습니다. 따라서 API 업데이트를 위한 세 가지 기본 채널 중 하나를 구독하고 알림 설정을 조정하는 것은 개발자의 책임입니다.
또한 개발자 사이트에 정기적으로 모니터링해야 하는 지원 중단 일정이 제공됩니다.
지원 받기
Ad Manager 통합과 관련된 문제가 발생하면 문제에 따라 다음과 같은 지원 채널이 제공됩니다. 제품 수준 질문이 있는 경우 Ad Manager 제품 포럼에 문의하세요. API 관련 질문이 있는 경우 Ad Manager API 포럼에 문의하세요. 제품 수준 질문인지 API 관련 질문인지 구분하는 방법은 이 블로그 게시물을 참고하세요.