LinkedIn Ads araçları
Kampanya grupları, kampanyalar, sponsorlu içerik, metin reklamları, hedefleme ve demografik raporlar.
Bu kanalın entegrasyonu hazır; bağlantı, platformun geliştirici uygulamamızı onaylamasıyla açılacak. Onay tamamlanana kadar hesap bağlanamaz ve bu sayfada anlatılan işlemler kullanılamaz.
Araç adları ve açıklamaları doğrudan sunucu kodundan üretilir; açıklamalar asistanın gördüğü metnin çevirisidir, araç ve parametre adları aynen kalır.
Okuma araçları16 araç
list_linkedin_accounts
Okuma1 krediBağlı kullanıcının erişebildiği LinkedIn reklam hesapları (id, ad, para birimi, durum, yayın durumu, şirket sayfası referansı). Ajanslar: diğer araçlar için account_id seçin. Salt okunur; hesap bağlı değilse connected=false döndürür.
Bu araç parametre almaz.
list_linkedin_campaign_groups
Okuma1 krediBir LinkedIn reklam hesabının kampanya grupları; durum, yayın durumları, hedef, toplam/günlük bütçe ve zamanlamayla. Salt okunur.
| Parametre | Tip | Açıklama |
|---|---|---|
account_idİsteğe bağlı | string | LinkedIn reklam hesabı id'si (list_linkedin_accounts sonucundan); bağlantıda tek hesap varsa isteğe bağlı |
statusesİsteğe bağlı | array<string> | ACTIVE | PAUSED | DRAFT | ARCHIVED (varsayılan dördü de) |
list_linkedin_campaigns
Okuma1 krediLinkedIn kampanyaları; durum, hedef, tür, günlük/toplam bütçe, teklif, para birimi, kampanya grubu ve hedeflemeyle. Güncelleme araçlarında kullanılacak urn ve ledger_campaign_id döndürür. Salt okunur.
| Parametre | Tip | Açıklama |
|---|---|---|
account_idİsteğe bağlı | string | LinkedIn reklam hesabı id'si (list_linkedin_accounts sonucundan); bağlantıda tek hesap varsa isteğe bağlı |
campaign_groupİsteğe bağlı | string | kampanya grubu urn'si ya da id'sine göre filtre |
statusesİsteğe bağlı | array<string> | ACTIVE | PAUSED | DRAFT | COMPLETED | ARCHIVED | CANCELED |
sync_ledgerİsteğe bağlı | boolean | kampanyaları Tecrübe defterine de aktar (varsayılan true) |
list_linkedin_creatives
Okuma1 krediLinkedIn kampanyalarının kreatifleri (reklamları): hedeflenen durum, yayın durumu ve bekletme nedenleri, inceleme durumu ve LinkedIn'in ret nedenleri (review_rejection_reasons), referans verilen gönderi ya da metin reklam alanları. Salt okunur.
| Parametre | Tip | Açıklama |
|---|---|---|
account_idİsteğe bağlı | string | LinkedIn reklam hesabı id'si (list_linkedin_accounts sonucundan); bağlantıda tek hesap varsa isteğe bağlı |
campaign_idsİsteğe bağlı | array<string> | kampanya urn'leri/id'leri; varsayılan: tüm etkin/duraklatılmış/taslak kampanyalar |
statusesİsteğe bağlı | array<string> | ACTIVE | PAUSED | DRAFT | ARCHIVED | CANCELED |
limitİsteğe bağlı | integer (1–100) | — |
linkedin_performance_report
Okuma2 krediBir tarih aralığı için LinkedIn reklam analizleri: kampanya / kampanya grubu / kreatif / hesap bazında harcama, gösterim, tıklama, CTR, CPC, CPM, form açılışı, potansiyel müşteri, web sitesi dönüşümü, dönüşüm değeri, potansiyel müşteri maliyeti (CPL) ve dönüşüm maliyeti; ayrıca toplamlar ve 500+ gösterimli sıfır dönüşümlü satırlar. Yalnızca gerçek rakamlar; asla uydurulmaz.
| Parametre | Tip | Açıklama |
|---|---|---|
account_idİsteğe bağlı | string | LinkedIn reklam hesabı id'si (list_linkedin_accounts sonucundan); bağlantıda tek hesap varsa isteğe bağlı |
daysİsteğe bağlı | integer (1–366) | bugün dahil son N gün (varsayılan 30) |
start_dateİsteğe bağlı | string | YYYY-MM-DD (days'i geçersiz kılar) |
end_dateİsteğe bağlı | string | YYYY-MM-DD |
pivotİsteğe bağlı | CAMPAIGN | CAMPAIGN_GROUP | CREATIVE | ACCOUNT | — |
campaign_idsİsteğe bağlı | array<string> | yalnızca bu kampanya urn'leri/id'leri (pivot=CREATIVE ile kreatif adları için zorunlu) |
campaign_group_idsİsteğe bağlı | array<string> | — |
time_granularityİsteğe bağlı | ALL | DAILY | — |
sort_byİsteğe bağlı | cpl | spend | impressions | clicks | leads | conversions | ctr | — |
linkedin_demographics_report
Okuma2 krediReklamlarınızı gören, tıklayan ve dönüşüm yapanların LinkedIn mesleki demografisi: unvan, kıdem, iş fonksiyonu, sektör, şirket büyüklüğü ve ülke (adAnalytics MEMBER_* pivotları); gösterim, tıklama, CTR, harcama, potansiyel müşteri, CPL ve web sitesi dönüşümleriyle. URN'ler okunabilir adlara çözümlenir. Her boyut, satır uydurmak yerine LinkedIn'in gizlilik eşiğince gizlenen payı bildirir (3'ten az olaylı değerler düşürülür). Salt okunur.
| Parametre | Tip | Açıklama |
|---|---|---|
account_idİsteğe bağlı | string | LinkedIn reklam hesabı id'si (list_linkedin_accounts sonucundan); bağlantıda tek hesap varsa isteğe bağlı |
pivotsİsteğe bağlı | array<MEMBER_JOB_TITLE | MEMBER_SENIORITY | MEMBER_JOB_FUNCTION | MEMBER_INDUSTRY | MEMBER_COMPANY_SIZE | MEMBER_COUNTRY_V2> | varsayılan: altısı da |
pivotİsteğe bağlı | MEMBER_JOB_TITLE | MEMBER_SENIORITY | MEMBER_JOB_FUNCTION | MEMBER_INDUSTRY | MEMBER_COMPANY_SIZE | MEMBER_COUNTRY_V2 | — |
daysİsteğe bağlı | integer (1–366) | bugün dahil son N gün (varsayılan 30) |
start_dateİsteğe bağlı | string | YYYY-MM-DD (days'i geçersiz kılar) |
end_dateİsteğe bağlı | string | YYYY-MM-DD |
campaign_idsİsteğe bağlı | array<string> | yalnızca bu kampanya urn'leri/id'leri |
campaign_group_idsİsteğe bağlı | array<string> | — |
limitİsteğe bağlı | integer (1–100) | boyut başına satır (varsayılan 25, gösterime göre) |
locale_languageİsteğe bağlı | string | ad dili, varsayılan en |
locale_countryİsteğe bağlı | string | varsayılan US |
build_linkedin_audience
Okuma2 krediDüz dille yazılmış hedeflemeyi (unvanlar, şirketler, sektörler, şirket büyüklükleri, konumlar, kıdemler, fonksiyonlar, beceriler) LinkedIn hedefleme ölçütlerine çözümler; targetingCriteria ve tahmini kitle boyutunu döndürür. LinkedIn'in reddettiği ölçüt birleşimlerini atar ve bunu belirtir. Salt okunur; targeting_criteria'yı create_linkedin_campaign ya da update_linkedin_campaign_targeting'e verin.
| Parametre | Tip | Açıklama |
|---|---|---|
titlesİsteğe bağlı | array<string> | unvanlar, ör. Marketing Manager |
industriesİsteğe bağlı | array<string> | — |
locationsİsteğe bağlı | array<string> | şehirler / bölgeler / ülkeler, ör. Istanbul, Turkey (LinkedIn en az birini zorunlu tutar) |
company_sizesİsteğe bağlı | array<string> | ör. '200+', '51-200', '1001+' |
senioritiesİsteğe bağlı | array<string> | — |
job_functionsİsteğe bağlı | array<string> | — |
skillsİsteğe bağlı | array<string> | — |
employersİsteğe bağlı | array<string> | şirket adları (industries / company_sizes ile birleştirilemez) |
companiesİsteğe bağlı | array<string> | Alias of employers |
exclude_titlesİsteğe bağlı | array<string> | — |
exclude_employersİsteğe bağlı | array<string> | — |
exclude_industriesİsteğe bağlı | array<string> | — |
interface_localesİsteğe bağlı | array<string> | ör. urn:li:locale:en_US, urn:li:locale:tr_TR (varsayılan en_US) |
locale_languageİsteğe bağlı | string | arama dili, varsayılan en |
locale_countryİsteğe bağlı | string | varsayılan US |
estimateİsteğe bağlı | boolean | kitle sayısını getir (varsayılan true) |
list_linkedin_posts
Okuma1 kredicreate_linkedin_sponsored_content için seçilecek son şirket sayfası gönderileri (urn, metin, içerik türü, yayın zamanı, sponsorlu işareti). r_organization_social kapsamı gerekir; yoksa not döndürür. Salt okunur.
| Parametre | Tip | Açıklama |
|---|---|---|
account_idİsteğe bağlı | string | LinkedIn reklam hesabı id'si (list_linkedin_accounts sonucundan); bağlantıda tek hesap varsa isteğe bağlı |
organization_urnİsteğe bağlı | string | urn:li:organization:{id}; varsayılan: reklam hesabının şirket sayfası |
countİsteğe bağlı | integer (1–100) | — |
linkedin_targeting_search
Okuma1 krediTek bir boyut içinde LinkedIn hedefleme varlıklarını ada göre arar (adTargetingEntities typeahead / boyut listesi) ve URN'lerini ve adlarını döndürür. Salt okunur.
| Parametre | Tip | Açıklama |
|---|---|---|
queryİsteğe bağlı | string | aranacak ad; boş bırakılırsa tüm boyut listelenir (seniorities, jobFunctions, staffCountRanges) |
facetİsteğe bağlı | titles | industries | locations | employers | skills | seniorities | jobFunctions | staffCountRanges | varsayılan titles |
locale_languageİsteğe bağlı | string | varsayılan en |
locale_countryİsteğe bağlı | string | varsayılan US |
linkedin_audience_forecast
Okuma1 krediBir hedeflemenin kaç LinkedIn üyesine ulaştığını tahmin eder (audienceCounts): toplam ve aktif üyeler; 300 üye alt sınırının altında ya da konum yoksa uyarıyla. targeting_criteria, boyut URN listeleri ya da bir kampanyanın kayıtlı hedeflemesini kabul eder. Salt okunur.
| Parametre | Tip | Açıklama |
|---|---|---|
account_idİsteğe bağlı | string | LinkedIn reklam hesabı id'si (list_linkedin_accounts'tan); bağlantıda tek hesap varsa isteğe bağlı |
targeting_criteriaİsteğe bağlı | object | build_linkedin_audience'ın döndürdüğü haliyle targetingCriteria JSON'u |
campaign_idİsteğe bağlı | string | başka hedefleme verilmediğinde bu kampanyanın kayıtlı hedeflemesini kullanır |
geo_urnsİsteğe bağlı | array<string> | locations boyutu için URN'ler (linkedin_targeting_search) |
job_title_urnsİsteğe bağlı | array<string> | titles boyutu için URN'ler (linkedin_targeting_search) |
job_function_urnsİsteğe bağlı | array<string> | jobFunctions boyutu için URN'ler (linkedin_targeting_search) |
seniority_urnsİsteğe bağlı | array<string> | seniorities boyutu için URN'ler (linkedin_targeting_search) |
industry_urnsİsteğe bağlı | array<string> | industries boyutu için URN'ler (linkedin_targeting_search) |
skill_urnsİsteğe bağlı | array<string> | skills boyutu için URN'ler (linkedin_targeting_search) |
staff_count_urnsİsteğe bağlı | array<string> | staffCountRanges boyutu için URN'ler (linkedin_targeting_search) |
employer_urnsİsteğe bağlı | array<string> | employers boyutu için URN'ler (linkedin_targeting_search) |
include_audience_urnsİsteğe bağlı | array<string> | audienceMatchingSegments boyutu için URN'ler (linkedin_targeting_search) |
exclude_geo_urnsİsteğe bağlı | array<string> | locations boyutu için URN'ler (linkedin_targeting_search) |
exclude_title_urnsİsteğe bağlı | array<string> | titles boyutu için URN'ler (linkedin_targeting_search) |
exclude_function_urnsİsteğe bağlı | array<string> | jobFunctions boyutu için URN'ler (linkedin_targeting_search) |
exclude_seniority_urnsİsteğe bağlı | array<string> | seniorities boyutu için URN'ler (linkedin_targeting_search) |
exclude_industry_urnsİsteğe bağlı | array<string> | industries boyutu için URN'ler (linkedin_targeting_search) |
exclude_skill_urnsİsteğe bağlı | array<string> | skills boyutu için URN'ler (linkedin_targeting_search) |
exclude_staff_count_urnsİsteğe bağlı | array<string> | staffCountRanges boyutu için URN'ler (linkedin_targeting_search) |
exclude_employer_urnsİsteğe bağlı | array<string> | employers boyutu için URN'ler (linkedin_targeting_search) |
exclude_audience_urnsİsteğe bağlı | array<string> | audienceMatchingSegments boyutu için URN'ler (linkedin_targeting_search) |
location_modeİsteğe bağlı | recent_or_permanent | permanent | recent_or_permanent (varsayılan, locations boyutu) ya da permanent (profileLocations boyutu) |
audience_languageİsteğe bağlı | string | arayüz yerel ayarı, ör. en_US, tr_TR ya da urn:li:locale:tr_TR (varsayılan en_US) |
linkedin_bid_recommendations
Okuma1 krediBir kitle için LinkedIn'in önerdiği teklif, teklif alt/üst sınırı ve günlük bütçe limitleri (adBudgetPricing criteriaV2), reklam hesabı para biriminde. Salt okunur.
| Parametre | Tip | Açıklama |
|---|---|---|
account_idİsteğe bağlı | string | LinkedIn reklam hesabı id'si (list_linkedin_accounts'tan); bağlantıda tek hesap varsa isteğe bağlı |
campaign_typeİsteğe bağlı | SPONSORED_UPDATES | TEXT_AD | SPONSORED_INMAILS | — |
bid_typeİsteğe bağlı | CPM | CPC | CPV | — |
objective_typeİsteğe bağlı | string | ör. WEBSITE_VISIT, LEAD_GENERATION, BRAND_AWARENESS, WEBSITE_CONVERSION, VIDEO_VIEW, ENGAGEMENT |
optimization_targetİsteğe bağlı | string | ör. MAX_CLICK, MAX_LEAD, MAX_CONVERSION, NONE |
daily_budgetİsteğe bağlı | number | hesap para birimi; öneriyi netleştirir |
audience_expansionİsteğe bağlı | boolean | — |
targeting_criteriaİsteğe bağlı | object | build_linkedin_audience'ın döndürdüğü haliyle targetingCriteria JSON'u |
campaign_idİsteğe bağlı | string | bu kampanyanın kayıtlı hedeflemesini kullanır |
geo_urnsİsteğe bağlı | array<string> | locations boyutu için URN'ler (linkedin_targeting_search) |
job_title_urnsİsteğe bağlı | array<string> | titles boyutu için URN'ler (linkedin_targeting_search) |
job_function_urnsİsteğe bağlı | array<string> | jobFunctions boyutu için URN'ler (linkedin_targeting_search) |
seniority_urnsİsteğe bağlı | array<string> | seniorities boyutu için URN'ler (linkedin_targeting_search) |
industry_urnsİsteğe bağlı | array<string> | industries boyutu için URN'ler (linkedin_targeting_search) |
skill_urnsİsteğe bağlı | array<string> | skills boyutu için URN'ler (linkedin_targeting_search) |
staff_count_urnsİsteğe bağlı | array<string> | staffCountRanges boyutu için URN'ler (linkedin_targeting_search) |
employer_urnsİsteğe bağlı | array<string> | employers boyutu için URN'ler (linkedin_targeting_search) |
include_audience_urnsİsteğe bağlı | array<string> | audienceMatchingSegments boyutu için URN'ler (linkedin_targeting_search) |
exclude_geo_urnsİsteğe bağlı | array<string> | locations boyutu için URN'ler (linkedin_targeting_search) |
exclude_title_urnsİsteğe bağlı | array<string> | titles boyutu için URN'ler (linkedin_targeting_search) |
exclude_function_urnsİsteğe bağlı | array<string> | jobFunctions boyutu için URN'ler (linkedin_targeting_search) |
exclude_seniority_urnsİsteğe bağlı | array<string> | seniorities boyutu için URN'ler (linkedin_targeting_search) |
exclude_industry_urnsİsteğe bağlı | array<string> | industries boyutu için URN'ler (linkedin_targeting_search) |
exclude_skill_urnsİsteğe bağlı | array<string> | skills boyutu için URN'ler (linkedin_targeting_search) |
exclude_staff_count_urnsİsteğe bağlı | array<string> | staffCountRanges boyutu için URN'ler (linkedin_targeting_search) |
exclude_employer_urnsİsteğe bağlı | array<string> | employers boyutu için URN'ler (linkedin_targeting_search) |
exclude_audience_urnsİsteğe bağlı | array<string> | audienceMatchingSegments boyutu için URN'ler (linkedin_targeting_search) |
location_modeİsteğe bağlı | recent_or_permanent | permanent | recent_or_permanent (varsayılan, locations boyutu) ya da permanent (profileLocations boyutu) |
audience_languageİsteğe bağlı | string | arayüz yerel ayarı, ör. en_US, tr_TR ya da urn:li:locale:tr_TR (varsayılan en_US) |
list_linkedin_audiences
Okuma1 krediBir LinkedIn reklam hesabının eşleşen kitleleri (reklam segmentleri, adSegments): liste yüklemeleri, web sitesi yeniden hedefleme, pazarlama otomasyonu ve tahmine dayalı kitleler; durum ve yaklaşık üye sayısıyla. Urn'yi hedeflemede kullanın (include_audience_urns). Salt okunur.
| Parametre | Tip | Açıklama |
|---|---|---|
account_idİsteğe bağlı | string | LinkedIn reklam hesabı id'si (list_linkedin_accounts'tan); bağlantıda tek hesap varsa isteğe bağlı |
typesİsteğe bağlı | array<string> | BULK | RETARGETING | MARKET_AUTOMATION | BUSINESS_OBJECTIVE_BASED_AUDIENCE |
statusesİsteğe bağlı | array<string> | BUILDING | READY | UPDATING | FAILED | ARCHIVED | EXPIRED … |
list_linkedin_conversions
Okuma1 krediBir LinkedIn reklam hesabının dönüşüm izleme kuralları (conversions q=account): id, ad, tür, etkinlik, ilişkilendirme pencereleri, değer ve bağlı kampanyalar. Salt okunur.
| Parametre | Tip | Açıklama |
|---|---|---|
account_idİsteğe bağlı | string | LinkedIn reklam hesabı id'si (list_linkedin_accounts'tan); bağlantıda tek hesap varsa isteğe bağlı |
list_linkedin_lead_forms
Okuma1 krediBir LinkedIn reklam hesabına ait Lead Gen Forms (leadForms q=owner): id, ad, durum, sürüm ve soru sayısı. Salt okunur.
| Parametre | Tip | Açıklama |
|---|---|---|
account_idİsteğe bağlı | string | LinkedIn reklam hesabı id'si (list_linkedin_accounts'tan); bağlantıda tek hesap varsa isteğe bağlı |
download_linkedin_leads
Okuma2 krediLinkedIn Lead Gen Forms üzerinden gönderilen potansiyel müşteriler (leadFormResponses): gönderim zamanı, kampanya, kreatif, tüm yanıtlar ve izinler. Kişisel veri: formun izni kapsamında kullanın. Salt okunur.
| Parametre | Tip | Açıklama |
|---|---|---|
account_idİsteğe bağlı | string | LinkedIn reklam hesabı id'si (list_linkedin_accounts'tan); bağlantıda tek hesap varsa isteğe bağlı |
form_idİsteğe bağlı | string | potansiyel müşteri formu id'si (list_linkedin_lead_forms); yanıtları soru adlarıyla eşler |
sinceİsteğe bağlı | string | YYYY-MM-DD |
untilİsteğe bağlı | string | YYYY-MM-DD (varsayılan bugün) |
test_onlyİsteğe bağlı | boolean | — |
limitİsteğe bağlı | integer (1–1000) | — |
linkedin_ad_copy
Okuma1 krediLinkedIn reklamlarının gerçek metnini okur: metin reklamının başlığı/açıklaması/açılış sayfası ya da sponsorlu gönderinin metni, makale başlığı, açılış sayfası ve eylem çağrısı. Salt okunur; mesajları karşılaştırmak için linkedin_performance_report ile birleştirin.
| Parametre | Tip | Açıklama |
|---|---|---|
account_idİsteğe bağlı | string | LinkedIn reklam hesabı id'si (list_linkedin_accounts'tan); bağlantıda tek hesap varsa isteğe bağlı |
creative_idsİsteğe bağlı | array<string> | kreatif urn'leri/id'leri |
post_urnsİsteğe bağlı | array<string> | urn:li:share / urn:li:ugcPost |
Yazma araçları20 araç
create_linkedin_campaign_group
Yazma2 krediLinkedIn kampanya grubu oluşturur (varsayılan olarak duraklatılmış). Önizleme döndürür ve onay öğesi açar; LinkedIn'de yalnızca onaydan sonra ve yalnızca bağlı hesapla oluşturulur.
| Parametre | Tip | Açıklama |
|---|---|---|
nameZorunlu | string | — |
account_idİsteğe bağlı | string | LinkedIn reklam hesabı id'si (list_linkedin_accounts sonucundan); bağlantıda tek hesap varsa isteğe bağlı |
statusİsteğe bağlı | ACTIVE | PAUSED | DRAFT | varsayılan PAUSED |
daily_budgetİsteğe bağlı | number | hesap para birimi; grubun kampanyalarınca paylaşılan dinamik bütçe |
total_budgetİsteğe bağlı | number | hesap para birimi; end_date gerektirir |
end_dateİsteğe bağlı | string | YYYY-MM-DD |
objectiveİsteğe bağlı | BRAND_AWARENESS | WEBSITE_VISITS | ENGAGEMENT | VIDEO_VIEWS | LEAD_GENERATION | WEBSITE_CONVERSIONS | JOB_APPLICANTS | WEBSITE_VISIT | — |
bid_strategyİsteğe bağlı | MAXIMUM_DELIVERY | MANUAL | COST_CAP | — |
currencyİsteğe bağlı | string | ISO currency for the preview when the ad account currency is unknown |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
create_linkedin_campaign
Yazma2 krediBütçe, hedef, teklif ve build_linkedin_audience hedeflemesiyle LinkedIn kampanyası (sponsorlu içerik ya da metin reklam) oluşturur. Deftere taslak yazar ve önizlemeli onay öğesi açar; onaydan sonra LinkedIn'de (varsayılan olarak duraklatılmış) oluşturulur. Kreatifleri create_linkedin_sponsored_content / create_linkedin_text_ad ile ekleyin.
| Parametre | Tip | Açıklama |
|---|---|---|
nameZorunlu | string | — |
daily_budgetZorunlu | number | hesap para birimi |
targeting_criteriaZorunlu | object | build_linkedin_audience'ın döndürdüğü haliyle targetingCriteria JSON'u |
account_idİsteğe bağlı | string | LinkedIn reklam hesabı id'si (list_linkedin_accounts sonucundan); bağlantıda tek hesap varsa isteğe bağlı |
campaign_groupİsteğe bağlı | string | kampanya grubu urn'si/id'si; varsayılan: hesabın varsayılan grubu |
objectiveİsteğe bağlı | BRAND_AWARENESS | WEBSITE_VISITS | ENGAGEMENT | VIDEO_VIEWS | LEAD_GENERATION | WEBSITE_CONVERSIONS | JOB_APPLICANTS | WEBSITE_VISIT | varsayılan WEBSITE_VISITS; form reklamları için LEAD_GENERATION |
typeİsteğe bağlı | SPONSORED_UPDATES | TEXT_AD | varsayılan SPONSORED_UPDATES |
statusİsteğe bağlı | PAUSED | ACTIVE | varsayılan PAUSED (devam ettirilene kadar harcama yapılmaz) |
total_budgetİsteğe bağlı | number | — |
unit_costİsteğe bağlı | number | manuel teklif; verilmezse otomatik teklif |
cost_typeİsteğe bağlı | CPC | CPM | — |
locale_countryİsteğe bağlı | string | — |
locale_languageİsteğe bağlı | string | — |
organization_urnİsteğe bağlı | string | sponsorlu içerik için şirket sayfası; varsayılan: reklam hesabının referansı |
audience_expansionİsteğe bağlı | boolean | — |
offsite_deliveryİsteğe bağlı | boolean | LinkedIn Audience Network |
political_intentİsteğe bağlı | NOT_POLITICAL | POLITICAL | NOT_DECLARED | advertiser's declaration; ask the user and pass NOT_POLITICAL only if they confirm the ad is not political advertising (required before EU targeting goes live). Default NOT_DECLARED |
goalİsteğe bağlı | string | — |
currencyİsteğe bağlı | string | ISO currency for the preview when the ad account currency is unknown |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
update_linkedin_campaign_budget
Yazma2 krediBir LinkedIn kampanyasının günlük bütçesini, toplam bütçesini ve/veya teklifini değiştirir. Mevcut → yeni değerlerle önizleme döndürür; onaydan sonra uygulanır (bütçe düşüşleri ve küçük artışlar kullanıcının onay politikasına göre otomatik uygulanabilir).
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idZorunlu | string | Tecrübe kampanya id'si (uuid) ya da list_linkedin_campaigns'teki LinkedIn kampanya urn'si/id'si |
daily_budgetİsteğe bağlı | number | hesap para birimi |
total_budgetİsteğe bağlı | number | — |
unit_costİsteğe bağlı | number | manuel teklif (kampanyayı manuel teklife geçirir) |
account_idİsteğe bağlı | string | LinkedIn reklam hesabı id'si (list_linkedin_accounts sonucundan); bağlantıda tek hesap varsa isteğe bağlı |
currencyİsteğe bağlı | string | ISO currency for the preview when the ad account currency is unknown |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
update_linkedin_campaign_status
Yazma2 krediBir LinkedIn kampanyasını duraklatır, devam ettirir (ACTIVE) ya da arşivler. Önizleme ve onay politikasından geçer.
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idZorunlu | string | Tecrübe kampanya id'si (uuid) ya da list_linkedin_campaigns'teki LinkedIn kampanya urn'si/id'si |
statusZorunlu | ACTIVE | PAUSED | ARCHIVED | — |
account_idİsteğe bağlı | string | LinkedIn reklam hesabı id'si (list_linkedin_accounts sonucundan); bağlantıda tek hesap varsa isteğe bağlı |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
update_linkedin_campaign_group_status
YazmaGeri alınamaz2 krediBir LinkedIn kampanya grubunu etkinleştirir, duraklatır, arşivler, taslağa alır ya da siler (PENDING_DELETION). Her zaman önce önizlenir ve onaylanır.
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_groupZorunlu | string | kampanya grubu urn'si ya da id'si |
statusZorunlu | ACTIVE | PAUSED | ARCHIVED | DRAFT | PENDING_DELETION | PENDING_DELETION grubu siler (geri alınamaz) |
nameİsteğe bağlı | string | yalnızca önizleme için |
account_idİsteğe bağlı | string | LinkedIn reklam hesabı id'si (list_linkedin_accounts sonucundan); bağlantıda tek hesap varsa isteğe bağlı |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
update_linkedin_campaign_group_budget
Yazma2 krediBir LinkedIn kampanya grubunun toplam bütçesini, günlük bütçesini, bitiş tarihini ya da adını günceller. Önce önizlenir ve onaylanır.
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_groupZorunlu | string | — |
total_budgetİsteğe bağlı | number | — |
daily_budgetİsteğe bağlı | number | — |
end_dateİsteğe bağlı | string | YYYY-MM-DD |
nameİsteğe bağlı | string | — |
account_idİsteğe bağlı | string | LinkedIn reklam hesabı id'si (list_linkedin_accounts sonucundan); bağlantıda tek hesap varsa isteğe bağlı |
currencyİsteğe bağlı | string | ISO currency for the preview when the ad account currency is unknown |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
update_linkedin_campaign_targeting
Yazma2 krediBir LinkedIn kampanyasının hedeflemesini build_linkedin_audience'tan gelen targeting_criteria ile değiştirir. Önce önizlenir ve onaylanır.
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idZorunlu | string | Tecrübe kampanya id'si (uuid) ya da list_linkedin_campaigns'teki LinkedIn kampanya urn'si/id'si |
targeting_criteriaİsteğe bağlı | object | build_linkedin_audience'ın döndürdüğü haliyle targetingCriteria JSON'u |
audienceİsteğe bağlı | object | build_linkedin_audience'tan kitle tahmini (önizleme için) |
interface_localeİsteğe bağlı | string | — |
account_idİsteğe bağlı | string | LinkedIn reklam hesabı id'si (list_linkedin_accounts sonucundan); bağlantıda tek hesap varsa isteğe bağlı |
geo_urnsİsteğe bağlı | array<string> | URNs for the locations facet (linkedin_targeting_search) |
job_title_urnsİsteğe bağlı | array<string> | URNs for the titles facet (linkedin_targeting_search) |
job_function_urnsİsteğe bağlı | array<string> | URNs for the jobFunctions facet (linkedin_targeting_search) |
seniority_urnsİsteğe bağlı | array<string> | URNs for the seniorities facet (linkedin_targeting_search) |
industry_urnsİsteğe bağlı | array<string> | URNs for the industries facet (linkedin_targeting_search) |
skill_urnsİsteğe bağlı | array<string> | URNs for the skills facet (linkedin_targeting_search) |
staff_count_urnsİsteğe bağlı | array<string> | URNs for the staffCountRanges facet (linkedin_targeting_search) |
employer_urnsİsteğe bağlı | array<string> | URNs for the employers facet (linkedin_targeting_search) |
include_audience_urnsİsteğe bağlı | array<string> | URNs for the audienceMatchingSegments facet (linkedin_targeting_search) |
exclude_geo_urnsİsteğe bağlı | array<string> | URNs for the locations facet (linkedin_targeting_search) |
exclude_title_urnsİsteğe bağlı | array<string> | URNs for the titles facet (linkedin_targeting_search) |
exclude_function_urnsİsteğe bağlı | array<string> | URNs for the jobFunctions facet (linkedin_targeting_search) |
exclude_seniority_urnsİsteğe bağlı | array<string> | URNs for the seniorities facet (linkedin_targeting_search) |
exclude_industry_urnsİsteğe bağlı | array<string> | URNs for the industries facet (linkedin_targeting_search) |
exclude_skill_urnsİsteğe bağlı | array<string> | URNs for the skills facet (linkedin_targeting_search) |
exclude_staff_count_urnsİsteğe bağlı | array<string> | URNs for the staffCountRanges facet (linkedin_targeting_search) |
exclude_employer_urnsİsteğe bağlı | array<string> | URNs for the employers facet (linkedin_targeting_search) |
exclude_audience_urnsİsteğe bağlı | array<string> | URNs for the audienceMatchingSegments facet (linkedin_targeting_search) |
location_modeİsteğe bağlı | recent_or_permanent | permanent | recent_or_permanent (default, locations facet) or permanent (profileLocations facet) |
audience_languageİsteğe bağlı | string | interface locale, e.g. en_US, tr_TR or urn:li:locale:tr_TR (default en_US) |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
upload_linkedin_image
Yazma2 krediAdresten görseli (Stüdyo'da üretilenler dahil, en çok 5 MB) LinkedIn'e yükler; reklam kreatifi için urn:li:image döner.
| Parametre | Tip | Açıklama |
|---|---|---|
image_urlZorunlu | string | — |
organization_urnİsteğe bağlı | string | — |
account_idİsteğe bağlı | string | LinkedIn ad account id (from list_linkedin_accounts); optional when the connection has one account |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
create_linkedin_sponsored_content
Yazma2 krediMevcut bir şirket sayfası gönderisini LinkedIn kampanyasında sponsorlu içeriğe (kreatife) dönüştürür ya da kreatif olarak yeni bir gizli gönderi (dark post) oluşturur. Önce önizlenir ve onaylanır; LinkedIn kreatifi yayınlanmadan önce inceler.
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idZorunlu | string | Tecrübe kampanya id'si (uuid) ya da list_linkedin_campaigns'teki LinkedIn kampanya urn'si/id'si |
post_urnİsteğe bağlı | string | mevcut sayfa gönderisi urn:li:share:… / urn:li:ugcPost:… (list_linkedin_posts) |
commentaryİsteğe bağlı | string | post_urn verilmediğinde YENİ gizli gönderinin metni |
landing_pageİsteğe bağlı | string | — |
cta_labelİsteğe bağlı | string | LEARN_MORE | SIGN_UP | DOWNLOAD | REGISTER | APPLY | ... |
image_urnİsteğe bağlı | string | urn:li:image:… from upload_linkedin_image |
article_urlİsteğe bağlı | string | — |
article_titleİsteğe bağlı | string | — |
article_descriptionİsteğe bağlı | string | — |
lead_form_urnİsteğe bağlı | string | LEAD_GENERATION kampanyaları için urn:li:adForm:… |
organization_urnİsteğe bağlı | string | — |
nameİsteğe bağlı | string | — |
statusİsteğe bağlı | ACTIVE | PAUSED | DRAFT | varsayılan PAUSED |
account_idİsteğe bağlı | string | LinkedIn reklam hesabı id'si (list_linkedin_accounts sonucundan); bağlantıda tek hesap varsa isteğe bağlı |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
create_linkedin_text_ad
Yazma2 krediBir TEXT_AD kampanyasında LinkedIn metin reklam kreatifi (başlık ≤25, açıklama ≤75 karakter, açılış sayfası) oluşturur. Önce önizlenir ve onaylanır.
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idZorunlu | string | Tecrübe kampanya id'si (uuid) ya da list_linkedin_campaigns'teki LinkedIn kampanya urn'si/id'si |
headlineZorunlu | string | — |
descriptionZorunlu | string | — |
landing_pageZorunlu | string | — |
image_urnİsteğe bağlı | string | urn:li:image:… 100x100 (isteğe bağlı) |
nameİsteğe bağlı | string | — |
statusİsteğe bağlı | ACTIVE | PAUSED | DRAFT | varsayılan PAUSED |
account_idİsteğe bağlı | string | LinkedIn reklam hesabı id'si (list_linkedin_accounts sonucundan); bağlantıda tek hesap varsa isteğe bağlı |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
update_linkedin_creative_status
Yazma2 krediBir ya da daha fazla LinkedIn kreatifini duraklatır, etkinleştirir, arşivler ya da taslağa alır (ör. gösterimi olup dönüşümü olmayanlar). Önce önizlenir ve onaylanır; incelemedeki kreatifler duraklatılamaz.
| Parametre | Tip | Açıklama |
|---|---|---|
creative_idsİsteğe bağlı | array<string> | kreatif urn'leri/id'leri (list_linkedin_creatives) |
creative_idİsteğe bağlı | string | — |
statusZorunlu | ACTIVE | PAUSED | ARCHIVED | DRAFT | — |
campaign_idİsteğe bağlı | string | isteğe bağlı; reklam hesabını seçmeye yardımcı olur |
account_idİsteğe bağlı | string | LinkedIn reklam hesabı id'si (list_linkedin_accounts sonucundan); bağlantıda tek hesap varsa isteğe bağlı |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
create_linkedin_conversion
Yazma2 krediLinkedIn Insight Tag üzerinde dönüşüm izleme kuralı oluşturur (POST conversions): URL kurallarıyla site genelinde (ör. adres /tesekkurler içeriyor) ya da olaya özel. Sonra attach_linkedin_conversion ile kampanyaya bağlanır. Önce önizlenir ve onaylanır.
| Parametre | Tip | Açıklama |
|---|---|---|
nameZorunlu | string | — |
typeZorunlu | ADD_TO_CART | DOWNLOAD | INSTALL | KEY_PAGE_VIEW | LEAD | PURCHASE | SIGN_UP | OTHER | — |
url_rulesİsteğe bağlı | array<object> | site geneli kuralı: kurallar VE ile birleşir; olaya özel dönüşüm için boş bırakın |
post_click_daysİsteğe bağlı | 1 | 7 | 30 | — |
view_through_daysİsteğe bağlı | 1 | 7 | 30 | — |
valueİsteğe bağlı | number | — |
currencyİsteğe bağlı | string | — |
account_idİsteğe bağlı | string | LinkedIn reklam hesabı id'si (list_linkedin_accounts'tan); bağlantıda tek hesap varsa isteğe bağlı |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
attach_linkedin_conversion
Yazma1 krediBir LinkedIn kampanyasına dönüşüm izleme kuralı bağlar (campaignConversions PUT); kampanya bu dönüşümü raporlar ve ona göre optimize eder. Önce önizlenir ve onaylanır.
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idZorunlu | string | Tecrübe kampanya id'si (uuid) ya da list_linkedin_campaigns'tan LinkedIn kampanya urn/id'si |
conversion_idZorunlu | string | list_linkedin_conversions'tan |
account_idİsteğe bağlı | string | LinkedIn reklam hesabı id'si (list_linkedin_accounts'tan); bağlantıda tek hesap varsa isteğe bağlı |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
detach_linkedin_conversion
YazmaGeri alınamaz1 krediBir LinkedIn kampanyasından dönüşüm izleme kuralını ayırır (campaignConversions DELETE). Önce önizlenir ve onaylanır.
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idZorunlu | string | Tecrübe kampanya id'si (uuid) ya da list_linkedin_campaigns'tan LinkedIn kampanya urn/id'si |
conversion_idZorunlu | string | — |
account_idİsteğe bağlı | string | LinkedIn reklam hesabı id'si (list_linkedin_accounts'tan); bağlantıda tek hesap varsa isteğe bağlı |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
delete_linkedin_campaign
YazmaGeri alınamaz5 krediBir LinkedIn kampanyasını siler: DRAFT kampanya kalıcı olarak silinir, diğerleri PENDING_DELETION durumuna alınır (rapor verileri kalır). Geri alınamaz; her zaman açık onay bekler.
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idZorunlu | string | Tecrübe kampanya id'si (uuid) ya da list_linkedin_campaigns'tan LinkedIn kampanya urn/id'si |
account_idİsteğe bağlı | string | LinkedIn reklam hesabı id'si (list_linkedin_accounts'tan); bağlantıda tek hesap varsa isteğe bağlı |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
delete_linkedin_campaign_group
YazmaGeri alınamaz5 krediBir LinkedIn kampanya grubunu siler: DRAFT ise kalıcı, değilse PENDING_DELETION olarak işaretlenir. Geri alınamaz; her zaman açık onay bekler.
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_groupZorunlu | string | kampanya grubu urn'si ya da id'si |
account_idİsteğe bağlı | string | LinkedIn reklam hesabı id'si (list_linkedin_accounts'tan); bağlantıda tek hesap varsa isteğe bağlı |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
delete_linkedin_creative
YazmaGeri alınamaz5 krediBir LinkedIn kreatifini (reklamı) siler: DRAFT ise kalıcı, değilse PENDING_DELETION olarak işaretlenir. Geri alınamaz; her zaman açık onay bekler.
| Parametre | Tip | Açıklama |
|---|---|---|
creative_idZorunlu | string | kreatif urn'si ya da id'si |
campaign_idİsteğe bağlı | string | isteğe bağlı; reklam hesabını seçmeye yardımcı olur |
account_idİsteğe bağlı | string | LinkedIn reklam hesabı id'si (list_linkedin_accounts'tan); bağlantıda tek hesap varsa isteğe bağlı |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
update_linkedin_campaign
Yazma5 krediBir LinkedIn kampanyasını tek çağrıda günceller: ad, optimizasyon hedefi, maliyet türü ve zamanlama tek işlemde; bütçe/teklif ve durum kendi korumalı işlemleri olarak açılır (update_linkedin_campaign_budget / _status ile aynı kurallar). Her biri ayrı onaylanır.
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idZorunlu | string | Tecrübe kampanya id'si (uuid) ya da list_linkedin_campaigns çıktısındaki LinkedIn kampanya urn/id'si |
nameİsteğe bağlı | string | — |
statusİsteğe bağlı | ACTIVE | PAUSED | ARCHIVED | — |
daily_budgetİsteğe bağlı | number | hesap para birimi; bütçe korumasından geçer |
unit_costİsteğe bağlı | number | manuel teklif |
optimization_targetİsteğe bağlı | string | ör. MAX_CLICK, MAX_LEAD, MAX_CONVERSION, NONE (manuel) |
cost_typeİsteğe bağlı | CPC | CPM | CPV | — |
start_dateİsteğe bağlı | string | YYYY-MM-DD |
end_dateİsteğe bağlı | string | YYYY-MM-DD |
currencyİsteğe bağlı | string | reklam hesabının para birimi bilinmediğinde önizleme için ISO para birimi |
account_idİsteğe bağlı | string | LinkedIn reklam hesabı id'si (list_linkedin_accounts sonucundan); bağlantıda tek hesap varsa isteğe bağlı |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
update_linkedin_campaign_group
Yazma5 krediBir LinkedIn kampanya grubunu günceller (yalnızca verilen alanlar): ad, durum, toplam bütçe, amaç, başlangıç ve bitiş tarihi. Önce önizlenir ve onaylanır; +%50'nin üzerindeki bütçe artışları reddedilir.
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_groupZorunlu | string | — |
nameİsteğe bağlı | string | — |
statusİsteğe bağlı | ACTIVE | PAUSED | ARCHIVED | DRAFT | — |
total_budgetİsteğe bağlı | number | hesap para birimi; değişiklik başına +%50 koruması |
objectiveİsteğe bağlı | BRAND_AWARENESS | WEBSITE_VISITS | ENGAGEMENT | VIDEO_VIEWS | LEAD_GENERATION | WEBSITE_CONVERSIONS | JOB_APPLICANTS | WEBSITE_VISIT | — |
start_dateİsteğe bağlı | string | YYYY-MM-DD |
end_dateİsteğe bağlı | string | YYYY-MM-DD |
currencyİsteğe bağlı | string | reklam hesabının para birimi bilinmediğinde önizleme için ISO para birimi |
account_idİsteğe bağlı | string | LinkedIn reklam hesabı id'si (list_linkedin_accounts sonucundan); bağlantıda tek hesap varsa isteğe bağlı |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
create_linkedin_ad_account
YazmaGeri alınamaz2 krediCreate a new LinkedIn ad account for the connected user (the one with no ad account after OAuth). Only call it when the user explicitly asked for it; the account is created at once, the user becomes its ACCOUNT_MANAGER and the connection is linked to it. Currency is permanent; a payment method must still be added in Campaign Manager.
Bu aracın açıklaması henüz çevrilmedi; asistanın gördüğü özgün İngilizce metin gösteriliyor.
| Parametre | Tip | Açıklama |
|---|---|---|
nameZorunlu | string | account name, e.g. “Acme Ads” |
currencyZorunlu | AED | AUD | BRL | CAD | CHF | CZK | DKK | EUR | GBP | HKD | HUF | ILS | INR | JPY | KRW | MXN | MYR | NOK | NZD | PLN | SEK | SGD | THB | TRY | TWD | USD | ZAR | permanent; LinkedIn-supported ISO code |
organization_urnİsteğe bağlı | string | optional company page urn:li:organization:{id} the account advertises for |
connection_idİsteğe bağlı | string | optional: which LinkedIn identity (connection) opens the account |
forceİsteğe bağlı | boolean | create even though this identity already has an ad account |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.