메인 콘텐츠로 건너뛰기

​
MACT 개요

X 모바일 앱 프로모션 측정은 광고주가 X에서 앱 설치 또는 기타 인앱 전환을 유도하도록 설계된 광고 캠페인의 성과를 추적할 수 있게 합니다. X의 모바일 측정 파트너(MMP)는 광고주가 X에서 프로모션하는 앱에서 어떤 전환을 추적할지 관리할 수 있도록 지원합니다. 광고주가 추적하려는 이벤트의 유형과 기간을 설정하면, 모바일 측정 파트너는 해당 이벤트를 X로 전송하고, 전환을 유도한 캠페인과 크리에이티브에 대해 사용자가 어떤 방식으로 참여했는지를 보여주는 기여(어트리뷰션) 데이터를 즉시 수신합니다.

​
전환 이벤트

전환 이벤트를 X에 보고하고 어트리뷰션 데이터를 받으려면 파트너는 모바일 앱 ID, 전환 유형과 타임스탬프, 그리고 광고/디바이스 ID의 해시 값을 전송해야 합니다. 이 데이터를 제공하면 X 플랫폼에 전환 이벤트가 기록되고, 적절한 경우 어트리뷰션이 반환됩니다. 또한 광고주는 구매 금액, 제품 ID, 가입 방법 등 전환 이벤트와 관련된 추가 메타데이터를 제공할 수 있습니다.

​
API 참조

​
전환 이벤트

​
POST conversion_event

모바일 측정 95을(를) 기록합니다. 응답에는 X 또는 X Audience Platform(TAP) 기여가 표시됩니다. 이는 GET 95 엔드포인트와 관련됩니다. 응답에는 X, TAP, 또는 기여 없음 중 하나가 반환됩니다. X 기여가 없는 경우 twitter_attribution 노드는 항상 존재하며 값이 null입니다(아래 예시 응답 참조). TAP 기여가 있는 경우 tpn_attribution 노드가 존재하며 해당 값이 채워집니다. 자세한 내용은 TAP 개요를 참조하세요. 각 95에 연결된 메타데이터를 설정할 수 있는 선택적 매개변수가 여러 개 제공됩니다. 이 메타데이터는 기여 계산에 영향을 주지 않습니다.
리소스 URL
https://ads-api.x.com/12/conversion_event
매개변수
이름설명
app_id
required		해당 앱 스토어와 매핑되는 고유 식별자입니다.

유형: int, string

예시: 333903271, com.vine.android
conversion_time
required		밀리초가 포함된 ISO-8601 타임스탬프 형식의 전환 이벤트 시간입니다.

유형: string

예시: 2014-05-22T02:38:28.103Z
conversion_type
required		전환 이벤트의 유형입니다.

유형: enum

가능한 값: PURCHASE, SIGN_UP, INSTALL, RE_ENGAGE, UPDATE, TUTORIAL_COMPLETE, RESERVATION, ADD_TO_CART, ADD_TO_WISHLIST, LOGIN, CHECKOUT_INITIATED, SEARCH, LEVEL_ACHIEVED, ACHIEVEMENT_UNLOCKED, CONTENT_VIEW, SHARE, INVITE, ADDED_PAYMENT_INFO, SPENT_CREDITS, RATED
hashed_device_id
required		HMAC_SHA-256으로 해시된 IDFA 또는 AdID입니다.

유형: string

예시: ABCD1234XYZ
os_type
required		앱의 OS 유형입니다.

유형: enum

가능한 값: IOS, ANDROID
click_window
optional		이 이벤트에 대한 클릭 기준 기간(일)입니다.

유형: int

참고: click_window는 view_through_window 이상이어야 합니다.

기본값: 14
가능한 값: 1, 7, 14, 30
device_ip_address
optional		전환 이벤트가 발생했을 때 디바이스의 IPv4 또는 IPv6 주소입니다.

유형: string

예시: 192.133.78.1
level
optional		이 이벤트와 연관된 레벨입니다.

유형: int

예시: 2
non_twitter_engagement_time
optional		전환 이전의 마지막 비(非) X 참여 시각입니다.

유형: string

예시: 2014-05-22T02:38:28.103Z
non_twitter_engagement_type
optional		전환 이전의 비(非) X 참여 유형입니다.

유형: enum

가능한 값: CLICK, VIEW
number_items
optional		이 이벤트와 연관된 항목 수입니다.

유형: int

