راه اندازی کمپین های تبلیغاتی گوگل با رویدادهای سفارشی و فلاتر گوگل آنالیتیکس

1. مقدمه

آخرین به روز رسانی: 2021-01-25

چیزی که خواهی ساخت

در این کد لبه، نحوه پیاده‌سازی رویدادهای سفارشی با GA4F و راه‌اندازی کمپین‌های اکشن از طریق Google Ads for Flutter را خواهید آموخت.

ما از برنامه پیش‌فرض Flutter با ویجت شمارنده ساده استفاده خواهیم کرد. ما برنامه خود را برای کاربران بالقوه تبلیغ خواهیم کرد، که احتمالاً روی ویجت شمارنده کلیک خواهند کرد.

چیزی که یاد خواهید گرفت

• نحوه مقداردهی اولیه GA4F (Google Analytics برای Firebase) در Flutter
• نحوه ایجاد رویدادها و پارامترهای سفارشی
• نحوه وارد کردن رویدادها از Firebase به Google Ads
• نحوه راه اندازی کمپین های اکشن با رویدادهای سفارشی

آنچه شما نیاز دارید

• اندروید استودیو 3.6 یا بالاتر
• Xcode (برای پشتیبانی از iOS)
• حساب Firebase
• حساب Google Ads

2. یک پروژه فلاتر جدید را شروع کنید

یک برنامه Flutter با قالب ساده ایجاد کنید. شما این برنامه شروع را برای این نرم افزار کد تغییر خواهید داد.

اندروید استودیو را راه اندازی کنید.

توجه: اگر New Flutter Project را به عنوان یک گزینه در IDE خود نمی بینید، مطمئن شوید که افزونه های Flutter و Dart را نصب کرده اید.

1. اگر پروژه‌های باز ندارید، از صفحه خوش‌آمدگویی Start a new Flutter ap p را انتخاب کنید. در غیر این صورت، File > New > New Flutter Project را انتخاب کنید.
2. Flutter Application را به عنوان نوع پروژه انتخاب کنید و روی Next کلیک کنید.
3. بررسی کنید که مسیر Flutter SDK مکان SDK را مشخص می کند. (اگر قسمت متن خالی است، Install SDK را انتخاب کنید.)
4. نام پروژه را وارد کرده و روی Next کلیک کنید.
5. از نام بسته پیش‌فرض پیشنهاد شده توسط Android Studio استفاده کنید و روی Next کلیک کنید.
6. روی Finish کلیک کنید.
7. منتظر بمانید تا Android Studio SDK را نصب کند و پروژه را ایجاد کند.

3. یک پروژه Firebase ایجاد و راه اندازی کنید

برای شروع کار با Firebase، باید یک پروژه Firebase ایجاد و راه اندازی کنید.

یک پروژه Firebase ایجاد کنید

1. وارد Firebase شوید.

در کنسول Firebase، روی افزودن پروژه (یا ایجاد پروژه) کلیک کنید و نام پروژه Firebase خود را به عنوان Firebase-Flutter-Ads یا هر نامی که دوست دارید، بگذارید.

2. روی گزینه های ایجاد پروژه کلیک کنید. در صورت درخواست، شرایط Firebase را بپذیرید. شما باید Google Analytics را برای این پروژه فعال کنید، زیرا برای ردیابی رویدادهای اقدام و تجزیه و تحلیل تبدیل ها به رویدادهای Google Analytics نیاز دارید.

برای کسب اطلاعات بیشتر درباره پروژه‌های Firebase، به درک پروژه‌های Firebase مراجعه کنید.

4. پیکربندی Firebase مخصوص پلتفرم (اندروید)

اندروید را پیکربندی کنید

1. در کنسول Firebase، Project Overview را در ناوبری سمت چپ انتخاب کنید، سپس روی دکمه Android در زیر «شروع با افزودن Firebase به برنامه خود» کلیک کنید.

گفتگوی نشان داده شده در صفحه زیر را خواهید دید.

2. مقدار مهمی که باید ارائه کنید، نام بسته اندروید است که با استفاده از مرحله زیر به دست خواهید آورد.

