이 페이지에서는 Display & Video 360 API를 사용할 때 발생할 수 있는 다양한 유형의 오류 및 경고를 설명합니다.
API 오류
완료할 수 없는 API에 대한 요청은 오류 메시지를 반환합니다. 오류를 반환하는 요청은 사용자 할당량에 포함되고 추가 할당량 요청을 검토할 때 고려됩니다. 오류 응답은 향후 오류를 방지하기 위해 처리 및 처리되어야 합니다.
오류 응답은 다음과 같은 형식을 취하며 HTTP 응답 코드, 오류 메시지, Google RPC 코드 상태를 포함합니다.
{
"error": {
"code": integer,
"message": string,
"status": enum (google.rpc.Code)
}
}
다음은 일반적인 API 오류와 오류가 반환될 경우 취할 수 있는 조치입니다.
| 코드 | RPC | 권장 조치 |
|---|---|---|
400
|
INVALID_ARGUMENT
|
요청에 문제가 있습니다. 오류 응답의 메시지 필드를 검토하고 적절하게 요청을 수정합니다. |
401
|
UNAUTHENTICATED
|
요청을 제대로 인증할 수 없습니다. 요청에 유효한 OAuth 사용자 인증 정보가 포함되어 있는지 확인합니다. 자세한 내용은 시작 가이드를 참조하세요. |
403
|
PERMISSION_DENIED
|
요청을 완료하는 데 필요한 권한이 없습니다. 사용자 계정에 관련 파트너 또는 광고주에 대한 적절한 권한이 있는지 확인합니다. |
404
|
NOT_FOUND
|
검색하려는 리소스를 찾을 수 없습니다. 사용 중인 ID가 올바르고 검색 중인 리소스 유형에 해당하는지 확인합니다. |
409
|
ABORTED
|
수정하려는 리소스가 다른 곳에서 수정되고 있습니다. 몇 초 동안 기다린 후 요청을 다시 시도하세요. |
429
|
RESOURCE_EXHAUSTED
|
비율 한도 또는 일일 요청 할당량을 초과했습니다.
Google API 콘솔을 사용하여 API 사용량을 살펴보고 기존 할당량 한도 내에서 작동하도록 워크플로를 수정합니다. 자세한 내용은 할당량 최적화 페이지를 참조하세요. 지정된 일일 할당량 내에서 작업을 완료할 수 없는 경우 추가 할당량을 요청할 수 있습니다. |
500
|
INTERNAL
|
API에 내부 오류가 발생했습니다. 몇 초 정도 기다린 후 요청을 다시 시도하세요. 오류가 계속되면 지원팀에 문의하세요. |
504
|
DEADLINE_EXCEEDED
|
API에서 요청을 완료하는 데 시간이 너무 오래 걸립니다. 몇 초 정도 기다린 후 요청을 다시 시도하세요. 오류가 계속되면 지원팀에 문의하세요. |
SDF 오류
Display & Video 360 API는 구조화된 데이터 파일 (SDF)을 생성하고 다운로드하는 데 비동기 메서드를 사용합니다. 이러한 이유로 SDF 생성 중에 발생한 오류는 완료된 SDF 다운로드 작업에서 반환됩니다. error에서 완료되는 SDF 다운로드 작업은 완료로 표시되지만 다음 잘린 예와 같이 response 필드에 미디어 리소스 이름 대신 채워진 오류 필드가 있습니다.
{
...
"done": true,
"error": {
"code": 3,
"message": "We couldn't prepare your CSV files: Invalid filter Ids for Advertiser: 00000000"
}
}
SDF를 생성하려고 할 때 조치 가능한 오류 메시지가 표시되면 그에 따라 조치를 취해야 합니다. 오류 메시지에 명확하게 조치를 취할 수 없는 경우 다음 조치를 취하는 것이 좋습니다.
- 사용자에게 상위 파트너 또는 광고주 리소스에 대한 적절한 권한이 있는지 확인합니다.
- 필터에 제공된 ID가 정확하고 의도한 리소스 유형에 해당하며 지정된 루트 ID 컨텍스트 내에 있는지 확인합니다.
- 사용자당 동시 SDF 다운로드 태스크 한도인 20개를 초과하지 않도록 합니다.
오류가 계속 발생하면 지원팀에 문의하여 문제를 신고하세요.
비차단 경고
비차단 경고는 광고 항목에 할당되어 광고 항목의 게재에 영향을 미칠 수 있는 문제를 나타냅니다. 유사한 경고가 알림 배너를 통해 UI에 전달됩니다. 이러한 경고는 수동적이며 광고 항목의 warningMessages 필드에 나열됩니다.
수동적이지만 이러한 경고를 유발하는 문제는 광고 항목 게재에 영향을 미쳐 광고 항목이 완전히 차단될 수도 있습니다.
예방
다음을 비롯하여 차단되지 않는 경고를 일으키는 많은 문제는 광고 항목 설정을 올바르게 구성하면 피할 수 있습니다.
- 광고 게재 기간: 광고 항목의 광고 게재 기간이 잘못되었거나 상위 게재 신청서의 광고 게재 기간이 만료된 경우 광고 항목에 경고가 생성되어 게재되지 않습니다. 후자의 문제를 방지하려면 광고 항목의 광고 게재 기간이 상위 게재 신청서의 광고 게재 기간 이후에 종료되지 않도록 해야 합니다.
- 할당된 광고 소재: 광고 항목에 할당된 유효한 광고 소재가 없는 경우 광고 항목이 경고를 생성하고 게재되지 않습니다.
- 타겟팅: 광고 항목의 타겟팅이 올바르게 할당되지 않으면 경고가 발생할 수 있으며 게재가 완전히 영향을 받거나 차단될 수 있습니다.
기존 광고 항목에서 구성을 복제하는 경우 기존 광고 항목에서 예기치 않은 경고가 발생하지 않도록 해야 합니다.
모니터링
광고 항목이 게재 중일 때 차단하지 않는 경고를 유발하는 문제가 발생할 수 있습니다. 광고 항목이 올바르게 게재되도록 하려면 활성 광고 항목에 새로
생성된 경고가 있는지 모니터링하세요. 광고 항목은 advertisers.lineItems.list 함수를
사용하여 일괄적으로 가져올 수 있습니다. 광고 항목에서 예기치 않은 경고가 발생하는 경우, 즉시 문제를 해결하여 게재에 미치는 영향을 줄여야 합니다.
광고 항목의 설정이나 타겟팅이 변경되지 않은 경우에도 문제가 발생할 수 있습니다. 예를 들어 상위 게재 신청서 일시중지 또는 만료, 사용자 목록 또는 기타 타겟팅의 지원 중단이 있습니다.