예시: 2
price_currency
optional		이 이벤트와 연관된 통화를 나타내는 ISO 4217 코드여야 합니다.

유형: String

예시: EUR, USD, JPY
price_micro
optional		이 이벤트와 연관된 금액(마이크로 단위)입니다.

유형: int

예시: 123450000
user_payment_info
optional		이 이벤트와 연관된 앱에 사용자의 결제 정보가 저장되어 있는지 나타내는 불리언 값입니다.

유형: bool

가능한 값: true 또는 false
view_through_window
optional		이 이벤트에 대한 뷰스루 기준 기간(일)입니다.

참고:

click_window는 view_through_window 이상이어야 합니다.

유형: int

기본값: 1
가능한 값: 0, 1, 7, 14, 30
예시 요청
https://ads-api.x.com/12/95?app_id=333903271&os_type=IOS&hashed_device_id=ABCD1234XYZ&conversion_type=INSTALL&conversion_time=2013-04-16T07:00:00.123Z&click_window=14&view_through_window=1
응답 예시
    {
      "data": {
        "conversion_value_micro": 0,
        "view_through_window": 1,
        "tpn_attribution": null,
        "conversion_time": "2017-01-21T01:14:00.602Z",
        "click_window": 30,
        "limit_ad_tracking": false,
        "event_metadata": null,
        "non_twitter_engagement_type": null,
        "conversion_type": "INSTALL",
        "partner_client_id": "com.appname contact id",
        "app_id": "com.appname",
        "hashed_device_id": "lke1GZa3AseB343ZcCQq7svfHzLfuSqyYnE+Rf49MOI=",
        "twitter_attribution": {
          "country_code": "US",
          "engagement_time": "2017-01-21T01:13:00.602Z",
          "engagement_type": "CLICK",
          "attribution_type": "PROMOTED",
          "promoted_properties": {
            "campaign_id": "4ns44",
            "line_item_id": "3x44d",
            "publisher_app_id": "333903271"
            "account_id":"18ce11e3egb",
            "line_item_objective": "APP_INSTALLS",
            "campaign_name": null
          },
          "tweet_id": "11434635565377600"
        },
        "os_type": "ANDROID",
        "non_twitter_engagement_time": null
      },
      "request": {
        "params": {
          "version_number": "1",
          "app_id": "com.appname",
          "conversion_type": "INSTALL",
          "os_type": "ANDROID",
          "hashed_device_id": "lke1GZa3AseB343ZcCQq7svfHzLfuSqyYnE+Rf49MOI=",
          "conversion_time": "2017-01-21T01:14:00.602Z",
          "click_window": "30",
          "view_through_window": "1",
          "limit_ad_tracking": "false"
        }
      }
    }

​
앱 이벤트 태그

​
GET accounts/:account_id/app_event_tags

현재 계정에 연동된 일부 또는 모든 앱 이벤트 태그의 상세 정보를 조회합니다. 이 태그는 Mobile App Conversion Tracking에서 전환 유형별로 설정된 전환 측정 기간을 정의합니다.
리소스 URL
https://ads-api.x.com/12/accounts/:account_id/app_event_tags
매개변수
이름설명
account_id
required		레버리지된 계정의 식별자입니다. 리소스 경로에 포함되며, GET accounts를 제외한 대부분의 Advertiser API 요청에서 일반적으로 필수 매개변수입니다. 지정된 계정은 인증된 사용자와 연결되어 있어야 합니다.

유형: string

예시: 18ce54d4x5t
app_event_tag_ids
optional		쉼표로 구분된 식별자 목록을 지정하여 원하는 앱 이벤트 태그만 응답에 포함합니다. 최대 200개의 ID를 제공할 수 있습니다.

유형: string

예시: jhp
count
optional		각 요청에서 조회를 시도할 레코드 수를 지정합니다.

유형: int

기본값: 200
최소/최대: 1 / 1000
cursor
optional		다음 결과 페이지를 가져오기 위한 커서를 지정합니다. 자세한 내용은 Pagination을 참조하세요.

유형: string

예시: 8x7v00oow
sort_by
optional		지원되는 속성을 기준으로 오름차순 또는 내림차순으로 정렬합니다. 자세한 내용은 Sorting을 참조하세요.

유형: string

예시: created_at-asc
with_deleted
optional		삭제된 결과를 포함합니다.

유형: boolean

기본값: false
가능한 값: true, false
with_total_count
optional		total_count 응답 속성을 포함합니다.

