# 설치 유입 정보 활용하기 설치에 기여한 광고를 확인하고, 광고에서 전달한 내용을 개인화에 활용하는 방법을 설명합니다. Source: https://cue.airbridge.io/docs/ko/guides/install-touchpoint Language: ko Updated: 2026-10-15 설치 유입 정보는 앱 사용자의 광고 유입 맥락을 파악하는 데 활용합니다. 사용자가 어떤 광고를 통해 유입됐는지 이해하면 광고에서 전달한 내용을 앱 화면이나 메시지로 이어서 안내할 수 있습니다. ## 설치 유입 정보가 알려주는 것 Context API 응답의 `context.lastTouchpoint`에는 사용자에게 연결된 광고 기여 정보가 담겨 있습니다. 채널은 광고를 운영한 매체를, 캠페인과 광고 그룹은 광고의 운영 구성을, 소재와 키워드는 개별 광고의 내용과 설정을 파악하는 데 활용할 수 있습니다. 광고 기여 정보를 운영 중인 광고와 연결하면 사용자에게 어떤 내용을 이어서 안내할지 정할 수 있습니다. 광고 기여 정보를 앱에 활용하는 흐름 광고 서비스와 콘텐츠 소개 광고에서 사용자에게 메시지를 전달합니다. 광고 기여 정보 사용자와 연결된 광고 확인 CUE가 채널과 캠페인 등의 정보를 제공합니다. 앱에서 활용 화면과 메시지에 적용 광고의 내용에 맞춰 앱에서 안내할 내용을 구성합니다. ## 광고에서 안내한 내용을 개인화로 이어가기 응답의 캠페인이나 소재 이름을 운영 중인 광고와 대조하면, 앱 사용자에게 어떤 내용을 이어서 안내할지 정할 수 있습니다. 예를 들어 `campaign`이 `promotion_A`라면 해당 캠페인의 프로모션을 앱 첫 화면이나 CRM 메시지에서 안내할 수 있습니다. 같은 캠페인이라도 `adCreative`별로 소개한 상품이 다르다면, 소재에 맞춰 상품을 안내할 수도 있습니다. 캠페인, 광고 그룹과 소재는 아래와 같이 광고를 구분하는 범위가 다릅니다. 반환된 이름이 어떤 프로모션이나 상품을 뜻하는지는 실제 광고 설정에서 확인할 수 있습니다. CUE는 이 이름으로 개인화 규칙을 자동 생성하지 않으므로, 서비스에서 각 값에 적용할 동작을 정해야 합니다. 캠페인에서 광고 소재로 이어지는 구성 캠페인 광고의 목적과 주제 광고 그룹 대상과 운영 설정 광고 소재 실제로 전달한 메시지와 표현 프로모션 전체를 안내하려면 캠페인 정보로 충분할 수 있습니다. 광고에서 소개한 상품까지 맞춰 안내하려면 해당 소재의 정보도 필요합니다. 개인화할 내용에 따라 어느 범위의 정보를 사용할지 고를 수 있습니다. ## 활용 목적에 맞는 정보 고르기 활용할 정보는 화면이나 메시지를 어떤 기준으로 구분할지에 따라 정해야 합니다. 캠페인에 공통으로 적용할 내용에는 캠페인을, 개별 광고의 내용에 맞춰 달리 안내할 때는 소재를 사용할 수 있습니다. * 캠페인(`campaign`)은 같은 목적이나 주제로 운영한 광고를 통해 유입된 사용자를 묶는 데 활용할 수 있습니다. 캠페인 전체에 공통으로 안내할 내용을 정할 때 사용합니다. * 광고 그룹(`adGroup`)은 같은 캠페인 안에서 광고를 나눠 운영한 기준을 반영합니다. 그룹마다 대상이나 안내 내용이 다르다면 그룹을 기준으로 앱 화면이나 메시지를 구분할 수 있습니다. * 광고 소재(`adCreative`)는 개별 광고에서 전달한 메시지와 표현을 구분하는 데 활용할 수 있습니다. 소재의 내용에 맞춰 이어서 보여줄 콘텐츠를 정할 때 사용합니다. * 채널(`channel`)은 광고를 운영한 매체를 구분하는 데 활용할 수 있습니다. 매체별로 안내할 내용을 달리할 때 사용합니다. * 키워드(`term`)는 광고에 설정한 키워드를 구분하는 데 활용할 수 있습니다. 반환된 값을 광고 설정과 연결해 키워드별로 안내할 내용을 정할 수 있습니다. 선택한 광고 정보에 구매 등급이나 이탈 등급을 더해 대상을 구체화할 수도 있습니다. 광고 정보와 예측값을 조합해 개인화 규칙을 구성하는 방법은 [Context 활용하기](/docs/ko/guides/using-context#설치에-기여한-광고-정보도-활용합니다)에서 확인할 수 있습니다. ## 확인할 수 있는 정보에 맞춰 활용하기 개인화 조건을 적용하려면 그 조건에 필요한 광고 정보가 응답에 있어야 합니다. 캠페인을 사용하는 규칙과 소재를 사용하는 규칙은 필요한 정보가 다릅니다. * 캠페인이 확인되면 소재 정보가 없어도 캠페인에 공통으로 적용하는 화면이나 메시지를 제공할 수 있습니다. * 캠페인과 소재가 모두 확인되면 같은 캠페인 안에서도 소재별로 다른 콘텐츠를 안내할 수 있습니다. * 채널만 확인되면 매체를 기준으로 안내할 내용을 정할 수 있습니다. 특정 캠페인이나 소재를 구분하는 규칙에는 해당 정보가 필요합니다. 조건에 필요한 정보를 얻지 못했을 때 제공할 기본 화면이나 메시지도 함께 정해야 합니다. ## 응답 사례 비교 아래는 `context.lastTouchpoint` 부분만 발췌한 예시입니다. 사례를 선택하면 광고 정보가 어디까지 제공되는지, 앱이나 CRM에서 어떤 규칙을 적용할 수 있는지 비교할 수 있습니다. 제한된 값이 나타나는 필드와 나머지 필드의 값은 실제 응답에 따라 달라집니다. 응답에 따라 확인할 수 있는 광고 정보 값이 있는 필드, null인 필드와 제한된 문자열을 구분해 살펴볼 수 있습니다. 광고 정보 제공 5개 필드의 값을 확인할 수 있습니다. 각 값을 운영 중인 광고와 대조해 캠페인부터 소재와 키워드까지 구분할 수 있습니다. channel media_A 확인 가능 campaign promotion_A 확인 가능 adGroup ad_group_A 확인 가능 adCreative creative_A 확인 가능 term keyword_A 확인 가능 앱이나 CRM에서 활용하기 앱이나 CRM에서 캠페인 또는 소재를 기준으로 개인화 규칙을 적용할 수 있습니다. 응답 JSON 확인하기 ```json lineNumbers { "context": { "lastTouchpoint": { "channel": "media_A", "campaign": "promotion_A", "adGroup": "ad_group_A", "adCreative": "creative_A", "term": "keyword_A" } } } ``` 객체 전체 null 설치 기여 결과가 없습니다. 조회에는 성공했지만 설치 기여 결과가 없는 사례입니다. `context.lastTouchpoint` = `null` 이 응답에는 channel, campaign 등 개별 필드가 없습니다. 앱이나 CRM에서 활용하기 앱이나 CRM에서 광고 정보를 사용하는 규칙은 건너뛰고 기본 화면이나 메시지를 제공합니다. 사용 가능한 예측값이 있다면 예측값만 사용하는 규칙은 별도로 적용할 수 있습니다. 응답 JSON 확인하기 ```json lineNumbers { "context": { "lastTouchpoint": null } } ``` 일부 필드 null 채널과 캠페인만 확인할 수 있습니다. 채널과 캠페인은 확인할 수 있지만, 광고 그룹과 소재, 키워드 등 세부 정보는 수집되지 않아 확인할 수 없는 사례입니다. channel media_A 확인 가능 campaign promotion_A 확인 가능 adGroup null 값 없음 adCreative null 값 없음 term null 값 없음 앱이나 CRM에서 활용하기 캠페인에 공통으로 적용하는 화면이나 메시지는 제공할 수 있습니다. 소재별로 다른 콘텐츠를 안내하는 규칙은 건너뛰고 해당 부분의 기본 동작을 유지합니다. 응답 JSON 확인하기 ```json lineNumbers { "context": { "lastTouchpoint": { "channel": "media_A", "campaign": "promotion_A", "adGroup": null, "adCreative": null, "term": null } } } ``` restricted 채널 이름 대신 restricted가 반환됐습니다. 광고 채널의 개인정보 보호 정책에 따라 광고 정보가 마스킹된 사례입니다. 채널 이름은 `restricted`로 표시되며, 캠페인 등의 세부 정보는 제공되지 않습니다. 관련 정책은 에어브릿지의 [메타 애즈 데이터 공유 정책](https://help.airbridge.io/ko/guides/meta-business-channel-integration#-7)에서 확인할 수 있습니다. channel restricted 제공 제한 campaign null 값 없음 adGroup null 값 없음 adCreative null 값 없음 term null 값 없음 앱이나 CRM에서 활용하기 이 값을 특정 광고 채널 이름이나 자연 유입으로 해석하지 않아야 합니다. 실제 광고 정보가 필요한 규칙은 건너뛰고, 사용 가능한 다른 정보의 규칙이나 기본 동작을 적용합니다. 응답 JSON 확인하기 ```json lineNumbers { "context": { "lastTouchpoint": { "channel": "restricted", "campaign": null, "adGroup": null, "adCreative": null, "term": null } } } ``` unattributed 채널 이름 대신 unattributed가 반환됐습니다. 설치가 특정 광고 채널에 기여되지 않은 결과로 표시된 사례입니다. channel unattributed 미기여 campaign null 값 없음 adGroup null 값 없음 adCreative null 값 없음 term null 값 없음 앱이나 CRM에서 활용하기 기여된 광고 채널을 기준으로 하는 규칙은 건너뛰고, 확인할 수 있는 다른 정보로 규칙을 적용하거나 기본 동작을 유지합니다. 응답 JSON 확인하기 ```json lineNumbers { "context": { "lastTouchpoint": { "channel": "unattributed", "campaign": null, "adGroup": null, "adCreative": null, "term": null } } } ``` 이 사례에서 사용한 필드의 정의와 응답 규격은 [Context API](/docs/ko/reference/context-api#response-body)에서 확인할 수 있습니다. 이 사례들은 API 조회에 성공한 응답을 설명합니다. API 오류로 조회에 실패한 경우에는 기본 동작을 유지해야 하며, 오류를 `lastTouchpoint: null`로 바꿔 해석하지 않아야 합니다. 오류별 처리는 [오류 처리](/docs/ko/reference/errors)에서 확인할 수 있습니다. 연동 후에는 [시작하기의 응답 확인](/docs/ko/quickstart#응답-확인하기)에 따라 응답의 광고 기여 정보가 테스트에서 예상한 기여 결과와 일치하는지 확인해야 합니다.