OneLinkUrlGenerator v1

개요

OneLinkUrlGenerator는 브랜드 웹사이트의 버튼이나 배너에 연결되는 링크를 자동으로 생성하고 포함합니다.

공용 생성자

OneLinkUrlGenerator

입력 인수

유형	파라미터	설명
문자열	neLinkURL[필수]	- 스크립트가 생성한 모든 링크의 기초 역할을 합니다. - 원링크 템플릿 도메인 + 템플릿 ID입니다.
문자열 목록	pidKeysList	- 발신 URL에서 pid 파라미터로 배치될 수신 URL의 미디어 소스 파라미터를 나열합니다. - 수신 링크에 여러 미디어 소스 파라미터가 있는 경우(예: af_pid 및 utm_source), pidKeysList는 파라미터를 처음부터 끝까지 스캔하고 발견된 첫 번째 일치 항목을 사용합니다.
dictionary {string: string, …}	pidOverrideList	대체할 미디어소스 값과 함께 미디어소스 값을 수신 URL에 나열합니다.
문자열	pidStaticValue	pidKeysList에서 pid 키를 찾을 수 없는 경우 pidStaticValue가 pid 값으로 사용됩니다.
문자열 목록	campaignKeysList	발신 URL에서 c 파라미터로 배치될 수신 URL의 캠페인 파라미터를 나열합니다.
문자열	campaignStaticValue	campaignKeysList에서 캠페인 키를 찾을 수 없는 경우 campaignStaticValue가 c 값으로 사용됩니다.
문자열	gclIdParam	- 발신 URL의 어떤 파라미터가 GCLID를 전달하는지 정의합니다. - 임의의 파라미터를 선택할 수 있습니다. 일러두기! 앱스플라이어 로데이터 리포트를 표시하려면 파라미터가 af_sub[1-5] 중 하나여야 합니다.
문자열	skipList	건너뛰기 목록의 문자열이 HTTP 리퍼러에 나타나면 스마트 스크립트가 실행되지 않고 반환합니다. `null`.

사용법 예시

const onelinkGenerator =  new window.AF.OneLinkUrlGenerator(
        {oneLinkURL: "https://engmntqa.onelink.me/LtRd/",
         pidKeysList: ['incoming_media_source'],
         pidStaticValue: 'my_static_pid',
         campaignKeysList: ['incoming_campaign'],
         campaignStaticValue: 'my_static_cmpn',
      });

공용 메서드

generateUrl

개요

이 함수는 위에서 설명한 공용 생성자와 아래에 설명된 세터 함수를 기반으로 URL을 생성합니다.

입력 인수

N/A

반환 값

유형	설명
문자열	생성된 URL `OneLinkUrlGenerator`

사용법 예시

const url = onelinkGenerator.generateUrl();

setDeepLinkValue

입력 인수

유형	파라미터	설명	필수
문자열	deepLinkValueParam	스크립트가 딥 링크 값을 사용하여 발신 URL에 설정하는 수신 URL의 키입니다. `deep_link_value`.	true
문자열	deepLinkValue	수신 URL에서 찾을 수 없는 `deep_link_value` 경우 `deepLinkValueParam` 발신 URL에 설정할 대체 값입니다.	False

반환 값

void

사용법 예시

const onelinkGenerator =  new window.AF.OneLinkUrlGenerator(
        {oneLinkURL: "https://engmntqa.onelink.me/LtRd/",
         pidKeysList: ['incoming_media_source'],
         campaignKeysList: ['incoming_campaign']
      });
onelinkGenerator.setDeepLinkValue("original_url_deeplinkvalue", "yessss");
const url = onelinkGenerator.generateUrl();

setChannel

입력 인수

유형	파라미터	설명	필수
문자열	channelParam	스크립트가 딥 링크 값을 사용하여 발신 URL에 설정하는 수신 URL의 키입니다. `af_channel`.	true
문자열	channelValue	수신 URL에서 찾을 수 없는 `af_channel` 경우 `channelParam` 발신 URL에 설정할 대체 값입니다.	False

반환 값

void

사용법 예시

const onelinkGenerator =  new window.AF.OneLinkUrlGenerator(
        {oneLinkURL: "https://engmntqa.onelink.me/LtRd/",
         pidKeysList: ['incoming_media_source'],
         campaignKeysList: ['incoming_campaign']
      });
onelinkGenerator.setChannel("original_url_channel", "new_channel");
const url = onelinkGenerator.generateUrl();

setAdset

입력 인수

유형	파라미터	설명	필수
문자열	adsetParam	스크립트가 딥 링크 값을 사용하여 발신 URL에 설정하는 수신 URL의 키입니다. `af_adset`.	true
문자열	adsetValue	수신 URL에서 찾을 수 없는 `af_adset` 경우 `adsetParam` 발신 URL에 설정할 대체 값입니다.	False

반환 값

void

사용법 예시

const onelinkGenerator =  new window.AF.OneLinkUrlGenerator(
        {oneLinkURL: "https://engmntqa.onelink.me/LtRd/",
         pidKeysList: ['incoming_media_source'],
         campaignKeysList: ['incoming_campaign']
      });

onelinkGenerator.setAdset("no_adset", "adset");
const url = onelinkGenerator.generateUrl();

setAd

입력 인수

유형	파라미터	설명	필수
문자열	adParam	스크립트가 딥 링크 값을 사용하여 발신 URL에 설정하는 수신 URL의 키입니다. `af_ad`.	true
문자열	adValue	수신 URL에서 찾을 수 없는 `af_ad` 경우 `adParam` 발신 URL에 설정할 대체 값입니다.	False

