본문 바로가기
AMP JS

광고 애널리틱스 - amp-auto-ads 자동광고

by 로마리우 2018. 9. 16.
기술원격 제공 구성 파일을 사용하여 AMP 페이지에 광고를 동적으로 삽입합니다.
유효성실험적
필수 스크립트<script async custom-element="amp-auto-ads" src="https://cdn.ampproject.org/v0/amp-auto-ads-0.1.js"></script>
지원되는 레이아웃N / A


행동

충분한 수의 유효한 게재 위치 (구성에서 제공됨)가 주어지면 amp-auto-ads광고 네트워크에서 지정한 제약 조건을 준수하면서 추가 광고를 삽입합니다. 이러한 제한은 다음을 제한합니다.

  • 삽입 할 수있는 총 광고 수
  • 인접한 광고 사이에 있어야하는 최소 거리

이 외에도 광고는 허용되지 않는 재순환을 발생시키지 않는 페이지의 위치에만 삽입됩니다 (attemptChangeSize에 의해 결정됨).

<amp-auto-ads>태그의 첫 번째 자식으로 배치해야합니다 <body>.

광고 네트워크 유형 및 추가 정보 (광고 네트워크에서 필요)는 태그에 지정해야합니다.

< amp-auto-ads 
    type = "adsense" 
    data-ad-client = "ca-pub-5439573510495356" > 
</ amp-auto-ads >

지원되는 광고 네트워크

속성

유형 (필수)

광고 네트워크의 식별자입니다.

데이터 - 푸 - 바

대부분의 광고 네트워크는 HTML data-속성 을 사용하여 네트워크로 전달할 수있는 추가 구성이 필요 합니다. 매개 변수 이름은 표준 데이터 속성 대시에서 낙타로 변환됩니다. 예를 들어, "data-foo-bar"는 "fooBar"로 구성 설정을 위해 광고로 전송됩니다. 속성을 사용할 수있는 광고 네트워크 설명서를 참조하십시오 .

공통 속성

이 요소에는 AMP 구성 요소로 확장 된 공통 속성 이 포함됩니다 .

구성 사양

구성은 페이지에서 <amp-auto-ads>광고를 게재 할 수 있는 위치를 정의합니다 구성은에 정의 된 URL의 제 3 자 광고 네트워크에서 가져옵니다 ad-network-config.js구성은 ConfigObj아래에 설명 된 정의와 일치하는 직렬화 된 JSON 객체 여야 합니다.

구성 예

다음 예제에서는 광고가 페이지 <P class='paragraph'>의 세 번째 요소 내에있는 모든 요소 바로 다음에 위치하도록 지정합니다 <DIV id='domId'>이 위치에 배치 된 광고는 BANNER 유형이어야하며 상단 여백은 4px이고 하단 여백은 10px 여야합니다.

{
  "placements": [
    {
      "anchor": {
        "selector": "DIV#domId",
        "index": 2,
        "sub": {
          "selector": "P.paragraph",
          "all": true,
        },
      },
      "pos": 4,
      "type": 1,
      "style": {
        "top_m": 5,
        "bot_m": 10,
      },
    },
  ]
}

개체 정의

ConfigObj

구성 개체에 지정할 필드 :

분야 명유형기술
placements배열 <! PlacementObj>필요한 광고가 페이지에 삽입 할 수있는 잠재적 장소를 나타내는 필드.
attributes개체 <string, string>이 구성을 사용하여 삽입 된 모든 요소 에 적용하기 위해 속성 이름에서 속성 값으로의 매핑을 지정 하는 선택적 필드입니다 <amp-ad>다음 속성 이름 만 허용됩니다.
  • 유형
  • 형세
  • data- * (즉, 모든 데이터 속성)