نکته : برای اطلاعات بیشتر درباره شناسه بسته و برنامه، شناسه برنامه را بخوانید.

3. در فهرست برنامه Flutter خود، فایل android/app/src/main/AndroidManifest.xml را باز کنید.
4. در عنصر manifest ، مقدار رشته ویژگی package را پیدا کنید. این مقدار نام بسته Android است (چیزی شبیه com.yourcompany.yourproject ). این مقدار را کپی کنید.
5. در محاوره Firebase، نام بسته کپی شده را در قسمت Android package name قرار دهید.
6. ما در اینجا به کلید SHA-1 نیاز نداریم، مگر اینکه قصد استفاده از پیوندهای دینامیک ورود به سیستم Google یا Firebase را داشته باشید (توجه داشته باشید که اینها بخشی از این آزمایشگاه کد نیستند). اگر قصد دارید داده‌های in_app_purchase را از Google Play وارد کنید، باید بعداً کلید را تنظیم کنید.
7. روی ثبت برنامه کلیک کنید.
8. برای ادامه در Firebase، دستورالعمل‌ها را برای دانلود فایل پیکربندی google-services.json دنبال کنید.

9. به دایرکتوری برنامه Flutter خود بروید، سپس فایل google-services.json (که به تازگی دانلود کرده اید) را به پوشه android/app منتقل کنید.
10. به کنسول Firebase برگردید، مراحل باقیمانده را رد کنید و به صفحه اصلی کنسول Firebase برگردید.
11. در نهایت، برای خواندن فایل google-services.json که توسط Firebase تولید شده است، به افزونه Google Services Gradle نیاز دارید.
12. در IDE یا ویرایشگر خود، android/app/build.gradle را باز کنید، سپس خط زیر را به عنوان آخرین خط در فایل اضافه کنید:

apply plugin: 'com.google.gms.google-services'

13. android/build.gradle را باز کنید، سپس داخل تگ buildscript ، یک وابستگی جدید اضافه کنید:

buildscript { 
   repositories {
      // ...
   }
   dependencies {
      // ...
      Classpath 'com.google.gms:google-services:4.3.3'
   }
}

14. اگر برنامه شما هنوز در حال اجرا است، آن را ببندید و دوباره بسازید تا به gradle اجازه دهید وابستگی ها را نصب کند.

پیکربندی برنامه Flutter خود را برای Android تمام کرده اید! برای iOS، ممکن است بخواهید به این کد لبه مراجعه کنید ( Firebase for Flutter را بشناسید )

5. Firebase Analytics را در Flutter پیکربندی کنید

در این مرحله، شروع به استفاده از بسته Firebase Analytics با نام firebase_analytics می‌کنید که حاوی ویژگی‌های Firebase Analytics است.

فایل pubspec دارایی های یک برنامه Flutter را مدیریت می کند. در pubspec.yaml ، firebase_analytics: ^6.2.0 ( firebase_analytics 6.2.0 یا بالاتر) را به لیست وابستگی ها اضافه کنید:

dependencies: 
   flutter: 
      sdk: flutter 
   cupertino_icons: ^0.1.2 
   firebase_analytics: ^6.2.0   # add this line

هنگام مشاهده pubspec در نمای ویرایشگر Android Studio، روی Packages get کلیک کنید. این بسته را به پروژه شما می کشد. باید موارد زیر را در کنسول مشاهده کنید:

flutter packages get 
Running "flutter packages get" in startup_namer... 
Process finished with exit code 0

اجرای Pub get همچنین فایل pubspec.lock را با لیستی از تمام بسته های وارد شده در پروژه و شماره نسخه آنها به صورت خودکار تولید می کند.

احتیاط: برای نسخه‌های خاص Firebase، java.lang.IllegalArgumentException: Service not registered در اولین راه‌اندازی کلاس FirebaseAnalytics نشان داده می‌شود (به شماره 1662 github مراجعه کنید) .

در lib/main.dart ، بسته جدید را وارد کنید:

import 'package:firebase_analytics/firebase_analytics.dart';

