मोबाइल कन्वर्ज़न

​

MACT अवलोकन

X मोबाइल ऐप प्रचार मापन विज्ञापनदाताओं को X पर उन विज्ञापन अभियानों की सफलता ट्रैक करने की सुविधा देता है, जिन्हें इंस्टॉल या अन्य इन-ऐप रूपांतरण बढ़ाने के लिए डिज़ाइन किया गया है। X का एक मोबाइल मापन पार्टनर विज्ञापनदाता को यह प्रबंधित करने की क्षमता देता है कि वह X पर प्रमोट किए जा रहे अपने ऐप्स से किन रूपांतरणों को ट्रैक करना चाहता है। एक बार विज्ञापनदाता उन इवेंट्स के type और समय-सीमाएं सेट कर देता है जिन्हें वह ट्रैक करना चाहता है, तो मोबाइल मापन पार्टनर उन सभी इवेंट्स को X को भेजता है और तुरंत एट्रिब्यूशन डेटा प्राप्त करता है, जो उस अभियान और क्रिएटिव की जानकारी देता है जिनके साथ उपयोगकर्ता ने रूपांतरण कराने के लिए इंटरैक्ट किया था।

​

कन्वर्ज़न इवेंट

X को कन्वर्ज़न इवेंट रिपोर्ट करने और एट्रिब्यूशन डेटा प्राप्त करने के लिए, पार्टनर को मोबाइल ऐप ID, रूपांतरण का type और timestamp, साथ ही advertising/device ID का एक hashed मान भेजना होगा। यह डेटा देने पर X के प्लेटफ़ॉर्म पर कन्वर्ज़न इवेंट दर्ज हो जाएगा और जहाँ उपयुक्त हो, वहाँ एट्रिब्यूशन भी लौटाया जाएगा। इसके अलावा, विज्ञापनदाता कन्वर्ज़न इवेंट के बारे में अतिरिक्त metadata देना चुन सकता है, जैसे खरीदारी का मान, किसी उत्पाद की ID, या पंजीकरण का तरीका।

​

API संदर्भ

​

कन्वर्ज़न इवेंट

​

POST conversion_event

मोबाइल मापन कन्वर्ज़न इवेंट रिकॉर्ड करें। रिस्पॉन्स यह बताएगा कि एट्रिब्यूशन X का है या X Audience Platform (TAP) का।

यह GET conversion_attribution endpoint से संबंधित है।

रिस्पॉन्स में X, TAP, या कोई एट्रिब्यूशन नहीं दिखाया जाएगा। twitter_attribution node हमेशा मौजूद रहेगा, और जब X एट्रिब्यूशन नहीं होगा तब उसका मान null होगा (नीचे दिया गया उदाहरण रिस्पॉन्स देखें)। अगर TAP एट्रिब्यूशन क्लेम किया जाता है, तो tpn_attribution node मौजूद रहेगा और उसी के अनुसार भरा जाएगा। अधिक जानकारी के लिए कृपया TAP overview देखें।

हर कन्वर्ज़न इवेंट से जुड़े metadata को सेट करने के लिए कई वैकल्पिक parameters उपलब्ध हैं। इस metadata का एट्रिब्यूशन कैलकुलेशन पर कोई प्रभाव नहीं पड़ता।

संसाधन URL

https://ads-api.x.com/12/conversion_event

पैरामीटर

