در Campaign Manager 360، یک تبدیل توسط یک برچسب، به نام فعالیت Floodlight ، ثبت می‌شود، زمانی که کاربر یک اقدام از پیش تعریف‌شده را پس از نمایش یک تبلیغ انجام می‌دهد. اقداماتی که معمولاً برچسب‌گذاری می‌شوند شامل ردیابی زمانی است که کاربر کالایی را از فروشگاه آنلاین خریداری می‌کند یا از یک صفحه وب برای درخواست اطلاعات بیشتر از طریق یک فرم آنلاین بازدید می‌کند. به طور کلی، تبدیل های ردیابی شده توسط گوگل هم به صورت آنلاین شروع و هم به پایان می رسد.
با این حال، تبدیل‌ها برای برخی از تبلیغ‌کنندگان ممکن است به صورت آنلاین شروع شده و به صورت آفلاین به پایان برسد. نمونه ای از این، کاربری است که شروع به تحقیق درباره یک محصول به صورت آنلاین می کند، روی یک تبلیغ کلیک می کند و سپس خرید خود را از طریق تلفن یا در یک فروشگاه خرده فروشی تکمیل می کند. در این سناریو، Campaign Manager 360 داده‌های مربوط به بخش آنلاین تراکنش را خواهد داشت، اما بخش آفلاین را ندارد، در نتیجه تبدیل ثبت نشده است.
برای رفع این مشکل، سرویس Conversions Campaign Manager 360 API به تبلیغ‌کنندگان اجازه می‌دهد اطلاعات مربوط به بخش آفلاین این تبدیل‌ها را مستقیماً به Campaign Manager 360 ارائه کنند.
پیش نیازها
قبل از شروع کار با سرویس Conversions ، باید مراحل زیر را انجام دهید:
همانطور که در راهنمای شروع ما ذکر شده است، یک پروژه API ایجاد و مجوز دهید.
مطمئن شوید که نمایه کاربری Campaign Manager 360 شما دارای مجوزهای لازم برای نقش کاربر است. برای فعال کردن این مجوزها، در صورت لزوم، با سرپرست حساب Campaign Manager 360 خود تماس بگیرید.
درج تبدیل‌های آفلاین : به آپلود تبدیل‌های آفلاین جدید با استفاده از
batchinsertاجازه می‌دهد.به‌روزرسانی تبدیل‌های آفلاین : اجازه می‌دهد تا تبدیل‌های آفلاین موجود را با استفاده از
batchupdateتغییر دهید.
مطابقت تبدیل به فعالیت
تبدیل‌های آفلاین باید با یک فعالیت آنلاین مربوطه در Campaign Manager 360 مطابقت داشته باشند. شما به این فعالیت‌ها با floodlightActivityId و floodlightConfigurationId مربوطه اشاره خواهید کرد.
اگر هنوز فعالیتی برای ردیابی تبدیل‌های آفلاین ندارید، می‌توانید از سرویس FloodlightActivities API برای ایجاد آن استفاده کنید. برای مثالی از نحوه انجام این کار، راهنمای وظایف رایج قاچاق را ببینید. ایجاد فعالیت های اختصاصی برای تبدیل های آفلاین به شدت توصیه می شود.
شناسه کلیک، دستگاه و کاربر را دریافت کنید
تبدیل‌های آفلاین نیز باید به یک کلیک، دستگاه یا شناسه کاربری نسبت داده شوند (که در هر زمان فقط یکی از آنها قابل استفاده است). متداول ترین راه های دریافت این شناسه ها در زیر پوشش داده شده است.
با استفاده از شناسه کلیک روی نمایشگر
از طریق استفاده از شناسه کلیک روی نمایش (DCLID) می توان تبدیل ها را به کلیک های تبلیغاتی نسبت داد. DCLID ها را می توان از Enhanced Attribution به دست آورد.
نمایش شناسه های کلیک باید در قسمت dclid ارسال شوند.
با استفاده از Google Click ID
با استفاده از شناسه کلیک گوگل (GCLID) می توان تبدیل ها را به کلیک های تبلیغات نسبت داد. GCLID ها را می توان از Google Ads یا Search Ads 360 دریافت کرد.
شناسه‌های کلیک Google باید در قسمت gclid ارسال شوند.
با استفاده از شناسه مطابقت
تبدیل‌ها را می‌توان از طریق شناسه شخص اول شما نسبت داد که با استفاده از ویژگی match_id در Floodlight با Google همگام‌سازی شده است.
با استفاده از شناسه دستگاه تلفن همراه
تبدیل ها را می توان مستقیماً به دستگاه های تلفن همراه یا تلویزیون متصل از طریق استفاده از شناسه های دستگاه تبلیغاتی نسبت داد. شناسه های زیر پشتیبانی می شوند:
- AdID
- IDFA
- شناسه های تبلیغات از دستگاه های CTV:
- ریدا (روکو)
- AFAI (تلویزیون آتش)
- AdID (تلویزیون اندروید)
- IDFA (Apple TV)
- MSAI (Xbox)
- تیفا (سامسونگ)
- VIDA (Vizio)
این شناسه ها باید در قسمت mobileDeviceId ارسال شوند.
با استفاده از %m ماکرو مطابقت
%m ماکرو را می توان در URL های کلیکی یا تغییر مسیر برای یک خلاقیت درج کرد. سرور آگهی این ماکرو را به شناسه کاربری رمزگذاری شده کاربر پس از یک رویداد کلیک گسترش می دهد. شناسه کاربر رمزگذاری شده می‌تواند مستقیماً از URL تغییر مسیر یا از گزارش‌های سرور گرفته شود.
شناسه‌های گرفته‌شده با استفاده از %m ماکرو باید در فیلدهای encryptedUserId یا encryptedUserIdCandidates[] ارسال شوند.
با استفاده از انتقال داده
انتقال داده یک ویژگی Campaign Manager 360 است که دسترسی به داده‌های گزارش سرور آگهی در سطح رویداد را فراهم می‌کند. این داده ها از طریق فیدهای جداگانه ارائه می شود که هر کدام شامل یک فایل انتقال داده واحد است. در این فایل ها، هر رویداد ضبط شده با یک شناسه کاربری رمزگذاری شده مرتبط است.
برای استفاده از شناسه‌های کاربری ارائه‌شده در فایل‌های انتقال داده، به راهی برای تطبیق یک رویداد سرور تبلیغات آنلاین با رویدادی در سیستم آفلاین خود نیاز دارید. این معمولاً با استفاده از متغیرهای Floodlight سفارشی انجام می‌شود، که می‌توانید به صورت پویا با مقادیری پر کنید که به طور منحصربه‌فردی یک اقدام کاربر را شناسایی می‌کنند. یک گردش کار ساده شده ممکن است به شکل زیر باشد:
یک تگ فعالیت Floodlight فعال می شود، که نشان دهنده شروع یک تراکنش است. این تگ حاوی یک مقدار متغیر سفارشی است که شما ارائه کرده اید که به طور منحصر به فرد تراکنش را شناسایی می کند.
تراکنش به صورت آفلاین ادامه می یابد و با حفظ همان شناسه تکمیل می شود.
با استفاده از شناسه ثبت شده هنگام تکمیل تراکنش، یک ورودی مطابق در فایل گزارش فعالیت انتقال داده که فعالیت اصلی Floodlight را ثبت کرده است، قرار می گیرد.
شناسه‌های بازیابی شده از فایل‌های انتقال داده باید در قسمت‌های encryptedUserId یا encryptedUserIdCandidates[] ارسال شوند.
در Campaign Manager 360، یک تبدیل توسط یک برچسب، به نام فعالیت Floodlight ، ثبت می‌شود، زمانی که کاربر یک اقدام از پیش تعریف‌شده را پس از نمایش یک تبلیغ انجام می‌دهد. اقداماتی که معمولاً برچسب‌گذاری می‌شوند شامل ردیابی زمانی است که کاربر کالایی را از فروشگاه آنلاین خریداری می‌کند یا از یک صفحه وب برای درخواست اطلاعات بیشتر از طریق یک فرم آنلاین بازدید می‌کند. به طور کلی، تبدیل های ردیابی شده توسط گوگل هم به صورت آنلاین شروع و هم به پایان می رسد.
با این حال، تبدیل‌ها برای برخی از تبلیغ‌کنندگان ممکن است به صورت آنلاین شروع شده و به صورت آفلاین به پایان برسد. نمونه ای از این، کاربری است که شروع به تحقیق درباره یک محصول به صورت آنلاین می کند، روی یک تبلیغ کلیک می کند و سپس خرید خود را از طریق تلفن یا در یک فروشگاه خرده فروشی تکمیل می کند. در این سناریو، Campaign Manager 360 داده‌های مربوط به بخش آنلاین تراکنش را خواهد داشت، اما بخش آفلاین را ندارد، در نتیجه تبدیل ثبت نشده است.
برای رفع این مشکل، سرویس Conversions Campaign Manager 360 API به تبلیغ‌کنندگان اجازه می‌دهد اطلاعات مربوط به بخش آفلاین این تبدیل‌ها را مستقیماً به Campaign Manager 360 ارائه کنند.
پیش نیازها
قبل از شروع کار با سرویس Conversions ، باید مراحل زیر را انجام دهید:
همانطور که در راهنمای شروع ما ذکر شده است، یک پروژه API ایجاد و مجوز دهید.
مطمئن شوید که نمایه کاربری Campaign Manager 360 شما دارای مجوزهای لازم برای نقش کاربر است. برای فعال کردن این مجوزها، در صورت لزوم، با سرپرست حساب Campaign Manager 360 خود تماس بگیرید.
درج تبدیل‌های آفلاین : به آپلود تبدیل‌های آفلاین جدید با استفاده از
batchinsertاجازه می‌دهد.به‌روزرسانی تبدیل‌های آفلاین : اجازه می‌دهد تا تبدیل‌های آفلاین موجود را با استفاده از
batchupdateتغییر دهید.
مطابقت تبدیل به فعالیت
تبدیل‌های آفلاین باید با یک فعالیت آنلاین مربوطه در Campaign Manager 360 مطابقت داشته باشند. شما به این فعالیت‌ها با floodlightActivityId و floodlightConfigurationId مربوطه اشاره خواهید کرد.
اگر هنوز فعالیتی برای ردیابی تبدیل‌های آفلاین ندارید، می‌توانید از سرویس FloodlightActivities API برای ایجاد آن استفاده کنید. برای مثالی از نحوه انجام این کار، راهنمای وظایف رایج قاچاق را ببینید. ایجاد فعالیت های اختصاصی برای تبدیل های آفلاین به شدت توصیه می شود.
شناسه کلیک، دستگاه و کاربر را دریافت کنید
تبدیل‌های آفلاین نیز باید به یک کلیک، دستگاه یا شناسه کاربری نسبت داده شوند (که در هر زمان فقط یکی از آنها قابل استفاده است). متداول ترین راه های دریافت این شناسه ها در زیر پوشش داده شده است.
با استفاده از شناسه کلیک روی نمایشگر
با استفاده از شناسه کلیک روی نمایش (DCLID) می توان تبدیل ها را به کلیک های تبلیغاتی نسبت داد. DCLID ها را می توان از Enhanced Attribution به دست آورد.
نمایش شناسه های کلیک باید در قسمت dclid ارسال شوند.
با استفاده از Google Click ID
با استفاده از شناسه کلیک گوگل (GCLID) می توان تبدیل ها را به کلیک های تبلیغات نسبت داد. GCLID ها را می توان از Google Ads یا Search Ads 360 دریافت کرد.
شناسه‌های کلیک Google باید در قسمت gclid ارسال شوند.
با استفاده از شناسه مطابقت
تبدیل‌ها را می‌توان از طریق شناسه شخص اول شما نسبت داد که با استفاده از ویژگی match_id در Floodlight با Google همگام‌سازی شده است.
با استفاده از شناسه دستگاه تلفن همراه
تبدیل ها را می توان مستقیماً به دستگاه های تلفن همراه یا تلویزیون متصل از طریق استفاده از شناسه های دستگاه تبلیغاتی نسبت داد. شناسه های زیر پشتیبانی می شوند:
- AdID
- IDFA
- شناسه های تبلیغات از دستگاه های CTV:
- ریدا (روکو)
- AFAI (تلویزیون آتش)
- AdID (تلویزیون اندروید)
- IDFA (Apple TV)
- MSAI (Xbox)
- تیفا (سامسونگ)
- VIDA (Vizio)
این شناسه ها باید در قسمت mobileDeviceId ارسال شوند.
با استفاده از %m ماکرو مطابقت
%m ماکرو را می توان در URL های کلیکی یا تغییر مسیر برای یک خلاقیت درج کرد. سرور آگهی این ماکرو را به شناسه کاربری رمزگذاری شده کاربر پس از یک رویداد کلیک گسترش می دهد. شناسه کاربر رمزگذاری شده می‌تواند مستقیماً از URL تغییر مسیر یا از گزارش‌های سرور گرفته شود.
شناسه‌هایی که با استفاده از %m ماکرو گرفته می‌شوند باید در فیلدهای encryptedUserId یا encryptedUserIdCandidates[] ارسال شوند.
با استفاده از انتقال داده
انتقال داده یک ویژگی Campaign Manager 360 است که دسترسی به داده‌های گزارش سرور آگهی در سطح رویداد را فراهم می‌کند. این داده ها از طریق فیدهای جداگانه ارائه می شود که هر کدام شامل یک فایل انتقال داده واحد است. در این فایل ها، هر رویداد ضبط شده با یک شناسه کاربری رمزگذاری شده مرتبط است.
برای استفاده از شناسه‌های کاربری ارائه‌شده در فایل‌های انتقال داده، به راهی برای تطبیق یک رویداد سرور تبلیغات آنلاین با رویدادی در سیستم آفلاین خود نیاز دارید. این معمولاً با استفاده از متغیرهای Floodlight سفارشی انجام می‌شود، که می‌توانید به صورت پویا با مقادیری پر کنید که به طور منحصربه‌فردی یک اقدام کاربر را شناسایی می‌کنند. یک گردش کار ساده شده ممکن است به شکل زیر باشد:
یک تگ فعالیت Floodlight فعال می شود، که نشان دهنده شروع یک تراکنش است. این تگ حاوی یک مقدار متغیر سفارشی است که شما ارائه کرده اید که به طور منحصر به فرد تراکنش را شناسایی می کند.
تراکنش به صورت آفلاین ادامه می یابد و با حفظ همان شناسه تکمیل می شود.
با استفاده از شناسه ثبت شده هنگام تکمیل تراکنش، یک ورودی مطابق در فایل گزارش فعالیت انتقال داده که فعالیت اصلی Floodlight را ثبت کرده است، قرار می گیرد.
شناسه‌های بازیابی شده از فایل‌های انتقال داده باید در قسمت‌های encryptedUserId یا encryptedUserIdCandidates[] ارسال شوند.