반환 값

void

사용법 예시

const onelinkGenerator =  new window.AF.OneLinkUrlGenerator(
        {oneLinkURL: "https://engmntqa.onelink.me/LtRd/",
         pidKeysList: ['incoming_media_source'],
         campaignKeysList: ['incoming_campaign']
      });

onelinkGenerator.setAd("original_url_ad", "new_ad");
const url = onelinkGenerator.generateUrl();

setAfSub1

입력 인수

유형	파라미터	설명	필수
문자열	afSub1Param	스크립트가 딥 링크 값을 사용하여 발신 URL에 설정하는 수신 URL의 키입니다. `af_sub1`.	true
문자열	afSub1Value	수신 URL에서 찾을 수 없는 `af_sub1` 경우 `afSub1Param` 발신 URL에 설정할 대체 값입니다.	False

반환 값

void

사용법 예시

const onelinkGenerator =  new window.AF.OneLinkUrlGenerator(
        {oneLinkURL: "https://engmntqa.onelink.me/LtRd/",
         pidKeysList: ['incoming_media_source'],
         campaignKeysList: ['incoming_campaign']
      });

onelinkGenerator.setAfSub1("original_url_sub1", "ram_afsub1");
const url = onelinkGenerator.generateUrl();

setAfSub2

입력 인수

유형	파라미터	설명	필수
문자열	afSub2Param	스크립트가 딥 링크 값을 사용하여 발신 URL에 설정하는 수신 URL의 키입니다. `af_sub2`.	true
문자열	afSub2Value	수신 URL에서 찾을 수 없는 `af_sub2` 경우 `afSub2Param` 발신 URL에 설정할 대체 값입니다.	False

반환 값

void

사용법 예시

const onelinkGenerator =  new window.AF.OneLinkUrlGenerator(
        {oneLinkURL: "https://engmntqa.onelink.me/LtRd/",
         pidKeysList: ['incoming_media_source'],
         campaignKeysList: ['incoming_campaign']
      });

onelinkGenerator.setAfSub2("original_url_sub2","fallback_sub2");
const url = onelinkGenerator.generateUrl();

setAfSub3

입력 인수

유형	파라미터	설명	필수
문자열	afSub3Param	스크립트가 딥 링크 값을 사용하여 발신 URL에 설정하는 수신 URL의 키입니다. `af_sub3`.	true
문자열	afSub3Value	수신 URL에서 찾을 수 없는 `af_sub3` 경우 `afSub3Param` 발신 URL에 설정할 대체 값입니다.	False

반환 값

void

사용법 예시

const onelinkGenerator =  new window.AF.OneLinkUrlGenerator(
        {oneLinkURL: "https://engmntqa.onelink.me/LtRd/",
         pidKeysList: ['incoming_media_source'],
         campaignKeysList: ['incoming_campaign']
      });

onelinkGenerator.setAfSub3("original_sub3", "new_afsub3");
const url = onelinkGenerator.generateUrl();

setAfSub4

입력 인수

유형	파라미터	설명	필수
문자열	afSub4Param	스크립트가 딥 링크 값을 사용하여 발신 URL에 설정하는 수신 URL의 키입니다. `af_sub4`.	true
문자열	afSub4Value	수신 URL에서 찾을 수 없는 `af_sub4` 경우 `afSub4Param` 발신 URL에 설정할 대체 값입니다.	False

반환 값

void

사용법 예시

const onelinkGenerator =  new window.AF.OneLinkUrlGenerator(
        {oneLinkURL: "https://engmntqa.onelink.me/LtRd/",
         pidKeysList: ['incoming_media_source'],
         campaignKeysList: ['incoming_campaign']
      });
onelinkGenerator.setAfSub3("orignial_sub4", "fallback_afsub4");
const url = onelinkGenerator.generateUrl();

setAfSub5

입력 인수

유형	파라미터	설명	필수
문자열	afSub5Param	스크립트가 딥 링크 값을 사용하여 발신 URL에 설정하는 수신 URL의 키입니다. `af_sub5`.	true
문자열	afSub5Value	수신 URL에서 찾을 수 없는 `af_sub5` 경우 `afSub5Param` 발신 URL에 설정할 대체 값입니다.	False

반환 값

void

사용법 예시

const onelinkGenerator =  new window.AF.OneLinkUrlGenerator(
        {oneLinkURL: "https://engmntqa.onelink.me/LtRd/",
         pidKeysList: ['incoming_media_source'],
         campaignKeysList: ['incoming_campaign']
      });
onelinkGenerator.setAfSub5("neverfind_sub5", "new_afsub5");
const url = onelinkGenerator.generateUrl();

setCustomParameter

입력 인수

유형	파라미터	설명	필수
문자열	searchKey	스크립트가 발신 URL에 설정할 값을 가져오는 수신 URL의 키 `customKey`	true
문자열	customKey	찾은 값을 배치할 발신 원링크 URL의 키 `searchKey`	true
문자열	customValue	수신 URL에서 찾을 수 없는 `customKey` 경우 `searchKey` 발신 URL에 설정할 대체 값입니다.	False

반환 값

void

사용법 예시

const onelinkGenerator =  new window.AF.OneLinkUrlGenerator(
        {oneLinkURL: "https://engmntqa.onelink.me/LtRd/",
         pidKeysList: ['incoming_media_source'],
         campaignKeysList: ['incoming_campaign']
      });
onelinkGenerator.setCustomParameter("search_key_on_url", "onelink_custom_param", "fallback_value");
const url = onelinkGenerator.generateUrl();