Performa aplikasi

Library klien .NET Google Ads menyederhanakan interaksi aplikasi Anda dengan Google Ads API, dengan konfigurasi minimal dari Anda. Namun, performa keseluruhan sangat bergantung pada cara library digunakan dan diintegrasikan dengan aplikasi Anda.

Panduan ini membahas pengoptimalan performa yang khusus untuk aplikasi .NET, dan melengkapi praktik terbaik yang umumnya berlaku untuk Google Ads API.

Menggunakan kembali GoogleAdsClient jika memungkinkan

GoogleAdsClient mewakili sesi pengguna saat melakukan panggilan API. Layanan ini memberikan pengoptimalan seperti:

• Menyimpan saluran gRPC yang digunakan oleh layanan API ke dalam cache. Hal ini mengurangi waktu penyiapan saat melakukan panggilan API awal.
• Menggunakan kembali token akses jika memungkinkan. Tindakan ini akan mengurangi jumlah perjalanan bolak-balik yang harus dilakukan library klien .NET Google Ads untuk memperbarui token akses.

Gunakan token akses dari akun tingkat pengelola jika memungkinkan

Jika memiliki token akses yang diterbitkan di tingkat akun pengelola, Anda dapat menggunakannya untuk melakukan panggilan API terhadap semua akun klien Google Ads dalam hierarki akun tersebut. Jika digabungkan dengan penggunaan kembali instance GoogleAdsClient, hal ini dapat mengurangi jumlah perjalanan pulang pergi yang harus dilakukan library klien untuk memperbarui token akses.

Gunakan SearchStream, bukan Search, jika memungkinkan

Google Ads API menyediakan dua cara utama untuk mengambil objek: GoogleAdsService.Search (yang menggunakan penomoran halaman) dan GoogleAdsService.SearchStream (yang menggunakan streaming).

Meskipun Search mengirim beberapa permintaan yang diberi nomor halaman untuk mendownload seluruh laporan, SearchStream mengirim satu permintaan dan memulai koneksi persisten dengan Google Ads API, berapa pun ukuran laporannya. Dengan menghilangkan waktu jaringan bolak-balik yang diperlukan untuk meminta setiap halaman respons Search, SearchStream umumnya menawarkan peningkatan performa dibandingkan paging. Lihat panduan laporan streaming untuk mempelajari lebih lanjut kapan harus memilih setiap metode.

Mengelola pembaruan token akses secara manual

Di lingkungan stateless tertentu seperti Google Cloud Functions, penggunaan kembali instance GoogleAdsClient di seluruh pemanggilan mungkin tidak dapat dilakukan. Lingkungan tersebut memiliki praktik terbaiknya sendiri untuk mempertahankan dan menggunakan kembali data.

Di Google.Ads.GoogleAds v27.0.0 dan yang lebih baru, Anda dapat memasukkan instance ICredential yang telah dikonfigurasi sebelumnya langsung di GoogleAdsConfig menggunakan properti Credentials dan menonaktifkan penyimpanan cache saluran (UseChannelCache = false).

Jika Anda lebih suka mengenkapsulasi pembuatan kredensial dalam class konfigurasi kustom (atau menggunakan versi library yang lebih lama), Anda dapat memperluas class GoogleAdsConfig untuk melakukan pemuatan ulang token akses Anda sendiri sebagai berikut:

// Create your own config class by extending the GoogleAdsConfig class.
class MyGoogleAdsConfig : GoogleAdsConfig
{
    public MyGoogleAdsConfig() : base()
    {
        // Disable the library's built-in channel caching mechanism.
        UseChannelCache = false;
    }

    protected override ICredential CreateCredentials()
    {
        // Create your own ICredential object here. You may refer to the
        // default implementation of GoogleAdsConfig.CreateCredentials
        // for an example.
    }
}

// Use your own config class when initializing the GoogleAdsClient instance.
MyGoogleAdsConfig myConfig = new MyGoogleAdsConfig();
GoogleAdsClient client = new GoogleAdsClient(myConfig);

Mengompilasi untuk build rilis

Pastikan Anda mengompilasi aplikasi menggunakan Konfigurasi rilis saat men-deploy ke server. Saat menggunakan konfigurasi Debug, aplikasi Anda akan mengompilasi dengan informasi proses debug simbolis lengkap dan tanpa pengoptimalan compiler.

Membuat profil aplikasi Anda

Buat profil aplikasi Anda untuk penggunaan CPU dan memori guna mengidentifikasi bottleneck performa. Visual Studio menyediakan Alat diagnostik untuk membantu membuat profil aplikasi Anda. Ada juga alat pembuatan profil komersial lain yang tersedia.

Menggunakan metode asinkron

Pemrograman asinkron menggunakan paradigma async-await membantu menghindari bottleneck performa dan meningkatkan responsivitas aplikasi Anda secara keseluruhan. Library .NET Google Ads menghasilkan metode asinkron untuk semua layanan dan metode RPC.

Pembatalan metode asinkron

Anda dapat menggunakan parameter callSettings untuk meneruskan CancellationToken ke metode asinkron seperti SearchStreamAsync:

using CancellationTokenSource cancellationTokenSource =
    new CancellationTokenSource();
