몰로코는 모든 트래킹 링크 등록 과정에서 그 유효성을 확인하여 문제가 발생할 가능성을 차단하고자 합니다. 이 가이드에서는 몰로코 애즈에서 트래킹 링크를 등록할 때 발생할 수 있는 다양한 오류를 안내합니다. 

유효하지 않은 링크

• 트래킹 링크를 올바르게 구문 분석할 수 없는 경우에 표시되는 오류 메시지입니다. 몰로코에서 제공하는 매크로 값만 사용할 수 있습니다. 트래킹 링크에 유효하지 않은 매크로 값이 하나 이상 있는 경우 다음과 같은 오류 메시지가 표시됩니다.

  https://app.appsflyer.com/com.appsflyer.adNetworkTest ?
  af_sub4={{mtid}} 
  &c={{campaign.title}} 
  &af_siteid={{af_site_id}}// NOT SUPPORTED BY MOLOCO
  &af_ad_type={{creative.type}} 
  &af_cost_currency={{price.cost_currency}} 
  &af_cost_value={{price.cost_amount}} 
  &af_ad_id={{creative.cr_id}}
  &af_cost_model={{price.cost_type}} 
  &af_ad={{creative.title}} 
  &pid=moloco_int 
  &af_click_lookback=7d 
  &clickid={{request.id}} 
  &advertising_id={{device.gaid}} 
  &af_c_id={{campaign.id}} 
  &af_ip={{device.ip}} 
  &af_ua={{device.user_agent}}

• 이 예시에서 {{af_site_id}}는 사용할 수 있는 매크로 값이 아닙니다. 따라서 이를 사용 가능한 매크로 값이나 하드코딩된 값으로 변경해야 합니다.
• MMP 담당자에게 문의해서 트래킹 링크에 누락되거나 유효하지 않은 값이 존재하지 않는지 트래킹 링크를 한 번 더 확인하는 것이 좋습니다.

유효하지 않은 스킴

• URL 스킴이 유효하지 않은 경우에 표시되는 오류 메시지입니다. URL 스킴은 URL의 가장 앞부분에 위치하며 그 뒤에는 ://가 붙습니다. 
• 예를 들어 http는 유효하지 않은 URL 스킴입니다. http로 시작하는 트래킹 링크를 등록하는 경우 다음과 같은 메시지가 표시됩니다. Use ‘https’ instead of ‘http’ in the URL
• 이 문제를 해결하려면 유효하지 않은 URL 스킴을 올바른 스킴으로 변경해야 합니다.

유효하지 않은 호스트

• 선택한 트래킹 업체와 URL의 호스트가 일치하지 않는 경우에 표시되는 오류 메시지입니다. URL 호스트는 :// 뒤에 오는 도메인 값입니다.
• 각 MMP는 트래킹 링크 호스트에 대해 고유 값 또는 로직을 보유합니다. 예를 들어 앱스플라이어 트래킹 링크는 Onelink™를 제외하면 일반적으로 app.appsflyer.com을 호스트로 합니다. 앱스플라이어를 트래킹 업체로 선택했으나 https://app.adjust.com/ 호스트를 사용해 트래킹 링크를 설정한 경우 이 오류가 발생합니다.
• 올바른 트래킹 업체를 선택했는지, 오탈자는 없는지 다시 검토합니다.

유효하지 않은 경로

• 트래킹 링크에 인식할 수 없는 경로 값이 존재하는 경우에 표시되는 오류 메시지입니다. 경로는 호스트 값 뒤에 오는 값이며, 일반적으로 앱에 관한 정보를 포함하고 있습니다.
• 이미지에서와 같이 앱스플라이어 트래킹 링크에는 앱의 구글 플레이 스토어 번들 ID가 포함되어 있습니다. 여기에 1111과 같은 예상치 못한 값이 포함되어 있는 경우 이 오류 메시지가 표시됩니다.
• MMP 담당자에게 문의해서 경로 값이 정확한지 확인하세요.

