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

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()를 사용하여 수동으로 트리거할 수 있습니다.

비율 제한을 사용하면 업데이트가 너무 자주 발생하는 것을 방지할 수 있습니다. navigator.updateAdInterestGroups()를 반복적으로 호출하면 비율 제한 기간 (현재 1일)이 지날 때까지 아무 작업도 하지 않습니다.

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

자동 업데이트

입찰을 위해 로드된 모든 관심분야 그룹은 입찰이 완료된 후 자동으로 업데이트되며 수동 업데이트와 동일한 비율 제한이 적용됩니다.

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

모든 Protected Audience API 참조

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

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