맞춤 잠재고객을 만들 때 맞춤 잠재고객 메타데이터의 일부 또는 전부를 지정할 수 있습니다. 이 정보는 CustomAudience
객체를 만들 때 직접 전달할 수 있습니다. CustomAudience.Builder
는 메타데이터를 제공하고 업데이트할 수 있는 dailyUpdateUri
필드도 지원합니다. 플랫폼은 24시간마다 백그라운드 작업을 실행하여 dailyUpdateUri
에서 업데이트된 메타데이터를 가져오고, 맞춤 잠재고객에 아직 입찰에 참여하는 데 필요한 AdData
가 없는 경우 4시간마다 실행합니다. 플랫폼은 다음과 같은 맞춤 잠재고객 메타데이터를 업데이트할 수 있습니다.
- 사용자 입찰 신호
- 신뢰할 수 있는 입찰 데이터
AdData
목록
이 메타데이터를 업데이트하기 위해 일일 백그라운드 업데이트 프로세스는 맞춤 잠재고객에 정의된 dailyUpdateUri
를 쿼리하며 이 쿼리는 JSON 응답을 반환할 수 있습니다.
- JSON 응답에는 업데이트해야 하는, 지원되는 메타데이터 필드가 포함될 수 있습니다.
- 각 JSON 필드는 독립적으로 검증됩니다. 클라이언트는 형식이 잘못된 필드를 무시하므로 응답의 해당 필드가 업데이트되지 않습니다.
- 빈 HTTP 응답이나 빈 JSON 객체 '
{}
'로 인해 메타데이터가 업데이트되지 않습니다. - 응답 메시지 크기는 10KB로 제한해야 합니다.
- 모든 URI는 HTTPS를 사용해야 합니다.
trusted_bidding_uri
는 구매자와 동일한 ETLD+1을 공유해야 합니다.
예: 백그라운드 일일 업데이트 JSON 응답
{
"user_bidding_signals" : { ... }, // Valid JSON object
"trusted_bidding_data" : {
"trusted_bidding_uri" : "example-dsp1-key-value-service.com",
"trusted_bidding_keys" : [ "campaign123", "campaign456", ... ]
},
"ads" : [
{
"render_uri" : "www.example-dsp1.com/.../campaign123.html",
"metadata" : { ... } // Valid JSON object
},
{
"render_uri" : "www.example-dsp1.com/.../campaign456.html",
"metadata" : { ... } // Valid JSON object
},
...
]
}
응답에 포함될 수 있는 데이터 유형의 예는 이 모의 서버 정의를 참고하세요.