تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
مقدمة
أعلنت Google مؤخرًا عن واجهة برمجة تطبيقات جديدة تمامًا لتتبُّع الإحالات الناجحة للتطبيقات وتجديد النشاط التسويقي في "إعلانات Google". إنّ الأسباب الرئيسية لتطوير واجهة برمجة التطبيقات الجديدة هي
تسهيل إحصاءات التطبيقات وتحديد المصدر للمعلِنين وتقديم مزيد من الموثوقية
لشركاء تحديد المصدر في "إعلانات Google".
من الآن فصاعدًا، سنشير إلى واجهة برمجة التطبيقات الجديدة لتتبُّع الإحالات الناجحة للتطبيقات وتجديد النشاط التسويقي ببساطة باسم "واجهة برمجة التطبيقات".
المفاهيم
تقدّم واجهة برمجة التطبيقات عدة مفاهيم جديدة للمستخدمين الذين يعرفون واجهة برمجة التطبيقات القديمة.
أحداث التطبيقات
في حين أنّ واجهة برمجة التطبيقات القديمة لتتبُّع الإحالات الناجحة تتعامل مع "معرّفات الإحالات الناجحة" و "تصنيفات الإحالات الناجحة"، تتعامل واجهة برمجة التطبيقات مع "أحداث التطبيق" بشكل عام. في عملية التكامل القديمة لواجهة برمجة التطبيقات، تتم معالجة الربط التركيبي بين أحداث التطبيق وأحداث الإحالات الناجحة للتطبيقات في "إعلانات Google" ضمن أنظمة الإحصاءات التابعة لجهات خارجية من خلال لوحات الإعدادات الخاصة بها. لذلك، يتطلّب الربط القديم إنشاء "أرقام تعريف الإحالات الناجحة" و"تصنيفات الإحالات الناجحة" في "إعلانات Google"، ثم ربطها في نظام الجهة الخارجية.
ومع ذلك، تتيح واجهة برمجة التطبيقات للمستهلكين إعادة توجيه أحداث التطبيق حسب الاسم بشكل ذري إلى "إعلانات Google". وباستخدام هذه الميزة، يمكن للمعلِنين بدء تتبُّع الإحالات الناجحة خارجيًا بدون الحاجة إلى إعدادات إضافية في "إعلانات Google".
الرمز المميز للمطوِّر
على جميع مستخدمي واجهة برمجة التطبيقات إنشاء رمز مميّز للمطوّرين. الغرض من الرمز المميز للمطوّر هو حصر الوصول إلى واجهة برمجة التطبيقات والتحكّم فيه، وسيعمل هذا الرمز المميز كسرّ ثابت مشترك. سيستخدم مستهلك واجهة برمجة التطبيقات دائمًا رمز المطوّر نفسه لتوقيع جميع طلبات تتبُّع الإحالات الناجحة داخل التطبيق وطلبات تجديد النشاط التسويقي، بغض النظر عن التطبيق الذي يتم إنشاء طلب نيابةً عنه. عند ملء طلب الحصول على رمز مميّز، يُرجى التأكّد من الإشارة إلى أنّ الرمز المميّز سيُستخدَم مع واجهة برمجة التطبيقات لتجديد النشاط التسويقي والإحالات الناجحة على التطبيق. يُرجى العِلم أنّه عليك إكمال عملية تقديم طلب للحصول على رمز مطوِّر من خلال النقر على طلب الوصول الأساسي. يمكنك الاطّلاع على مستوى الوصول الحالي في مركز Google Ads API ضمن "إعلانات Google". بالإضافة إلى ذلك، إذا كنت تستخدم
Google Ads API
للاستفادة من وظائف أخرى لإعداد التقارير أو إدارة الحملات، عليك إنشاء
حساب إداري ورمز مميز للمطوّر منفصلَين لاستخدامهما مع واجهة برمجة التطبيقات هذه.
إذا كنت مقدّم خدمة تابعًا لجهة خارجية، يجب إرسال جميع الطلبات نيابةً عن المعلِنين الذين يستخدمون خدمتك مع رمز المطوّر الخاص بك. لا تطلب من كل عميل
تقديم طلب للحصول على الرمز المميز للمطوِّر. بدلاً من ذلك، على كل عميل إنشاء رقم تعريف رابط باستخدام رقم تعريف مقدّم الخدمة (راجِع القسم أدناه)، ثم تزويدك برقم تعريف الرابط.
رقم تعريف الرابط
معرّف الرابط هو معرّف فريد لربط تطبيق معيّن برمز مميّز خاص بالمطوّر. يشير مصطلح "تطبيق معيّن" هنا إلى تطبيق واحد على منصة واحدة (على سبيل المثال، App123 على iOS). يمكن إنشاء أرقام تعريف الربط ومشاركتها بين حسابات "إعلانات Google" بغض النظر عن التسلسل الهرمي لإدارة حسابات "إعلانات Google"، ما يغني تمامًا عن الحاجة إلى إدارة معرّفات تتبُّع متعدّدة للتطبيق نفسه.
لإنشاء رقم تعريف رابط مرتبط برمز المطوّر المميز، اختَر مقدّم خدمة آخر من القائمة المنسدلة مقدّم خدمة تحليلات التطبيقات. في مربّع الإدخال الذي يحمل التصنيف
أدخِل رقم تعريف مقدّم الخدمة، أدخِل رقم تعريف العميل الخارجي المرتبط بالحساب الإداري على
"إعلانات Google" الذي قدّمت فيه طلبًا للحصول على رمز المطوّر. أدخِل رقم التعريف
بدون شرطات (مثلاً: 1234567890 لرقم تعريف حساب معروض على النحو 123-456-7890 في واجهة مستخدم "إعلانات Google").
تحديد المصدر من شبكات متعدّدة
تُعدّ إزالة التكرار على مستوى شبكات متعدّدة إحدى الميزات الأساسية في العديد من المنتجات ضمن مجال تحديد مصدر التطبيقات. تتيح واجهة برمجة التطبيقات إمكانية إزالة التكرار على مستوى شبكات متعدّدة في "إعلانات Google" من خلال مطالبة مستخدمي واجهة برمجة التطبيقات بإرسال طلب إضافي "لتحديد المصدر على مستوى شبكات متعدّدة" بعد تلقّي تأكيد الإحالة الناجحة من "إعلانات Google". الغرض من الطلب على مستوى شبكات متعدّدة هو إعلام "إعلانات Google" بما إذا كان تأكيد الإحالة الناجحة قد تم احتسابه كإحالة ناجحة من قِبل مستهلك واجهة برمجة التطبيقات الذي تلقّى التأكيد.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eGoogle Ads introduced a new API for app conversion tracking and remarketing, simplifying analytics and attribution for advertisers and partners.\u003c/p\u003e\n"],["\u003cp\u003eThis API utilizes "app events" to track conversions, allowing advertisers to track externally without additional Google Ads setup.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers need a developer token to access the API, obtainable via application and used for all app conversion requests.\u003c/p\u003e\n"],["\u003cp\u003eA Link ID uniquely connects an app to a developer token, enabling cross-account sharing and simplifying tracking identifier management.\u003c/p\u003e\n"],["\u003cp\u003eThe API supports cross-network attribution, requiring an additional request after conversion confirmation to manage deduplication across networks.\u003c/p\u003e\n"]]],[],null,["# App Conversion Tracking and Remarketing API\n\nIntroduction\n------------\n\nGoogle recently announced an entirely new API for Google Ads app conversion\ntracking and remarketing. The primary drivers for developing this new API are\nto make app analytics and attribution **simpler for advertisers** and **more\nreliable for Google Ads attribution partners**.\n\nFrom here on out, we'll simply refer to the new API for app conversion\ntracking and remarketing as \"the API\".\n\nConcepts\n--------\n\nThe API introduces several new concepts for those who are familiar\nwith the legacy API.\n\n### App events\n\nWhere the legacy conversion tracking API is concerned with \"conversion IDs\"\nand \"conversion labels,\" the API is concerned with \"app events\" in a\ngeneric sense. In the legacy API integration, the syntactic mapping between app\nevents and Google Ads app conversion events is handled in the third-party analytics\nsystems via their respective configuration panels. The legacy integration hence\nrequires the generation of said \"conversion IDs\" and \"conversion labels\" in\nGoogle Ads followed by a mapping in the third-party system.\n\nThe API, however, allows consumers to forward app\nevents by *name*, atomically, to Google Ads. With this, advertisers can begin\ntracking conversions externally without additional required setup in Google Ads.\n\n### Developer token\n\nAll consumers of the API will need to generate a [developer\ntoken](//support.google.com/adspolicy/contact/new_token_application). The\npurpose of the developer token is to restrict and control access to the API, and\nthis token will function as a static shared secret. A consumer of the API will\nalways use the same developer token to sign all app conversion tracking and\nremarketing requests, regardless of which app they are creating a request on\nbehalf of. When filling out your application for a token, please make sure that\nyou indicate the token will be used for the **App conversions and remarketing\nAPI** . Note that you need to complete the developer token application\nprocess by clicking on **Apply for Basic Access** . You can check your current\naccess level in the Google Ads API center within Google Ads. Also, if you use the\n[Google Ads API](/google-ads/api/docs/start)\nfor other reporting or campaign management functionalities, you'll need to\ncreate a separate Manager account and developer token for use with this API.\n| **Note:** if your third-party analytics provider is an [App Attribution Partner](//ads.google.com/lp/appcampaigns/attribution/), you do not need to generate a separate developer token from the one being used by your analytics provider for this integration.\n\nIf you are a third-party provider, all requests on behalf of advertisers using\nyour service should be sent with your developer token. **Do not ask each client\nto apply for their own developer token** . Instead, each client should create a\nLink ID using your Provider ID ([see section below](#link_id)) and then provide\nyou their Link ID.\n\n### Link ID\n\nA link ID is a unique identifier for binding a specific app to a specific\ndeveloper token. Here, a \"specific app\" refers to a single app on a single\nplatform (for example, `App123` on iOS). Link IDs can be\n[generated and shared](//support.google.com/google-ads/answer/7365001)\nbetween Google Ads accounts regardless of\n[Google Ads account management hierarchy](//ads.google.com/home/tools/manager-accounts/),\nand completely eliminate the need to manage multiple tracking identifiers for\nthe same app.\n\nTo create a link ID associated with your unique developer token, select **Other\nprovider** from the **app analytics provider** dropdown. In the input box labeled\n**Enter your provider's ID** enter the external customer ID associated with the\nGoogle Ads manager account where you applied for your developer token. Enter the ID\nwithout dashes (ex. 1234567890 for an account ID shown as 123-456-7890 in the\nGoogle Ads UI).\n\n### Cross-network attribution\n\nCross-network deduplication is a core feature of many products in the app\nattribution space. The API brings the concept of cross-network\nde-duplication to Google Ads by requiring API consumers to send an additional\n\"cross-network attribution\" request after receiving a conversion confirmation\nfrom Google Ads. The purpose of the cross-network request is to notify Google Ads\nwhether or not the conversion confirmation was counted as a conversion by the\nAPI consumer who received it.\n| **Note:** You can find more details in the [Request and\n| Response Specifications](/app-conversion-tracking/api/request-response-specs) section. Additionally, please follow our [Privacy\n| Compliant App Attribution](/app-conversion-tracking/api/privacy-compliant-guide) guide to ensure clicks from users that opt out of ad tracking or ads personalization are only attributed using privacy compliant workflows."]]
