Bu sayfa, Cloud Translation API ile çevrilmiştir.

DT Exchange'i uyumlulaştırma ile entegre etme

Bu kılavuzda, şelale entegrasyonlarını ele alan uyumlulaştırma özelliğini kullanarak DT Exchange'den reklam yüklemek ve görüntülemek için Google Mobile Ads SDK'sının nasıl kullanılacağı gösterilmektedir. Bu kılavuzda, reklam biriminin uyumlulaştırma yapılandırmasına DT Exchange'in nasıl ekleneceği ve DT Exchange SDK'sı ile bağdaştırıcının bir uygulamaya nasıl iOS entegre edileceği ele alınmaktadır.

Desteklenen entegrasyonlar ve reklam biçimleri

DT Exchange için AdMob uyumlulaştırma bağdaştırıcısı aşağıdaki özelliklere sahiptir:

Entegrasyon
Teklif
Şelale
Formatlar
Banner
Geçişli
Ödül olarak verildi
Yerel biçim

Koşullar

12.0 veya üstü iOS dağıtım hedefi

En son Google Mobile Ads SDK'sı
Uyumlulaştırmayı tamamlayın Başlangıç kılavuzu

1. Adım: DT Exchange kullanıcı arayüzünde yapılandırmaları ayarlayın

Yeni uygulama ve reklam yerleşimi ekle

DT Exchange Konsolu'na kaydolun veya giriş yapın.

Uygulamanızı eklemek için Uygulama Ekle düğmesini tıklayın.

Uygulamaları Yönet

Platformunuzu seçin, formun geri kalanını doldurun ve Yerleşim Ekle'yi tıklayın.

Yerleşiminizi Adlandırın etiketli alana yeni yerleşim için bir ad girin ve açılır listeden istediğiniz Yerleşim Türü'nü seçin. Son olarak, Yerleşimi Kaydet'i tıklayın.

Kurulum

Uygulama Kimliği ve Yerleşim Kimliği

Farenizi üzerine getirerek sol gezinme çubuğunu açın. Ardından soldaki menüden Uygulamalar'ı tıklayın.

Uygulama Yönetimi sayfasında, uygulamanızın yanındaki Uygulama Kimliğini not edin.

Uygulama Kimliği

Uygulamanızı seçin, Yerleşimler sekmesine gidin ve Yerleşim Adı'nın yanındaki kopyala simgesini tıklayın. Yerleşim Kimliğini not edin.

Yerleşim Kimliği

Yayıncı Kimliği, Tüketici Anahtarı ve Tüketici Sırrı

Soldaki menüden kullanıcı adınızı tıklayın ve Kullanıcı Profili'ni seçin.

Sonraki adımda gerekli olan Yayıncı Kimliği, Tüketici Anahtarı ve Tüketici Sırrı değerlerini not edin.

2. Adım: Kullanıcı arayüzünde DT Exchange talebini AdMob ayarlayın

Reklam biriminiz için uyumlulaştırma ayarlarını yapılandırma

Reklam biriminizin uyumlulaştırma yapılandırmasına DT Exchange 'ı eklemeniz gerekiyor.

İlk olarak, AdMob hesabınızda oturum açın. Ardından Uyumlulaştırma sekmesine gidin. Değiştirmek istediğiniz mevcut bir uyumlulaştırma grubunuz varsa bu uyumlulaştırma grubunu düzenlemek için grubun adını tıklayın ve Reklam kaynağı olarak DT Exchange ekle bölümüne atlayın.

Yeni bir uyumlulaştırma grubu oluşturmak için Uyumlulaştırma Grubu Oluştur'u seçin.

Reklam biçimini ve platformunuzu girip Devam'ı tıklayın.

Uyumlulaştırma grubunuza bir ad verin ve hedeflenecek konumları seçin. Ardından, uyumlulaştırma grubu durumunu Etkin olarak ayarlayın ve Reklam Birimleri Ekle'yi tıklayın.

Bu uyumlulaştırma grubunu mevcut bir veya daha fazla AdMob reklam biriminizle ilişkilendirin. Ardından Bitti'yi tıklayın.

Şimdi, seçtiğiniz reklam birimleriyle doldurulmuş reklam birimleri kartını görmeniz gerekir:

Reklam kaynağı olarak DT Exchange ekleyin

Reklam Kaynakları bölümündeki Şelale kartının altından Reklam Kaynağı Ekle'yi seçin. Ardından DT Exchange simgesini seçin.