참고: 이 매개변수와 cursor는 상호 배타적입니다.

참고: total_count를 포함하는 요청은 더 낮은 요청 한도가 적용되며, 현재 15분당 200회로 설정되어 있습니다.

유형: boolean

기본값: false
가능한 값: true, false
예시 요청
GET https://ads-api.x.com/12/accounts/18ce54d4x5t/app_event_tags?app_event_tag_ids=jhp
예시 응답
    {
      "request": {
        "params": {
          "app_event_tag_ids": [
            "jhp"
          ],
          "account_id": "18ce54d4x5t"
        }
      },
      "next_cursor": null,
      "data": [
        {
          "provider_app_event_name": null,
          "app_store_identifier": "co.vine.android",
          "post_view_attribution_window": 1,
          "deep_link_scheme": "vine://",
          "id": "jhp",
          "retargeting_enabled": true,
          "conversion_type": "INSTALL",
          "created_at": "2016-12-08T07:49:58Z",
          "post_engagement_attribution_window": 14,
          "provider_app_event_id": null,
          "last_tracked_at": "2021-05-22T17:00:04Z",
          "status": "TRACKING",
          "updated_at": "2016-12-08T23:07:54Z",
          "os_type": "ANDROID",
          "deleted": false
        }
      ]
    }

​
GET accounts/:account_id/app_event_tags/:app_event_tag_id

현재 계정에 연결된 특정 앱 이벤트 태그를 조회합니다. 이는 Mobile App Conversion Tracking에서 전환 유형별로 설정된 전환 측정 기간을 정의합니다.
리소스 URL
https://ads-api.x.com/12/accounts/:account_id/app_event_tags/:app_event_tag_id
매개변수
이름설명
account_id
required		사용 중인 계정의 식별자입니다. 리소스 경로에 포함되며 GET accounts를 제외한 대부분의 Advertiser API 요청에서 일반적으로 필수 매개변수입니다. 지정한 계정은 인증된 사용자와 연동되어 있어야 합니다.

유형: string

예시: 18ce54d4x5t
app_event_tag_id
required		요청에서 다루는 앱 이벤트 태그에 대한 참조입니다.

유형: string

예시: jhp
with_deleted
optional		삭제된 결과를 요청에 포함합니다.

유형: boolean

기본값: false
가능한 값: true, false

​
예시 요청

GET https://ads-api.x.com/12/accounts/18ce54d4x5t/app_event_tags/jhp

​
응답 예시

    {
      "request": {
        "params": {
          "app_event_tag_id": "jhp",
          "account_id": "18ce54d4x5t"
        }
      },
      "data": {
        "provider_app_event_name": null,
        "app_store_identifier": "co.vine.android",
        "post_view_attribution_window": 1,
        "deep_link_scheme": "vine://",
        "id": "jhp",
        "retargeting_enabled": true,
        "conversion_type": "INSTALL",
        "created_at": "2016-12-08T07:49:58Z",
        "post_engagement_attribution_window": 14,
        "provider_app_event_id": null,
        "last_tracked_at": "2021-05-22T17:00:04Z",
        "status": "TRACKING",
        "updated_at": "2016-12-08T23:07:54Z",
        "os_type": "ANDROID",
        "deleted": false
      }
    }

​
POST accounts/:account_id/app_event_tags

현재 계정에 연결된 새 앱 이벤트 태그를 생성합니다.
리소스 URL
https://ads-api.x.com/12/accounts/:account_id/app_event_tags
매개변수
이름설명
account_id
required		대상 계정의 식별자입니다. 리소스 경로에 포함되며 GET accounts를 제외한 모든 Advertiser API 요청에서 일반적으로 필요한 매개변수입니다. 지정한 계정은 인증된 사용자와 연결되어 있어야 합니다.

유형: string

예시: 18ce54d4x5t
app_store_identifier
required		앱 스토어 식별자입니다.

유형: string

예시: com.twitter.android
conversion_type
required		전환 이벤트 유형입니다.

유형: enum

가능한 값: ACHIEVEMENT_UNLOCKED, ADDED_PAYMENT_INFO, ADD_TO_CART, ADD_TO_WISHLIST, CHECKOUT_INITIATED, CONTENT_VIEW, INSTALL, INVITE, LEVEL_ACHIEVED, LOGIN, PURCHASE, RATED, RESERVATION, RE_ENGAGE, SEARCH, SHARE, SIGN_UP, SPENT_CREDITS, TUTORIAL_COMPLETE, UPDATE
os_type
required		앱의 OS 유형입니다.