cancellationTokenSource.CancelAfter(3000);
CallSettings callSettings =
    CallSettings.FromCancellationToken(cancellationTokenSource.Token);

string query = "SELECT campaign.name FROM campaign";
var request = new SearchGoogleAdsStreamRequest()
{
    CustomerId = customerId.ToString(),
    Query = query,
};

GoogleAdsServiceClient googleAdsService = client.GetService(
    Services.V26.GoogleAdsService);

await googleAdsService.SearchStreamAsync(
    request,
    (SearchGoogleAdsStreamResponse resp) =>
    {
        foreach (GoogleAdsRow googleAdsRow in resp.Results)
        {
            // Process the row.
        }
    },
    callSettings);

Menonaktifkan logging jika memungkinkan

Library .NET Google Ads menonaktifkan logging secara default dan menggunakan pendekatan logging lambat yang memberikan performa lebih baik pada aplikasi Anda. Jika Anda mengaktifkan logging selama pengembangan, pastikan Anda menonaktifkannya di lingkungan produksi. Jika Anda perlu memantau permintaan tertentu yang gagal dalam produksi, Anda dapat melakukan satu atau beberapa langkah berikut tanpa memengaruhi performa aplikasi secara negatif:

• Aktifkan hanya log ringkasan.
• Tetapkan log lengkap ke level ERROR.
• Simpan ID permintaan untuk permintaan gagal tertentu agar Anda dapat membagikannya ke saluran dukungan.

Lihat panduan logging untuk mempelajari lebih lanjut.

Menggunakan opsi ReadyToRun

.NET modern mendukung prakompilasi biner Anda ke platform dan arsitektur tertentu dengan menetapkan PublishReadyToRun ke true, lalu memublikasikan biner dengan menentukan RuntimeIdentifier yang valid. Lihat panduan deployment ReadyToRun untuk mempelajari lebih lanjut.

Menggunakan TieredCompilation

TieredCompilation (diaktifkan secara default di versi .NET modern seperti .NET 8) memungkinkan .NET mengidentifikasi hotspot dan meningkatkan performa runtime. Kompilasi bertingkat berfungsi dengan baik dengan ReadyToRun karena dapat menggunakan image yang telah dibuat sebelumnya untuk memulai dengan cepat, lalu mengompilasi ulang metode panas dengan pengoptimalan penuh. Lihat panduan TieredCompilation untuk mempelajari lebih lanjut.

Menyesuaikan pembersihan sampah memori (GC)

.NET menyediakan dua profil umum untuk pembersihan sampah memori (GC): profil workstation dan profil server. Kedua profil ini memiliki kompromi performa yang berbeda. Aplikasi server khusus yang menggunakan library .NET Google Ads sering kali berperforma lebih baik saat berjalan di profil server.

Perhatian: Mengaktifkan ServerGarbageCollection atau RetainVMGarbageCollection di lingkungan dengan resource terbatas (seperti container Docker kecil atau fungsi serverless) dapat meningkatkan konsumsi memori secara signifikan dan menyebabkan error kehabisan memori. Lakukan tolok ukur jejak memori aplikasi Anda sebelum mengaktifkan setelan ini di lingkungan dalam container.

Anda dapat memperoleh manfaat dari penyesuaian setelan GC berikut:

• Pembersihan sampah memori server: Pembersihan sampah memori server memungkinkan runtime .NET memberikan throughput yang lebih tinggi ke aplikasi Google Ads API dengan beroperasi pada beberapa heap dan thread GC. Lihat panduan GC server untuk mengetahui detail selengkapnya. Anda dapat mengaktifkan pembersihan sampah memori server dengan menambahkan baris berikut ke file .csproj aplikasi Anda:

  <PropertyGroup>
    <ServerGarbageCollection>true</ServerGarbageCollection>
  </PropertyGroup>
  

• Pembersihan sampah memori serentak: Anda dapat mengaktifkan pembersihan sampah memori serentak untuk memberi GC .NET thread khusus untuk pembersihan sampah memori di generasi 2. Setelan ini dapat berguna saat memproses laporan berukuran besar. Anda dapat mengaktifkan pembersihan sampah memori serentak dengan menambahkan baris berikut ke file .csproj aplikasi Anda:

  <PropertyGroup>
    <ConcurrentGarbageCollection>true</ConcurrentGarbageCollection>
  </PropertyGroup>
  

• Retain VM garbage collection: Setelan RetainVMGarbageCollection mengonfigurasi apakah segmen memori virtual yang seharusnya dihapus akan dimasukkan ke dalam daftar standby untuk penggunaan di masa mendatang, atau dikembalikan ke sistem operasi (OS). Anda dapat mengaktifkan retensi memori virtual dengan menambahkan baris berikut ke file .csproj aplikasi:

  <PropertyGroup>
    <RetainVMGarbageCollection>true</RetainVMGarbageCollection>
  </PropertyGroup>
  

Anda dapat menyesuaikan GC dengan memilih penyiapan yang menyeimbangkan perilaku workstation dan server. Semua setelan GC yang relevan dapat ditentukan dalam file runtimeconfig.json aplikasi .NET Anda, melalui variabel lingkungan, atau di App.config Anda.