Attribution Reporting API 교차 웹 및 앱 구현 가이드

Attribution Reporting API는 소스의 교차 앱 및 웹 기여 분석을 사용 설정합니다. 동일한 기기에서 발생하는 트리거가 포함됩니다. Chrome과 같은 브라우저는 소스 및 트리거 등록을 모두 Attribution Reporting에 위임할 수 있습니다. API를 사용하여 브라우저에서 이러한 등록을 처리하는 대신 Android용 API를 사용할 수 있습니다. 이렇게 하면 Android가 사이트와 앱 모두에서 소스와 트리거를 일치시킬 수 있습니다.

이 가이드에서는 교차 앱 및 웹 기여 분석을 설정하는 방법을 설명합니다.

교차 앱 및 웹 기여 분석을 설정할 때는 디버깅 솔루션을 숙지하여 문제를 설정이 정상적으로 작동하는지 확인하세요.

Android OS로 소스 및 트리거 등록

교차 앱 및 웹 기여 분석은 기여 분석이 Reporting API가 브라우저와 Android OS 모두에서 동일하게 사용 설정됨 있습니다. Android Attribution Reporting API의 사용 가능 여부가 전송됩니다. Attribution-Reporting-Support 헤더를 통해 이러한 요청을 받습니다. 이 헤더는 os, 둘 다 또는 둘 다로 설정할 수 있습니다. 둘 다 사용할 수 있게 되면 광고 기술은 웹 소스와 웹 페이지를 등록할 수 있습니다. 브라우저 또는 OS에서 트리거가 실행됩니다.

광고 기술은 웹 소스를 등록할지 또는 웹 트리거를 등록할지 결정해야 합니다. 브라우저나 OS와 다를 수 있습니다.

  • 웹 전용 캠페인의 경우 광고 기술은 계속해서 소스와 트리거를 모두 등록할 수 있습니다. Chrome의 Attribution Reporting API와 함께 사용하거나 두 가지 모두 OS에 위임하도록 선택할 수 있습니다. 소스 또는 트리거가 한 위치에서 발생할 수 있는 웹 전용 캠페인의 경우 WebView를 사용하는 경우 광고 기술은 소스 및 트리거 등록을 둘 다 있습니다. 자세한 내용은 WebView 섹션을 참고하세요.
  • 광고 기술은 소스 및 트리거를 Chrome 브라우저와 및 Android API를 동시에 사용하여 중복 기여 분석을 생성합니다. 있습니다.
  • 기여 분석은 브라우저와 OS에서 별도로 발생합니다. 소스가 트리거가 OS에 등록되어 있는 경우 그 반대의 경우도 마찬가지입니다.
  • 앱 또는 웹 트리거로 이어질 수 있는 소스의 경우 광고 기술이 웹 소스를 위임하고 등록을 트리거하여 Android Attribution Reporting API
  • 앱 기반 소스에 의해 유도되었을 수 있는 트리거의 경우 광고 기술은 웹 트리거 등록을 Android Attribution Reporting에 위임하도록 선택 API에 액세스할 수 있습니다.
  • 소스와 트리거가 모두 앱에서 발생하는 캠페인의 경우 OS Attribution Reporting API에 등록해야 합니다.

앱 소스 및 웹 트리거 등록

일부 캠페인의 경우 트리거가 발생하는 동안 앱에서 소스가 발생할 수 있습니다. 동일한 기기의 모바일 브라우저에서 웹사이트에 게재됩니다.

사용자가 즐겨 사용하는 뉴스 앱에서 기사를 읽고 있습니다. 저가의 광고를 봄 즐거운 마음으로 클릭하여 예약하세요. 뉴스 앱이 Android Attribution Reporting API에 클릭 소스를 등록합니다. 사용자가 Chrome에서 광고주의 웹페이지로 이동하며 여기에서 있습니다. 광고주 사이트의 광고 기술이 OS 수준 API가 사용할 수 있습니다 광고 기술은 다음을 통해 전환 트리거를 등록합니다. 등록하는 대신 OS에 등록을 위임하도록 Chrome에 지시 바로 Chrome의 Attribution Reporting API를 사용해 보세요 OS 수준 기여 분석 그러면 Reporting API가 앱 소스와 웹 트리거를 일치시키고 확인할 수 있습니다