유형: enum

가능한 값: IOS, ANDROID
provider_app_event_id
required		공급자 사이트의 전환 태그 ID입니다.

유형: string

예시: provider_tag_j5394
provider_app_event_name
required		공급자 사이트의 전환 태그 이름입니다.

유형: string

예시: provider_name_a4382
deep_link_scheme
optional		이 태그와 연결된 앱의 딥링크 URI를 지정합니다.

유형: string

예시: twitter://
post_engagement_attribution_window
optional		이 이벤트의 참여 후 기여도 측정 윈도우입니다.

유형: int

기본값: 30
가능한 값: 1, 7, 14, 30
post_view_attribution_window
optional		이 이벤트의 조회 후 기여도 측정 윈도우입니다.

유형: int

기본값: 1
가능한 값: 0, 1, 7, 14, 30
retargeting_enabled
optional		이 앱 이벤트 태그에 대해 리타기팅을 활성화할지 지정합니다.

유형: boolean

기본값: true
가능한 값: true, false
예시 요청
POST https://ads-api.x.com/12/accounts/18ce54d4x5t/app_event_tags?app_store_identifier=com.twitter.android&os_type=ANDROID&conversion_type=PURCHASE&provider_app_event_id=abc123&provider_app_event_name=test-tag
예시 응답
    {
      "data": {
        "provider_app_event_name": "test-tag",
        "app_store_identifier": "com.twitter.android",
        "post_view_attribution_window": 1,
        "deep_link_scheme": "https://",
        "id": "3p3t",
        "retargeting_enabled": true,
        "conversion_type": "PURCHASE",
        "created_at": "2017-09-06T06:58:22Z",
        "post_engagement_attribution_window": 30,
        "provider_app_event_id": "abc123",
        "updated_at": "2017-09-06T06:58:22Z",
        "os_type": "ANDROID",
        "deleted": false
      },
      "request": {
        "params": {
          "provider_app_event_name": "test-tag",
          "app_store_identifier": "com.twitter.android",
          "account_id": "18ce54d4x5t",
          "conversion_type": "PURCHASE",
          "provider_app_event_id": "abc123",
          "os_type": "ANDROID"
        }
      }
    }

​
DELETE accounts/:account_id/app_event_tags/:id

현재 계정의 지정된 앱 이벤트 태그를 삭제합니다.
리소스 URL
https://ads-api.x.com/12/accounts/:account_id/app_event_tags/:id
매개변수
NameDescription
account_id
required		레버리지드 계정의 식별자입니다. 리소스 경로에 포함되며 GET accounts를 제외한 대부분의 Advertiser API 요청에서 일반적으로 필수 매개변수입니다. 지정한 계정은 인증된 사용자와 연동되어 있어야 합니다.

Type: string

Example: 18ce54d4x5t
id
required		해당 요청에서 작업 대상인 앱 이벤트 태그를 가리키는 참조입니다.

Type: string

Example: jhp
예제 요청
DELETE https://ads-api.x.com/12/accounts/18ce54d4x5t/app_event_tags/jhp
예시 응답
    {
      "data": {
        "provider_app_event_name": null,
        "app_store_identifier": "co.vine.android",
        "post_view_attribution_window": 1,
        "deep_link_scheme": "vine://",
        "id": "jhp",
        "retargeting_enabled": true,
        "conversion_type": "INSTALL",
        "created_at": "2016-12-08T07:49:58Z",
        "post_engagement_attribution_window": 14,
        "provider_app_event_id": null,
        "last_tracked_at": "2021-05-22T17:00:04Z",
        "status": "TRACKING",
        "updated_at": "2017-08-30T05:44:57Z",
        "os_type": "ANDROID",
        "deleted": true
      },
      "request": {
        "params": {
          "id": "jhp",
          "account_id": "5gvk9h"
        }
      }
    }

​
앱 목록

​
GET accounts/:account_id/app_lists

현재 계정에 연동된 일부 또는 모든 앱 목록의 상세 정보를 가져옵니다.
리소스 URL
https://ads-api.x.com/12/accounts/:account_id/app_lists

​
매개변수

이름설명
account_id
required		사용 중인 계정의 식별자입니다. 리소스 경로에 포함되며, GET accounts를 제외한 모든 Advertiser API 요청에서 일반적으로 필수 매개변수입니다. 지정한 계정은 인증된 사용자와 연동되어 있어야 합니다.

