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

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
        }
      }
    }

X Ads API

मूल बातें

संसाधन

मापन

​MACT अवलोकन

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

​API संदर्भ

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

​POST conversion_event

संसाधन URL

पैरामीटर

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

उदाहरण प्रतिक्रिया

​ऐप इवेंट टैग

​GET accounts/:account_id/app_event_tags

संसाधन URL

पैरामीटर

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

उदाहरण प्रतिक्रिया

​GET accounts/:account_id/app_event_tags/:app_event_tag_id

संसाधन URL

पैरामीटर

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

​उदाहरण प्रतिक्रिया

​POST accounts/:account_id/app_event_tags

संसाधन URL

पैरामीटर

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

उदाहरण प्रतिक्रिया

​DELETE accounts/:account_id/app_event_tags/:id

संसाधन URL

पैरामीटर

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

उदाहरण प्रतिक्रिया

​ऐप सूचियाँ

​GET accounts/:account_id/app_lists

संसाधन URL

​पैरामीटर

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

उदाहरण प्रतिक्रिया

​GET accounts/:account_id/app_lists/:app_list_id

संसाधन URL

पैरामीटर

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

प्रतिक्रिया का उदाहरण

​POST accounts/:account_id/app_lists

संसाधन URL

पैरामीटर

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

उदाहरण प्रतिक्रिया

​DELETE accounts/:account_id/app_lists/:app_list_id

संसाधन URL

पैरामीटर

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

प्रतिक्रिया का उदाहरण

​ऐप इवेंट प्रोवाइडर कॉन्फ़िगरेशन

​GET accounts/:account_id/app_event_provider_configurations¶

संसाधन URL

पैरामीटर

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

उदाहरण रिस्पॉन्स

​GET accounts/:account_id/app_event_provider_configurations/:id

संसाधन URL

पैरामीटर

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

उदाहरण रिस्पॉन्स

POST accounts/:account_id/app_event_provider_configurations

संसाधन URL

पैरामीटर

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

प्रतिक्रिया का उदाहरण

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

संसाधन URL

पैरामीटर

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

उदाहरण प्रतिक्रिया

​कन्वर्ज़न एट्रिब्यूशन

​GET conversion_attribution

संसाधन URL

पैरामीटर

MACT अवलोकन

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

API संदर्भ

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

POST conversion_event

ऐप इवेंट टैग

GET accounts/:account_id/app_event_tags

GET accounts/:account_id/app_event_tags/:app_event_tag_id

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

उदाहरण प्रतिक्रिया

POST accounts/:account_id/app_event_tags

DELETE accounts/:account_id/app_event_tags/:id

ऐप सूचियाँ

GET accounts/:account_id/app_lists

पैरामीटर

GET accounts/:account_id/app_lists/:app_list_id

POST accounts/:account_id/app_lists

DELETE accounts/:account_id/app_lists/:app_list_id

ऐप इवेंट प्रोवाइडर कॉन्फ़िगरेशन

GET accounts/:account_id/app_event_provider_configurations¶

GET accounts/:account_id/app_event_provider_configurations/:id

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

कन्वर्ज़न एट्रिब्यूशन

GET conversion_attribution