در کلاس MyApp ، شی FirebaseAnalytics با فراخوانی سازنده راه اندازی کنید.

class MyApp extends StatelessWidget {
 static FirebaseAnalytics analytics = FirebaseAnalytics();
   ...
}

اکنون شما آماده هستید تا برخی از گزارش های رویداد سفارشی را فعال کنید!

6. ثبت رویدادهای سفارشی با Firebase Analytics

اگر بخواهید یک الگوی جدید در برنامه Flutter ایجاد کنید، یک متغیر _counter و متد _incrementCounter() در کلاس State پیش فرض مشاهده خواهید کرد. اکنون، شما می خواهید رویدادهای سفارشی را زمانی که دکمه افزایش بیش از پنج بار توسط کاربران بسیار مشتاق کلیک می شود، ثبت کنید. بعداً، یک کمپین برنامه راه‌اندازی می‌کنیم تا کاربران بالقوه مشتاق را جذب کنیم

ابتدا، می خواهیم اشیاء تحلیلی را که مقداردهی اولیه کرده ایم به ویجت Stateful منتقل کنیم. ما با افزودن یک پارامتر تجزیه و تحلیل به سازنده MyHomePage شروع می کنیم.

MyHomePage({Key key, this.title, this.analytics}) : super(key: key);

همچنین هنگام فراخوانی سازنده، یک پارامتر تجزیه و تحلیل اضافه خواهید کرد.

home: MyHomePage(
   title: 'Flutter Demo Home Page',
   analytics: analytics,
),

اکنون می توانید به راحتی رویدادها را با متد logEvent() ثبت کنید. متد را اضافه کنید و متغیر _counter را افزایش دهید.

void _incrementCounter() {
 setState(() {
   _counter++;

   //add this
   if(_counter > 5) { 
     widget.analytics.logEvent(name: "clicked_counter"); 
   }

 });
}

اکنون برنامه شما آماده است تا گزارش رویداد سفارشی را فعال کند!

همچنین می توانید از روش های از پیش ساخته شده برای شلیک رویدادها استفاده کنید.

حالا همه چیز آماده است. در Android Studio خود، "main.dart" را اجرا کنید.

(اختیاری) ارسال اطلاعات اضافی به Firebase Analytics با استفاده از پارامترها

شما می توانید اطلاعات اضافی را از طریق پارامترها ارسال کنید. پارامترهای سفارشی را می توان برای گزارش در گزارش های Analytics شما ثبت کرد . آنها همچنین می توانند به عنوان فیلترهایی در تعاریف مخاطب استفاده شوند که می توانند برای هر گزارش اعمال شوند. اگر برنامه شما به پروژه BigQuery مرتبط است، پارامترهای سفارشی نیز در BigQuery یافت می‌شوند ( به صادرات BigQuery برای Firebase مراجعه کنید).

ما در اینجا مقدار _counter را به عنوان یک پارامتر تنظیم می کنیم.

void _incrementCounter() {
 setState(() {
   _counter++;

   if(_counter > 5) {
     widget.analytics.logEvent(name: "clicked_counter", parameters: {'count' : _counter});
   }
 });
}

بررسی و اشکال زدایی رویدادها

پس از چند ساعت، می توانید رویدادهای ثبت شده خود را در کنسول Firebase مشاهده کنید. فقط روی تب رویدادها از بخش Analytics موجود در کنسول Firebase کلیک کنید. همچنین می‌توانید مقادیر داخل رویداد clicked_counter را با کلیک کردن روی رویداد بررسی کنید.

با کشیدن کلید علامت گذاری به عنوان تبدیل به سمت راست، clicked_counter را به عنوان تبدیل علامت گذاری کنید.

اگر رویداد در برگه تبدیل باشد، شما با موفقیت آن رویداد را به عنوان تبدیل علامت گذاری کرده اید. Google Ads اکنون می‌تواند این رویداد را از Firebase وارد کند.

برای اهداف اشکال زدایی، از Firebase DebugView استفاده کنید. برای جزئیات بیشتر، به رویداد اشکال زدایی مراجعه کنید.