유형: string

예시: 18ce54d4x5t
app_list_ids
optional		쉼표로 구분된 식별자 목록을 지정하여 원하는 앱 목록으로만 응답을 한정합니다. 최대 200개의 ID를 제공할 수 있습니다.

유형: string

예시: wm7x
count
optional		각 요청당 조회를 시도할 레코드 수를 지정합니다.

유형: int

기본값: 200
최소, 최대: 1, 1000
cursor
optional		다음 페이지 결과를 가져오기 위한 커서를 지정합니다. 자세한 내용은 Pagination을 참조하세요.

유형: string

예시: 8x7v00oow
sort_by
optional		지원되는 속성을 기준으로 오름차순 또는 내림차순으로 정렬합니다. 자세한 내용은 Sorting을 참조하세요.

유형: string

예시: created_at-asc
with_deleted
optional		삭제된 결과를 포함합니다.

유형: boolean

기본값: false
가능한 값: true, false
with_total_count
optional		total_count 응답 속성을 포함합니다.

참고: 이 매개변수와 cursor는 상호 배타적입니다.

참고: total_count를 포함한 요청은 더 낮은 요청 한도가 적용되며, 현재 15분당 200회로 설정되어 있습니다.

유형: boolean

기본값: false
가능한 값: true, false
요청 예시
GET https://ads-api.x.com/12/accounts/18ce54d4x5t/app_lists?app_list_ids=wm7x
응답 예시
    {
      "request": {
        "params": {
          "app_list_ids": [
            "wm7x"
          ],
          "account_id": "18ce54d4x5t"
        }
      },
      "next_cursor": null,
      "data": [
        {
          "id": "wm7x",
          "name": "foo @ 14026528192426843"
        }
      ]
    }

​
GET accounts/:account_id/app_lists/:app_list_id

현재 계정에 연결된 특정 앱 목록을 조회합니다.
리소스 URL
https://ads-api.x.com/12/accounts/:account_id/app_lists/:app_list_id
매개변수
NameDescription
account_id
required		사용 중인 계정의 식별자입니다. 리소스 경로에 포함되며, GET accounts를 제외한 모든 Advertiser API 요청에서 일반적으로 필수 매개변수입니다. 지정한 계정은 인증된 사용자와 연결되어 있어야 합니다.

Type: string

Example: 18ce54d4x5t
app_list_id
required		요청에서 사용 중인 앱 목록에 대한 참조입니다.

Type: string

Example: 28ukf
with_deleted
optional		요청 결과에 삭제된 항목을 포함합니다.

Type: boolean

Default: false
Possible values: true, false
예시 요청
GET https://ads-api.x.com/12/accounts/18ce54d4x5t/app_lists/28ukf
예시 응답
    {
      "data": {
        "name": "twitter @ 262689209670784",
        "id": "28ukf",
        "created_at": "2017-08-17T17:07:42Z",
        "updated_at": "2017-08-17T17:07:42Z",
        "deleted": false,
        "apps": [
          {
            "app_store_identifier": "com.twitter.android",
            "os_type": "Android"
          }
        ]
      },
      "request": {
        "params": {
          "app_list_id": "28ukf",
          "account_id": "18ce54d4x5t"
        }
      }
    }

​
POST accounts/:account_id/app_lists

현재 계정에 연결된 app_list를 생성합니다. 현재 account_id당 최대 100개의 app_list 객체와, 각 app_list당 최대 500개의 앱이 허용됩니다.
리소스 URL
https://ads-api.x.com/12/accounts/:account_id/app_lists
매개변수
이름설명
account_id
required		활용 중인 계정의 식별자입니다. 리소스 경로에 포함되며, GET accounts를 제외한 모든 Advertiser API 요청에서 일반적으로 필수 매개변수입니다. 지정된 계정은 인증된 사용자와 연결되어 있어야 합니다.

유형: string

예시: 18ce54d4x5t
app_store_identifiers
required		app_list에 포함할 앱 스토어 식별자입니다.

유형: string

예시: com.twitter.android
name
required		app_list에 지정할 이름입니다.

유형: string