नाम	विवरण
app_id required	संबंधित ऐप स्टोर के लिए अद्वितीय पहचानकर्ता। Type: int, string Example: 333903271, com.vine.android
conversion_time required	मिलीसेकंड सहित ISO-8601 टाइमस्टैम्प फ़ॉर्मैट में कन्वर्ज़न इवेंट का समय। Type: string Example: 2014-05-22T02:38:28.103Z
conversion_type required	कन्वर्ज़न इवेंट का प्रकार। Type: enum Possible values: 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 से hashed IDFA या AdID। Type: string Example: ABCD1234XYZ
os_type required	ऐप के लिए OS का प्रकार। Type: enum Possible values: IOS, ANDROID
click_window optional	दिनों में इस event के लिए click window। Type: int Note: click_window view\_through\_window से बड़ा या उसके बराबर होना चाहिए Default: 14 Possible values: 1, 7, 14, 30
device_ip_address optional	कन्वर्ज़न इवेंट होने के समय डिवाइस का IPv4 या IPv6 पता। Type: string Example: 192.133.78.1
level optional	इस event से संबद्ध level। Type: int Example: 2
non_twitter_engagement_time optional	conversion से पहले हुए अंतिम non-twitter engagement का समय। Type: string Example: 2014-05-22T02:38:28.103Z
non_twitter_engagement_type optional	कन्वर्ज़न इवेंट से पहले हुए non-twitter engagement का प्रकार। Type: enum Possible values: CLICK, VIEW
number_items optional	इस event से संबद्ध आइटमों की संख्या। Type: int Example: 2
price_currency optional	इस event से संबद्ध मुद्रा दर्शाने के लिए ISO 4217 code अपेक्षित है। Type: String Examples: EUR,USD,JPY
price_micro optional	micro में इस event से संबद्ध मूल्य राशि। Type: int Example: 123450000
user_payment_info optional	यह बताने वाला boolean मान कि उपयोगकर्ता की भुगतान जानकारी इस event से संबद्ध ऐप में संग्रहीत है या नहीं। Type: bool Possible values: true or false
view_through_window optional	दिनों में इस event के लिए view through window। Note: click_window view\_through\_window से बड़ा या उसके बराबर होना चाहिए। Type: int Default: 1 Possible values: 0, 1, 7, 14, 30

उदाहरण अनुरोध

https://ads-api.x.com/12/conversion_event?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 के लिए प्रत्येक conversion type के अनुसार सेट की गई conversion windows को परिभाषित करते हैं।

संसाधन URL

https://ads-api.x.com/12/accounts/:account_id/app_event_tags

पैरामीटर

Name	Description
account_id required	लेवरेज्ड अकाउंट का पहचानकर्ता। यह resource के path में दिखाई देता है और आम तौर par GET accounts को छोड़कर सभी Advertiser API requests के लिए आवश्यक पैरामीटर होता है। निर्दिष्ट account authenticated user से संबद्ध होना चाहिए। Type: string Example: 18ce54d4x5t
app_event_tag_ids optional	पहचानकर्ताओं की comma-separated सूची देकर response को केवल इच्छित app event tags तक सीमित करें। अधिकतम 200 IDs दी जा सकती हैं। Type: string Example: jhp
count optional	प्रत्येक अलग request में प्राप्त करने का प्रयास किए जाने वाले records की संख्या निर्दिष्ट करता है। Type: int Default: 200 Min, Max: 1, 1000
cursor optional	results का अगला page प्राप्त करने के लिए cursor निर्दिष्ट करता है। अधिक जानकारी के लिए Pagination देखें। Type: string Example: 8x7v00oow
sort_by optional	समर्थित attribute के आधार पर ascending या descending क्रम में sort करता है। अधिक जानकारी के लिए Sorting देखें। Type: string Example: created_at-asc
with_deleted optional	अपनी request में deleted results शामिल करें। Type: boolean Default: false Possible values: true, false
with_total_count optional	total_count response attribute शामिल करें। Note: यह पैरामीटर और cursor एक साथ इस्तेमाल नहीं किए जा सकते। Note: जिन requests में total_count शामिल होता है, उनकी रेट लिमिट्स कम होती हैं, जो फिलहाल 15 मिनट में 200 पर सेट हैं। Type: boolean Default: false Possible values: 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 के लिए प्रत्येक रूपांतरण type के अनुसार सेट की गई रूपांतरण विंडो को निर्धारित करते हैं।

संसाधन URL

https://ads-api.x.com/12/accounts/:account_id/app_event_tags/:app_event_tag_id

पैरामीटर

Name	Description
account_id required	लेवरेज्ड अकाउंट का पहचानकर्ता। यह रिसोर्स के path में दिखाई देता है और GET accounts को छोड़कर आम तौर पर सभी Advertiser API अनुरोधों के लिए आवश्यक पैरामीटर होता है। निर्दिष्ट खाता प्रमाणीकृत उपयोगकर्ता से संबद्ध होना चाहिए। Type: string Example: 18ce54d4x5t
app_event_tag_id required	उस ऐप इवेंट टैग का संदर्भ जिसके साथ आप अनुरोध में कार्य कर रहे हैं। Type: string Example: jhp
with_deleted optional	अपने अनुरोध में हटाए गए परिणामों को शामिल करें। Type: boolean Default: false Possible values: 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

पैरामीटर

