기여 분석 범위를 사용하여 기여 분석 전에 소스 필터링

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

기여 분석 범위를 사용하면 API 호출자가 소스 및 트리거 등록 중에 기여 분석이 실행되기 전에 필터링에 사용할 수 있는 문자열 목록을 지정할 수 있습니다. 이를 통해 더 세분화된 필터링으로 API 효율성을 높이고 유연성을 높일 수 있습니다. 예를 들어 동일한 사이트에서 별도의 광고주를 구분하여 추적할 수 있습니다. 또한 단일 광고 배너 내에서 여러 캠페인 또는 제품을 쉽게 추적할 수 있습니다.

기여 분석 범위는 소스 및 트리거 등록 중에 설정할 수 있는 선택적 필드입니다. 기여 분석 중에 기여 분석 범위 값에 트리거의 기여 분석 범위 값 중 하나 이상이 포함된 소스만 기여 분석에 고려됩니다. 트리거에 범위가 지정되지 않으면 모든 소스가 고려됩니다. 계속하기 전에 Attribution reporting API 및 대략적인 필터를 숙지해야 합니다.

소스 등록 중

선택적 매개변수 attribution_scopes가 헤더 Attribution-Reporting-Register-Source에 추가됩니다. 이 헤더에는 필수 매개변수 2개(values, limit)와 선택적 매개변수 1개(max_event_states)가 포함됩니다.

• limit: 소스 보고 출처의 대상당 허용되는 고유한 범위의 총 개수를 나타냅니다. 보고 출처와 대상이 동일하지만 한도가 더 낮은 기존 등록된 소스는 삭제됩니다.
• values: 특정 소스의 기여 분석 범위 목록을 나타냅니다. 이 값은 최대 길이가 50인 문자열이어야 합니다.
• max_event_states (선택사항): API 호출자가 후속 이벤트 소스 등록에서 사용할 계획인 최대 이벤트 상태 수를 나타냅니다. 보고 출처와 대상은 동일하지만 max_event_states value가 다른 기존 등록된 소스는 삭제됩니다. 이 선택사항 필드의 기본값은 3입니다.

소스 등록 샘플

  Attribution-Reporting-Register-source: {
  //optional
  "attribution_scopes":{
  "limit": <int>,
  "values": <list of strings>,
  // optional
  "max_event_states": <int>
    },
  ...
  }

트리거 등록 중

트리거 등록 중에 선택적 매개변수 attribution_scopes가 헤더 Attribution-Reporting-Register-Trigger에 추가됩니다. 매개변수 값이 트리거의 범위를 나타내는 문자열 목록인지 확인합니다. 트리거는 attribution_scopes 값 매개변수에 트리거의 attribution_scopes 중 하나 이상이 포함된 소스(지정된 경우)에만 일치합니다.

트리거 등록 샘플

Attribution-Reporting-Register-Trigger: {
//optional
"attribution_scopes": <list of strings>,
...
}

기여 분석 범위 예시

다음 예는 기여 분석 범위를 사용하는 동안 트리거가 소스에 기여한 사례를 보여줍니다.

소스 등록 #1

  Attribution-Reporting-Register-source: {
  "destination": "https://trigger.example",
  "attribution_scopes": {
  "limit": 2,
  "values": ["advertiser1"],
  "max_event_states": 3
  },
  ...
  }

소스 등록 #2

  Attribution-Reporting-Register-source: {
  "destination": "https://trigger.example",
  "attribution_scopes": {
  "limit": 2,
  "values": ["advertiser2"],
  "max_event_states": 3
  },
  ...
  }

트리거 등록

  Attribution-Reporting-Register-Trigger: {
  "attribution_scopes": ["advertiser1"],
  ...
  }

트리거 등록이 발생하면 API는 기여 분석에 고려할 소스 중에서 트리거 등록의 값과 교차하는 attribution_scopes 값이 있는 소스를 선택합니다. 일치하는 소스 등록은 나머지 기여 분석 흐름과 함께 계속됩니다. 이 예시에서 API 호출자는 트리거 등록을 첫 번째 소스 등록으로 기여 분석하는 기여 분석 보고서를 수신합니다.

기여 분석 범위와 필터 비교

기여 분석 범위와 필터의 기능은 비슷해 보이지만 트리거 등록 흐름에서 적용되는 위치가 다릅니다. 기여 분석 범위 필터링은 기여 분석 전에 실행됩니다. 즉, 트리거에 있는 범위와 교차하는 범위가 있는 소스를 기준으로 대상 사이트 및 보고 출처가 동일한 만료되지 않은 후보 소스 풀을 줄입니다. 하지만 최상위 필터는 트리거가 단일 소스에 기여한 후에 적용됩니다. 소스 필터와 트리거 필터가 교차하지 않으면 보고서가 생성되지 않습니다.

다음 이미지는 출처를 보고하고 만료되지 않은 동일한 도착 사이트를 사용하는 소스 그룹과 트리거를 보여줍니다. 기여 분석 범위 및 필터가 사용되는 방식과 사용 가능한 소스 및 트리거를 기반으로 보고서가 생성되는지 여부에 대해 간단히 설명합니다.

<img "activewear"="" "attribution="" "casualwear"="" "casualwear",="" "outerwear"="" "outerwear".="" "outerwear"."="" #1".the="" 1.="" 2.="" alt="An image showing 4 boxes labelled sources numbered 1 through 4 and a single box labelled " and="" attributes="" filter:="" first="" following="" fourth="" has="" priority:="" scope":="" second="" source="" src="/static/assets/images/attribution-scopes-example-1.png" the="" third="" title="Example on how attribution works with attribution scopes and filters" trigger="" />