예시: My First App List
예시 요청
POST https://ads-api.x.com/12/accounts/18ce54d4x5t/app_lists?name=app list&app_store_identifiers=com.twitter.android
응답 예시
    {
      "data": {
        "name": "앱 목록",
        "id": "2a4um",
        "created_at": "2017-09-06T07:17:26Z",
        "updated_at": "2017-09-06T07:17:26Z",
        "deleted": false,
        "apps": [
          {
            "app_store_identifier": "com.twitter.android",
            "os_type": "Android"
          }
        ]
      },
      "request": {
        "params": {
          "app_store_identifiers": [
            "com.twitter.android"
          ],
          "name": "앱 목록",
          "account_id": "18ce54d4x5t"
        }
      }
    }

​
DELETE accounts/:account_id/app_lists/:app_list_id

현재 계정에 연결된 지정된 앱 목록을 삭제합니다.
리소스 URL
https://ads-api.x.com/12/accounts/:account_id/app_lists/:app_list_id
매개변수
이름설명
account_id
필수		활용 중인 계정의 식별자입니다. 리소스 경로에 포함되며, GET accounts를 제외한 모든 Advertiser API 요청에서 일반적으로 필수 매개변수입니다. 지정한 계정은 인증된 사용자와 연동되어 있어야 합니다.

유형: string

예시: 18ce54d4x5t
app_list_id
필수		이 요청에서 사용 중인 앱 목록에 대한 참조입니다.

유형: string

예시: 28ukf
예시 요청
DELETE https://ads-api.x.com/12/accounts/18ce54d4x5t/app_lists/28ukf
예시 응답
    {
      "data": {
        "name": "twitter @ 262689209670784",
        "id": "28ukf",
        "created_at": "2017-08-17T17:07:42Z",
        "updated_at": "2017-09-12T22:20:33Z",
        "deleted": true,
        "apps": [
          {
            "app_store_identifier": "com.twitter.android",
            "os_type": "Android"
          }
        ]
      },
      "request": {
        "params": {
          "app_list_id": "28ukf",
          "account_id": "18ce54d4x5t"
        }
      }
    }

​
앱 이벤트 제공업체 구성

❯

​
GET accounts/:account_id/app_event_provider_configurations

현재 계정과 연결된 일부 또는 모든 앱 이벤트 제공자 구성(모바일 애플리케이션 전환 추적을 위한 핵심 구성)의 세부 정보를 조회합니다.
리소스 URL
https://ads-api.x.com/11/accounts/:account_id/app_event_provider_configurations
매개변수
이름설명
account_id
required		레버리지 계정의 식별자입니다. 리소스 경로에 포함되며, GET accounts를 제외한 모든 Advertiser API 요청에서 일반적으로 필수 매개변수입니다. 지정한 계정은 인증된 사용자와 연결되어 있어야 합니다.

유형: string

예시: 18ce54d4x5t
count
optional		각 요청마다 조회할 레코드 수를 지정합니다.

유형: int

기본값: 200
최솟값/최댓값: 1/1000
cursor
optional		다음 결과 페이지를 가져오기 위한 커서를 지정합니다. 자세한 내용은 Pagination을 참조하세요.

유형: string

예시: 8x7v00oow
ids
optional		쉼표로 구분된 식별자 목록을 지정하여 원하는 구성만 응답에 포함되도록 범위를 한정합니다. 최대 200개의 ID를 제공할 수 있습니다.

유형: string

예시: 25n
sort_by
optional		지원되는 속성을 기준으로 오름차순 또는 내림차순으로 정렬합니다. 자세한 내용은 Sorting을 참조하세요.

유형: string

예시: created_at-asc
with_deleted
optional		삭제된 결과를 응답에 포함합니다.

유형: boolean

기본값: false
가능한 값: true, false
with_total_count
optional		total_count 응답 속성을 포함합니다.

참고: 이 매개변수와 cursor는 상호 배타적입니다.

참고: total_count를 포함한 요청은 더 낮은 요청 한도가 적용되며, 현재 15분당 200회로 설정되어 있습니다.

유형: boolean

기본값: false
가능한 값: true, false
예시 요청
GET https://ads-api.x.com/11/accounts/18ce54d4x5t/app_event_provider_configurations?ids=25n
예시 응답
    {
      "data": [
        {
          "provider_name": "Fabric 기반 Answers",
          "id": "25n",
          "provider_advertiser_id": "54ac2766f0de9e1f7a00001a",
          "created_at": "2016-12-08T07:49:58Z",
          "provider_advertiser_identifier": "54ac2766f0de9e1f7a00001a",
          "updated_at": "2017-05-12T21:37:15Z",
          "deleted": false
        }
      ],
      "next_cursor": null,
      "request": {
        "params": {
          "ids": [
            "25n"
          ],
          "account_id": "18ce54d4x5t"
        }
      }
    }