Name	Description
account_id required	लेवरेज्ड अकाउंट का पहचानकर्ता। यह resource path में दिखाई देता है और आम तौर पर GET accounts को छोड़कर सभी Advertiser API अनुरोधों के लिए आवश्यक पैरामीटर होता है। निर्दिष्ट खाता प्रमाणीकृत उपयोगकर्ता से संबद्ध होना चाहिए। Type: string Example: 18ce54d4x5t
app_store_identifier required	ऐप स्टोर का पहचानकर्ता। Type: string Example: com.twitter.android
conversion_type required	कन्वर्ज़न इवेंट का type। Type: enum Possible values: 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 का type। Type: enum Possible values: IOS, ANDROID
provider_app_event_id required	provider की साइट पर कन्वर्ज़न टैग की ID। Type: string Example: provider_tag_j5394
provider_app_event_name required	provider की साइट पर कन्वर्ज़न टैग का नाम। Type: string Example: provider_name_a4382
deep_link_scheme optional	इस टैग से संबद्ध ऐप के लिए deep link URI निर्दिष्ट करें। Type: string Example: twitter://
post_engagement_attribution_window optional	इन इवेंट्स के लिए पोस्ट-एंगेजमेंट attribution window। Type: int Default: 30 Possible values: 1, 7, 14, 30
post_view_attribution_window optional	इन इवेंट्स के लिए पोस्ट-व्यू attribution window। Type: int Default: 1 Possible values: 0, 1, 7, 14, 30
retargeting_enabled optional	निर्दिष्ट करें कि इस app event tag के लिए retargeting सक्षम होनी चाहिए या नहीं। Type: boolean Default: true Possible values: 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

पैरामीटर

नाम	विवरण
account_id required	लेवरेज्ड अकाउंट का पहचानकर्ता। यह resource के path में दिखाई देता है और आमतौर पर GET accounts को छोड़कर सभी Advertiser API अनुरोधों के लिए आवश्यक पैरामीटर होता है। निर्दिष्ट account प्रमाणीकृत user से संबद्ध होना चाहिए। Type: string Example: 18ce54d4x5t
id required	उस app event tag का संदर्भ, जिस पर आप request में काम कर रहे हैं। 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

​

पैरामीटर

Name	Description
account_id required	लेवरेज्ड अकाउंट का पहचानकर्ता। यह resource के path में दिखाई देता है और आमतौर पर GET accounts को छोड़कर सभी Advertiser API अनुरोधों के लिए आवश्यक पैरामीटर होता है। निर्दिष्ट account प्रमाणीकृत उपयोगकर्ता से संबद्ध होना चाहिए। Type: string Example: 18ce54d4x5t
app_list_ids optional	कॉमा-सेपरेटेड पहचानकर्ताओं की सूची देकर response को केवल इच्छित ऐप सूचियों तक सीमित करता है। अधिकतम 200 IDs दिए जा सकते हैं। Type: string Example: wm7x
count optional	प्रत्येक अलग अनुरोध में प्राप्त किए जाने वाले records की संख्या निर्दिष्ट करता है। Type: int Default: 200 Min, Max: 1, 1000
cursor optional	परिणामों का अगला पृष्ठ प्राप्त करने के लिए cursor निर्दिष्ट करता है। अधिक जानकारी के लिए Pagination देखें। Type: string Example: 8x7v00oow
sort_by optional	समर्थित attribute के अनुसार आरोही या अवरोही क्रम में sort करता है। अधिक जानकारी के लिए Sorting देखें। Type: string Example: created_at-asc
with_deleted optional	अपने अनुरोध में deleted results शामिल करें। Type: boolean Default: false Possible values: true, false
with_total_count optional	total_count response attribute शामिल करें। Note: यह पैरामीटर और cursor एक साथ उपयोग नहीं किए जा सकते। Note: जिन अनुरोधों में total_count शामिल होता है, उनकी रेट लिमिट्स कम होती हैं, जो वर्तमान में प्रति 15 मिनट 200 पर सेट हैं। Type: boolean Default: false Possible values: 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

पैरामीटर

