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

기여 분석 범위는 API 호출자가 소스 및 트리거 등록 중에 기여 분석이 발생하기 전에 필터링하는 데 사용할 수 있는 문자열 목록을 지정할 수 있도록 합니다. 이를 통해 더 세부적인 필터링이 가능해져 API 효율성이 높아지고 유연성이 향상됩니다. 예를 들어 동일한 사이트에서 서로 다른 광고주를 명확하게 추적할 수 있습니다. 또한 단일 광고 배너 내에서 여러 캠페인 또는 제품을 추적하는 데도 도움이 됩니다.

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

소스 등록 중

필수 매개변수 값과 한도, 선택적 매개변수 max_event_states가 포함된 헤더 Attribution-Reporting-Register-Source에 선택적 매개변수 attribution_scopes가 추가됩니다.

• 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 호출자는 트리거 등록을 첫 번째 소스 등록에 기여 분석하는 기여 분석 보고서를 수신합니다.

기여 분석 범위와 필터 비교

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

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

기여도 분석 전

• 소스 1은 기여 분석 범위가 트리거의 casualwear 범위와 일치하지 않아 필터링됩니다. 사용 가능한 모든 소스 중에서 우선순위가 가장 높더라도 우선순위가 확인되기 전에 사전 기여 분석 필터링이 발생하므로 필터링되지 않습니다.
• 소스 2도 트리거와 범위가 동일하지 않아 필터링됩니다. 이 소스에는 트리거와 동일한 필터도 있지만, 속성 부여가 완료될 때까지는 상위 수준 필터가 적용되지 않습니다.

기여 분석 중

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

게시물 속성

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

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

기여 분석 중

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

게시물 속성

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

기여 분석 범위는 기여 분석에 고려되는 소스 수를 줄입니다. 그러면 나머지 기여 분석 단계가 이 작은 소스 풀에 적용되어 보고서가 생성될 수 있습니다.

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

기여 분석 범위는 기여 분석에 사용할 소스가 선택되기 전에 적용됩니다. 또한 최상위 필터 및 맞춤 보고서 기간 필터링보다 우선합니다. 다음 다이어그램은 기여 분석 범위가 기여 분석 및 나머지 기여 분석 확인 전에 발생하는 전체 기여 분석 흐름의 간소화된 버전을 보여줍니다.

기여 분석 흐름 작업

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

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

다음 단계

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