​
GET accounts/:account_id/app_event_provider_configurations/:id

현재 계정에 연결된 이벤트 제공자 구성(모바일 애플리케이션 전환 추적을 위한 핵심 구성)의 특정 id를 조회합니다.
리소스 URL
https://ads-api.x.com/11/accounts/:account_id/app_event_provider_configurations/:id
매개변수
NameDescription
account_id
required		레버리지드 계정의 식별자입니다. 리소스 경로에 포함되며 GET accounts를 제외한 대부분의 Advertiser API 요청에서 일반적으로 필수 매개변수입니다. 지정한 계정은 인증된 사용자와 연동되어 있어야 합니다.

Type: string

Example: 18ce54d4x5t
id
required		요청에서 사용 중인 앱 이벤트 공급자 구성에 대한 참조입니다.

Type: string

Example: 25n
with_deleted
optional		삭제된 결과를 포함할지 여부입니다.

Type: boolean

Default: false
Possible values: true, false
예시 요청
GET https://ads-api.x.com/11/accounts/18ce54d4x5t/app_event_provider_configurations/25n
응답 예시
    {
      "data_type": "app_event_provider_configuration",
      "data": {
        "provider_name": "API McTestface",
        "id": "25n",
        "provider_advertiser_id": "123",
        "created_at": "2017-03-24T22:24:56Z",
        "provider_advertiser_identifier": "123",
        "updated_at": "2017-03-24T22:24:56Z",
        "deleted": false
      },
      "request": {
        "params": {
          "id": "25n",
          "account_id": "18ce54d4x5t"
        }
      }
    }
POST accounts/:account_id/app_event_provider_configurations
현재 계정에 연결된 새 앱 이벤트 제공자 구성을 생성합니다. 특정 광고 계정에는 MACT 제공자를 하나만 연결할 수 있습니다.
리소스 URL
https://ads-api.x.com/11/accounts/:account_id/app_event_provider_configurations
매개변수
이름설명
account_id
필수		레버리지된 계정의 식별자입니다. 리소스 경로에 포함되며 GET accounts를 제외한 대부분의 Advertiser API 요청에서 일반적으로 필수 매개변수입니다. 지정된 계정은 인증된 사용자와 연동되어 있어야 합니다.

유형: string

예시: 18ce54d4x5t
provider_advertiser_id
필수		제공자 사이트의 광고주 식별자입니다.

유형: string

예시: client1
예제 요청
POST https://ads-api.x.com/11/accounts/18ce54d4x5t/app_event_provider_configurations?provider_advertiser_id=client1
응답 예시
    {
      "data": {
        "provider_name": "InternalTestProvider",
        "id": "e5g",
        "provider_advertiser_id": "client1",
        "created_at": "2017-08-30T05:40:07Z",
        "provider_advertiser_identifier": "client1",
        "updated_at": "2017-09-06T06:39:03Z",
        "deleted": false
      },
      "request": {
        "params": {
          "provider_advertiser_id": "client1",
          "account_id": "18ce54d4x5t"
        }
      }
    }

​
DELETE accounts/:account_id/app_event_provider_configurations/:id[¶]

현재 계정의 지정된 앱 이벤트 제공자 구성을 삭제합니다.
리소스 URL
https://ads-api.x.com/11/accounts/:account_id/app_event_provider_configurations/:id
매개변수
이름설명
account_id
required		사용 중인 레버리지드 계정의 식별자입니다. 리소스 경로에 포함되며, GET accounts를 제외한 대부분의 Advertiser API 요청에서 일반적으로 필수 매개변수입니다. 지정한 계정은 인증된 사용자와 연동되어 있어야 합니다.

유형: string

예시: 18ce54d4x5t
id
required		요청에서 사용 중인 앱 이벤트 제공자 구성에 대한 참조입니다.

유형: string

예시: e5g
예시 요청
DELETE https://ads-api.x.com/11/accounts/18ce54d4x5t/app_event_provider_configurations/e5g
응답 예시
    {
      "data": {
        "provider_name": "InternalTestProvider",
        "id": "e5g",
        "provider_advertiser_id": "client1",
        "created_at": "2017-08-30T05:40:07Z",
        "provider_advertiser_identifier": "client1",
        "updated_at": "2017-08-30T05:40:26Z",
        "deleted": true
      },
      "request": {
        "params": {
          "id": "e5g",
          "account_id": "18ce54d4x5t"
        }
      }
    }

