잠재고객 데이터 업데이트 및 광고 새로고침

Protected Audience API 관심분야 그룹의 업데이트 URL을 구성하여 잠재고객 데이터를 업데이트하는 방법을 알아봅니다. 개발자 가이드에서 Protected Audience API의 전체 수명 주기를 확인하고 Protected Audience API 설명에서 브라우저가 관심분야 그룹을 기록하는 방법에 관한 자세한 제안을 참고하세요.

개발자가 아니신가요? Protected Audience API 개요를 참고하세요.

Protected Audience API 관심분야 그룹

Protected Audience API 관심분야 그룹은 공통 관심분야가 있는 사용자 그룹을 나타내며 리마케팅 목록에 해당합니다. 모든 Protected Audience API 관심분야 그룹에는 소유자가 있습니다.

관심분야 그룹 소유자는 Protected Audience API 광고 입찰에서 구매자 역할을 합니다. 관심분야 그룹 멤버십은 브라우저가 사용자의 기기에 저장하며 브라우저 공급업체나 다른 사람과 공유되지 않습니다.

API 함수

사용 예

다음은 잠재고객 데이터 정의에 관한 가이드의 예로, 관심분야 그룹을 만들고 브라우저에 그룹에 참여하도록 요청하는 방법을 보여줍니다.

const interestGroup = {
  owner: 'https://dsp.example',
  name: 'custom-bikes',
  biddingLogicUrl: ...,
  biddingWasmHelperUrl: ...,
  updateUrl: ...,
  trustedBiddingSignalsUrl: ...,
  trustedBiddingSignalsKeys: ['key1', 'key2'],
  userBiddingSignals: {...},
  ads: [bikeAd1, bikeAd2, bikeAd3],
  adComponents: [customBike1, customBike2, bikePedal, bikeFrame1, bikeFrame2],
};

navigator.joinAdInterestGroup(interestGroup, 7 * kSecsPerDay);

updateUrl는 관심분류 속성을 업데이트하는 JSON을 반환하는 URL을 제공합니다. 출처는 owner와 동일해야 합니다.

속성 업데이트

updateUrl는 joinAdInterestGroup()에 전달된 관심분야 그룹 객체에 해당하는 관심분야 그룹 속성을 정의하는 JSON을 반환하는 웹 서버를 지정합니다.

이를 통해 그룹 소유자는 관심분야 그룹의 속성을 주기적으로 업데이트할 수 있습니다. 현재 구현에서는 다음 속성을 변경할 수 있습니다.

  • biddingLogicUrl
  • biddingWasmHelperUrl
  • trustedBiddingSignalsUrl
  • trustedBiddingSignalsKeys
  • ads
  • priority

JSON에 지정되지 않은 필드는 덮어쓰지 않습니다. JSON에 지정된 필드만 업데이트됩니다. 반면 navigator.joinAdInterestGroup()를 호출하면 기존 관심분야가 덮어쓰입니다.

업데이트는 최선의 방법이며 다음 조건에서는 실패할 수 있습니다.

  • 네트워크 요청 제한 시간 (현재 30초)
  • 기타 네트워크 오류입니다.
  • JSON 파싱 실패

업데이트는 하루에 최대 1회로 제한됩니다.

연속된 업데이트 시간이 너무 길면 업데이트가 취소될 수 있지만 취소된 (남은) 업데이트에는 비율 제한이 적용되지 않습니다. 네트워크 오류로 인해 실패한 업데이트는 1시간 후에 다시 시도되고, 인터넷 연결이 끊어져 실패한 업데이트는 다시 연결되면 즉시 다시 시도됩니다.

수동 업데이트

현재 프레임의 출처가 소유한 관심분야 그룹의 업데이트는 navigator.updateAdInterestGroups()를 사용하여 수동으로 트리거할 수 있습니다.

비율 제한은 업데이트가 너무 자주 발생하는 것을 방지합니다. 비율 제한 기간 (현재 1일)이 지나기 전까지 navigator.updateAdInterestGroups()를 반복적으로 호출해도 아무 작업도 실행되지 않습니다.

동일한 관심분야 그룹 owner 및 name에 대해 navigator.joinAdInterestGroup()가 다시 호출되면 비율 제한이 재설정됩니다.

자동 업데이트

경매에 로드된 모든 관심분야 그룹은 경매가 완료된 후 수동 업데이트와 동일한 비율 제한에 따라 자동으로 업데이트됩니다.

하나 이상의 관심분야 그룹이 입찰에 참여하는 각 소유자의 경우 출처가 해당 소유자와 일치하는 iframe에서 navigator.updateAdInterestGroups()가 호출된 것과 같습니다.

모든 Protected Audience API 참조

다음과 같은 API 참조 가이드를 이용할 수 있습니다.

Protected Audience API 설명에서는 기능 지원 및 제약조건에 대한 세부정보도 제공합니다.