<ph type="x-smartling-placeholder">
</ph> 앱에서 웹으로의 기여 분석 흐름
앱-웹 기여 분석 흐름

앱 소스 등록:

  1. Daily News Android 앱의 광고 기술 SDK는 registerSource()

  2. Android의 Attribution Reporting API가 광고 기술 서버에 요청을 보냅니다. registerSource()에 제공된 URL

  3. 광고 기술 서버가 Attribution-Reporting-등록-소스로 응답합니다. 소스 등록을 완료하는 헤더

웹 트리거 등록:

  1. 광고 기술은 트리거를 등록하고 Attribution Reporting API

  2. 웹 ARA는 지원되는 플랫폼에 대한 정보를 반환합니다.

  3. OS-Trigger 헤더는 OS ARA API를 호출하도록 웹 ARA API에 지시합니다. registerWebTrigger() 함수

  4. registerWebTrigger() 호출은 내부에서 발생하며 개발자가 OS에서 직접 registerWebTrigger()를 호출할 필요가 없음

  5. OS ARA가 인계받고 Attribution-Reporting-Register-OS-Trigger 헤더

  6. 광고 기술이 OS API로 트리거 등록을 완료합니다.

  7. OS ARA는 앱<> 기여 분석을 수행하고 동일한 보고서를

워크플로

다음 단계에는 작업을 완료하는 방법에 관한 자세한 내용이 포함되어 있습니다.

  1. 앱의 광고 기술이 Android의 기여 분석에 소스를 등록함 Reporting API에 다음과 같은 변경사항이 적용됩니다.

    • 웹사이트에서 전환이 예상되는 앱 소스를 등록하려면 Attribution-Reporting-Register-Source 응답 헤더에는 웹을 포함해야 합니다. 대상 (eTLD+1)을 사용하도록 설정됩니다.
    를 통해 개인정보처리방침을 정의할 수 있습니다.
    Attribution-Reporting-Register-Source: {
        "web_destination": "https://advertiser.example",
        ...
    }
    
    • 일부 광고주는 여러 측정 제공업체 (예: 서드 파티 측정 도구 또는 애널리틱스 도구)을 통해 Google에 직접 연결할 수 있습니다. 경우에 따라 Attribution Reporting API가 리디렉션 경로를 따릅니다. 백그라운드에서 Attribution-Reporting-Redirect 헤더에 지정된 동시에 기존 서버에 대해 302 리디렉션 경로가 포그라운드에서 실행될 때 탐색 요청에 사용합니다. 이러한 요청은 동일한 URL로 이동하므로 서드 파티 측정 제공업체의 등록이 중복으로 집계됩니다. 받는사람 등록 중복 계산 방지, 광고 기술은 리디렉션 동작을 수정할 수 있음 Attribution Reporting API 등록을 다른 개발자로 보낼 수 있습니다. 결정론적 URL입니다.
    • 이 동작을 사용 설정하려면 광고 기술이 다음과 같습니다.

      • 헤더는 Attribution-Reporting-Redirect-Config입니다.
      • 헤더의 값은 리디렉션-302-to-well-known이어야 합니다.
      를 통해 개인정보처리방침을 정의할 수 있습니다.
      "Attribution-Reporting-Redirect-Config": "redirect-302-to-well-known"
      
    • 소스 등록 프로세스의 나머지 부분은 표준 앱 간 소스 등록

    를 통해 개인정보처리방침을 정의할 수 있습니다.
  2. 광고주 웹사이트의 광고 기술은 Chrome에서 Android Attribution Reporting API에 등록을 위임합니다.

    • 사용자가 웹사이트에서 전환을 완료하면 광고 기술은 Chrome에 트리거 등록 요청

      1. 픽셀 또는 fetch() 요청을 사용하면 트리거

      2. Chrome에서 Attribution-Reporting-Support 요청 헤더를 반환함 광고 기술에 연결합니다 이 API가 Chrome 브라우저와 Android 기기: 헤더에서 os, web를 반환합니다.

      "Attribution-Reporting-Support": "os, web"
      
    • 그러면 광고 기술은 다음을 수행하는 Attribution-Reporting-Register-OS-Trigger 헤더

      1. Chrome에 등록을 OS에 위임하도록 지시합니다.

      2. Chrome이 OS API 함수를 호출하여 OS에 등록을 위임함 registerWebTrigger()

        • registerWebTrigger() 호출은 내부에서 발생합니다. 광고 기술 registerWebTrigger()를 직접 호출할 필요가 없음
      3. OS API가 전달된 광고 기술 URI에 대한 보조 API 호출을 시작합니다. 브라우저에서

      "Attribution-Reporting-Register-OS-Trigger": "https://adtech.example/register-trigger",
      "https://other-adtech.example/register-trigger"
      
    • 경우에 따라 Attribution-Reporting-Support 헤더를 사용할 수 없으며 전송할 수 없습니다. 이 경우 광고 기술은 여전히 포함하여 트리거 등록을 처리할 수 있는 Attribution-Reporting-Info 헤더. 키는 기본 플랫폼이며 허용되는 값은 osweb입니다. 브라우저에서 기본 플랫폼을 사용합니다. OS가 다시 로드되면 웹 플랫폼으로 돌아갑니다 사용할 수 없습니다.

    를 통해 개인정보처리방침을 정의할 수 있습니다.
    Attribution-Reporting-Info: preferred-platform=os
    
    • 트리거 등록을 완료하려면 광고 기술의 엔드포인트가 응답 헤더를 사용하여 Android Attribution Reporting API 요청에 추가합니다.
    Attribution-Reporting-Register-Trigger {
        "event_trigger_data": [{"trigger_data":"1"}],
        "aggregatable_trigger_data": [
            {"key_piece":"0x400","source_keys":["campaignCounts"]},
            {"key_piece":"0xA80","source_keys":["geoValue"]}
        ],
        ...
    }
    