​
전환 기여도 측정

​
GET conversion_attribution

95를 기록하지 않고 X에 쿼리하여 전환 기여도를 확인합니다. 응답에는 X 기여도가 표시됩니다. 이는 POST 95 엔드포인트와 관련이 있습니다. 응답에서는 X, TAP 또는 기여도 없음 중 하나가 표시됩니다. twitter_attribution 노드는 항상 존재하며 X 기여도가 없을 경우 값이 null이고, 아래 예시 응답과 같이 값이 채워집니다. TAP 기여도가 있는 경우 tpn_attribution 노드가 존재하며 해당 값이 채워집니다. 자세한 내용은 TAP 개요를 참조하세요.
리소스 URL
https://ads-api.x.com/12/95
매개변수
이름설명
app_id
required		해당 앱 스토어에서의 고유 식별자입니다.

유형: int, string

예시: 333903271, com.vine.android
conversion_time
required		밀리초가 포함된 ISO-8601 타임스탬프 형식의 전환 이벤트 시간입니다.

유형: string

예시: 2014-05-22T02:38:28.103Z
conversion_type
required		전환 이벤트의 유형입니다.

유형: enum

가능한 값: ACHIEVEMENT_UNLOCKED, ADDED_PAYMENT_INFO, ADD_TO_CART, ADD_TO_WISHLIST, CHECKOUT_INITIATED, CONTENT_VIEW, INSTALL, INVITE, LEVEL_ACHIEVED, LOGIN, PURCHASE, RATED, RESERVATION, RE_ENGAGE, SEARCH, SHARE, SIGN_UP, SPENT_CREDITS, TUTORIAL_COMPLETE, UPDATE
hashed_device_id
required		HMAC_SHA-256으로 해시한 IDFA 또는 AdID입니다.

유형: string

예시: ABCD1234XYZ
os_type
required		앱의 OS 유형입니다.

유형: enum

가능한 값: IOS, ANDROID
click_window
optional		이 이벤트의 클릭 추적 기간(일)입니다.

유형: int

기본값: 14
가능한 값: 1, 7, 14, 30
extra_device_ids
optional		hashed_device_id로 전달된 디바이스 ID의 SHA1을 다시 SHA256으로 해시한 값과 추가 해시된 디바이스 ID들입니다.

유형: string

예시: ABCD1234XYZ, DCBA4321XYZ
non_twitter_engagement_time
optional		전환 이전의 마지막 비 X 참여 시각입니다.

유형: string

예시: 2014-05-22T02:38:28.103Z
non_twitter_engagement_type
optional		전환 이벤트 이전의 비 X 참여 유형입니다.

유형: enum

가능한 값: CLICK, VIEW
view_through_window
optional		이 이벤트의 뷰스루 추적 기간(일)입니다.

유형: int

기본값: 1
가능한 값: 0, 1, 7, 14, 30
예시 요청
GET https://ads-api.x.com/12/95?app_id=333903271&os_type=IOS&hashed_device_id=ABCD1234XYZ&conversion_type=INSTALL&conversion_time=2013-04-16T07:00:00.123Z&click_window=14&view_through_window=0
응답 예시
    {
      data:{
        "app_id":"333903271",
        "os_type":"IOS",
        "hashed_device_id":"ABCD1234XYZ",
        "conversion_type":"설치",
        "partner_client_id":"123abc",
        "conversion_time":"2013-04-16T07:00:00.123Z",
        "click_window":14,
        "view_through_window":0,
        "extra_device_ids":null,
        "twitter_attribution":{
          "engagement_type":"조회",
          "engagement_time":"2013-04-16T07:00:00.123Z",
          "country_code":"US",
          "tweet_id":"383034667764441088",
          "attribution_type":"프로모션",
          "promoted_properties":{
            "campaign_id”: “54a21",
            "campaign_name":"Vine_콘테스트",
            "line_item_id":"23ab2d4"
          }
        }
      },
      "data_type":"95"
      "request":{
        "params":{
          "app_id":"333903271",
          "os_type":"IOS",
          "hashed_device_id":"ABCD1234XYZ",
          "conversion_time":"2013-04-16T07:00:00.123Z",
          "conversion_type":"INSTALL",
          "click_window":14,
          "view_through_window":0
        }
      }
    }