필수 파라미터 누락

• 트래킹 링크에 필수 파라미터가 하나 이상 누락되는 경우에 표시되는 오류 메시지입니다. 파라미터는 트래킹 링크에서 ? 뒤에 표시됩니다. 아래 예시와 같이 key=value 쌍이 &로 나누어져 있습니다. Key는 MMP의 파라미터로, MMP의 리포트에 표시되는 열 이름이기도 합니다. 
  
  
  
• 어트리뷰션을 수행하려면 트래킹 링크에 모든 필수 파라미터가 존재해야 합니다. Add all missing parameters를 클릭하여 모든 필수 파라미터를 자동으로 추가하세요. 

유효하지 않은 파라미터

• • 각 파라미터와 쌍을 맺는 값이 하나 이상 유효하지 않은 경우에 표시되는 오류입니다. 트래킹 링크 파라미터와 쌍을 맺는 값은 사용 가능한 매크로 값 또는 하드코딩된 값이어야 합니다. 매크로 값은 자리 표시자로, 캠페인 ID, 소재 이름 등의 실질적인 값으로 동적으로 대체됩니다. 

오류 메시지에 해결 방법이 함께 표시됩니다. 오류 메시지에 다수의 해결 방법이 제시되어 있는 경우 이 섹션에서 사용 가능한 매크로 값과 MMP 파라미터 전체 목록을 확인하세요.

• 이 파라미터의 값이 유효하지 않습니다. 다음 중 하나와 같아야 합니다(또는 다음 중 하나를 포함해야 합니다).
  • [해결 방법 1]
  • [해결 방법 2]
  • [해결 방법 3]
• 이 파라미터의 값이 유효하지 않습니다. 다음과 같아야 합니다. {{macro_value}}

중복된 파라미터

• 동일한 파라미터가 두 개 이상 존재하는 경우에 표시되는 오류 메시지입니다. 예를 들어 트래킹 링크에는 pid 파라미터가 단 하나만 있어야 합니다.

[앱스플라이어만 해당] 잘못된 앱 ID

• 트래킹 링크의 app_id 값은 연결된 앱의 MMP 번들 ID와 일치해야 합니다. 두 값이 일치하는지 다시 검토합니다. 

[앱스플라이어 에이전시 고객만 해당] 필수 값 누락 

• 앱스플라이어의 자체 에이전시 대시보드를 통해 몰로코와 협력하는 에이전시 고객은 몰로코에서 승인한 유효한 값을 포함한 af_prt 파라미터가 트래킹 링크에 있어야 합니다. 앱스플라이어의 에이전시 ID를 af_prt 파라미터 값으로 입력하세요. 

[앱스플라이어 에이전시 고객만 해당] 비승인 에이전시 

• 앱스플라이어의 자체 에이전시 대시보드를 통해 몰로코와 협력하는 에이전시 고객은 몰로코에서 승인한 유효한 값을 포함한 af_prt 파라미터가 트래킹 링크에 있어야 합니다. 몰로코 담당자에게 연락하여 몰로코 허용 목록에 추가할 파라미터의 값을 알려 주시기 바랍니다. 

[애드저스트만 해당] 앱의 호스트 값 누락

• 앱 등록 단계에서 범용 링크 및 브랜디드 트래킹 링크의 호스트 값을 등록해야 합니다. 우선 Apps로 이동하고 Create를 클릭하여 새 앱을 등록합니다. New App 페이지에서 MMP를 애드저스트로 선택하면 Universal link host와 Branded link host가 표시되며, 여기에 범용 링크와 브랜디드 링크의 호스트 값을 각각 입력할 수 있습니다.

[애드저스트만 해당] 잘못된 호스트 값

범용 또는 브랜디드 트래킹 링크의 호스트 값은 연결된 앱에 등록된 호스트 값과 일치해야 합니다. 두 값이 일치하는지 다시 검토합니다.