SupplyChain 객체를 사용하면 구매자와 중개자가 광고 인벤토리를 판매하거나 재판매하는 모든 당사자를 볼 수 있습니다. 객체는 ads.txt
/ads.txt
및 ads.txt
과 함께 작동하여 광고 생태계에 투명성을 제공합니다.
- 게시자가 입찰 요청을 보냅니다.
- 구매자는 SupplyChain 객체에서 입찰 요청 및 데이터를 수신합니다.
- 구매자는 재고를 재판매하는 모든 중개자의 신원을 조회합니다.
- 구매자는 재고 판매 권한이 있는 공급업체를 크롤링하고 확인합니다.
Google은 해당하는 경우 OpenRTB 요청 또는 Google RTB 프로토콜 내에서 자동으로 객체를 생성합니다.
SupplyChain 객체의 작동 방식
이라고도 하는 SupplyChain 객체는 OpenRTB 입찰 요청의 일부이며 '노드'로 구성됩니다. schain
schain
객체의 각 노드는 입찰 요청에 참여하는 특정 항목을 나타내며, 여기에는 인벤토리의 직접적인 결제 흐름과 관련된 모든 항목이 포함됩니다.
// Example object
"schain": {
"complete": 1,
"nodes": [{
"asi":"google.com",
"sid":"pub-1234567891234567", // Same seller_id for the publisher in sellers.json
"hp":1
}],
"ver":"1.0"
}
자세한 내용은 OpenRTB의 개발자 문서 및 IAB 문서를 참고하세요.
SupplyChain 객체는 구매자와 작업하는 방식에 따라 다르게 표시됩니다.
Google을 통해 직접 판매하는 게시자
Ad Manager, AdMob 또는 애드센스를 통해 인벤토리를 직접 판매하는 게시자의 경우 schain
객체에는 sellers.json에 있는 seller_id
와 함께 'google.com'에 대한 노드가 하나만 포함됩니다.
공개 입찰을 사용하는 게시자
타사 거래소와 협력하기 위해 공개 입찰을 사용하는 게시자에게는 schain
객체에 두 개의 노드가 있습니다. 하나는 sellers.json에서 찾아볼 수 있는 seller_id
가 있는 google.com용 노드이고, 다른 하나는 거래소 수익 파트너용 노드입니다.
Google이 입찰 요청을 보내기 전에 google.com을 위한 노드를 생성하는 것처럼 타사 거래소는 요청을 전달하기 전에 노드를 추가해야 합니다.
모든 비결제 중개자
결제를 처리하지 않는 중개자는 SupplyChain 객체에 포함되지 않습니다. 여기에는 클라이언트 측 헤더 입찰, 미결제 헤더 입찰, 인벤토리 공유, 기타 미디에이션이 포함됩니다.
요청하기 전에 결제 중개자를 사용하는 게시자 (베타)
베타 단계의 기능은 네트워크에서 사용하지 못할 수도 있습니다. 언제 이 기능을 일반적으로 사용할 수 있는지 알아보려면 출시 노트를 확인하세요.
Google Ad Manager 요청의 업스트림에서 결제 중개자를 활용하는 게시자는 IAB 가이드라인에 따라 SupplyChain
객체를 전달해야 합니다. SupplyChain
객체에는 인벤토리에 대한 결제 흐름과 직접적으로 관련된 중개자만 포함되어야 합니다. 이러한 중개자에는 게시자가 사용하는 서드 파티 광고 서버 기술이 포함될 수 있습니다. SupplyChain
객체는 schain
매개변수를 사용하여 광고 요청에 전송할 수 있습니다.
설명
공급망(schain
) 매개변수는 직렬화된 SupplyChain 객체여야 하는 변수 값을 허용합니다. 이 매개변수가 포함되면 Google은 구매자에게 전송하기 전에 수신된 모든 schain
객체에 노드를 추가합니다.
OpenRTB가 아닌 태그를 통해 SupplyChain 정보를 전달하는 방법은 전체 IAB 문서를 참고하세요.
올바른schain
파싱을 위한 요구사항 보기
IAB 문서에 따라 다음은 SupplyChain
객체의 직렬화를 정의합니다.
{SupplyChainObject}!{SupplyChainNode array}. SupplyChainObject
및SupplyChainNode
속성은 쉼표로 구분되므로 옵션 필드는 생략할 수 있고 쉼표 구분자는 선택적으로 제외할 수 있습니다.- 각
SupplyChainNode
요소는 '!
'로 구분됩니다. - 속성 값에 URL 인코딩이 필요한 문자(예: '
,
' 또는 '!
')가 포함된 경우 직렬화하기 전에 값을 URL로 인코딩해야 합니다.
직렬화 순서
SupplyChainObject
속성은 다음 순서로 직렬화됩니다.
ver,complete
SupplyChainNode
속성은 다음 순서로 직렬화됩니다.
asi,sid,hp,rid,name,domain,ext
ext
의 콘텐츠는 광고 거래소마다 다릅니다. Google Ad Manager는 이 속성을 파싱하지 않습니다.SupplyChain 객체를 직렬화하는 방법의 예
다음은 위의 SupplyChain
객체를 직렬화하는 두 가지 방법의 예입니다.
1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1,,,,
1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1
사용 예
schain=1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1,,,,
asi
의 값이 exchange,1
이면 이스케이프된 문자를 사용한 직렬화는 다음과 같습니다.
1.0,1!exchange%2C1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1
요구사항 및 권장사항
이 매개변수는 특정 구현 또는 거래 유형에 광고를 게재하는 데 필요하지는 않지만 Google Ad Manager 요청의 업스트림에서 결제 중개자를 활용하는 게시자에게는 필요합니다. 여기에는 서드 파티 광고 서버 기술을 사용하는 게시자도 포함됩니다.
SupplyChain
객체에 추가된 노드는 게시자의 ads.txt/app-ads.txt 파일에도 표시되어야 합니다. 그렇지 않으면 구매자가 트래픽을 승인되지 않은 것으로 간주할 수 있습니다.복수 고객 관리 게시자
복수 고객 관리(MCM)를 이용하면 게시자가 게시자 고객의 AdMob 계정을 게시자와 동일한 조회 및 관리 권한을 갖고 관리할 수 있습니다.
AdMob MCM을 사용하는 상위 및 하위 게시자의 경우 schain
객체에는 하위 게시자의 판매자 ID가 있는 노드 1개, 상위 게시자용 노드 1개가 있으며 체인은 완전한 것으로 표시됩니다. AdMob MCM의 경우 수익 창출은 하위 게시자의 계정에서 발생합니다. 하위 게시자는 최종 게시자로 간주됩니다.