다음은 타사 앱 추적 솔루션을 사용하여 DoubleClick 구매 측 제품에서 캠페인을 실행하는 데 필요한 광고주 설정과 타사 구현의 전체 과정입니다.
인앱 기여 분석 기능에 대한 개요와 일반적인 DoubleClick 디지털 마케팅에 대한 자세한 내용은 DoubleClick 디지털 마케팅 배경 페이지를 참고하세요.
광고주가 설치 또는 전환을 위해 DDM에서 전환 이벤트를 설정합니다(Bid Manager만 - 전환 픽셀, Campaign Manager - 플러드라이트 활동).
광고주가 타사 인터페이스에서 DDM 전환 이벤트를 '연결'하고 광고주 및 전환 활동 그룹을 식별하는 주요 변수를 제공합니다.
src는 플러드라이트 활동의 소스인 광고주 ID입니다.cat는 활동이 속한 활동 그룹을 플러드라이트 서버에서 식별할 때 사용하는 활동 태그 문자열입니다.type은 플러드라이트 활동이 연결된 활동 그룹을 식별하는 그룹 태그 문자열입니다.u1, u2, ...는 맞춤 플러드라이트 변수 키-값입니다 (사용 가능한 경우).
광고주가 DMA 규정 준수를 위한 동의 수집을 나타내는 변수를 추가합니다.
eea는 EEA 사용자를 식별하는 데 사용됩니다.eea=0는 사용자가 EEA에 거주하지 않음을 나타냅니다.eea=1는 사용자가 EEA에 있음을 나타냅니다.
ad_user_data는 광고 목적으로 사용자 데이터를 사용하는 데 대한 동의 플래그입니다.eea=1이ad_user_data=0는 사용자가 광고 목적으로 사용자 수준 데이터를 Google에 전송하는 데 동의하지 않았음을 나타냅니다.ad_user_data=1는 사용자가 광고 목적으로 사용자 수준 데이터를 Google에 전송하는 데 동의했음을 나타냅니다.
npa은 광고 개인 최적화 콘텐츠에 사용됩니다.npa=0은 사용자가 맞춤설정에 동의했음을 나타냅니다.npa=1는 사용자가 맞춤설정에 동의하지 않았음을 나타냅니다.
test_request_reason=dma를 사용하여 DMA 매개변수를 테스트할 수 있습니다.- 모든 DMA 매개변수의 유효성을 검사하고 경고를 반환합니다.
- 가짜 클릭이 포함된 다중 응답을 반환합니다.
- 전환을 테스트 전환으로 로깅합니다.
또한 광고주가 타사에 특정 승인 토큰을 제공해야 합니다.
token은 각 서버 요청과 함께 DDM에 전달해야 하는 광고주별 영숫자 문자열입니다.DBM이 실시간 입찰 거래소에서 제공하거나 DCM이 직접 구매 미디어에서 제공하는 광고 태그로 광고주가 인앱 광고 캠페인을 운영합니다.
최종 사용자가 광고를 조회하거나 클릭하며, 이 내용이 DDM에 기록됩니다.
최종 사용자가 앱을 설치하거나 '게임 플레이'와 같은 전환 이벤트를 완료하면 서드 파티 서버가 모든 앱 활동에서 DDM을 '핑'합니다.
EEA에 거주하지 않는 사용자의 URL 예
https://ad.doubleclick.net/ddm/s2s/appactivity/src=1234567;cat=fghij456;type=abcde123;u1=[friendlyname1];ord=1312312312;eea=0;npa=0EEA 사용자의 URL 예
https://ad.doubleclick.net/ddm/s2s/appactivity/src=1234567;cat=fghij456;type=abcde123;u1=[friendlyname1];ord=1312312312;eea=1;ad_user_data=1;npa=0각 항목의 의미는 다음과 같습니다.
src는 플러드라이트 활동의 소스인 광고주 ID입니다.cat는 활동이 속한 활동 그룹을 플러드라이트 서버에서 식별할 때 사용하는 활동 태그 문자열입니다.type은 플러드라이트 활동이 연결된 활동 그룹을 식별하는 그룹 태그 문자열입니다.ord는 플러드라이트 태그를 고유하게 만드는 임의의 숫자입니다.u1, u2, ...는 맞춤 플러드라이트 변수 키-값입니다 (사용 가능한 경우).eea는 사용자가 EEA에 있는지 여부를 식별합니다.ad_user_data는 사용자가 쿠키 및 측정에 동의하는지 여부를 식별합니다.npa는 사용자가 맞춤설정에 동의하는지 여부를 식별합니다.
HTTP POST에서 JSON 페이로드를 통해 전송되는 추가 매개변수가 있습니다.
{ "app": { "bundle": "com.rovio.angrybirds" }, "device": { "ua": "Mozilla/5.0 (KHTML, like Gecko) Version/6.0 Mobile/10A5376e Safari/8536.25", "ip": "108.176.57.230", "didmd5": "A2D2DA47AC2DE1BCA16883BD5CAA6F2F", "lmt": 1 } }광고주 인증 토큰은 HTTP 인증 헤더에서 전달됩니다.
Authorization: Token token="[advertiser authorization token string]"각 항목의 의미는 다음과 같습니다.
app(필수)은 전환 활동이 발생한 앱을 나타내는 JSON 객체입니다. 전환 활동이 발생한 앱을 사용할 수 없는 경우app: {}을 사용합니다.bundle은 Play 스토어 번들 이름 또는 App Store ID의 문자열 값을 포함하는 앱 객체 필드입니다 (사용 가능한 경우).device은 전환 활동이 발생한 기기를 나타내는 JSON 객체입니다.ua는 활동이 기록된 앱의 사용자 에이전트 문자열을 나타내는 기기 객체 필드입니다. 이 매개변수는 필수항목입니다.ip는 기기에 할당된 기기 IPv4 주소입니다 (사용 가능한 경우). 이 매개변수는 필수항목입니다.didmd5는 대문자 IDFA 또는 Google Play 광고 ID 값의 MD5 해시 문자열입니다.lmt는 정수이며, 사용자가 IDFA 또는 AdID가 있는 '광고 추적 제한' 옵션을 사용 설정한 경우에는 1이고, 그렇지 않은 경우에는 0입니다.
DDM은 전환 이벤트가 DCM을 통해 발생한 조회 또는 클릭에 기여했는지에 대한 JSON 응답을 이용해 답하며, 답이 '예'인 경우 이벤트에 대한 추가 정보 (마지막 조회 또는 클릭)를 제공합니다.
- 광고 ID
- 사이트 ID
- 게재위치 ID
- 광고 소재 ID
- 타임스탬프
JSON 응답의 예는 다음과 같습니다.
{ "attributed": 1, // Whether the conversion can be attributed to a DCM event. "last_impression_ad_id":283641088, "last_impression_site_id":1408067, "last_impression_placement_id":107616368, "last_impression_creative_id":60162352, "last_impression_timestamp":1415647607, "last_click_ad_id":283641088, "last_click_site_id":1408067, "last_click_placement_id":107616368, "last_click_creative_id":60162352, "last_click_timestamp":1415647657, "last_click_exclid":"CKm0nLKhyssCFceH2wod8l4I4A", "cps": <cps>, "ad_events": [ <ad event objects> ], "warnings": [<warning strings>], "errors": [<error strings>], }각 항목의 의미는 다음과 같습니다.
attributed의 값은 1 (전환이 노출 또는 클릭에 기여할 수 있는 경우) 또는 0 (기여할 수 없는 경우)입니다.last_impression_ad_id는 attributed가 1인 경우 마지막 노출의 광고 ID입니다.last_impression_site_id는 attributed가 1인 경우 마지막 노출의 사이트 ID입니다.last_impression_placement_id는 attributed가 1인 경우 마지막 노출의 게재위치 ID입니다.last_impression_creative_id는 attributed가 1인 경우 마지막 노출의 광고 소재 ID입니다.last_click_ad_id는 attributed가 1이고 클릭에 기여한 요소가 있는 경우 마지막 클릭의 광고 ID입니다.last_click_site_id는 attributed가 1이고 클릭에 기여한 요소가 있는 경우 마지막 클릭의 사이트 ID입니다.last_click_placement_id는 attributed가 1이고 클릭에 기여한 요소가 있는 경우 마지막 클릭의 게재위치 ID입니다.last_click_creative_id는 attributed가 1이고 클릭에 기여한 요소가 있는 경우 마지막 클릭의 광고 소재 ID입니다.last_click_exclid는%eiid!매크로를 사용하여 입력되는 고유한 클릭 ID에 해당합니다.
2024년 3월 DMA 시행부터 다음 필드도 사용할 수 있습니다.
cps는 이벤트가 속한 핵심 플랫폼 서비스를 나타냅니다.a: 광고m: 지도p: Play 스토어s: 검색h: 쇼핑y: YouTube
ad_events는 모든 전환 이벤트가 포함된ad_event객체의 배열입니다.ad_event객체에는 다음 필드가 포함됩니다.product_type는 전환을 담당하는 제품을 보고하는 문자열입니다.DCM또는DBM이 됩니다.interaction_type은 이벤트로 이어진 상호작용 유형입니다.impression또는click입니다.conversion_metric은 기여에 사용된 전환 측정항목입니다.conversion또는view_through_conversion입니다.timestamp은 광고 이벤트가 발생한 UNIX 타임스탬프로, 정밀도는 마이크로초입니다. 이 값은 마지막 클릭 기여에 사용해야 합니다.campaign_type은 광고 이벤트를 생성한 캠페인 유형을 식별합니다.line_item_id(DBM만 해당)은 광고 이벤트를 생성한 DBM 광고 항목 ID입니다.line_item_name(DBM만 해당)은 광고 이벤트를 생성한 DBM 광고 항목의 이름입니다.placement_id(DCM만 해당)은 광고 이벤트를 생성한 DCM 게재위치 태그 ID입니다.placement_name(DCM만 해당)은 광고 이벤트를 생성한 DCM 게재위치 태그의 이름입니다.external_customer_id는 광고 이벤트를 생성한 캠페인을 소유한 광고주 식별자입니다.product이 DBM인 경우 이 필드는 DBM 광고주 ID를 나타냅니다.product이 DCM인 경우 이 필드는 DCM 광고주 ID를 나타냅니다.
creative_id는 광고 이벤트를 생성한 광고 소재 광고 단위의 ID입니다.product이 DBM인 경우 이 필드는 DBM 광고 소재 ID를 나타냅니다.product이 DCM인 경우 이 필드는 DCM 광고 소재 ID를 나타냅니다.
exchange_id(DBM만 해당)은 DBM 광고를 게재한 거래소의 ID입니다.insertion_order_id(DBM만 해당)는 DBM 게재 신청서 ID입니다.site_id(DCM만 해당)은 광고 이벤트의 DCM 사이트 ID입니다.cps는 광고 이벤트가 속한 핵심 플랫폼 서비스를 나타냅니다. 자세한 내용은 문서 앞부분의cps필드에 관한 전체 설명을 참고하세요.
warnings는 전환 이벤트에서 생성된 경고의 배열입니다.errors는 다음 시나리오에서 HTTP 오류 코드가 있는 전환 이벤트로 생성된 오류의 배열입니다.HTTP 204: 요청 할당량을 초과한 경우- 요청이 잘못된 것으로 간주되는 경우(예: 필수 매개변수가 누락되고 서버가 픽셀 추적으로 대체된 경우)
HTTP 400 HTTP 401: 인증 토큰이 유효하지 않은 경우HTTP 404: 요청이 잘못된 경우
광고주는 시스템에서 캠페인 보고서를 볼 수 있습니다. 또한 동일한 매개변수를 사용하여 DCM에서 전환 보고서를 확인할 수도 있습니다.
2024년 3월 DMA 시행 후 추가 응답 예시
전환이 Google 검색 및 YouTube 광고 상호작용 모두에 기여한 것으로 간주되지만 Google 검색 및 YouTube CPS 간에 5(2)(b) + 5(2)(c) 교차 사용 동의가 거부된 기여 전환 추적 응답의 예는 다음과 같습니다.
{ attributed: 1, last_impression_ad_id: 283641088, last_impression_site_id: 1408067, last_impression_placement_id: 107616368, last_impression_creative_id: 60162352, last_impression_timestamp: 1415647607, last_click_ad_id: 283641088, last_click_site_id: 1408067, last_click_placement_id: 107616368, last_click_creative_id: 60162352, last_click_timestamp: 1415647655, last_click_exclid: "CKm0nLKhyssCFceH2wod8l4I4A", cps: "s", ad_events: [{ cps : "s", product_type: "DCM", interaction_type: "click", ad_event_type: "click", campaign_type: "Display", placement_id: 107616368, placement_name: "TEST PLACEMENT NAME", external_customer_id: 7480542, creative_id: 60162352, timestamp: 1415647655.123456, site_id: 1408067, }, { cps : "s", product_type:"DCM", interaction_type: "impression", ad_event_type: "impression", campaign_type: "Display", placement_id: 107616368, placement_name: "TEST PLACEMENT NAME", external_customer_id: 7480542, creative_id: 60162352, timestamp: 1415647607.123456, site_id: 1408067 },{ cps : "y", product_type: "DCM", ad_event_type: "click", campaign_type: "Display", placement_id: 107616370, placement_name: "Placement on Youtube", external_customer_id: 7480542, creative_id: 6016444, timestamp: 14344344.123456, site_id: 140806 }, ]}DBM 캠페인에 대한 긍정적인 전환추적 응답의 예:
{ attributed: 1, last_click_ad_id: 283641088, last_click_site_id: 1408067, last_click_placement_id: 107616368, last_click_creative_id :60162352, last_click_timestamp: 1415647655, last_click_exclid: "CKm0nLKhyssCFceH2wod8l4I4A" cps: "y", ad_events: [{ product_type: "DBM", interaction_type: "click", ad_event_type: "click", campaign_type: "Display", line_item_id: 123456789, line_item_name: "TEST LINE ITEM NAME", external_customer_id: 2550, creative_id: 512333, exchange_id: 132, insertion_order_id: 523423, timestamp: 1432681913.123456 cps: "y" }, { product_type: "DCM", interaction_type: "click", campaign_type: "Display", placement_id: 9342323, placement_name: "TEST PLACEMENT NAME", external_customer_id: 7480542, creative_id: 8234234, timestamp: 1432681913.123456, cps: "y" } ]}