웹 소스 및 앱 트리거 등록

일부 캠페인의 경우 소스가 모바일 브라우저의 사이트에서 나타날 수 있지만 같은 기기의 앱에서 트리거가 발생하는 경우

사용자가 Android 휴대전화의 Chrome 브라우저에서 사이트를 탐색하고 있습니다. 좋아하는 매장에서 판매하는 스웨터 광고를 봅니다. 사용자는 이미 다운로드한 앱으로 연결됩니다. 서버의 광고 기술은 광고가 게재된 웹사이트는 Chrome에 요청하여 클릭 소스를 등록합니다. 대신 Android Attribution Reporting API에 등록을 위임합니다. Attribution Reporting API를 사용합니다. 사용자가 스웨터를 구매합니다. 확인할 수 있습니다 그러면 광고주의 앱의 광고 기술이 Android Attribution Reporting API로 전환 트리거 OS 수준 Attribution Reporting API는 웹 소스 및 앱 트리거를 매칭하고 관련 보고서를 보냅니다.

<ph type="x-smartling-placeholder">
</ph> 웹-앱 기여 분석 흐름
웹에서 앱으로의 기여 분석 흐름

웹 소스 등록:

  1. 광고 기술은 소스를 등록하고 Attribution Reporting API

  2. 웹 ARA는 지원되는 플랫폼에 대한 정보를 반환합니다.

  3. OS-Source 헤더는 OS ARA API를 호출하도록 웹 ARA API에 지시합니다. registerWebSource() 함수

  4. registerWebSource() 호출은 내부적으로 발생하며 개발자는 이를 실행합니다. OS에서 직접 registerWebSource()를 호출할 필요 없음

  5. OS ARA가 인계되어 제공된 광고 기술 서버 URL로 요청을 전송합니다. Attribution-Reporting-Register-OS-Source 헤더별

  6. 광고 기술이 OS API로 소스 등록을 완료합니다.

앱 트리거 등록:

  1. 의류 스토어 Android 앱의 광고 기술 SDK는 다음을 사용하여 트리거를 등록합니다. OS ARA

  2. Android의 Attribution Reporting API가 광고 기술 서버에 요청을 보냅니다. registerTrigger()에 제공된 URL

  3. 광고 기술 서버가 Attribution-Reporting-Register-Trigger로 응답합니다. 트리거 등록을 완료하는 헤더

  4. OS ARA는 앱<> 기여 분석을 수행하고 동일한 보고서를

