از Data Manager API برای ارسال دادههای رویداد برای تبدیلهای آفلاین Google Ads یا تبدیلهای بهبودیافته برای مشتریان بالقوه استفاده کنید.
اگر از Google Ads API ارتقا میدهید، ارتقا از Google Ads API را ببینید.
نمای کلی گردش کار
برای ارسال دادههای رویداد با Data Manager API، مراحل زیر را تکمیل کنید:
آمادهسازی مقصدها: اشیای
Destinationرا برای فیلدdestinationsدرخواست جذب تعریف کنید تا حساب هدف و مقصد تبدیل یا رویداد را مشخص کنید. برای جزئیات، آمادهسازی مقصدها را ببینید.آمادهسازی دادههای رویداد و شناسهها: فیلدهای
Eventرا با جزئیات رویداد و شناسههای لازم (مانند شناسههای کلیک آگهی، کارخواه، یا نمونه برنامه) پر کنید. اگر اطلاعات تماس کاربر را درuserDataاضافه میکنید، شناسهها را طبق دستورالعملهای قالببندی نرمالسازی و درهمسازی SHA-256 کنید، و بهصورت اختیاری آنها را رمزگذاری کنید. برای جزئیات، به آمادهسازی دادههای رویداد مراجعه کنید.درخواست دریافت را بسازید و ارسال کنید: درخواست
events.ingestحاویdestinations، سوابقEvent، وencryptionInfo(اگرuserDataرا رمزگذاری کردهاید) ارسال کنید. ازvalidateOnly: trueبرای آزمایش کردن بار داده برای خطاهای سریع-ناموفق قبلاز ارسال دادههای تولید استفاده کنید. برای اطلاع از الزامات فیلد و نمونه کدها، ارسال رویداد را ببینید.بررسی وضعیت درخواست و عیبیابی، و تنظیم تبدیلها: بررسی وضعیت پردازش ناهمگام و مرور عیبیابی با
requestStatus.retrieve، و تنظیم یا پس گرفتن تبدیلهای قبلاً ثبتشده درصورت نیاز.