با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
مقدمه
گوگل اخیراً یک API کاملاً جدید برای ردیابی تبدیل و بازاریابی مجدد برنامه Google Ads اعلام کرده است. محرک‌های اصلی برای توسعه این API جدید، ساده‌تر کردن تجزیه و تحلیل برنامه و ارجاع برای تبلیغ‌کنندگان و قابل اعتمادتر کردن برای شرکای اسناد Google Ads است.
از اینجا به بعد، ما به سادگی به API جدید برای ردیابی تبدیل برنامه و بازاریابی مجدد به عنوان "API" اشاره خواهیم کرد.
مفاهیم
API چندین مفهوم جدید را برای کسانی که با API قدیمی آشنا هستند معرفی می کند.
رویدادهای برنامه
در جایی که API ردیابی تبدیل قدیمی مربوط به «شناسه‌های تبدیل» و «برچسب‌های تبدیل» است، API مربوط به «رویدادهای برنامه» به معنای کلی است. در ادغام API قدیمی، نگاشت نحوی بین رویدادهای برنامه و رویدادهای تبدیل برنامه Google Ads در سیستم‌های تحلیلی شخص ثالث از طریق پانل‌های پیکربندی مربوطه انجام می‌شود. از این رو، ادغام قدیمی نیازمند تولید «شناسه‌های تبدیل» و «برچسب‌های تبدیل» در Google Ads است که به دنبال نقشه‌برداری در سیستم شخص ثالث است.
با این حال، API به مصرف‌کنندگان اجازه می‌دهد تا رویدادهای برنامه را با نام ، به صورت اتمی، به Google Ads ارسال کنند. با این کار، تبلیغ‌کنندگان می‌توانند بدون تنظیمات اضافی در Google Ads، تبدیل‌ها را به صورت خارجی ردیابی کنند.
توکن توسعه دهنده
همه مصرف کنندگان API باید یک توکن توسعه دهنده ایجاد کنند. هدف توکن توسعه دهنده محدود کردن و کنترل دسترسی به API است و این توکن به عنوان یک راز مشترک ثابت عمل می کند. مصرف‌کننده API همیشه از یک رمز توسعه‌دهنده برای امضای تمام درخواست‌های ردیابی تبدیل و بازاریابی مجدد برنامه استفاده می‌کند، صرف نظر از اینکه از طرف کدام برنامه درخواست ایجاد می‌کند. هنگام پر کردن درخواست خود برای یک نشانه، لطفاً مطمئن شوید که نشان می‌دهید که این رمز برای تبدیل برنامه و API بازاریابی مجدد استفاده می‌شود. توجه داشته باشید که باید فرآیند درخواست توکن توسعه دهنده را با کلیک بر روی Apply for Basic Access تکمیل کنید. می‌توانید سطح دسترسی فعلی خود را در مرکز API Google Ads در Google Ads بررسی کنید. همچنین، اگر از Google Ads API برای سایر عملکردهای گزارش دهی یا مدیریت کمپین استفاده می کنید، باید یک حساب مدیر جداگانه و توکن توسعه دهنده برای استفاده با این API ایجاد کنید.
اگر شما یک ارائه‌دهنده شخص ثالث هستید، همه درخواست‌ها از طرف تبلیغ‌کنندگانی که از سرویس شما استفاده می‌کنند باید با توکن توسعه‌دهنده شما ارسال شوند. از هر مشتری نخواهید برای توکن توسعه دهنده خود درخواست دهد . درعوض، هر مشتری باید با استفاده از شناسه ارائه دهنده شما یک شناسه پیوند ایجاد کند ( به بخش زیر مراجعه کنید ) و سپس شناسه پیوند خود را به شما ارائه دهد.
شناسه پیوند
شناسه پیوند یک شناسه منحصر به فرد برای اتصال یک برنامه خاص به یک توکن توسعه دهنده خاص است. در اینجا، "برنامه خاص" به یک برنامه واحد در یک پلتفرم (مثلاً App123 در iOS) اشاره دارد. شناسه‌های پیوند را می‌توان بدون توجه به سلسله مراتب مدیریت حساب Google Ads بین حساب‌های Google Adsایجاد و به اشتراک گذاشت و نیاز به مدیریت چندین شناسه ردیابی برای یک برنامه را کاملاً از بین برد.
برای ایجاد شناسه پیوند مرتبط با توکن توسعه‌دهنده منحصربه‌فرد خود، ارائه‌دهنده دیگر را از منوی کشویی ارائه‌دهنده تجزیه و تحلیل برنامه انتخاب کنید. در کادر ورودی با عنوان شناسه ارائه‌دهنده خود را وارد کنید ، شناسه مشتری خارجی مرتبط با حساب مدیر Google Ads را که در آن برای کد برنامه‌نویس خود درخواست کرده‌اید، وارد کنید. شناسه را بدون خط تیره وارد کنید (مثلاً 1234567890 برای شناسه حساب نشان داده شده به عنوان 123-456-7890 در رابط کاربری Google Ads).
انتساب بین شبکه ای
حذف مجدد بین شبکه ای یکی از ویژگی های اصلی بسیاری از محصولات در فضای اسناد برنامه است. API با درخواست از مصرف‌کنندگان API برای ارسال یک درخواست اضافی «ارسال بین شبکه‌ای» پس از دریافت تأیید تبدیل از Google Ads، مفهوم حذف‌سازی بین شبکه‌ای را به Google Ads می‌آورد. هدف از درخواست بین شبکه ای این است که به Google Ads اطلاع دهد که آیا تأیید تبدیل توسط مصرف کننده API که آن را دریافت کرده است به عنوان تبدیل حساب شده است یا خیر.
تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","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-24 بهوقت ساعت هماهنگ جهانی."],[[["\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."]]