adConstraintsAdConstraintsObj페이지에 광고를 배치 할 때 사용해야하는 제한 조건을 지정 하는 선택적필드. 지정되지 않으면 amp-auto-ads[ad-network-config.js] (https://github.com/ampproject/amphtml/blob/master/extensions/amp-auto-ads/0.1/ad)에 지정된 기본 제약 조건을 사용하려고 시도합니다. -network-config.js).

게재 위치 Obj

placements구성 개체 에 지정할 필드 :

분야 명유형기술
anchor앵커 오브배치 위치가 고정 된 페이지에서 요소를 조회하는 데 사용되는 정보를 제공 하는 필수 필드.
posRelativePositionEnum필요 앵커 소자 배치의 위치를 나타내는 필드.
typePlacementTypeEnum필요한 위치의 유형을 나타냅니다 필드.
stylePlacementStyleObj옵션 이 배치 위치에 삽입 광고에 적용 할 어떤 스타일을 나타내는 필드.
attributes개체 <string, string>이 속성을 사용하여 삽입 된 모든요소 에 적용 할 속성의 속성 이름에서 값까지의 매핑을위한선택적 필드입니다 <amp-ad>.여기에 지정된 속성은 부모에 지정된 이름과 동일한 이름으로 any를 대체합니다 ConfigObj.다음 속성 이름 만 허용됩니다.
  • 유형
  • 형세
  • data- * (즉, 모든 데이터 속성)

앵커 오브

anchor구성 개체 에 지정할 필드 :

분야 명유형기술
selector요구 앵커 정의의이 수준에서 요소 (들)을 선택하는 CSS 선택기를 정의하는 필드.
index번호이 레벨의 엥커 정의를 제한 할 필요가있는 셀렉터에 의해 선택된 요소의 인덱스를 지정 하는 옵션필드입니다. 기본적으로이 값은 0으로 설정됩니다 ( all필드가 false 인 경우).
all부울index필드가 지정된 경우 무시됩니다 이 값을 설정true하면 선택기에서 선택한 모든 요소가 포함되어야 함 나타냅니다. 그렇지 않은 경우false.
min_c번호포함되는 요소의 textContent 속성의 최소 길이를 지정 하는선택적 필드입니다. 기본값은 0입니다.
sub앵커 오브이 앵커 정의 수준에서 선택된 요소 내의 요소를 선택할 재귀를 지정하는 선택적 필드입니다AnchorObj.

PlacementStyleObj

style구성 개체 에 지정할 필드 :

분야 명유형기술
top_m번호옵션 이 위치에 삽입 된 광고가 있어야한다 픽셀 위쪽 여백을 나타내는 필드. 기본값 : 0.
bot_m번호옵션 이 위치에 삽입 된 광고가 있어야한다 픽셀 아래쪽 여백을 나타내는 필드. 기본값 : 0.

RelativePositionEnum

구성 개체 의 pos필드에 대한 ENUM 값 placements:

이름기술
전에1광고는 앵커 바로 앞에 형제로 삽입해야합니다.
FIRST_CHILD2광고는 앵커의 첫 번째 자녀로 삽입해야합니다.
막내3광고는 앵커의 마지막 자식으로 삽입해야합니다.
4광고는 앵커 바로 다음에 형제로 삽입해야합니다.

PlacementTypeEnum

구성 개체 의 type필드에 대한 ENUM 값 placements:

이름기술
기치1게재 위치는 배너 광고 게재 순위를 나타냅니다.

AdConstraintsObj

adConstraints구성 개체 에 지정할 필드 :

분야 명유형기술
initialMinSpacing삽입시 광고가 이미 페이지에있는 광고 (수동으로 배치되었거나 자동 광고로 배치 된 광고)에서 있어야하는 최소 거리를 나타내는 필수입력란입니다. 값은 단위 접두사가있는 숫자로 표시됩니다. 예를 들어 "10 픽셀"은 10 픽셀을 의미하거나 "0.5vp"는 절반의 뷰포트 높이를 의미합니다. 음수 값이 유효하지 않습니다. 지원되는 단위는 다음과 같습니다.
  • 픽셀 - 픽셀
  • vp - 뷰포트 높이의 배수
이 값은 페이지에 이미있는 광고 수가 adCount후속 맞춤 공간 필드에 지정된 일치 프로그램 보다 적은 경우에만 적용됩니다 .
subsequentMinSpacingArray <! SubsequentMinSpacingObj>삽입시 페이지에 이미 몇 개의 광고가 있는지에 따라 적용해야하는 광고 간격을 지정 하는 선택적 필드입니다.
maxAdCount번호페이지에있을 수 있는 최대 광고 수를 지정 하는 필수입력란입니다 amp-auto-ads.수동으로 배치 된 광고는 물론amp-auto-ads이 합계 에 집계 된 광고도 게재됩니다 예를 들어이 입력란을 5로 설정하고 페이지에 수동으로 배치 된 광고가 3 개인 amp-auto-ads경우 최대 2 개의 광고를 추가로 게재합니다.

SubsequentMinSpacingObj

subsequentMinSpacing구성 개체 에 지정할 필드 입니다. subsequentMinSpacing항목을 사용하여 이미 페이지에있는 광고의 수에 따라 추가 광고간에 필요한 간격을 변경할 수 있습니다. 예를 들어, 다음 시나리오를 고려하십시오.

  • 페이지에 기존 광고 2 개가 있습니다.
  • subsequentMinSpacing 필드는 다음과 같습니다. [ {adCount: 3, spacing: "500px"}, {adCount: 5, spacing: "1000px"}, ]

초기에는 페이지에 2 개의 기존 광고가 있으므로 매핑이 일치하지 않습니다. 따라서 최소 간격은 AdConstraints객체의 initialMinSpacing을 기본값으로 사용 합니다. amp-auto-ads재사용을 시도하지 않고 사용할 수있는 게재 위치가 없어 질 때까지 반복적으로 광고 게재를 시도합니다 adContraintsamp-auto-ads첫 번째 광고를 게재 한 후 3 개의 광고에 대한 매핑이 있기 때문에 페이지에 3 개의 광고가 있으며 이제 subsequentMinSpacing최소 간격은 500 픽셀이됩니다. 이것은 5 개의 광고에 대한 규칙이 있기 때문에 페이지에 5 개의 광고가있는 지점까지 적용됩니다. 따라서 6 번째 광고를 삽입하려면 적어도 1000 픽셀 이상의 다른 광고가 없어야합니다.

분야 명유형기술
adCount번호필요한 필드. 이 규칙을 적용하는 페이지에 이미있는 광고의 최소 개수입니다. 다른 규칙이 더 적합하지 않은 것으로 가정합니다.자세한 설명은 위의 설명을 참조하십시오.
spacing에 따라이 규칙이 일치 할 때 적용되는 최소 광고 간격을 지정 하는 필수 입력란입니다adCount값은 단위 접두사가있는 숫자로 표시됩니다. 예를 들어 "10 픽셀"은 10 픽셀을 의미하거나 "0.5vp"는 절반의 뷰포트 높이를 의미합니다. 음수 값이 유효하지 않습니다.지원되는 단위는 다음과 같습니다.
  • 픽셀 - 픽셀
  • vp - 뷰포트 높이의 배수

확인

AMP 검사기 사양에서 amp-auto-ads 규칙 을 참조하십시오 .

댓글