Hızlı Başlangıç

Veri Yöneticisi API'sine aşina olmak için bu hızlı başlangıç kılavuzunu inceleyebilirsiniz. Hızlı başlangıç kılavuzunun görmek istediğiniz sürümünü seçin:

Bu hızlı başlangıç kılavuzunda aşağıdaki adımları tamamlarsınız:

  1. Kitle verilerini almak için bir Destination hazırlayın.
  2. Gönderilecek kitle verilerini hazırlayın.
  3. IngestionService isteği oluşturun.
  4. İsteği Google API Gezgini ile gönderin.
  5. Başarılı ve başarısız yanıtları anlama

Hedef hazırlama

Veri göndermeden önce, verileri göndereceğiniz hedefi hazırlamanız gerekir. Kullanabileceğiniz örnek bir Destination aşağıda verilmiştir:

    {
      "operatingAccount": {
        "product": "OPERATING_ACCOUNT_PRODUCT",
        "accountId": "OPERATING_ACCOUNT_ID"
      },

      "productDestinationId": "AUDIENCE_ID"
    }

  • operatingAccount parametresini, kitle verilerini alacak hesabın ürününe ve kimliğine ayarlayın.

Kitle verilerini hazırlama

Virgülle ayrılmış bir dosyada aşağıdaki örnek verileri inceleyin. Dosyadaki her satır kitlenin bir üyesine karşılık gelir ve her üyenin en fazla üç e-posta adresi vardır.

#,email_1,email_2,email_3
1,dana@example.com,DanaM@example.com,
2,ALEXJ@example.com, AlexJ@cymbalgroup.com,alexj@altostrat.com
3,quinn@CYMBALGROUP.com,baklavainthebalkans@gmail.com  ,
4,rosario@example.org,cloudySanFrancisco@GMAIL.com,

E-posta adresleri için aşağıdaki biçimlendirme ve karma oluşturma koşulları geçerlidir:

  1. Baştaki, sondaki ve aradaki tüm boşlukları kaldırın.
  2. E-posta adresini küçük harfe dönüştürün.
  3. E-posta adresine SHA-256 algoritması kullanılarak karma oluşturma işlemi uygulayın.
  4. Karma oluşturma işlemi uygulanmış baytları onaltılık (onaltılık) veya Base64 kodlaması kullanarak kodlayın. Bu kılavuzdaki örneklerde onaltılık kodlama kullanılmaktadır.

Biçimlendirilmiş veriler:

#,email_1,email_2,email_3
1,dana@example.com,danam@example.com,
2,alexj@example.com,alexj@cymbalgroup.com,alexj@altostrat.com
3,quinn@cymbalgroup.com,baklavainthebalkans@gmail.com,
4,rosario@example.org,cloudysanfrancisco@gmail.com,

Karma oluşturma ve kodlama işlemi uygulanmış veriler ise şu şekildedir:

#,email_1,email_2,email_3
1,07e2f1394b0ea80e2adca010ea8318df697001a005ba7452720edda4b0ce57b3,1df6b43bc68dd38eca94e6a65b4f466ae537b796c81a526918b40ac4a7b906c7
2,2ef46c4214c3fc1b277a2d976d55194e12b899aa50d721f28da858c7689756e3,54e410b14fa652a4b49b43aff6eaf92ad680d4d1e5e62ed71b86cd3188385a51,e8bd3f8da6f5af73bec1ab3fbf7beb47482c4766dfdfc94e6bd89e359c139478
3,05bb62526f091b45d20e243d194766cca8869137421047dc53fa4876d111a6f0,f1fcde379f31f4d446b76ee8f34860eca2288adc6b6d6c0fdc56d9eee75a2fa5
4,83a834cc5327bc4dee7c5408988040dc5813c7662611cd93b707aff72bf7d33f,223ebda6f6889b1494551ba902d9d381daf2f642bae055888e96343d53e9f9c4

Giriş verilerinin ilk satırındaki dana@example.com ve danam@example.com için biçimlendirilmiş, karma oluşturma işlemi uygulanmış ve kodlanmış e-posta adresleri için örnek bir AudienceMember aşağıda verilmiştir:

{
  "userData": {
    "userIdentifiers": [
      {
        "emailAddress": "07e2f1394b0ea80e2adca010ea8318df697001a005ba7452720edda4b0ce57b3"
      },
      {
        "emailAddress": "1df6b43bc68dd38eca94e6a65b4f466ae537b796c81a526918b40ac4a7b906c7"
      }
    ]
  }
}

İstek metnini oluşturma

İstek gövdesi için Destination ve userData'yi birleştirin:

