보고서 범위는 어떻게 해야 하나요?
대부분의 보고서에서는 Reports.reportScope를 특정 엔진 계정 또는 광고주로 설정하는 것이 좋습니다. 키워드 보고서, 전환 보고서, 세분화된 보고서 등 매우 큰 보고서의 경우 범위를 특정 엔진 계정으로 제한하는 것이 좋습니다. 행이 1,000만 개를 초과하는 보고서의 경우 API에서 오류를 반환할 수 있습니다.
금지됨 (403) 오류가 표시되는 이유는 무엇인가요?
대부분의 경우 갱신 OAuth 토큰을 얻어야 합니다.
대행사 및 광고주의 ID를 찾으려면 어떻게 해야 하나요?
조회 권한이 있는 대행사 및 광고주의 ID가 아직 없는 경우 agencyId 및 advertiserId 열이 포함된 advertiser 보고서를 요청하되 reportScope는 지정하지 않습니다.
Search Ads 360은 Google 계정에서 볼 수 있는 권한을 보유한 모든 대행사 및 광고주 ID의 목록을 반환합니다.
다음은 요청의 예입니다.
POST https://www.googleapis.com/doubleclicksearch/v2/reports/generate
Authorization: Bearer your OAuth 2.0 access token
Content-type: application/json
{
"reportType": "advertiser",
"columns": [
{ "columnName": "agency" },
{ "columnName": "agencyId" },
{ "columnName": "advertiser" },
{ "columnName": "advertiserId" }
],
"statisticsCurrency": "usd"
}
보고 데이터는 얼마나 자주 업데이트되나요?
일부 측정항목은 다른 측정항목보다 최신 상태입니다. 자세한 내용은 Search Ads 360의 보고 데이터는 얼마나 최신인가요?를 참고하세요.
보고서에 사용 가능한 모든 측정항목이 포함되도록 하려면 자정 (엔진 계정 시간대) 후 약 4시간 후에 어제의 측정항목 보고서를 요청하는 것이 좋습니다. conversion 보고서의 경우 자정 후 (Campaign Manager 광고주 시간대) 후 12시간을 기다리는 것이 좋습니다. API를 사용하여 전환 데이터를 업로드하는 경우 업로드된 데이터의 가용성에 대한 자세한 내용은 insert.operation을 참조하세요.
며칠이 지난 후에도 엔진 스팸 필터 또는 API를 통해 업로드되는 오프라인 전환으로 인해 측정항목이 계속 변경될 수 있습니다. 이러한 변경사항을 점진적으로 다운로드하려면 마지막 다운로드 이후 변경된 데이터에 관한 보고서를 요청합니다. 증분 변경사항을 다운로드하는 경우 가끔 전체 보고서를 요청하는 것이 좋습니다. 예를 들어 며칠마다 증분 변경사항을 다운로드한 후 한 달에 한 번 전체 보고서를 요청할 수 있습니다.
속성 변경사항은 언제 보고서에 표시되나요?
Search Ads 360에서 사용자가 변경한 속성이 API를 통해 다운로드하는 보고서에 반영되는 데는 1분 정도 걸립니다. Search Ads 360을 통하지 않고 외부 엔진에서 직접 변경한 경우 먼저 인바운드 동기화를 사용하여 Search Ads 360으로 가져와야 합니다.
속성이 변경된 항목을 확인하려면 변경된 데이터만 반환하는 것이 좋습니다.
기여원이 드러나지 않은 광고와 키워드란 무엇인가요?
Search Ads 360이 특정 광고에 측정항목의 기여도를 부여하지 못하는 경우가 있습니다. 예를 들어 지원되지 않는 형식이 있는
광고 또는 오류가 있는 클릭서버 URL로 인해 Search Ads 360이 광고에 대한
측정항목의 기여도를 부여하지 않을 수 있습니다. Search Ads 360에서는 각 광고 그룹에 대해 기여원이 드러나지 않은 측정항목을
'기여가 없는 광고'에 속한 것으로 보고합니다. 보고서에서 이러한 측정항목을 요청하려면 includeRemovedEntities를 true로 설정하세요. 기여원이 드러나지 않은 광고를 쉽게 확인할 수 있도록 요청에 isUnattributedAd 열을 포함합니다.
마찬가지로 Search Ads 360이 특정 키워드에 측정항목의 기여도를 부여하지 못하는 경우도 있습니다.
이는 보고에 불일치가 발생할 때 발생합니다. 이러한 경우 기여원이 드러나지 않은 키워드의 keywordId 열은 0으로 설정됩니다.
보고서에 확장된 전환이 포함되나요?
경우에 따라 브라우저 설정 등의 요인으로 인해 광고 클릭에 관한 정보를 저장하는 웹사이트 쿠키를 사용할 수 없는 경우와 같이 전환을 측정하기 어려울 수 있습니다. 이 경우 플러드라이트에서는 확장을 사용하여 직접 측정할 수 없는 전환 데이터를 고려합니다. 즉, 플러드라이트는 머신러닝을 이전 데이터에 적용하여 측정할 수 없는 전환수 및 전환 수익 금액을 모델링합니다. 그러면 플러드라이트 에서 결과 추정치를 전환 측정항목에 추가하여 광고가 전환을 유도하는 방식을 더 완벽하게 파악할 수 있습니다.
플러드라이트는 항상 다음 보고 열에 배율을 적용합니다.
- dfaActions
- dfaRevenue
- dfaTransactions
- dfaWeightedActions
- 플러드라이트 활동에 대해 보고하는 저장된 열
conversion
보고서에는 확장된 전환이 포함되지 않습니다. 직접 측정된 전환만
표시됩니다. conversion 보고서의 전환수 및 수익 금액은 위에 나열된 열에 보고된 전환수 및 수익과 일치하지 않을 수 있습니다.
원시 전환수가 집계된 측정항목 X로 합산되지 않는 이유는 무엇인가요?
드물지만 집계된 측정항목이 Search Ads 360의 원시 이벤트와 일치하지 않는 경우 집계된 측정항목을 신뢰합니다. 측정항목 집계를 계산할 때 Search Ads 360은 중복으로 의심되는 전환을 삭제하여 데이터 소스를 정리하려고 시도합니다.
내 질문에 대한 답변이 여기에 없으면 어떻게 하나요?
이 사이트의 리소스를 읽은 후에도 해결할 수 없는 문제가 있으면 지원팀에 문의하고 다음 정보를 준비하세요.
액세스하려는 Search Ads 360 대행사 ID 및 광고주 ID
Google API 콘솔의 프로젝트 번호
API에 액세스하는 데 사용하는 Google 계정의 사용자 이름
이 계정은 Search Ads 360 액세스 권한을 부여받았으며, Search Ads 360은 승인 설정에 사용하는 계정과 동일한 계정입니다.요청의 코드 스니펫
JSON 응답
응답이 오류인 경우 숫자 오류 코드뿐 아니라 오류 메시지를 포함해야 합니다.