DT Exchange'i seçin ve Optimize et anahtarını etkinleştirin.DT Exchangeiçin reklam kaynağı optimizasyonunu ayarlamak üzere önceki bölümde belirtilen Publisher ID, Consumer Secret and Consumer Keydeğerini girin. ArdındanDT Exchange için bir eBGBM değeri girip Devam'ı tıklayın.

DT Exchangeiçin zaten bir eşlemeniz varsa bunu seçebilirsiniz. Aksi takdirde, Eşleme ekle'yi tıklayın.

Sonra, önceki bölümde aldığınız Application ID and Placement ID kodunu girin. Ardından Bitti'yi tıklayın.

GDPR ve ABD eyalet düzenlemeleri reklam iş ortakları listesine Fyber ekle

GDPR ayarları ve ABD eyalet düzenlemeleri ayarları bölümündeki adımları uygulayarak AdMob kullanıcı arayüzünde GDPR ve ABD eyalet düzenlemeleri reklam iş ortakları listesine Fyber ekleyin.

3. Adım: DT Exchange SDK'sını ve bağdaştırıcıyı içe aktarın

CocoaPods kullanma (önerilir)

Projenizin Podfile dosyasına aşağıdaki satırı ekleyin:

pod 'GoogleMobileAdsMediationFyber'

Komut satırından şu komutu çalıştırın:

pod install --repo-update

Manuel entegrasyon

iOS için DT Exchange SDK'sının en son sürümünü indirin ve aşağıdaki çerçeveleri projenize bağlayın:
- IASDKCore.framework
- IASDKMRAID.framework
- IASDKVideo.framework
Changelog'daki indirme bağlantısından DT Exchange bağdaştırıcısının en son sürümünü indirin ve projenizde FyberAdapter.framework bağlantısını tıklayın.
Projenize aşağıdaki çerçeveleri ekleyin:
- libxml2.2.tbd

4. Adım: DT Exchange SDK'sında gizlilik ayarlarını uygulayın

AB kullanıcı rızası alma ve GDPR

Google AB Kullanıcı Rızası Politikası uyarınca, Avrupa Ekonomik Alanı'ndaki (AEA) kullanıcılara cihaz tanımlayıcılarının ve kişisel verilerin kullanımıyla ilgili belirli açıklamalar yapılması ve bu kullanıcılardan izin alınması gerekir. Bu politika AB eGizlilik Yönergesi ve Genel Veri Koruma Yönetmeliği (GDPR) gereksinimlerini yansıtmaktadır. İzin isterken, uyumlulaştırma zincirinizde kişisel verileri toplayabilen, alabilen veya kullanabilen ve her bir ağın kullanımı hakkında bilgi verebilecek her bir reklam ağını tanımlamanız gerekir. Google şu anda kullanıcının izin seçimini bu tür ağlara otomatik olarak aktaramamaktadır.

DT Exchange, kullanıcı rızasını SDK'sına yönlendirmenize olanak tanıyan bir API içerir. Aşağıdaki örnek kod, izin bilgilerinin DT Exchange SDK'sına manuel olarak nasıl iletileceğini gösterir. İzin bilgilerini DT Exchange SDK'sına manuel olarak aktarmayı seçerseniz bu kodun Google Mobile Ads SDK'sı aracılığıyla reklam isteğinde bulunmadan önce çağrılması önerilir.

Swift

import IASDKCore
// ...

IASDKCore.sharedInstance().gdprConsent = IAGDPRConsentType.given
IASDKCore.sharedInstance().gdprConsentString = "myGdprConsentString"

Objective-C

#import <IASDKCore/IASDKCore.h>
// ...

[IASDKCore.sharedInstance setGDPRConsent:YES];
[IASDKCore.sharedInstance setGDPRConsentString:@"myGdprConsentString"];

DT Exchange'in GDPR Kaynak Sayfasını ve GDPR uygulama kılavuzunu ziyaret ederek daha fazla ayrıntıya ve yöntemde sunulabilecek değerlere erişebilirsiniz.

ABD eyalet gizlilik yasaları

ABD eyalet gizlilik yasaları kullanıcılara, "kişisel bilgilerini" "satma" (yasaların bu terimleri tanımladığı şekilde) özelliğinin kapsamı dışında kalma hakkı sunmayı zorunlu kılıyor. Bu seçenek, "satan" tarafın ana sayfasında belirgin bir şekilde görünen "Kişisel Bilgilerimi Satma" bağlantısıyla sunuluyor. ABD eyalet gizlilik yasalarına uygunluk kılavuzu, Google reklam yayını için kısıtlanmış veri işlemeyi etkinleştirme olanağı sunar ancak Google, bu ayarı uyumlulaştırma zincirinizdeki her reklam ağına uygulayamaz. Bu nedenle, uyumlulaştırma zincirinizde kişisel bilgi satışına dahil olabilecek tüm reklam ağlarını belirlemeniz ve uyumluluğu sağlamak için bu ağların her birinin talimatlarını uygulamanız gerekir.