기여 분석 전

• 소스 1은 기여 분석 범위가 트리거의 범위인 casualwear와 일치하지 않으므로 필터링됩니다. 사용 가능한 모든 소스 중 우선순위가 가장 높다고 해서 필터링되지 않는 것은 아닙니다. 우선순위가 확인되기 전에 기여 분석 전 필터링이 이루어지기 때문입니다.
• 소스 2도 트리거와 범위가 같지 않아 필터링됩니다. 이 소스에도 트리거와 동일한 필터가 있지만 상위 필터는 기여 분석 후에 적용됩니다.

기여 분석 중

• 소스 4보다 우선순위가 낮기 때문에 소스 3은 기여 분석에 선택되지 않습니다.
• 소스 4가 트리거와 일치하는 기여 분석 범위가 있고 우선순위가 가장 높기 때문에 선택됩니다. 상위 수준 필터는 기여 분석 후에 적용되므로 기여 분석 프로세스 중에 고려되지 않습니다.

게시물 기여 분석

• 선택한 소스 (소스 4)의 상위 필터와 트리거가 교차하지 않으므로 보고서가 생성되지 않습니다.

이전 예시에서는 보고서가 생성되지 않습니다. 하지만 네 번째 소스가 완전히 삭제되면 다음과 같이 표시됩니다.

기여 분석 중

• 소스 3이 트리거와 교차하는 기여 분석 범위가 있으므로 선택됩니다.

게시물 기여 분석

• 소스 3은 필터가 트리거의 필터와 교차하므로 거부되지 않습니다. 그런 다음 기여 분석은 기여 분석 후 검사를 거치며, 모든 검사를 통과하면 보고서가 생성됩니다.

기여 분석 범위를 지정하면 기여 분석에 고려되는 소스의 수가 줄어듭니다. 그런 다음 나머지 기여 분석 단계가 이 소수의 소스 풀에 적용되며, 이로 인해 보고서가 생성될 수 있습니다.

기여 분석 흐름에서 기여 분석 범위의 위치

기여 분석 범위는 기여 분석을 위해 소스를 선택하기 전에 적용됩니다. 또한 이는 최상위 필터 및 맞춤 보고서 기간 필터링보다 우선 적용됩니다. 다음 다이어그램은 기여 분석 전에 발생하는 기여 분석 범위와 기타 기여 분석 확인을 포함하여 전체 기여 분석 흐름을 단순화한 버전을 보여줍니다.

<img "attribution="" "attribution",="" "deactivation="" "filters="" "report="" "source="" "trigger="" alt="Attribution 흐름의 단순화된 버전을 보여주는 이미지로, 각 단계가 다음 단계에 화살표로 연결된 정사각형으로 표시됩니다. 순서대로 단계는 " and="" check",="" checks"="" generation"."="" matching",="" of="" other="" registration",="" scopes="" source="" sources",="" src="/static/assets/images/attribution-scopes-attribution-flow.png" title="Simplified attribution flow diagram" />

기여 분석 흐름 작업

다음은 기여 분석 흐름 중에 실행되는 다양한 작업을 요약한 내용입니다.

• 소스 등록: 사용자가 광고주의 사이트에서 광고와 상호작용할 때 소스 이벤트가 등록됩니다. 그런 다음 기기는 보고 출처의 엔드포인트로 요청을 전송하고, 엔드포인트는 소스 이벤트 데이터가 포함된 헤더로 응답합니다.
• 트리거 등록: 광고주 사이트에서 전환이 발생하면 트리거 이벤트가 등록됩니다. 기기에서 보고 출처로 또 다른 요청을 전송하면 보고 출처에서 트리거 이벤트 데이터가 포함된 헤더로 응답합니다.
• 소스 일치: 기기가 대상 사이트, 보고 출처, 만료와 같은 기준에 따라 소스 및 트리거 이벤트를 일치시킵니다.
• 기여 분석 범위 확인: 소스와 트리거 attribution_scopes 값 간의 교집합을 기반으로 소스가 필터링됩니다.
• 기여 분석: 기기는 여러 소스가 일치하는 경우 기여 분석을 위해 우선순위가 가장 높은 소스를 선택합니다. 우선순위가 동일하면 가장 최근 항목이 선택됩니다.
• 필터 확인: 기기가 소스 필터와 트리거 필터를 비교하여 일치하는지 확인합니다. 필터가 일치하지 않으면 기여 분석이 삭제됩니다.
• 기타 소스 비활성화: 선택한 소스의 필터가 일치하면 기기는 소스 일치 단계에서 일치한 소스를 비활성화합니다. 기여 분석 범위가 트리거 범위와 일치하지 않는 소스는 비활성화됩니다.
• 기여 분석 후 확인: 기기는 선택한 기여 분석에 대해 더 많은 확인을 실행합니다(예: 소스가 가짜 신고로 인해 노이즈가 발생하는지 확인, 중복 삭제 키를 사용하여 중복 기여 분석 확인, 트리거가 소스의 보고 기간 내에 있는지 확인, 비율 제한 확인).
• 보고서 생성: 모든 검사가 통과하면 기기는 기여 분석 보고서를 생성하고 보고 출처의 엔드포인트로 전송되도록 예약합니다.

다음 단계

• 저작자 표시 범위에 관한 자세한 내용은 저작자 표시 전 필터링 GitHub 설명을 참고하세요.
• 필터를 사용하여 고객 규칙 정의에서 필터에 대해 자세히 알아보세요.