{
  "destinations": [
    {
      "operatingAccount": {
        "product": "OPERATING_ACCOUNT_PRODUCT",
        "accountId": "OPERATING_ACCOUNT_ID"
      },

      "productDestinationId": "AUDIENCE_ID"
    }
  ],
  "audienceMembers": [
    {
      "userData": {
        "userIdentifiers": [
          {
            "emailAddress": "07e2f1394b0ea80e2adca010ea8318df697001a005ba7452720edda4b0ce57b3"
          },
          {
            "emailAddress": "1df6b43bc68dd38eca94e6a65b4f466ae537b796c81a526918b40ac4a7b906c7"
          }
        ]
      }
    },
    {
      "userData": {
        "userIdentifiers": [
          {
            "emailAddress": "2ef46c4214c3fc1b277a2d976d55194e12b899aa50d721f28da858c7689756e3"
          },
          {
            "emailAddress": "54e410b14fa652a4b49b43aff6eaf92ad680d4d1e5e62ed71b86cd3188385a51"
          },
          {
            "emailAddress": "e8bd3f8da6f5af73bec1ab3fbf7beb47482c4766dfdfc94e6bd89e359c139478"
          }
        ]
      }
    },
    {
      "userData": {
        "userIdentifiers": [
          {
            "emailAddress": "05bb62526f091b45d20e243d194766cca8869137421047dc53fa4876d111a6f0"
          },
          {
            "emailAddress": "f1fcde379f31f4d446b76ee8f34860eca2288adc6b6d6c0fdc56d9eee75a2fa5"
          }
        ]
      }
    },
    {
      "userData": {
        "userIdentifiers": [
          {
            "emailAddress": "83a834cc5327bc4dee7c5408988040dc5813c7662611cd93b707aff72bf7d33f"
          },
          {
            "emailAddress": "223ebda6f6889b1494551ba902d9d381daf2f642bae055888e96343d53e9f9c4"
          }
        ]
      }
    }
  ],
  "consent": {
    "adUserData": "CONSENT_GRANTED",
    "adPersonalization": "CONSENT_GRANTED"
  },
  "encoding": "HEX",
  "termsOfService": {
    "customerMatchTermsOfServiceStatus": "ACCEPTED"
  },
  "validateOnly": true
}
  1. Gövdedeki OPERATING_ACCOUNT_PRODUCT, OPERATING_ACCOUNT_ID ve AUDIENCE_ID gibi yer tutucuları hesabınız ve hedefinizle ilgili değerlerle güncelleyin.
  2. Değişiklikleri uygulamadan isteği doğrulamak için validateOnly değerini true olarak ayarlayın. Değişiklikleri uygulamaya hazır olduğunuzda validateOnly değerini false olarak ayarlayın.
  3. Kullanıcının Müşteri Eşleştirme Hizmet Şartları'nı kabul ettiğini belirtmek için termsOfService değerini ayarlayın.
  4. Bu isteğin, consent izninin verildiğini ve şifreleme kullanılmadığını belirttiğini unutmayın.

İsteği gönderme

  1. Örneğin sağ üst kısmındaki kopyala düğmesini kullanarak istek gövdesini kopyalayın.
  2. audienceMembers.ingest sayfasına gidin.
  3. Sağdaki API düğmesini, ardından genişletilmiş bölümdeki Deneyin düğmesini tıklayın.
  4. Kopyalanan istek gövdesini İstek gövdesi kutusuna yapıştırın.
  5. Yürüt düğmesini tıklayın, yetkilendirme istemlerini tamamlayın ve yanıtı inceleyin.

Başarı yanıtları

Başarılı bir istek, requestId içeren bir nesneyi içeren bir yanıt döndürür.

{
  "requestId": "126365e1-16d0-4c81-9de9-f362711e250a"
}

Hata yanıtları

Başarısız bir istek, 400 Bad Request gibi bir hata yanıtı durum kodu ve hata ayrıntılarını içeren bir yanıtla sonuçlanır.

Örneğin, onaltılık kodlanmış değer yerine düz metin dizesi içeren bir email_address aşağıdaki yanıtı oluşturur:

{
  "error": {
    "code": 400,
    "message": "There was a problem with the request.",
    "status": "INVALID_ARGUMENT",
    "details": [
      {
        "@type": "type.googleapis.com/google.rpc.ErrorInfo",
        "reason": "INVALID_ARGUMENT",
        "domain": "datamanager.googleapis.com"
      },
      {
        "@type": "type.googleapis.com/google.rpc.BadRequest",
        "fieldViolations": [
          {
            "field": "audience_members.audience_members[0].user_data.user_identifiers",
            "description": "Email is not hex encoded.",
            "reason": "INVALID_HEX_ENCODING"
          }
        ]
      }
    ]
  }
}

Karma oluşturma işlemi uygulanmayan ve yalnızca on altılık olarak kodlanan bir email_address, aşağıdaki yanıtı döndürür:

{
  "error": {
    "code": 400,
    "message": "There was a problem with the request.",
    "status": "INVALID_ARGUMENT",
    "details": [
      {
        "@type": "type.googleapis.com/google.rpc.ErrorInfo",
        "reason": "INVALID_ARGUMENT",
        "domain": "datamanager.googleapis.com"
      },
      {
        "@type": "type.googleapis.com/google.rpc.BadRequest",
        "fieldViolations": [
          {
            "field": "audience_members.audience_members[0]",
            "reason": "INVALID_SHA256_FORMAT"
          }
        ]
      }
    ]
  }
}

Sonraki adımlar