워크플로

다음 단계에는 작업을 완료하는 방법에 관한 자세한 내용이 포함되어 있습니다.

  1. 게시자 웹사이트의 광고 기술은 Chrome에서 Android Attribution Reporting API에 등록을 위임합니다.

    • 웹-앱 사용 사례의 경우 소스를 등록할 때 기여 분석 source 매개변수는 attributionsrc 태그 또는 자바스크립트 등록을 사용하여
    • 다음 예시에서는 attributionsrc 태그를 사용하여 소스 매개변수:
    <img src="https://adtech.example/conversionpixel"
    attributionsrc="https://adtech.example/register-source?purchase=12">
    
  2. Chrome은 Attribution-Reporting-Support 요청 헤더를 광고 기술 Chrome 브라우저와 Android 기기 모두에서 API가 사용 설정된 경우 헤더는 os, web를 반환합니다.

    "Attribution-Reporting-Support": "os, web"
    
  3. 광고 기술은 다음을 사용하여 OS 수준 API에 위임하도록 Chrome에 알려야 합니다. 다음을 수행하는 Attribution-Reporting-Register-OS-Source 헤더

    1. Chrome에 등록을 OS에 위임하도록 지시합니다.
    2. Chrome이 OS API 함수를 호출하여 OS에 등록을 위임함 registerWebSource()
    3. registerWebSource() 호출은 내부적으로 발생하며 광고 기술은 registerWebSource()를 직접 호출할 필요 없음
    4. OS API는 브라우저
    "Attribution-Reporting-Register-OS-Source": "https://adtech.example/register-source"
    
    • Attribution-Reporting-Support 헤더를 사용할 수 없는 경우도 있습니다. 이 경우 광고 기술은 여전히 기본 플랫폼을 설정하여 Attribution-Reporting-Info 헤더를 포함하여 소스 등록을 처리합니다. 키는 기본 플랫폼이며 허용되는 값은 osweb입니다. 이 가능한 경우 브라우저에서 선호 플랫폼을 사용하고 웹 플랫폼으로 작동하기만 하면 됩니다.
    를 통해 개인정보처리방침을 정의할 수 있습니다.
    Attribution-Reporting-Info: preferred-platform=os
    
    • 소스 등록을 완료하려면 광고 기술의 엔드포인트가 응답 헤더를 사용하여 Android Attribution Reporting API 요청으로 전송 Attribution-Reporting-Register-Source 응답은 또한 대상 필드에 앱 대상을 입력합니다.
    Attribution-Reporting-Register-Source {
        "source_event_id":"123001",
        "destination":"android-app://com.example.advertiser",
        ...
    }
    
    • 소스 등록 리디렉션을 지원하기 위해 Chrome은 리디렉션하고 각 리디렉션 홉의 웹 컨텍스트 API를 호출합니다.
    • 소스 등록의 나머지 부분은 동일하게 유지됩니다.
  4. 광고주 앱의 광고 기술이 Android Attribution Reporting API:

    • 앱에서 발생하는 트리거의 경우 앱은 트리거를 등록합니다. Android Attribution Reporting API를 정상적으로 사용합니다.