नाम	विवरण
account_id required	लेवरेज्ड अकाउंट का पहचानकर्ता। यह संसाधन के पथ में शामिल होता है और आम तौर पर GET accounts को छोड़कर सभी Advertiser API अनुरोधों के लिए एक आवश्यक पैरामीटर है। निर्दिष्ट खाता प्रमाणीकृत उपयोगकर्ता से संबद्ध होना चाहिए। प्रकार: string उदाहरण: 18ce54d4x5t
app_list_id required	उस ऐप सूची का संदर्भ जिसका आप अनुरोध में उपयोग कर रहे हैं। प्रकार: string उदाहरण: 28ukf
with_deleted optional	अपने अनुरोध में हटाए गए परिणाम शामिल करें। प्रकार: boolean डिफ़ॉल्ट: false संभावित मान: 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	लीवरेज्ड खाता का पहचानकर्ता। यह resource के path में दिखाई देता है और आम तौर पर GET accounts को छोड़कर सभी Advertiser API अनुरोधों के लिए एक आवश्यक parameter होता है। निर्दिष्ट account प्रमाणीकृत user से संबद्ध होना चाहिए। Type: string Example: 18ce54d4x5t
app_store_identifiers required	app_list में शामिल किए जाने वाले ऐप स्टोर पहचानकर्ता Type: string Example: com.twitter.android
name required	वह नाम जो आप app_list को देंगे Type: string Example: 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": "app list",
        "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": "app list",
          "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 required	लीवरेज्ड खाता का पहचानकर्ता। यह रिसोर्स के पथ में दिखाई देता है और आम तौर पर GET accounts को छोड़कर सभी Advertiser API अनुरोधों के लिए एक आवश्यक पैरामीटर होता है। निर्दिष्ट खाता प्रमाणीकृत उपयोगकर्ता से संबद्ध होना चाहिए। प्रकार: string उदाहरण: 18ce54d4x5t
app_list_id required	उस ऐप सूची का संदर्भ, जिस पर आप अनुरोध में काम कर रहे हैं। प्रकार: 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¶

वर्तमान खाते से संबद्ध कुछ या सभी ऐप इवेंट प्रोवाइडर कॉन्फ़िगरेशन (Mobile Application Conversion Tracking के लिए मुख्य कॉन्फ़िगरेशन) का विवरण प्राप्त करें।

संसाधन 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	परिणामों का अगला पेज प्राप्त करने के लिए cursor निर्दिष्ट करता है। अधिक जानकारी के लिए Pagination देखें। प्रकार: string उदाहरण: 8x7v00oow
ids optional	कॉमा-सेपरेटेड पहचानकर्ताओं की सूची निर्दिष्ट करके रिस्पॉन्स को केवल इच्छित कॉन्फ़िगरेशन तक सीमित करता है। अधिकतम 200 ID प्रदान की जा सकती हैं। प्रकार: string उदाहरण: 25n
sort_by optional	समर्थित attribute के अनुसार आरोही या अवरोही क्रम में सॉर्ट करता है। अधिक जानकारी के लिए Sorting देखें। प्रकार: string उदाहरण: created_at-asc
with_deleted optional	अपने अनुरोध में हटाए गए परिणाम शामिल करें। प्रकार: boolean डिफ़ॉल्ट: false संभावित मान: true, false
with_total_count optional	total_count रिस्पॉन्स attribute शामिल करें। नोट: यह पैरामीटर और 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": "Answers powered by Fabric",
          "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

वर्तमान खाते से संबद्ध इवेंट प्रोवाइडर कॉन्फ़िगरेशन (Mobile Application Conversion Tracking के लिए मुख्य कॉन्फ़िगरेशन) की एक विशिष्ट ID प्राप्त करें।

संसाधन URL

https://ads-api.x.com/11/accounts/:account_id/app_event_provider_configurations/:id

पैरामीटर

नाम	विवरण
account_id required	लीवरेज्ड खाता का पहचानकर्ता। यह resource के path में दिखाई देता है और आम तौर पर GET accounts को छोड़कर सभी Advertiser API अनुरोधों के लिए एक आवश्यक parameter होता है। निर्दिष्ट account, authenticated user से संबद्ध होना चाहिए। Type: string उदाहरण: 18ce54d4x5t
id required	उस ऐप इवेंट प्रोवाइडर कॉन्फ़िगरेशन का संदर्भ, जिसके साथ आप इस अनुरोध में काम कर रहे हैं। Type: string उदाहरण: 25n
with_deleted optional	अपने अनुरोध में deleted results शामिल करें। Type: boolean डिफ़ॉल्ट: false संभावित मान: 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 required	लीवरेज्ड खाता का पहचानकर्ता। यह संसाधन के पथ में दिखाई देता है और सामान्यतः GET accounts को छोड़कर सभी Advertiser API अनुरोधों के लिए एक आवश्यक पैरामीटर होता है। निर्दिष्ट खाता प्रमाणित उपयोगकर्ता से संबद्ध होना चाहिए। Type: string Example: 18ce54d4x5t
provider_advertiser_id required	प्रदाता की साइट पर विज्ञापनदाता का पहचानकर्ता Type: string Example: 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

