서드 파티는 자체 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 API 약관에 동의하는 것으로 간주됩니다.
서드 파티로서 Ad Manager 통합을 테스트하는 방법
서드 파티는 클라이언트의 프로덕션 네트워크에 대해 실행하기 전에 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 네트워크에 계정을 새 사용자로 추가해 달라고 요청합니다.
OAuth2 서비스 계정 이메일 주소를 제공하는 경우 네트워크에 추가하도록 요청하세요.
일반 Google 계정을 제공하는 경우 내 계정을 네트워크에 사용자로 추가하도록 요청하세요.
어떤 방법을 선택하든 애플리케이션이 클라이언트의 네트워크에서 필요한 데이터에 액세스할 수 있도록 계정에 필요한 역할 및 권한을 클라이언트와 논의해야 합니다.
이제 클라이언트의 Ad Manager 네트워크에 API 호출을 시작할 수 있습니다. API 호출을 실행하는 클라이언트의 네트워크 코드에 networkCode SOAP 헤더를 설정해야 합니다. 모든 클라이언트 라이브러리에서 프로그래매틱 방식으로 이를 설정할 수 있습니다. 예를 들어 광고 Java 클라이언트 라이브러리에서 DfpSession 인스턴스를 빌드할 때 프로그래매틱 방식으로 네트워크 코드를 설정할 수 있습니다.
API 최신 정보 확인하기
사용 중단되거나 지원이 종료되는 API 버전과 새 버전이 출시되는 시기를 최신 상태로 유지하는 것이 중요합니다. 버전이 지원 중단될 때 갑작스럽게 클라이언트가 중단되는 상황을 피해야 합니다. Google은 고객에게 제공하는 것과 같은 방식으로 예정된 지원 중단 및 종료에 관해 서드 파티에 연락할 수 없는 경우가 있습니다. 따라서 API 업데이트에 관한 세 가지 기본 채널 중 하나를 구독하고 알림 설정을 조정해야 합니다.
개발자 사이트에서 지원 중단 일정도 제공하므로 정기적으로 확인하시기 바랍니다.