앱 및 웹의 잠재 도착 페이지가 모두 있는 캠페인

  1. 이중 대상 설정

    • 일부 캠페인은 광고주의 앱 또는 다양한 요소에 따라 달라질 수 있습니다. 앱이 설치되어 있어야 합니다.
    • 이 경우 소스 등록을 OS가 있는 경우 이에 관계없이 소스가 올바르게 기여될 수 있도록 함 확인할 수 있습니다 OS에 소스를 등록할 때, 앱과 웹 대상은 각 매개변수에서 지정할 수 있습니다.
    • 앱 대상은 destination 필드에 있어야 합니다.
    • 웹 대상은 web_destination 필드에 있어야 합니다.
    • Chrome 개발자는 OS의 destination 필드에 주목해야 합니다. Attribution Reporting API는 URL이 아닌 앱 패키지여야 합니다.
    Attribution-Reporting-Register-Source {
        "source_event_id":"123001",
        "destination":"android-app://com.example.advertiser",
        "web_destination": "https://example.advertiser"
        ...
    }
    
    • 대략적인 보고에 대한 다음 섹션에서는 이중 대상을 사용하는 방법을 설명합니다. 보고서의 노이즈에 영향을 줄 수 있습니다.
  2. 대략적인 보고를 사용하여 이중 보고서에 대한 이벤트 수준 보고서의 노이즈 줄이기 대상 소스:

    • 소스에 OS (앱)와 웹 대상이 모두 지정된 경우 이벤트 수준 보고서는 트리거가 발생했는지 여부를 지정합니다. 웹 대상 또는 앱 대상에 기본적으로 저장됩니다 그러나 개인 정보 보호 제한, 추가적인 노이즈가 이러한 보고서에 추가됩니다.
    • 광고 기술은 아래의 coarse_event_report_destinations 필드를 사용하여 대략적 보고서를 사용 설정하려면 Attribution-Reporting-Register-Source 헤더 노이즈를 줄여줍니다 소스가 coarse_event_report_destinations인 경우 지정된 필드가 기여 분석을 얻으면 결과 보고서에는 두 가지 앱이 모두 포함됩니다. 실제 트리거가 발생하는 위치를 구분하지 않고 앱 또는 웹 대상의 보고서보다 노이즈가 적습니다. 지정합니다.
    • 집계 보고서는 변경되지 않습니다.

Chrome 맞춤 탭을 사용하는 앱의 경우

일부 앱에서는 맞춤 탭을 사용하여 웹 콘텐츠를 렌더링할 수 있습니다. 맞춤 탭 동작 앱과 모바일 웹사이트에서 측정할 때 일반 웹페이지와 비슷함

  1. 앱 소스 및 맞춤 탭 트리거를 등록합니다. <ph type="x-smartling-placeholder">
  2. 맞춤 탭 소스 및 앱 트리거를 등록합니다. <ph type="x-smartling-placeholder">
  3. CCT 소스 및 CCT 트리거 등록 <ph type="x-smartling-placeholder">

WebView를 사용하는 앱의 경우