पैरामीटर

Name	Description
account_id required	लीवरेज्ड खाते का पहचानकर्ता। यह संसाधन के path में दिखाई देता है और आम तौर पर GET accounts को छोड़कर सभी Advertiser API अनुरोधों के लिए एक आवश्यक पैरामीटर होता है। निर्दिष्ट खाता प्रमाणीकृत उपयोगकर्ता से संबद्ध होना चाहिए। Type: string Example: 18ce54d4x5t
id required	उस ऐप इवेंट प्रोवाइडर कॉन्फ़िगरेशन का संदर्भ जिसके साथ आप अनुरोध में काम कर रहे हैं। Type: string Example: 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

कन्वर्ज़न इवेंट लिखे बिना कन्वर्ज़न एट्रिब्यूशन की जांच करने के लिए X से क्वेरी करें। रिस्पॉन्स से पता चलेगा कि X एट्रिब्यूशन लागू होता है या नहीं।

यह POST conversion_event endpoint से संबंधित है।

रिस्पॉन्स में X, TAP, या कोई एट्रिब्यूशन नहीं होने का दावा किया जाएगा। twitter_attribution नोड हमेशा मौजूद रहेगा और अगर कोई X एट्रिब्यूशन नहीं है, तो इसका मान null होगा; अन्यथा, इसे नीचे दिए गए उदाहरण रिस्पॉन्स की तरह भरा जाएगा। अगर TAP एट्रिब्यूशन का दावा किया जाता है, तो tpn_attribution नोड मौजूद रहेगा और उसे उसी अनुसार भरा जाएगा। अधिक जानकारी के लिए कृपया TAP overview देखें।

संसाधन URL

https://ads-api.x.com/12/conversion_attribution

पैरामीटर

नाम	विवरण
app_id required	संबंधित ऐप स्टोर के साथ अद्वितीय पहचानकर्ता। Type: int, string उदाहरण: 333903271, com.vine.android
conversion_time required	मिलीसेकंड सहित ISO-8601 टाइमस्टैम्प फ़ॉर्मैट में रूपांतरण इवेंट का समय। Type: string उदाहरण: 2014-05-22T02:38:28.103Z
conversion_type required	रूपांतरण इवेंट का type। Type: 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 hashed IDFA या AdID। Type: string उदाहरण: ABCD1234XYZ
os_type required	ऐप के लिए OS type। Type: enum संभावित मान: IOS, ANDROID
click_window optional	इस इवेंट के लिए दिनों में क्लिक विंडो। Type: int डिफ़ॉल्ट: 14 संभावित मान: 1, 7, 14, 30
extra_device_ids optional	hashed_device_id में पास की गई डिवाइस ID के SHA1 का SHA256, साथ ही कोई भी अतिरिक्त hashed डिवाइस IDs। Type: string उदाहरण: ABCD1234XYZ, DCBA4321XYZ
non_twitter_engagement_time optional	रूपांतरण से पहले हुई अंतिम non-twitter सहभागिता का समय। Type: string उदाहरण: 2014-05-22T02:38:28.103Z
non_twitter_engagement_type optional	रूपांतरण इवेंट से पहले हुई non-twitter सहभागिता का type। Type: enum संभावित मान: CLICK, VIEW
view_through_window optional	इस इवेंट के लिए दिनों में व्यू-थ्रू विंडो। Type: int डिफ़ॉल्ट: 1 संभावित मान: 0, 1, 7, 14, 30

अनुरोध का उदाहरण

GET https://ads-api.x.com/12/conversion_attribution?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":"INSTALL",
        "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":"VIEW",
          "engagement_time":"2013-04-16T07:00:00.123Z",
          "country_code":"US",
          "tweet_id":"383034667764441088",
          "attribution_type":"PROMOTED",
          "promoted_properties":{
            "campaign_id”: “54a21",
            "campaign_name":"Vine_Contest",
            "line_item_id":"23ab2d4"
          }
        }
      },
      "data_type":"conversion_attribution",
      "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
        }
      }
    }