7. وارد کردن رویدادهای تجزیه و تحلیل در گوگل ادز

هنگامی که راه اندازی Firebase-Flutter شما کامل شد، آماده راه اندازی کمپین های برنامه با رویدادهای اکشن هستید. با پیوند دادن Firebase به Google Ads شروع کنید. با پیوند Firebase به Google Ads، کمپین های برنامه می توانند رویدادهای Firebase را وارد کنند. این فرآیند همچنین به Google Ads کمک می‌کند تا کمپین‌های برنامه را تقویت کند و به آن اجازه می‌دهد درباره مخاطبان خود اطلاعات بیشتری کسب کند.

1. با کلیک کردن روی دکمه کنار نمای کلی پروژه به تنظیمات Firebase بروید.
2. در تب Integrations ، Google Ads و یک دکمه پیوند را مشاهده خواهید کرد. روی پیوند کلیک کنید و سپس روی ادامه کلیک کنید.

3. حساب Google Ads را انتخاب کنید.

احتیاط: اگر رویداد هدف به‌عنوان رویداد تبدیل علامت‌گذاری نشود، Google Ads نمی‌تواند آن را وارد کند. مطمئن شوید که رویداد به درستی به عنوان تبدیل علامت گذاری شده است.

اکنون قسمت Firebase انجام شده است.

به Google Ads بروید.

1. وارد شوید و به Tools & Settings > Measurement > Conversions بروید تا رویدادهای سفارشی را به عنوان تبدیل وارد کنید.
2. برای افزودن اقدامات تبدیل جدید، روی دکمه + کلیک کنید.

3. ویژگی های Google Analytics 4 (Firebase) را انتخاب کنید و روی Continue کلیک کنید.

4. می‌توانید همه رویدادهای تحلیلی را که به‌عنوان تبدیل علامت‌گذاری شده‌اند، ببینید. رویداد clicked_counter را که قبلا اجرا کرده بودیم پیدا کنید.

5. عملکرد را بررسی کنید، روی Import کلیک کنید و سپس روی Continue کلیک کنید.

پس از تنظیم clicked_counter به‌عنوان یک اقدام تبدیل، می‌توانید کمپین‌های اقدامی راه‌اندازی کنید که می‌تواند کاربرانی را که احتمالاً رویدادهای clicked_counter را بیش از 5 بار فعال می‌کنند هدف قرار دهند.

8. راه اندازی کمپین های اکشن اپلیکیشن با رویدادهای وارداتی

مهم : برای راه‌اندازی موفقیت‌آمیز یک کمپین برنامه، باید یک برنامه سطح تولید در Google Play دریافت کنید. با این حال، اگر هنوز برای انتشار آماده نیستید، می توانید فعلا از این مرحله صرف نظر کنید.

6. به تب کمپین حساب فعلی خود بروید و با کلیک بر روی دکمه + کمپین جدیدی را شروع کنید. روی [کمپین جدید] و سپس روی ادامه کلیک کنید.
7. با گزینه App Installs یک کمپین تبلیغاتی برنامه راه اندازی کنید.

8. با تایپ نام برنامه، نام بسته یا ناشر برنامه خود را پیدا کنید.
9. در بخش Bidding ، در منوی کشویی ، اقدامات درون برنامه را انتخاب کنید.
10. رویداد سفارشی خود را در لیست ارائه شده پیدا کنید. هزینه هدف برای هر اقدام را تنظیم کنید و هر گزینه اضافی را تکمیل کنید.

11. تنظیمات کمپین خود را تمام کنید.

9. تبریک می گویم

تبریک می‌گوییم، شما با موفقیت Firebase و Google Ads خود را ادغام کردید! این به شما کمک می کند عملکرد کمپین خود را با رویدادهای وارداتی Firebase افزایش دهید.

تو یاد گرفتی

• نحوه پیکربندی Firebase Analytics برای Flutter
• نحوه ثبت رویدادهای سفارشی با Firebase Analytics در برنامه Flutter.
• نحوه وارد کردن رویدادها و استفاده از آنها برای کمپین های اکشن