일부 앱은 WebView를 사용하여 콘텐츠를 표시할 수 있습니다. 다양한 사용 사례가 있습니다. (예: 광고 렌더링, 웹 콘텐츠 호스팅, 맞춤 앱) 웹 형식에 더 적합한 여러 기능을 제공합니다.

  1. WebView에서는 OS 수준 기여 분석만 사용할 수 있습니다. 이 Attribution-Reporting-Support 헤더는 os만 반환하며 Android Attribution Reporting API를 사용할 수 있습니다.

  2. OS에 위임할 때 WebView에서 registerSource 또는 registerWebSourceregisterTrigger 또는 registerWebTrigger입니다. 어떤 메서드가 WebView를 렌더링하는 앱에 의해 설정되며 API마다 다릅니다

    • registerSourceregisterWebSource의 차이점은 무엇인가요? 소스가 게시자로 기록됩니다. registerSource를 사용하면 앱이 로깅됩니다. 게시자로서 registerSource를 사용하는 경우의 예는 다음과 같습니다. WebView를 사용하여 렌더링되는 광고를 표시하는 게시자 앱 다음으로 바꿉니다. registerWebSource: WebView에서 호스팅되는 웹사이트가 다음과 같이 로깅됩니다. 게시자 registerWebSource를 사용해야 하는 경우의 예로는 WebView를 호스팅하고 WebView에 의해 렌더링되는 웹사이트가 있습니다. registerTriggerregisterWebTrigger는 비슷하게 동작합니다. 이 항목 3의 차트에는 앱 또는 SDK 개발자가 registerSource 또는 registerWebSource를 사용하도록 API를 구성하려고 합니다. 및 registerTrigger 또는 registerWebTrigger
  3. 기본적으로 WebView는 다음의 경우 registerSourceregisterWebTrigger를 사용합니다. Android Attribution Reporting API를 호출하기만 하면 됩니다 이렇게 하면 소스와 WebView에서 URL의 최상위 출처로 트리거되는 앱 및 트리거가 트리거가 발생합니다

    • 앱에 다른 동작이 필요한 경우 새 메서드를 사용해야 함 androidx.webkit.WebViewSettingsCompatsetAttributionRegistrationBehavior 클래스에 대해 자세히 알아보세요. 이 메서드는 WebView가 registerWebSource()를 호출해야 하는지 지정합니다. 또는 registerSource() 또는 registerTrigger()이 아니라 registerWebTrigger()입니다.
      • 이 동작은 시작된 각 WebView에 대해 설정해야 합니다.
      • 광고 기술 SDK가 WebView를 시작하는 경우 SDK는 기본 동작입니다.
      • registerWebSource()를 사용하여 소스를 연결하려는 앱 앱이 아닌 WebView에서 웹사이트에 등록할 때 웹 앱 허용 목록에 추가해야 합니다. 허용 목록에 가입하려면 이 양식을 작성하세요. 이 허용 목록의 목적은 Google과 같은 웹 컨텍스트에 대한 신뢰 구축
    • setAttributionRegistrationBehavior 옵션
    설명 사용 사례 예시
    APP_SOURCE_AND_WEB_TRIGGER(기본값) 앱이 WebView에서 앱 소스(앱 패키지 이름과 연결된 소스) 및 웹 트리거(eTLD+1과 연결된 트리거)를 등록할 수 있도록 허용합니다. WebView를 사용하여 웹 탐색을 사용 설정하기보다 광고를 게재하는 앱
    WEB_SOURCE_AND_WEB_TRIGGER 앱이 WebView에서 웹 소스 및 웹 트리거를 등록하도록 허용합니다. 광고 노출 및 전환이 WebView의 웹사이트에서 모두 발생할 수 있는 WebView 기반 브라우저 앱
    APP_SOURCE_AND_APP_TRIGGER 앱이 WebView에서 앱 소스 및 앱 트리거를 등록하도록 허용합니다. 광고 노출 및 전환이 항상 WebView의 eTLD+1이 아니라 앱과 연결되어야 하는 WebView 기반 앱
    사용 중지됨 WebView에서 소스 및 트리거 등록을 사용 중지합니다.
  4. WebView에서 소스 및 트리거 등록

    • 광고 기술은 Attribution-Reporting-Register-OS-Source 헤더. 설정된 동작 기반 WebView의 경우 registerSource() 또는 registerWebSource()를 호출합니다. Android Attribution에서 보조 API 호출을 시작합니다. Reporting API를 광고 기술 URI에 추가합니다.

      • 소스 등록을 완료하려면 광고 기술의 엔드포인트가 Android Attribution Reporting API 요청에 응답하려면 응답 헤더를 확인합니다.
      Attribution-Reporting-Register-OS-Source {
          "source_event_id":"123001",
          "destination":"android-app://com.example.advertiser",
          ...
      }
      
    • 소스 등록의 나머지 부분은 동일하게 유지됩니다.

  5. 광고 기술은 Attribution-Reporting-Register-OS-Trigger 헤더. 설정된 동작 기반 WebView의 경우 registerTrigger() 또는 registerWebTrigger()를 호출합니다. Rb에서 광고 기술 URI로의 보조 API 호출을 시작합니다.

    • 트리거 등록을 완료하려면 광고 기술의 엔드포인트가 응답으로 Android Attribution Reporting API 요청에 응답 헤더를 클릭하세요.
    Attribution-Reporting-Register-OS-Trigger {
        "event_trigger_data": [{"trigger_data":"1"}],
        "aggregatable_trigger_data": [
            {"key_piece":"0x400","source_keys":["campaignCounts"]},
            {"key_piece":"0xA80","source_keys":["geoValue"]}
        ],
        ...
    }
    
    • 트리거 등록 프로세스의 나머지 부분은 동일하게 유지됩니다.

디버그

앱에서 웹으로의 구현을 설정할 때는 디버그를 설정하고 보고서를 사용하여 소스와 트리거가 올바르게 등록되고 있는지, 등록되지 않은 사용자입니다.

일반적인 기여 분석 보고 디버깅 단계는 디버깅 설명서를 참고하세요.