리마케팅 잠재고객 개발자 가이드

이 문서에서는 Management API를 사용하여 Google 애널리틱스 리마케팅 잠재고객을 관리하는 방법을 설명합니다.

소개

Management API를 사용하면 Google 애널리틱스 속성에 대해 리마케팅 잠재고객을 create, get, delete, list, update, patch할 수 있습니다. 리마케팅 잠재고객의 작동 방식에 대해 자세히 알아보려면 애널리틱스의 리마케팅 잠재고객에 대한 정보 고객센터 도움말을 참고하세요.

사용 사례

리마케팅 잠재고객 리소스는 get, delete, list, patch 및 update를 지원하지만 주요 사용 사례는 다음과 같습니다.

리마케팅 잠재고객 나열

속성의 모든 리마케팅 잠재고객을 표시하려면 다음 단계를 따르세요.

  1. Management API 또는 계정 탐색기를 사용하여 accountId 및 webPropertyId를 검색합니다.
  2. 리마케팅 잠재고객 리소스의 list 메서드를 실행합니다.

리마케팅 잠재고객 리소스의 list 메서드에 대한 자세한 내용은 API 참조를 확인하세요.

새 리마케팅 잠재고객 만들기

속성에 대한 새 리마케팅 잠재고객을 만드는 방법은 다음과 같습니다.

  1. Management API 또는 계정 탐색기를 사용하여 accountId 및 webPropertyId를 가져옵니다.
  2. Management API 또는 계정 탐색기를 사용하여 linkedViews [] 속성의 보기 (프로필) ID를 가져옵니다.
  3. Google Ads 연결 모음을 사용하여 linkedAdAccounts.linkedAccountId의 Google Ads 계정 ID를 가져옵니다.
    • linkedAdAccounts[] 속성은 현재 하나의 linkedForeignAccount로만 제한됩니다.
    • linkedAdAccounts[].type는 ADWORDS_LINKS, DBM_LINKS, MCC_LINKS 또는 OPTIMIZE로 설정할 수 있습니다.
  4. includeConditions의 segment 속성을 설정하는 옵션에 세그먼트 컬렉션을 사용하고, 상태 기반 잠재고객을 만드는 경우 excludeConditions에도 동일한 작업을 실행합니다. 세그먼트를 정의하는 방법은 세그먼트 참조를 참고하세요.
    • includeConditions는 membershipDurationDays 및 daysToLookBack 값을 선택적으로 가질 수 있습니다.
    • excludeConditions.exclusionDuration를 PERMANENT로 설정할 수도 있습니다.
  5. 리마케팅 잠재고객 리소스의 insert 메서드를 실행합니다.

API를 사용하면 SIMPLE 및 STATE_BASED라는 두 가지 유형의 잠재고객을 만들 수 있습니다. SIMPLE 잠재고객의 경우 NOT 연산자 (! 문자) 없이 양수 segment를 사용하여 audienceDefinition만 구성하면 됩니다. 제외 조건을 포함하려면 statebasedDefinition를 정의해야 합니다. 자세한 내용은 상태 기반 잠재고객을 참고하세요. 자세한 내용은 참조 예시를 확인하세요.

기존 리마케팅 잠재고객 업데이트

속성의 기존 리마케팅 잠재고객을 업데이트하는 방법은 다음과 같습니다.

  1. 리마케팅 잠재고객 ID가 이미 있는 경우 get를 호출할 수 있습니다. 또는 list를 호출하고 업데이트할 잠재고객을 선택할 수 있습니다.
  2. 쓰기 가능한 필드를 업데이트하고 업데이트된 잠재고객 객체를 전달하는 update를 호출합니다.