Swift

import IASDKCore
// ...

IASDKCore.sharedInstance().ccpaString = "myCCPAConsentString"

Objective-C

#import <IASDKCore/IASDKCore.h>
// ...

[IASDKCore.sharedInstance setCCPAString:@"myCCPAConsentString"];

DT Exchange'in CCPA Kaynak Sayfası'nı ve CCPA uygulama rehberini ziyaret ederek daha ayrıntılı bilgi edinin ve yöntemde sağlanabilecek değerleri öğrenin.

5. Adım: Gerekli kodu ekleyin

SKAdNetwork entegrasyonu

SKAdNetwork tanımlayıcılarını projenizin Info.plist dosyasına eklemek için DT Exchange'in dokümanlarındaki talimatları uygulayın.

6. Adım: Uygulamanızı test etme

Test reklamlarını etkinleştir

AdMob.

Test reklamlarını doğrulama

DT Exchangereklam kaynağından test reklamları aldığınızı doğrulamak için DT Exchange (Waterfall) reklam kaynaklarını kullanarak reklam inceleyicide tek reklam kaynağı testini etkinleştirin.

İsteğe bağlı adımlar

Ağa özgü parametreler

DT Exchange bağdaştırıcısı, GADMAdapterFyberExtras() kullanılarak bağdaştırıcıya iletilebilecek ek istek parametrelerini destekler. Adaptör, pakette aşağıdaki anahtarları arar:

İstek parametreleri ve değerleri
`setUserData` Kullanıcının yaşı, cinsiyeti ve posta kodu.	`IAUserData`
`setMuteAudio`	Boole. Videonun sesini kapat veya aç

Aşağıda, bu reklam isteği parametrelerini nasıl ayarlayacağınıza ilişkin bir kod örneği verilmiştir:

Swift

let userData = IAUserData.build({ builder in
  builder.age = 23
  builder.gender = IAUserGenderType.male
  builder.zipCode = "1234"
}];

let request = GADRequest()
let extras = GADMAdapterFyberExtras()
extras.userData = userData
extras.muteAudio = true
request.register(extras)

Objective-C

IAUserData *userData = [IAUserData build:^(id<IAUserDataBuilder> _Nonnull builder) {
    builder.age = 23;
    builder.gender = IAUserGenderTypeMale;
    builder.zipCode = @"1234";
}];

GADRequest *request = [GADRequest request];
GADMAdapterFyberExtras *extras = [[GADMAdapterFyberExtras alloc] init];
extras.userData = userData;
extras.muteAudio = YES;
[request registerAdNetworkExtras:extras];

Daha fazla bilgi için DT Exchange entegrasyon kılavuzuna bakın.

Hata kodları

Bağdaştırıcı, DT Exchange'den reklam alamazsa aşağıdaki sınıfın altında GADResponseInfo.adNetworkInfoArray şu sınıf kapsamında:

GADMediationAdapterFyber

Bir reklam yüklenemediğinde DT Exchange bağdaştırıcısı tarafından atılan kodlar ve ilgili mesajları burada bulabilirsiniz:

Hata kodu	Neden
101	Kullanıcı arayüzünde yapılandırılmış DT Exchange sunucusu parametreleri AdMob eksik/geçersiz.
103	İstenen reklam boyutu, DT Exchange tarafından desteklenen bir banner boyutuyla eşleşmiyor.
105	DT Exchange SDK'sı bir reklam yükledi, ancak beklenmeyen bir denetleyici döndürdü.
106	Reklam görüntülenmeye hazır değil.
200-399	DT Exchange SDK bir hata döndürdü. Daha fazla bilgi için kodu inceleyin.
0-10	DT Exchange SDK bir hata döndürdü. Daha fazla ayrıntı için belgelere bakın.
101	Kullanıcı arayüzünde yapılandırılmış DT Exchange sunucusu parametreleri AdMob eksik/geçersiz.
102	İstenen reklam boyutu, DT Exchange tarafından desteklenen bir banner boyutuyla eşleşmiyor.
103	Reklam nesnesi zaten kullanıldığı için reklam gösterilemedi.
104	Reklam hazır olmadığı için DT Exchange reklamları gösterilemedi.
105	DT Exchange SDK'sı bir başlatma hatası döndürdü.