Semua permintaan ke AudienceInsightsService memiliki batasan kapasitas. Permintaan yang diizinkan per hari untuk generateAudienceCompositionInsights dan generateSuggestedTargetingInsights lebih sedikit dibandingkan dengan metode Audience Insights lainnya. Lihat kuota API untuk mengetahui detail selengkapnya.
AudienceInsightsService memungkinkan Anda mengintegrasikan data analisis audiens Google ke dalam alat perencanaan Anda. Data ini membantu agensi media dan Media Planner mendapatkan
pemahaman yang lebih mendalam tentang target audiens mereka, termasuk demografi,
minat, dan perilaku online.
Analisis audiens membantu Anda memahami audiens, kategori, topik, atau merek dengan memberikan ringkasan tingkat tinggi. Dengan menganalisis perilaku pengguna sehubungan dengan topik terkait, Anda dapat menggunakan analisis audiens ini untuk mengungkap kaitan dan persepsi yang dimiliki konsumen serta mengidentifikasi segmen audiens baru.
API ini mendukung tiga kasus penggunaan utama:
- Menyempurnakan dan menemukan audiens: Memahami minat dan perilaku unik konsumen untuk mengidentifikasi audiens baru bagi suatu merek, mengembangkan persona audiens, dan menyempurnakan strategi segmentasi audiens.
- Menentukan perencanaan kampanye: Terjemahkan output data menjadi target audiens YouTube untuk direncanakan, perkirakan potensi jangkauan audiens yang ditarget, dan ukur tumpang-tindih antara segmen audiens untuk memaksimalkan jangkauan kampanye.
- Kembangkan pesan materi iklan: Sesuaikan pesan materi iklan dengan target audiens Anda berdasarkan topik dan minat yang paling sering mereka gunakan.
Persyaratan kelayakan
Agar memenuhi syarat untuk AudienceInsightsService, partner harus memenuhi
kondisi berikut:
- Sudah memiliki akses, atau memenuhi syarat untuk mendapatkan akses, ke Insights Finder.
- Memiliki alat perencanaan atau antarmuka pengguna yang mengintegrasikan API.
- Gunakan API untuk tujuan perencanaan media atau kasus penggunaan relevan lainnya.
- Menyelesaikan penilaian pra-seleksi.
- Mengikuti persyaratan penggunaan data dan menjalani audit data berkala.
- Setujui persyaratan layanan Google Ads API dan kebijakan penggunaan data terkait.
Hubungi perwakilan Google untuk mendapatkan informasi selengkapnya.
Tanggal yang memenuhi syarat untuk insight daftar
Alur kerja standar dimulai dengan memeriksa bulan kalender dan periode tanggal yang
tersedia untuk analisis. Metode listInsightsEligibleDates menampilkan
ListInsightsEligibleDatesResponse, yang kolom data_months-nya mencantumkan
bulan (dalam format YYYY-MM) yang menyediakan data analisis audiens.
Kolom last_thirty_days respons berisi rentang tanggal persis yang digunakan generateAudienceCompositionInsights saat data_month tidak ditetapkan dalam permintaan.
Mencantumkan atribut analisis audiens
Sebelum membuat kueri metrik komposisi atau tumpang-tindih audiens, temukan ID atribut yang valid menggunakan listAudienceInsightsAttributes. Metode ini menampilkan
ListAudienceInsightsAttributesResponse yang berisi atribut
yang tersedia untuk dimensi yang diminta.
Misalnya, jika AFFINITY_USER_INTEREST dipilih sebagai dimensi dalam permintaan, metode ini akan menampilkan audiens minat yang didukung seperti "Penggemar Olahraga" atau "Pencinta Musik". Dimensi minat pengguna lain yang didukung mencakup
IN_MARKET_USER_INTEREST dan LIFE_EVENT_USER_INTEREST. Anda dapat menetapkan beberapa dimensi dalam satu permintaan. Untuk mengetahui daftar lengkap dimensi yang didukung, lihat
referensi kolom dimensions.
Saat menelusuri entitas (topik) Pustaka Pengetahuan menggunakan dimensi KNOWLEDGE_GRAPH, Anda harus memberikan kueri string di kolom query_text (misalnya, "football and the World Cup").
Anda dapat menyertakan knowledge_graph_entity_search_options secara opsional untuk
menyesuaikan penelusuran topik:
- Filter menurut kemampuan: Gunakan
search_filteruntuk mempersempit entity yang diambil hanya ke entity yang mendukung kemampuan tertentu. Misalnya, Anda dapat memfilter topik yang didukung sebagai atribut kreator dengan memberikanCREATOR_ATTRIBUTEdi kolomentity_capability_filters. Beberapa kemampuan dapat disediakan dan digabungkan dengan logikaOR. - Mengambil semua atribut kreator: Tetapkan
get_all_creator_attributesketrueuntuk mengambil semua entitas Pustaka Pengetahuan yang tersedia dan diberi tag sebagai atribut kreator. Saat menggunakan opsi ini, dimensiKNOWLEDGE_GRAPHharus dipilih,query_textharus kosong, dan Anda tidak dapat menggabungkan opsi ini dengansearch_filter.
Atribut yang ditampilkan oleh metode visibilitas ini dapat digunakan sebagai input untuk
metode AudienceInsightsService lainnya.
Setiap objek AudienceInsightsAttributeMetadata di
ListAudienceInsightsAttributesResponse memberikan representasi terstruktur dari
atribut audiens beserta properti deskriptif dan metrik engagement.
Atribut ini mencakup definisi utama, nama tampilan, jenis dimensi,
dan estimasi jangkauan audiens. Lihat referensi AudienceInsightsAttributeMetadata untuk mengetahui definisi kolom.
Membuat definisi audiens
Metode generateAudienceDefinition menerjemahkan deskripsi teks bentuk bebas audiens menjadi saran atribut audiens terstruktur yang dapat Anda teruskan ke metode insight downstream.
Membuat insight penargetan yang disarankan
Metode generateSuggestedTargetingInsights menampilkan kumpulan analisis penargetan (seperti segmen audiens yang dapat ditarget) yang relevan dengan audiens yang diminta.
Anda dapat menentukan audiens yang diminta sebagai
InsightsAudienceDefinition terstruktur atau sebagai deskripsi teks dalam
InsightsAudienceDescription.
Meskipun generateAudienceCompositionInsights menampilkan insight untuk setiap segmen atribut, generateSuggestedTargetingInsights menampilkan saran gabungan segmen audiens Google Ads yang dapat ditarget. Metode ini membantu menjawab
pertanyaan seperti "Beri saya saran audiens yang dapat ditarget untuk ayah berusia
30-an yang suka memancing".
Membuat metrik saran penargetan
Metode generateTargetingSuggestionMetrics menampilkan
GenerateTargetingSuggestionMetricsResponse, yang berisi potensi
populasi YouTube yang dapat dijangkau untuk setiap definisi audiens yang diminta di
GenerateTargetingSuggestionMetricsRequest.
Metode ini membantu menjawab pertanyaan seperti "Berapa banyak pria berusia 18 tahun ke atas yang tertarik dengan berkemah di Amerika Serikat yang dapat dijangkau di YouTube?"
Membuat analisis komposisi audiens
Metode generateAudienceCompositionInsights menampilkan
GenerateAudienceCompositionInsightsResponse, yang berisi daftar
atribut yang mewakili audiens yang diminati yang diminta, beserta metrik indeks
dan pangsa yang membandingkan pangsa audiens setiap atribut dengan
populasi dasar pengukuran.
Anda harus memberikan negara target untuk audiens. Daftar dimensi yang didukung untuk mengambil insight komposisi didokumentasikan di kolom dimensions dari GenerateAudienceCompositionInsightsRequest.
Metode ini membantu menjawab pertanyaan seperti "Apa minat utama yang diminati audiens target saya dibandingkan dengan populasi umum, dan seberapa besar kemungkinan mereka berinteraksi dengan minat tersebut?"
Membuat insight tumpang-tindih audiens
Metode generateAudienceOverlapInsights menampilkan
GenerateAudienceOverlapInsightsResponse, yang berisi daftar
atribut audiens dengan estimasi tumpang-tindih antara potensi
jangkauan YouTube mereka dan atribut utama.
Anda harus memberikan negara target dan atribut utama. Rentang usia, gender, segmen minat, dan segmen berniat beli didukung sebagai dimensi audiens.
Metode ini membantu menjawab pertanyaan seperti "Seberapa besar ukuran audiens inkremental saat kita menargetkan penggemar olahraga dan pencinta musik di Amerika Serikat?"
Membuat laporan Insights Finder
Metode generateInsightsFinderReport membuat laporan tersimpan di
Insights Finder berdasarkan input yang ditentukan dalam
GenerateInsightsFinderReportRequest dan menampilkan
GenerateInsightsFinderReportResponse yang berisi link yang dapat diakses secara eksternal
untuk membuka laporan tersebut di UI Insights Finder.
Google Issue Tracker
Gunakan Issue Tracker Google untuk mengajukan pertanyaan dukungan, melaporkan bug, atau mengirimkan permintaan fitur. Google melacak, memprioritaskan, dan memposting info terbaru tentang permintaan Anda langsung di Issue Tracker. Untuk mengetahui informasi selengkapnya, lihat Membuat laporan masalah di Issue Tracker Google.
Laporkan masalah menggunakan salah satu template Issue Tracker berikut:
- Mengajukan pertanyaan dukungan umum atau mengirimkan masukan terkait dokumentasi
- Melaporkan bug teknis
- Mengirimkan permintaan fitur API
Isi semua kolom dalam template dengan informasi mendetail agar Google dapat mereproduksi dan memprioritaskan permintaan Anda. Google mungkin akan menutup laporan yang tidak lengkap dan meminta Anda mengirimkan masalah baru dengan detail yang tidak ada.